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>
                


_______________________________________________
debian-med-commit mailing list
[email protected]
http://lists.alioth.debian.org/mailman/listinfo/debian-med-commit

Reply via email to