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

[Russ Allbery]

Mario Iseli <[EMAIL PROTECTED]> 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 ([EMAIL PROTECTED])               <http://www.eyrie.org/~eagle/>



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]