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

[Andreas Tille]

Author: tille
Date: 2011-03-19 12:03:47 +0000 (Sat, 19 Mar 2011)
New Revision: 6313

Modified:
   trunk/community/website/docs/policy.xml
Log:
Use dh in favour of cdbs


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2011-03-19 11:41:48 UTC (rev 6312)
+++ trunk/community/website/docs/policy.xml	2011-03-19 12:03:47 UTC (rev 6313)
@@ -331,13 +331,15 @@
 			touch packages only because it has an older Debhelper version.</para>
 			<para>
 			It is strongly recommended to use the short <emphasis>dh</emphasis> notation in <filename>debian/rules</filename> files which makes code factorisation very
-			simple and easy to understand the packaging for other members of the team.
+			simple and easy to understand the packaging for other members of the team.  Even complex packaging becomes quite transparant this way.
 			</para>
 		</sect2>
 		
 		<sect2 id="cdbs">
 			<title>CDBS</title>
-			<para>The use of CDBS is welcome as it helps us to factorise our code. Nevertheless, please do not use complex CDBS for non-trivial packages, so that other developers can quickly understand the package when doing QA work.</para>
+			<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>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>