From: <smi...@us...> - 2003-11-14 01:43:30
|
Update of /cvsroot/devil-linux/build/docs/documentation In directory sc8-pr-cvs1:/tmp/cvs-serv6530/docs/documentation Modified Files: 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.48 retrieving revision 1.49 diff -u -d -r1.48 -r1.49 --- documentation.xml 25 Oct 2003 00:22:15 -0000 1.48 +++ documentation.xml 14 Nov 2003 01:43:27 -0000 1.49 @@ -871,6 +871,35 @@ </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>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>man</command> pages of <command>patch</command> and <command>diff</command>.</para> + <itemizedlist> + <listitem> + <para>copy the unchanged <filename>SCRIPT</filename> to <filename>SCRIPT.old</filename> </para> + </listitem> + <listitem> + <para>make your changes</para> + </listitem> + <listitem> + <para>change into the <filename>build</filename> directory</para> + </listitem> + <listitem> + <para>execute: <command>diff -u subdir/SCRIPT.old subdir/SCRIPT > yourpatch.diff</command></para> + </listitem> + </itemizedlist> + </sect2> + </sect1> + <sect1> <title>The Build System</title> <sect2> <title>Directory structure</title> |