From: Russ Allbery <rra@debian.org>
Date: Sat, 24 Dec 2011 19:03:49 +0000 (-0800)
Subject: Clarify the Perl policy documentation rules
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=f6938d47f9250f672586191cc00988e9e61cea06;hp=cbbacc3e326902ebe89005e528191681f0003409;p=debian%2Fdebian-policy.git

Clarify the Perl policy documentation rules

The first section about documentation and manual page extensions
only applies to packages generated from the perl source package.
Make that explicit and add a reference to the section discussing
module packages.
---

diff --git a/perl-policy.sgml b/perl-policy.sgml
index 70c5bfc..626c514 100644
--- a/perl-policy.sgml
+++ b/perl-policy.sgml
@@ -197,8 +197,8 @@
 	  package.
 	</p>
 	<p>
-	  Manual pages distributed with Perl packages must be installed
-	  into the standard directories:
+	  Manual pages distributed with packages built from the perl
+	  source package must be installed into the standard directories:
 	  <taglist>
 	    <tag>Programs</tag>
 	    <item>
@@ -217,6 +217,8 @@
 	      </p>
 	    </item>
 	  </taglist>
+	  The extensions used for manual pages distributed with module
+	  packages are different.  See <ref id="vendor_dirs">.
 	</p>
       </sect>
     </chapt>