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>
_______________________________________________
debian-med-commit mailing list
[email protected]
http://lists.alioth.debian.org/mailman/listinfo/debian-med-commit
