Subject: | manpage-has-bad-whatis-entry, no copyright and license info in POD |
Hi,
first off, the CPAN RT is the bug tracker explicitly referred to in the latest release of this module. The link to the "preferred bug tracker" at the top of the page where I'm typing this does not lead to a website that says "report a bug" or anything similar anywhere; hitting "contact us" on that page, I get links to Facebook, but no bug tracker. I don't really want to get involved with padre, but when I finally find the padre trac, I'm not allowed to post my bug there because I don't have an account. hmm...
--
While packaging version 0.19-1 of Parse-ErrorString-Perl for Debian, our QA tools called my attention to the fact that two included modules, ::ErrorItem and ::StackItem, do not include a NAME section in their POD from which pod2man can generate a whatis entry. It seems this was lost when the module was converted from dzil to M::I, along with all information on authors / copyright holders and licensing anywhere. Please consider putting that information back into the POD, or at least apply the following patch so that the resulting manpages can be properly indexed.
--- a/lib/Parse/ErrorString/Perl/ErrorItem.pm
+++ b/lib/Parse/ErrorString/Perl/ErrorItem.pm
@@ -36,6 +36,10 @@
__END__
+=head1 NAME
+
+Parse::ErrorString::Perl::ErrorItem - a Perl error item object
+
=head1 Parse::ErrorString::Perl::ErrorItem
Each object contains the following accessors (only C<message>, C<file>,
--- a/lib/Parse/ErrorString/Perl/StackItem.pm
+++ b/lib/Parse/ErrorString/Perl/StackItem.pm
@@ -25,6 +25,10 @@
__END__
+=head1 NAME
+
+Parse::ErrorString::Perl::StackItem - a Perl stack item object
+
=head1 Parse::ErrorString::Perl::StackItem
=over
Florian