From 8c478a3d848f31e0f6dab406c8eff70c8cf3837f Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@debian.org>
Date: Mon, 28 Jun 2010 10:56:19 -0700
Subject: [PATCH] Better explanation of the Perl module naming policy
* Explain the Perl module package naming policy more explicitly and
provide some examples. (Closes: #175202)
---
debian/changelog | 2 ++
perl-policy.sgml | 15 +++++++++++----
2 files changed, 13 insertions(+), 4 deletions(-)
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>
--
2.39.5