From: Russ Allbery <rra@debian.org>
Date: Wed, 5 Mar 2008 03:14:52 +0000 (+0000)
Subject: Add Homepage control field
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=772725c1152b8f6681cf9bf0173375b814eb177f;p=debian%2Fdebian-policy.git

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 0728ea9..de0ca1d 100644
--- 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 9e2037a..e8ea2e4 100644
--- 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 3105c5d..a6d6742 100644
--- 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