Bug 10984 - perldoc is unable to find builtin functions
Summary: perldoc is unable to find builtin functions
Status: RESOLVED INVALID
Alias: None
Product: Mageia
Classification: Unclassified
Component: RPM Packages (show other bugs)
Version: 3
Hardware: i586 Linux
Priority: Normal normal
Target Milestone: ---
Assignee: Jerome Quelin
QA Contact:
URL:
Whiteboard:
Keywords: Triaged
Depends on:
Blocks:
 
Reported: 2013-08-12 12:05 CEST by Frédéric "LpSolit" Buclin
Modified: 2014-02-24 09:10 CET (History)
1 user (show)

See Also:
Source RPM: perl
CVE:
Status comment:


Attachments

Description Frédéric "LpSolit" Buclin 2013-08-12 12:05:14 CEST
This was working fine in Mageia 1 and 2; this is now broken in Mageia 3:

First of all, perl-Pod-Perldoc-3.170.0-3.mga3 contains /bin/perldoc-3.17 instead of /bin/perldoc as it did in Mageia 1 and 2. I don't see the point to append -3.17 to the name. This is confusing and is not what we expect.

Then, it's unable to find builtin functions:

perldoc-3.17 -f grep
No documentation found for "perlfunc".
No documentation found for "perlop".

This is a regression.
Manuel Hiebel 2013-08-12 19:32:08 CEST

Keywords: (none) => Triaged
Assignee: bugsquad => jquelin

Comment 1 Jerome Quelin 2014-02-24 09:10:08 CET
Sorry for the time needed to answer (real life kicked in quite hard).

Regarding the fact that perldoc has its version appended: this is because perldoc is shipped both by rpm perl-doc and rpm perl-Pod-Perldoc. Indeed, the package is dual-lived upstream (both in perl tarball and on cpan), and therefore the script perldoc is provided by both rpms.

Note that it's the same for quite a lot of dual-lived scripts: cpan, cpan2dist, cpanp, corelist, pod2*, prove, ptar, etc.

We chose to have this scheme (appending -version to rpms shipping dual-lived scripts) instead of providing alternatives because alternatives are complicated to set up, and not really satisfying to use.

To have the regular perldoc command, you just need to install perl-doc.

$ urpmf /usr/bin/perldoc
perl-Perl6-Perldoc:/usr/bin/perldoc2text
perl-Perl6-Perldoc:/usr/bin/perldoc2xhtml
perl-doc:/usr/bin/perldoc
perl-Pod-Perldoc:/usr/bin/perldoc-3.21
[...]

Note also that installing perl-doc will provide you with the pod containing the documentation shipped by regular perl. And once installed, even perldoc-3.xx will work:

$ perldoc-3.21 -f grep
    grep BLOCK LIST
    grep EXPR,LIST
[...]

And to prevent your question: we split the documentation in its own package to make sure the installer doesn't get bloated, with a really minimal perl installed.

Marking thus the bug as invalid - once again, sorry for the delay to answer.

Status: NEW => RESOLVED
CC: (none) => jquelin
Resolution: (none) => INVALID


Note You need to log in before you can comment on or make changes to this bug.