Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 184358 - perl should install manpages to man3pm
Summary: perl should install manpages to man3pm
Status: RESOLVED LATER
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: x86 Linux
: Lowest enhancement (vote)
Assignee: Gentoo Perl team
URL:
Whiteboard:
Keywords:
: 199997 (view as bug list)
Depends on:
Blocks:
 
Reported: 2007-07-05 22:15 UTC by l.mai
Modified: 2008-02-27 18:38 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description l.mai 2007-07-05 22:15:57 UTC
$ man -S3:2 open
gives me
open(3pm)                Perl Programmers Reference Guide               open(3pm)

I.e. instead of open(2) I get open(3pm) even though I didn't request pages from section 3pm. This happens because the perl manpages are actually put in section 3, not 3pm:

$ man -w 3 open
/usr/share/man/man3/open.3pm.bz2
$ man -w 3pm open
No entry for open in section 3pm of the manual

This is very annoying because it breaks my C function manpage getter script; because open.3pm is in section 3, it is found before open(2). Proposed fix: install the perl manual pages into section 3pm.

Additional feature request: Add a USE flag that doesn't install man pages for perl modules. If I really want those docs, I use perldoc anyway (not man).

Reproducible: Always

Steps to Reproduce:
1. emerge perl
2. man -S3:2 open

Actual Results:  
open(3pm)              Perl Programmers Reference Guide              open(3pm)

Expected Results:  
OPEN(2)                    Linux Programmer's Manual                   OPEN(2)
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2007-07-05 22:37:45 UTC
(In reply to comment #0)
> install the perl manual pages into section 3pm.

Err, that's not a valid MANSECT ATM; see /etc/man.conf.

> Additional feature request: Add a USE flag that doesn't install man pages for
> perl modules. If I really want those docs, I use perldoc anyway (not man).

There's no use flag for manpages and there won't be any, that's what FEATURES=noman is for (or use INSTALL_MASK). Plus most perl modules install any manpages at all because of collisions.
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2007-11-22 17:24:42 UTC
*** Bug 199997 has been marked as a duplicate of this bug. ***