Refer generically to Debian instead of the GNU/Linux instance

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

diff --git a/perl-policy.sgml b/perl-policy.sgml
index 58c33328fb8eec1aea378294862c3df1cc79cc5c..b9f327739b963ae949265ce871f13870ad033368 100644 (file)
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -1,4 +1,8 @@
-<!doctype debiandoc system>
+<!doctype debiandoc system [
+<!-- include version information so we don't have to hard code it
+     within the document -->
+<!entity % versiondata SYSTEM "version.ent"> %versiondata;
+]>
 
 <debiandoc>
   <book>
@@ -14,11 +18,11 @@
        <name>The Debian Policy mailing list</name>
        <email>debian-policy@lists.debian.org</email>
       </author>
-      <version>version 1.20</version>
+      <version>version &version;, &date;</version>
 
       <abstract>
        This document describes the packaging of Perl within the Debian
-       GNU/Linux distribution and the policy requirements for packaged
+       distribution and the policy requirements for packaged
        Perl programs and modules.
       </abstract>
 
@@ -40,7 +44,7 @@
        </p>
        <p>
          A copy of the GNU General Public License is available as
-         <tt>/usr/share/common-licenses/GPL</tt> in the Debian GNU/Linux
+         <tt>/usr/share/common-licenses/GPL</tt> in the Debian
          distribution or on the World Wide Web at 
          <url id="http://www.gnu.org/copyleft/gpl.html"
          name="The GNU Public Licence">.
@@ -294,10 +298,17 @@ make install
        <heading>Module Package Names</heading>
        <p>
          Perl module packages should be named for the primary module
-         provided.  The naming convention for module <tt>Foo::Bar</tt>
-         is <package>libfoo-bar-perl</package>.  Packages which include
-         multiple modules may additionally include provides for those
-         modules using the same convention.
+         provided.  The naming convention is to lowercase the Perl module
+         name, prepend, <tt>lib</tt>, change all occurrences
+         of <tt>::</tt> to <tt>-</tt>, and append <tt>-perl</tt>.  For
+         example:
+         <example>
+Foo::Bar        libfoo-bar-perl
+Foo::Bar::Baz   libfoo-bar-baz-perl
+Foo::BarBaz     libfoo-barbaz-perl
+         </example>
+         Packages which include multiple modules may additionally include
+         provides for the additional modules using the same convention.
        </p>
       </sect>
 
@@ -316,7 +327,7 @@ $(MAKE) OPTIMIZE="-O2 -g -Wall"
          </example>
          and this one to install the results into the temporary tree:
          <example>
-$(MAKE) install PREFIX=$(CURDIR)/debian/&lt;tmp&gt;/usr
+$(MAKE) install DESTDIR=$(CURDIR)/debian/&lt;tmp&gt;
          </example><footnote>
            <p>Replace &lt;tmp&gt; with the appropriate directory
            (nominally just tmp)</p>