[Devil-linux-commit] build/docs/documentation documentation.xml,1.43.2.6,1.43.2.7

[<smi...@us...>]

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 &amp; 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 &gt; yourpatch.diff</command></para>
+          </listitem>
+        </itemizedlist>
+      </sect2>
     </sect1>
     <sect1>
       <title>The Build System</title>