Add Homepage control field

Add a specification for the optional Homepage control field.
Closes #452105.

git-archimport-id: rra@debian.org--lenny/debian-policy--devel--3.7--patch-34

diff --git a/debian/changelog b/debian/changelog
index 0728ea921f1bf3b5fa48114462afa5b32721d993..de0ca1d01f2064b160ddb9d55aa8418b023701be 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -9,6 +9,8 @@ debian-policy (3.7.4.0) unstable; urgency=low
   * Bug fix: "[PROPOSAL] Add should not embed code from other packages",
     thanks to Neil McGovern, Colin Watson, Bill Allombert, Steve Langasek,
     Kurt Roeckx, and others                                  (Closes: #392362).
+  * Bug fix: "Homepage field in debian/control undocumented", thanks to
+    Mario Iseli                                              (Closes: #452105).
   * Bug fix: "Examples of dpkg frontends should mention apt now", thanks
     to Josh Triplett                                         (Closes: #455602).
   * Bug fix: "Minor typos and wording suggestions", thanks to Michael

diff --git a/policy.sgml b/policy.sgml
index 9e2037aba21b3c84832825017a0d42bf46dbcea8..e8ea2e4af259b6c1839d8fcfb9315aae4816ba96 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -2210,6 +2210,7 @@ Package: libc6
            <item><qref id="f-Priority"><tt>Priority</tt></qref> (recommended)</item>
            <item><qref id="sourcebinarydeps"><tt>Build-Depends</tt> et al</qref></item>
            <item><qref id="f-Standards-Version"><tt>Standards-Version</tt></qref> (recommended)</item>
+           <item><qref id="f-Homepage"><tt>Homepage</tt></qref></item>
          </list>
        </p>
 
@@ -2224,6 +2225,7 @@ Package: libc6
            <item><qref id="f-Essential"><tt>Essential</tt></qref></item>
            <item><qref id="binarydeps"><tt>Depends</tt> et al</qref></item>
            <item><qref id="f-Description"><tt>Description</tt></qref> (mandatory)</item>
+           <item><qref id="f-Homepage"><tt>Homepage</tt></qref></item>
          </list>
        </p>
 
@@ -2280,6 +2282,7 @@ Package: libc6
            <item><qref id="f-Installed-Size"><tt>Installed-Size</tt></qref></item>
            <item><qref id="f-Maintainer"><tt>Maintainer</tt></qref> (mandatory)</item>
            <item><qref id="f-Description"><tt>Description</tt></qref> (mandatory)</item>
+           <item><qref id="f-Homepage"><tt>Homepage</tt></qref></item>
          </list>
        </p>
       </sect>
@@ -2304,6 +2307,7 @@ Package: libc6
           <item><qref id="sourcebinarydeps"><tt>Build-Depends</tt> et al</qref></item>
          <item><qref id="f-Standards-Version"><tt>Standards-Version</tt></qref> (recommended)</item>
          <item><qref id="f-Files"><tt>Files</tt></qref> (mandatory)</item>
+         <item><qref id="f-Homepage"><tt>Homepage</tt></qref></item>
        </list>
        </p>
 
@@ -3148,6 +3152,19 @@ Package: libc6
          </p>
        </sect1>
 
+       <sect1 id="f-Homepage">
+         <heading><tt>Homepage</tt></heading>
+
+         <p>
+           The URL of the web site for this package, preferably (when
+           applicable) the site from which the original source can be
+           obtained and any additional upstream documentation or
+           information may be found.  The content of this field is a
+           simple URL without any surrounding characters such as
+           <tt>&lt;&gt;</tt>.
+         </p>
+       </sect1>
+
       </sect>
 
       <sect>

diff --git a/upgrading-checklist.html b/upgrading-checklist.html
index 3105c5d6efd8c3d83bea19f0337ce415de96a7d5..a6d6742d66797c002f8d374a6cda9ff386a90067 100644 (file)
--- a/upgrading-checklist.html
+++ b/upgrading-checklist.html
@@ -58,6 +58,7 @@ picking your way through this list.
        packages unless the included package is explicitly intended to be
        used that way.                                            [4.13]
      * The Uploaders field in debian/control may be wrapped.     [5.6.3]
+     * New Homepage field for upstream web sites.                [5.6.23]
      * The Breaks field declares that this package breaks another and
        prevents installation of the breaking package unless the package
        named in Breaks is deconfigured first.  This field should not be