Bug#483834: debian-policy: contradiction how to name man pages in perl-policy
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:
Manual pages for programs and scripts are installed into
/usr/share/man/man1 with the extension .1.
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