X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=perl-policy.sgml;h=1d26df7c40ab75eaa6cb2a1cf4e768c116aa7d0f;hb=907905af29883401668ca56652c6b9e0a75f75fe;hp=8edf3d7e5bdb7ffbc5dd4b0272d9ce268f383c66;hpb=a3a649ad7268e5709cb3a84cd37c7adeba71cf35;p=debian%2Fdebian-policy.git

diff --git a/perl-policy.sgml b/perl-policy.sgml
index 8edf3d7..1d26df7 100644
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -6,11 +6,13 @@
       <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>
+      <author>
+	<name>The Debian Policy mailing list</name>
+	<email>debian-policy@lists.debian.org</email>
       </author>
       <version>version 1.20</version>
 
@@ -38,21 +40,33 @@
 	</p>
 	<p>
 	  A copy of the GNU General Public License is available as
-	  <tt>/usr/share/common-licences/GPL</tt> in the Debian GNU/Linux
+	  <tt>/usr/share/common-licenses/GPL</tt> in the Debian GNU/Linux
 	  distribution or on the World Wide Web at 
 	  <url id="http://www.gnu.org/copyleft/gpl.html"
 	  name="The GNU Public Licence">.
 	</p>
 	<p>
 	  You can also obtain it by writing to the
-	  Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-	  Boston, MA 02111-1307, USA.
+	  Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+	  Boston, MA 02110-1301, USA. 
 	</p>
       </copyright>
     </titlepag>
 
     <toc detail="sect">
 
+    <chapt>
+      <heading>About this document</heading>
+      <p>
+	This document is distributed as the <tt>perl-policy</tt> files
+	in the Debian package
+        <package><url name="debian-policy" id="http://packages.debian.org/debian-policy"></package>.
+	It is also available from the Debian web mirrors at
+	<tt><url name="/doc/packaging-manuals/perl-policy/"
+		id="http://www.debian.org/doc/packaging-manuals/perl-policy/"></tt>.
+      </p>
+    </chapt>
+
     <chapt id="perl">
       <heading>Perl Packaging</heading>
       <sect id="versions">
@@ -299,12 +313,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>
-	</p>
-	<p>
-	  A <tt>Build-Depends</tt> on <tt>perl (>= 5.6.0-16)</tt> is
-	  required.
+$(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>
       </sect>
 
@@ -325,13 +338,6 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
 	    the minimum required version, or more simply the current
 	    version.
 	  </p>
-	  <p>
-	    In the absence of an explicit requirement,
-	    architecture-independent modules must depend on a minimum
-	    <package>perl</package> or <package>perl-base</package>
-	    version of <tt>5.6.0-16</tt> due to the changes in
-	    <tt>@INC</tt> introduced by that version.
-	  </p>
 	</sect1>
 
 	<sect1 id="binary_modules">
@@ -353,15 +359,22 @@ $(MAKE) install PREFIX=$(CURDIR)/debian/tmp/usr
 	    Rather than hard-coding the dependencies into the control
 	    file, using a substitution such as <tt>${perl:Depends}</tt>
 	    is suggested.  This allows the dependencies to be determined
-	    as build time and written to the <file>substvars</file> file
-	    in the form <tt>perl:Depends=<var>deps</var></tt>.
+	    at build time and written to the <file>substvars</file> file
+	    in the form
+	    <tt>perl:Depends=<var>deps</var></tt>.<footnote>
+	      <p>Please note that dependencies caused by versioned
+	      uses and on separately packaged modules are not included
+	      in this variable and must be explicitly included.</p>
+	    </footnote>
 	  </p>
 	  <p>
-	    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>.
+	    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>
@@ -395,7 +408,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>
@@ -464,3 +477,6 @@ perl -MExtUtils::Embed -e ldopts
     </appendix>
   </book>
 </debiandoc>
+<!-- Local variables: -->
+<!-- indent-tabs-mode: t -->
+<!-- End: -->