Bug#483834: debian-policy: contradiction how to name man pages in perl-policy

[Ansgar Burchardt <ansgar@2008.43-1.org>]

Package: debian-policy
Version: 3.7.3.0
Severity: normal

Hi,

there is a contradiction how to name man pages for perl modules.
Section 4.1 states

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

while section 2.4 states

    Manual pages distributed with Perl packages must be installed into
    the standard directories: 
    Programs
        Manual pages for programs and scripts are installed into
        /usr/share/man/man1 with the extension .1. 
    Modules
	Manual pages for modules are installed into /usr/share/man/man3
	with the extension .3perl.

A quick survey for the packages installed on my system shows that .3pm
and .1 seem to be more popular:

    *.3perl       -  495
    *.3pm         - 1697
    *.1p          -   33
    perl programs -  270

Regards,
Ansgar