Description of problem: mandb --test gives the following error, among others: mandb: warning: /usr/share/man/man3/CPAN::Debug.3pm.gz: whatis parse for CPAN::Debug(3pm) failed Version-Release number of selected component (if applicable): Name : perl-CPAN Epoch : 0 Version : 1.9800 Release : 237.fc18 How reproducible: Steps to Reproduce: 1. mandb --test 2. 3. Actual results: mandb: warning: /usr/share/man/man3/CPAN::Debug.3pm.gz: whatis parse for CPAN::Debug(3pm) failed Expected results: No errors. Additional info:
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.