Update of /cvsroot/devil-linux/build/docs/documentation
In directory sc8-pr-cvs1:/tmp/cvs-serv13954/docs/documentation
Modified Files:
Tag: rel-1-0-patches
documentation.xml
Log Message:
added information about patching
Index: documentation.xml
===================================================================
RCS file: /cvsroot/devil-linux/build/docs/documentation/documentation.xml,v
retrieving revision 1.43.2.6
retrieving revision 1.43.2.7
diff -u -d -r1.43.2.6 -r1.43.2.7
--- documentation.xml 15 Nov 2003 15:29:40 -0000 1.43.2.6
+++ documentation.xml 26 Nov 2003 17:11:49 -0000 1.43.2.7
@@ -15,7 +15,7 @@
<!ENTITY sample1 SYSTEM "sample/ez-ipupdate">
]>
<book>
- <title>\Devil-Linux Documentation</title>
+ <title>Devil-Linux Documentation</title>
<bookinfo>
<subtitle>This documentation is for v1.0 and above</subtitle>
<subtitle>$Revision$ $Date$ </subtitle>
@@ -869,6 +869,35 @@
<para>You can create a configuration floppy disc by invocing the command <filename>build/scripts/build-etc</filename><caution>
<para>Do not execute any make command outside the chroot environment! Otherwise you will have to re-install your host Operating System.</para>
</caution></para>
+ </sect1>
+ <sect1>
+ <title>Your Modifications & Patches</title>
+ <para>The Devil-Linux Develop Team and our Users really appreciate when you send in your patches, so they can be included in the next release.</para>
+ <sect2>
+ <title>Submitting Patches</title>
+ <para>Please create a "unified diff" and send it to our mailinglist with the subject <quote>[PATCH] short title</quote>. </para>
+ <para>Attach the patch file to the email, so that no formatting is lost. Please compress the file if it's more then a few hundret bytes.</para>
+ <para>Add a (short) description what you patch is doing. </para>
+ <para>If your patch required the some source package has to be put into the <filename moreinfo="none">build/src/</filename> directory, then please write us all the necessary links into the email.</para>
+ </sect2>
+ <sect2>
+ <title>Creating Patches</title>
+ <para>If you're not familiar with patches, take a look at the <command moreinfo="none">man</command> pages of <command moreinfo="none">patch</command> and <command moreinfo="none">diff</command>.</para>
+ <itemizedlist>
+ <listitem>
+ <para>copy the unchanged <filename moreinfo="none">SCRIPT</filename> to <filename moreinfo="none">SCRIPT.old</filename> </para>
+ </listitem>
+ <listitem>
+ <para>make your changes</para>
+ </listitem>
+ <listitem>
+ <para>change into the <filename moreinfo="none">build</filename> directory</para>
+ </listitem>
+ <listitem>
+ <para>execute: <command moreinfo="none">diff -u subdir/SCRIPT.old subdir/SCRIPT > yourpatch.diff</command></para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
</sect1>
<sect1>
<title>The Build System</title>
|
