[website] 04/06: Improve 'debian/compat' section.
Bas Couwenberg
sebastic at xs4all.nl
Sun Feb 16 00:14:38 UTC 2014
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 <sebastic at 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
More information about the Pkg-grass-devel
mailing list