Re: whatis information in manpages

Hi Peter,

Thanks very much for this.  I have uploaded v 2.03 to sourceforge & CPAN,
which contains this patch (or something very, very, close to it).  Thank you.
It also contains XS code to set the subname that it creates, to make profiling
& debugging possible.  I'm quite excited by that!

Cheers,
Mx.

On Tue, Sep 28, 2004 at 08:26:16PM +0200, Peter Palfrader wrote:
> [please CC me on replies, I'm not subscribed]
> 
> Hi,
> 
> during packaging the new 2.02 version of Class::Methodmaker for Debian,
> one of our checking tools said:
> 
> W: libclass-methodmaker-perl: manpage-has-bad-whatis-entry 
> usr/share/man/man3/Class::MethodMaker::hash.3pm.gz
> N:
> N:   Each manual page should start with a `NAME' section, which lists the
> N:   name and a brief description of the page seperated by '\-'. These
> N:   sections are parsed by `mandb' and stored in a database for the use of
> N:   `apropos' and `whatis', so they must be in a certain format. This
> N:   manual page apparently uses the wrong format and cannot be parsed by
> N:   `mandb'.
> N:   
> N:   For information on how `NAME' sections should be written see
> N:   lexgrog(1). See also groff_man(7) and groff_mdoc(7) for general
> N:   information on writing manual pages.
> N:
> W: libclass-methodmaker-perl: manpage-has-bad-whatis-entry 
> usr/share/man/man3/Class::MethodMaker::array.3pm.gz
> W: libclass-methodmaker-perl: manpage-has-bad-whatis-entry 
> usr/share/man/man3/Class::MethodMaker::scalar.3pm.gz
> 
> 
> This is one possible fix for the issue:


-------------------------------------------------------
This SF.net email is sponsored by: IT Product Guide on ITManagersJournal
Use IT products in your business? Tell us what you think of them. Give us
Your Opinions, Get Free ThinkGeek Gift Certificates! Click to find out more
http://productguide.itmanagersjournal.com/guidepromo.tmpl