[med-svn] r6330 - trunk/community/website/docs

[Charles Plessy]

Author: plessy
Date: 2011-03-21 08:22:27 +0000 (Mon, 21 Mar 2011)
New Revision: 6330

Modified:
   trunk/community/website/docs/policy.xml
Log:
Refreshed section about patches.


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2011-03-21 08:05:27 UTC (rev 6329)
+++ trunk/community/website/docs/policy.xml	2011-03-21 08:22:27 UTC (rev 6330)
@@ -691,15 +691,27 @@
 		</sect2>
 		<sect2 id="patches">
 			<title>Handling patches</title>
-			<para>Often happens that the upstream code doesn't fit well into the
-			Debian distribution: be this wrong paths, missing features, anything
-			that implies editing the source files. When you directly edit
-			upstream's source files, your changes will be put into a .diff.gz file,
-			which should instead contain only debian. To better organise the patches and group the by function, please use a patch handling system which keeps patches under the
-			<filename class="directory">debian/patches</filename> directory.</para>
-			<para>The most known are <command>quilt</command>, <emphasis>simple-patchsys</emphasis> (from the <emphasis>CDBS</emphasis> package) and <command>dpatch</command>.
-			Please don't use any other patch system in Debian Med, unless absolutely
-			necessary.</para>
+			<para>
+				Often happens that the upstream code doesn't fit well into the
+				Debian distribution: be this wrong paths, missing features, anything
+				that implies editing the source files.  When you directly edit
+				upstream's source files, your changes will be put into a .diff.gz file
+				if you use the <literal>1.0</literal> source format and in a monolithic
+				patch if you use the <literal>3.0 (quilt)</literal> format.  To better
+				organise the patches and group the by function, please use a patch
+				handling system	which keeps patches under the <filename
+				class="directory">debian/patches</filename> directory.
+			</para>
+			<para>
+				The <literal>3.0 (quilt)</literal> Dpkg source format provides its own
+				patch system.  Apart from this, the most popular is
+				<command>quilt</command>.  <emphasis>simple-patchsys</emphasis>, from
+				the <package>CDBS</package> package, is deprecated since version
+				<literal>0.4.85</literal>.  <command>dpatch</command> has been popular
+				as well, but is not compatible with the <literal>3.0 (quilt)</literal>
+				source format.  Please don't use any other patch system in Debian Med,
+				unless absolutely necessary.
+			</para>
 			<sect3 id="quilt">
 				<title>Using <command>quilt</command></title>
 				<para>Using quilt is rather easy.</para>