]> git.donarmstrong.com Git - debian/debian-policy.git/commitdiff
Mention optional special role for the first changelog line
authorCharles Plessy <plessy@debian.org>
Fri, 23 Jul 2010 02:06:45 +0000 (11:06 +0900)
committerRuss Allbery <rra@debian.org>
Sun, 25 Jul 2010 04:46:26 +0000 (21:46 -0700)
Points at the Debian Developer's Reference, that documents standardised
changelog first entries for NMU, QA, security and team uploads.

policy.sgml

index e357b547e3692f51ae725dc9602478cef79966df..83d42a9f38b15210852ace0932ec427480d4dc3f 100644 (file)
          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>
+           If the developer uploading the package is not one of the usual
+           maintainers of the package (as listed in the
+           <qref id="f-Maintainer"><tt>Maintainer</tt></qref> or
+           <qref id="f-Uploaders"><tt>Uploaders</tt></qref> control fields of
+           the package), the first line of the changelog is conventionally used
+           to explain why a non-maintainer is uploading the package.  The
+           Debian Developer's Reference (see <ref id="related">) documents the
+           conventions used.</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