This is an automated email from the git hooks/post-receive script. sebastic-guest pushed a commit to branch master in repository website.
commit b242ed2d5ed7501db4bd8f2996dfa5e95b8789d3 Author: Bas Couwenberg <sebas...@xs4all.nl> Date: Sun Feb 16 01:10:17 2014 +0100 Improve 'debian/compat' section. --- policy.xml | 81 +++++++++++++++++++++++++++++++++++++------------------------- 1 file changed, 48 insertions(+), 33 deletions(-) diff --git a/policy.xml b/policy.xml index fd2ac35..f7fae8c 100644 --- a/policy.xml +++ b/policy.xml @@ -1769,41 +1769,56 @@ pristine-tar = True <filename class="directory">debian</filename> directory. </para> </sect2> - <sect2 id="debhelper"> - <title>Debhelper</title> + <sect2 id="debian-compat"> + <title><filename>debian/compat</filename></title> <para> - Debhelper uses compatibility levels to control the behavior of its - commands. We currently recommend to use the level <literal>9</literal> - which is available in current <literal>stable</literal> (Wheezy) and - backported to <literal>oldstable</literal>. However, there is no - urgent need to touch packages only because it has an older Debhelper - version. - </para> - <para> - It is strongly recommended to use the short <literal>dh</literal> - notation in <filename>debian/rules</filename> files which makes code - factorization very simple and easy to understand the packaging for - other members of the team. Even complex packaging becomes quite - transparent this way. - </para> - </sect2> - <sect2 id="cdbs"> - <title>CDBS</title> - <para> - Before the short <literal>dh</literal> notation of debhelper existed - CDBS was the only way to factorize code in - <filename>debian/rules</filename> files. - We would like to standardize on <literal>dh</literal> when both - provide similar comfort. Please give it priority for new packages. - It is also possible to switch to <literal>dh</literal> 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 - <link linkend="debhelper">Debhelper</link> guidelines. + Should normally contain <literal>9</literal>. + This debhelper compatibility level is recommended for its improved + support of + <ulink url="https://wiki.debian.org/Hardening">hardening buildflags</ulink> + and + <ulink url="https://wiki.debian.org/Multiarch">Multi-Arch</ulink>. +<programlisting> +9 +</programlisting> </para> + <sect3 id="debhelper"> + <title>Debhelper</title> + <para> + Debhelper uses compatibility levels to control the behavior of its + commands. + We currently recommend to use the level <literal>9</literal> which + is available in current <literal>stable</literal> (Wheezy) and + backported to <literal>oldstable</literal>. + However, there is no urgent need to touch packages only because it + has an older Debhelper version. + </para> + <para> + It is strongly recommended to use the short <literal>dh</literal> + notation in <filename>debian/rules</filename> files which makes code + factorization very simple and easy to understand the packaging for + other members of the team. + Even complex packaging becomes quite transparent this way. + </para> + </sect3> + <sect3 id="cdbs"> + <title>CDBS</title> + <para> + Before the short <literal>dh</literal> notation of debhelper existed + CDBS was the only way to factorize code in + <filename>debian/rules</filename> files. + We would like to standardize on <literal>dh</literal> when both + provide similar comfort. Please give it priority for new packages. + It is also possible to switch to <literal>dh</literal> 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 + <link linkend="debhelper">Debhelper</link> guidelines. + </para> + </sect3> </sect2> <sect2 id="vcs"> <title>Version control systems</title> -- Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/website.git _______________________________________________ Pkg-grass-devel mailing list Pkg-grass-devel@lists.alioth.debian.org http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel