From: Russ Allbery <rra@debian.org>
Date: Mon, 28 Jun 2010 17:56:19 +0000 (-0700)
Subject: Better explanation of the Perl module naming policy
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=8c478a3d848f31e0f6dab406c8eff70c8cf3837f;p=debian%2Fdebian-policy.git

Better explanation of the Perl module naming policy

* Explain the Perl module package naming policy more explicitly and
  provide some examples.  (Closes: #175202)
---

diff --git a/debian/changelog b/debian/changelog
index dfc4246..880a3c5 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,8 @@ debian-policy (3.9.0.1) UNRELEASED; urgency=low
 
   * Set the version of the Perl Policy to match the version of the Policy
     package.
+  * Explain the Perl module package naming policy more explicitly and
+    provide some examples.  (Closes: #175202)
 
  -- Russ Allbery <rra@debian.org>  Mon, 28 Jun 2010 09:34:54 -0700
 
diff --git a/perl-policy.sgml b/perl-policy.sgml
index 7c37446..3b76b94 100644
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -298,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>