Package: debian-policy
Version: 3.9.0.0
Severity: wishlist
Tags: patch

Dear all,

during the discussion about team uploads (http://wiki.debian.org/TeamUpload),
it was proposed to send a patch to the Policy, to include a footnotes that
reminds that sometimes the first line of a changelog has a special meaning, and
point at the Developer's Reference for more information.

Here is tha patch:

diff --git a/policy.sgml b/policy.sgml
index 0b3c1a1..e64b18b 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -1608,7 +1608,24 @@
          The maintainer name and email address used in the changelog
          should be the details of the person uploading <em>this</em>
          version.  They are <em>not</em> necessarily those of the
-         usual package maintainer.  The information here will be
+         usual package maintainer<footnote>
+           When the developer uploading the pacakge is not listed in
+           the <qref id="f-Maintainer"><tt>Maintainer</tt></qref> or
+           <qref id="f-Uploaders"><tt>Uploaders</tt></qref> fields,
+           the first line of the changelog may be used to indicate
+           a justification of the upload. In particular, the following
+           lines are currently used:
+           <example>
+             * Non-maintainer upload.
+             * Non-maintainer upload by the Security Team.
+             * QA upload.
+             * Binary-only non-maintainer upload for <var>architecture</var>; 
no source changes.
+             * Team upload.
+           </example>
+           Most of these uses are described in more details in the <tt><url
+           name="Debian Deveper's Reference"
+           id="http://www.debian.org/doc/developers-reference/";></tt>.
+         </footnote>.  The information here will be
          copied to the <tt>Changed-By</tt> field in the
          <tt>.changes</tt> file (see <ref id="f-Changed-By">),
          and then later used to send an acknowledgement when the


In addition, there is currently a typo in the master branch of the policy:

-           example, <prng>dpkg</prng> will consider "96May01" to be
+           example, <prgn>dpkg</prgn> will consider "96May01" to be


Have a nice day,

-- 
Charles



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to