| Subject: | Log::Any::Adapter::Base's POD generates incomplete man pages |
| Date: | Wed, 04 Aug 2010 16:39:29 -0430 |
| To: | bug-Log-Any-Adapter [...] rt.cpan.org |
| From: | Ernesto Hernández-Novich <emhnemhn [...] gmail.com> |
The NAME section included in Log::Any::Adapter::Base's POD is missing a
short description. It has
=head1 NAME
Log::Any::Adapter::Base
Thus, using pod2man to create man pages suitable for a Linux
distribution package (Debian, in my case) will result in a man page that
has an improper NAME section, breaking up whatis databases.
The simple fixed is to add a description after the name of the class.
Since I'm building a Debian package, I added
Log::Any::Adapter::Base - Base class for Log::Any adapters.
but anything along the same lines would be fine.
Thanks!
--
Ernesto Hernández-Novich - @iamemhn - Unix: Live free or die!
Geek by nature, Linux by choice, Debian of course.
If you can't aptitude it, it isn't useful or doesn't exist.
GPG Key Fingerprint = 438C 49A2 A8C7 E7D7 1500 C507 96D6 A3D6 2F4C 85E3