The following commit has been merged in the master branch:
commit 5a301fc9c7bf98d35e7176129a79f1cc4ec5e980
Author: Bas Couwenberg <[email protected]>
Date: Sun Jan 19 23:32:16 2014 +0100
Improve Config::Module section. Add explicit debian/control examples.
diff --git a/policy.xml b/policy.xml
index b2d0b6c..b224b99 100644
--- a/policy.xml
+++ b/policy.xml
@@ -1019,18 +1019,6 @@ Cmnd_Alias PBUILDERS=/usr/sbin/pbuilder,
/usr/sbin/cowbuilder
</programlisting>
</para>
</sect5>
- <sect5 id="">
- <title></title>
- <para>
- ...
- </para>
- </sect5>
- <sect5 id="">
- <title></title>
- <para>
- ...
- </para>
- </sect5>
</sect4>
</sect3>
<sect3 id="git-package-branches">
@@ -1368,7 +1356,12 @@ lintian ../build-area/*changes
<listitem>
<formalpara>
<title>Section</title>
- <para>Should be <quote>science</quote> for the source
package.</para>
+ <para>
+ Should be <quote>science</quote> for the source package.
+<programlisting>
+Section: science
+</programlisting>
+ </para>
</formalpara>
</listitem>
<listitem>
@@ -1380,6 +1373,9 @@ lintian ../build-area/*changes
(<ulink
url="http://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities";>see
§2.5</ulink>).
Packages of priority <quote>extra</quote> are excluded from some
QA tests.
+<programlisting>
+Priority: optional
+</programlisting>
</para>
</formalpara>
</listitem>
@@ -1395,6 +1391,9 @@ lintian ../build-area/*changes
<ulink
url="http://qa.debian.org/[email protected]";>QA
page</ulink>
corresponding to this email to gather information about the
packages.
+<programlisting>
+Maintainer: Debian GIS Project <[email protected]>
+</programlisting>
</para>
</formalpara>
</listitem>
@@ -1403,10 +1402,16 @@ lintian ../build-area/*changes
<title>Uploaders</title>
<para>
Please add yourself as an uploader when you have a significant
- interest in a package. Being Uploader means that you are expected
- to answer to the bug reports. For more occasional works, you can
- do a
- <ulink
url="http://www.debian.org/doc/developers-reference/pkgs#nmu-team-upload";>team
upload</ulink>.
+ interest in a package.
+ Being Uploader means that you are expected to answer to the bug
+ reports.
+ For more occasional works, you can do a
+ <ulink
url="http://www.debian.org/doc/developers-reference/pkgs#nmu-team-upload";>team
upload</ulink>
+ with <command>dch</command> <option>--team</option>.
+<programlisting>
+Uploaders: <replaceable>John Doe <[email protected]></replaceable>,
+ <replaceable>Your Name <[email protected]></replaceable>
+</programlisting>
</para>
</formalpara>
</listitem>
@@ -1417,6 +1422,9 @@ lintian ../build-area/*changes
Please always use the latest unless there are concerns for
backporting. If no changes are needed, please indicate this
fact in the changelog, and increment the value of the field.
+<programlisting>
+Standards-Version: 3.9.5
+</programlisting>
</para>
</formalpara>
</listitem>
@@ -1425,12 +1433,15 @@ lintian ../build-area/*changes
<title>Homepage</title>
<para>
Should be documented whenever possible.
+<programlisting>
+Homepage: <replaceable>http://www.example.com/</replaceable>
+</programlisting>
</para>
</formalpara>
</listitem>
<listitem>
<formalpara id="vcs-url">
- <title>Vcs-Git: and Vcs-Browser:</title>
+ <title>Vcs-Git and Vcs-Browser</title>
<para>
Please use the following templates, and refer to the Debian
Policy
<ulink
url="http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-VCS-fields";>§
5.6.26</ulink>
@@ -1448,18 +1459,25 @@ Vcs-Svn:
svn://anonscm.debian.org/pkg-grass/packages/<package>/trunk/
</formalpara>
</listitem>
</orderedlist>
- <para id="cme">
- It is a very good idea to use
- <ulink
url="http://packages.qa.debian.org/libc/libconfig-model-perl.html";><command>Config::Model</command></ulink>
- to unify the formatting of <filename>debian/control</filename>.
- To do so make sure you have installed
- <literal>libconfig-model-perl</literal>
- and <literal>libconfig-model-dpkg-perl</literal>
- and then you can simply call
- <command>cme fix</command> <option>dpkg-control</option>
- to get a properly formated, sanity checked
- <filename>debian/control</filename> file.
- Please note that sometimes you need to call this more than once.
+ <sect3 id="cme">
+ <title>Config::Model</title>
+ <para>
+ It is a very good idea to use
+ <ulink
url="http://packages.qa.debian.org/libc/libconfig-model-perl.html";><command>Config::Model</command></ulink>
+ to unify the formatting of <filename>debian/control</filename>.
+ </para>
+ <para>
+ To do so make sure you have installed
+ <literal>libconfig-model-perl</literal>
+ and <literal>libconfig-model-dpkg-perl</literal>
+ and then you can simply call
+ <command>cme fix</command> <option>dpkg-control</option>
+ to get a properly formated, sanity checked
+ <filename>debian/control</filename> file.
+ </para>
+ <para>
+ Please note that sometimes you need to call this more than once.
+ </para>
<programlisting>
<command>apt-get install</command> <option>libconfig-model-dpkg-perl
libconfig-model-perl</option>
# Install libconfig-model-itself-perl for a graphical model editor
@@ -1468,22 +1486,27 @@ Vcs-Svn:
svn://anonscm.debian.org/pkg-grass/packages/<package>/trunk/
<command>cme check</command> <option>dpkg-control</option>
<command>cme fix</command> <option>dpkg-control</option>
</programlisting>
- </para>
+ </sect3>
</sect2>
<sect2 id="debian-copyright">
<title><filename>debian/copyright</filename></title>
<para>
We use the
<ulink
url="http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/";>machine-readable
format</ulink>
- for the <filename>debian/copyright</filename> file. The
- <computeroutput>Source</computeroutput> field does not need to contain
- the full URL to the particular version that is being packaged, since
- this can be determined by the <command>uscan</command> program with the
- <filename>debian/watch</filename> file. Please list yourself in the
- <computeroutput>Files: debian/*</computeroutput> section if you think
- that your contributions are not trivial and therefore subjected to
- copyright. Please chose a license that is compatible with the program
- you package. You can also use
+ for the <filename>debian/copyright</filename> file.
+ </para>
+ <para>
+ The <literal>Source</literal> field does not need to contain the full
+ URL to the particular version that is being packaged,
+ since this can be determined by the <command>uscan</command> program
+ with the <filename>debian/watch</filename> file.
+ </para>
+ <para>
+ Please list yourself in the <literal>Files: debian/*</literal> section
+ if you think that your contributions are not trivial and therefore
+ subjected to copyright.
+ Please chose a license that is compatible with the program you package.
+ You can also use
<quote>same as if it were in the public domain</quote> or
<quote>same as the packaged program itself</quote>.
</para>
@@ -1499,11 +1522,12 @@ Vcs-Svn:
svn://anonscm.debian.org/pkg-grass/packages/<package>/trunk/
To verify the correct syntax of the
<filename>debian/copyright</filename> file you can use:
<programlisting>
-<command>config-edit</command> <option>-application dpkg-copyright</option>
<option>-ui none</option>
+<command>cme check</command> <option>dpkg-copyright</option>
+<command>cme fix</command> <option>dpkg-copyright</option>
</programlisting>
or
<programlisting>
-<command>cme fix</command> <option>dpkg-copyright</option>
+<command>config-edit</command> <option>-application dpkg-copyright</option>
<option>-ui none</option>
</programlisting>
from package <filename>libconfig-model-dpkg-perl</filename>
(see <link linkend="cme">Config::Model</link> above).
@@ -1519,7 +1543,8 @@ Vcs-Svn:
svn://anonscm.debian.org/pkg-grass/packages/<package>/trunk/
<para>
This can be done automatically by declaring
<literal><varname>DEBCHANGE_RELEASE_HEURISTIC</varname>=<replaceable>changelog</replaceable></literal>
- in <filename>~/.devscripts</filename> and using <command>dch</command>.
+ in <filename>~/.devscripts</filename> and using
+ <ulink
url="http://manpages.debian.net/cgi-bin/man.cgi?query=dch";><command>dch</command></ulink>.
</para>
</sect2>
<sect2 id="debian-upstream">
--
pkg-grass website
_______________________________________________
Pkg-grass-devel mailing list
[email protected]
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel
