Bug#643690: perl policy unclear about the section for manpages

[Steve Langasek <vorlon@debian.org>]

Package: debian-policy
Version: 3.9.2.0

The perl policy makes confusing statements about the section that manpages
should be installed in:

2.4. Documentation
------------------

     Manual pages distributed with Perl packages must be installed into the
     standard directories:

     [...]

     Modules
          Manual pages for modules are installed into `/usr/share/man/man3'
          with the extension `.3perl'.


4.1. Vendor Directories
-----------------------

     The installation directory for Debian modules must be different from
     that for <core> and <site> modules.

     [...]

     Module packages must install manual pages into the standard
     directories (see Section 2.4, `Documentation') using the extensions
     `.1p' and `.3pm' to ensure that no conflict arises where a packaged
     module duplicates a <core> module.


I apparently misread this long ago and assumed that "manual pages for
modules" was talking about all modules rather than just those from the perl
source package.  Only a recent lintian warning, showing me that MakeMaker
has output the manpage with a .TH that doesn't match the filename, clued me
in.

I think the language in 2.4 should be clarified to explicitly state this
only applies to modules from the perl source package.

-- 
Steve Langasek                   Give me a lever long enough and a Free OS
Debian Developer                   to set it on, and I can move the world.
Ubuntu Developer                                    http://www.debian.org/
slangasek@ubuntu.com                                     vorlon@debian.org