Synchronized with patch 194 from Manojs tree

[debian/debian-policy.git] / perl-policy.sgml

diff --git a/perl-policy.sgml b/perl-policy.sgml
index 94ba0c25dbbb875580ecf484b61303ff46916843..f4e55c25f043a2d58ca3851e22150c04f3569a47 100644 (file)
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -6,13 +6,15 @@
       <title>Debian Perl Policy</title>
       <author>
        <name>Rapha&euml;l Hertzog</name>
-       <email>hertzog@debian.org</email>
       </author>
       <author>
        <name>Brendan O'Dea</name>
-       <email>bod@debian.org</email>
       </author>
-      <version>version 1.19</version>
+      <author>
+       <name>The Debian Policy mailing list</name>
+       <email>debian-policy@lists.debian.org</email>
+      </author>
+      <version>version 1.20</version>
 
       <abstract>
        This document describes the packaging of Perl within the Debian
@@ -299,8 +301,11 @@ $(MAKE) OPTIMIZE="-O2 -g -Wall"
          </example>
          and this one to install the results into the temporary tree:
          <example>
-$(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
-         </example>
+$(MAKE) install PREFIX=$(CURDIR)/debian/&lt;tmp&gt;/usr
+         </example><footnote>
+           <p>Replace &lt;tmp&gt; with the appropriate directory
+           (nominally just tmp)</p>
+         </footnote>
        </p>
        <p>
          A <tt>Build-Depends</tt> on <tt>perl (>= 5.6.0-16)</tt> is
@@ -342,7 +347,8 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
            a minimum version of the <package>perl</package> package
            used to build the module, and must additionally depend on
            the expansion of
-           <package>perlapi-$Config{version}</package>.
+           <package>perlapi-$Config{version}</package> using
+           the <tt>Config</tt> module.
          </p>
        </sect1>
 
@@ -356,10 +362,13 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
            in the form <tt>perl:Depends=<var>deps</var></tt>.
          </p>
          <p>
-           Packages built with <prgn>debhelper</prgn> may use <manref
-           name="dh_perl" section=1> to generate this substitution
-           automatically.  Additionally requires a
-           <tt>Build-Depends</tt> on <tt>debhelper (>= 3.0.18)</tt>.
+           Packages built with <prgn>debhelper</prgn> may use
+
+           <manref name="dh_perl" section="1"> to generate this
+           substitution automatically.  This additionally requires a
+           versioned <tt>Build-Depends</tt> (or
+           <tt>Build-Depends-Indep</tt>) on <tt>debhelper (>=
+           3.0.18)</tt>.
          </p>
        </sect1>
       </sect>
@@ -393,7 +402,7 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
        </p>
        <p>
          As with modules, packages using <prgn>debhelper</prgn> may use
-         <manref name="dh_perl" section=1> to automatically generate
+         <manref name="dh_perl" section="1"> to automatically generate
          dependences (see <ref id="dh_perl">).
        </p>
       </sect>