Bug#452105: debian-policy: Homepage field in debian/control undocumented

[Russ Allbery <rra@debian.org>]

Mario Iseli <mario@debian.org> writes:

> Package: debian-policy
> Severity: normal
> Tags: patch
>
> I think the Homepage field for debian/control is now official - at least
> it isn't documented in the policy right now. So here - a little patch
> which would fix that.

Here is a somewhat revised patch that tries to be more specific about the
format and contents.  It also notes that this field is valid in binary
control files and source *.dsc files.

Comments?  Seconds?

--- orig/policy.sgml
+++ mod/policy.sgml
@@ -2182,6 +2182,7 @@
 	    <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>
 
@@ -2196,6 +2197,7 @@
 	    <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>
 
@@ -2252,6 +2254,7 @@
 	    <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>
@@ -2276,6 +2279,7 @@
           <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>
 
@@ -3125,6 +3129,19 @@
 	  </p>
 	</sect1>
 
+	<sect1 id="f-Homepage">
+	  <heading><tt>Homepage</tt></heading>
+
+	  <p>
+	    The URL of the web site for this package, preferrably (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>

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>