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

[Charles Plessy]

Author: plessy
Date: 2013-11-30 05:16:17 +0000 (Sat, 30 Nov 2013)
New Revision: 15344

Modified:
   trunk/community/website/docs/policy.xml
Log:
Stronger recommendation to prefer dh over CDBS, with a different justification.

I think that the documentaiton of CDBS is good, in contrary with what was
written here.



Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2013-11-30 04:30:51 UTC (rev 15343)
+++ trunk/community/website/docs/policy.xml	2013-11-30 05:16:17 UTC (rev 15344)
@@ -741,8 +741,8 @@
 		<sect2 id="cdbs">
 			<title>CDBS</title>
 			<para>Before the short <emphasis>dh</emphasis> notation of debhelper existed CDBS was the only way to factorise code in <filename>debian/rules</filename> files.
-			So it was recommended in the past but it turned out that CDBS is badly documented and recently introduced incompatible changes.  So it is sometimes reasonable
-			to switch from CDBS to <emphasis>dh</emphasis> if some problems in the packaging might occure.</para>
+			We would like to standardise on <emphasis>dh</emphasis> when both provide similar comfort.  Please give it priority for new packages.
+			It is also possible to switch to <emphasis>dh</emphasis> for existing packages, but this is entirely at the packagers discretion.</para>
 			<para>It is technically possible to build CDBS packages using Debhelper without the <filename>debian/compat</filename> file. Please do not, and always include such a file according to the above guidelines.</para>
 		</sect2>