Bug 908113
Summary: | CPAN::Debug(3pm) is missing NAME section | ||||||
---|---|---|---|---|---|---|---|
Product: | [Fedora] Fedora | Reporter: | Paul DeStefano <prd-fedora> | ||||
Component: | perl | Assignee: | Petr Pisar <ppisar> | ||||
Status: | CLOSED ERRATA | QA Contact: | Fedora Extras Quality Assurance <extras-qa> | ||||
Severity: | unspecified | Docs Contact: | |||||
Priority: | unspecified | ||||||
Version: | 18 | CC: | cjwatson, cweyl, iarnell, jplesnik, kasal, keramidasceid, lkundrak, mmaslano, perl-devel, ppisar, psabata, pschiffe, rc040203, tcallawa | ||||
Target Milestone: | --- | ||||||
Target Release: | --- | ||||||
Hardware: | Unspecified | ||||||
OS: | Unspecified | ||||||
Whiteboard: | |||||||
Fixed In Version: | perl-5.16.2-259.fc19 | Doc Type: | Bug Fix | ||||
Doc Text: | Story Points: | --- | |||||
Clone Of: | Environment: | ||||||
Last Closed: | 2013-04-03 04:55:25 UTC | Type: | Bug | ||||
Regression: | --- | Mount Type: | --- | ||||
Documentation: | --- | CRM: | |||||
Verified Versions: | Category: | --- | |||||
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
Cloudforms Team: | --- | Target Upstream Version: | |||||
Embargoed: | |||||||
Attachments: |
|
Description
Paul DeStefano
2013-02-05 22:18:03 UTC
Filed against wrong component - should be perl. Cannot reproduce with man-db-2.6.3-2.fc18.x86_64. "whatis -w '*' >/dev/null" does not complain. Moreover I don't understand what's wrong on CPAN::Debug(3pm). It just does not contain NAME heading, which is maybe unfortunate, but I can do anything with it. You can try to make man-db more robust. I don't see why whatis should complain. It only looks at what's in the database, and since this parse failed it won't be in the database. Thus, not a valid test. lexgrog is the proper tool to use to test this. Please attach /usr/share/man/man3/CPAN::Debug.3pm.gz to this bug. If it doesn't contain a NAME section as Petr says, though, then this is *not* a man-db bug - the manual page must be fixed instead to be in the proper form. The requirements are not particularly onerous. (In reply to comment #2) > Cannot reproduce with man-db-2.6.3-2.fc18.x86_64. I can. # mandb --test ... mandb: warning: /usr/share/man/man3/CPAN::Debug.3pm.gz: whatis parse for CPAN::Debug(3pm) failed ... > Moreover I don't understand what's wrong on CPAN::Debug(3pm). It just does > not contain NAME heading, which is maybe unfortunate, but I can do anything > with it. Here, "man CPAN::Debug" only displays a LICENSE. I am having doubts this is the "intended behavior" <snip> CPAN::Debug(3pm) Perl Programmers Reference Guide CPAN::Debug(3pm) LICENSE This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.16.2 2012-10-26 CPAN::Debug(3pm) </snip> (In reply to comment #3) > Please attach /usr/share/man/man3/CPAN::Debug.3pm.gz to this bug. You can extract it from Fedora's perl-CPAN-1.9800-238.fc18.noarch rpm. I asked for an attachment since I don't use Fedora (I'm an upstream author helping out here) and it's a pain to dig out Fedora packages and extract things from them. But anyway, now that I've done that, this is clearly a bug in the perl-CPAN package; mandb is entirely justified in issuing a warning about this broken page. Somebody with appropriate privileges please reassign. Created attachment 698907 [details]
Fedora 18's CPAN::Debug.3pm.gz
(In reply to comment #5) > I asked for an attachment since I don't use Fedora I didn't know - Sorry. > But anyway, now that I've done that, this is clearly a bug in the perl-CPAN > package; Are you sure? CPAN::Debug.3pm is pod2man generated, so at least I would not want to exclude it's a more general bug in pod2man rsp. its infrastructure. pod2man just converts POD to ROFF. There is no NAME heading in the POD, thus no NAME in ROFF, thus no text for man-db. I don't think there is a Manual Page Specification which demands specific headings. I'll ask perl-CPAN upstream to add enhance the POD. This issue has been already reported to upstream <https://rt.cpan.org/Public/Bug/Display.html?id=73396> and fix is upstream VCS. lexgrog(1) documents the requirements, which AFAIK are generally applicable across man implementations. perl-5.16.2-239.fc18 has been submitted as an update for Fedora 18. https://admin.fedoraproject.org/updates/perl-5.16.2-239.fc18 perl-5.14.3-222.fc17 has been submitted as an update for Fedora 17. https://admin.fedoraproject.org/updates/perl-5.14.3-222.fc17 perl-5.16.2-239.fc18 fixes this bug I left positive feedback at https://admin.fedoraproject.org/updates/F18/FEDORA-2013-2685 perl-5.16.2-239.fc18 has been pushed to the Fedora 18 stable repository. If problems still persist, please make note of it in this bug report. perl-5.14.3-223.fc17 has been submitted as an update for Fedora 17. https://admin.fedoraproject.org/updates/perl-5.14.3-223.fc17 perl-5.14.4-224.fc17 has been submitted as an update for Fedora 17. https://admin.fedoraproject.org/updates/perl-5.14.4-224.fc17 Package perl-5.14.4-224.fc17: * should fix your issue, * was pushed to the Fedora 17 testing repository, * should be available at your local mirror within two days. Update it with: # su -c 'yum update --enablerepo=updates-testing perl-5.14.4-224.fc17' as soon as you are able to. Please go to the following url: https://admin.fedoraproject.org/updates/FEDORA-2013-3673/perl-5.14.4-224.fc17 then log in and leave karma (feedback). perl-5.14.4-224.fc17 has been pushed to the Fedora 17 stable repository. If problems still persist, please make note of it in this bug report. |