| Subject: | Various modules' POD lack a description |
| Date: | Thu, 6 Dec 2007 06:55:45 -0300 |
| To: | bug-Font-TTF [...] rt.cpan.org, "Martin Hosken" <martin_hosken [...] sil.org> |
| From: | "Martín Ferrari" <martin.ferrari [...] gmail.com> |
Hi,
when sanity-checking the files generated by Font-TTF, I've got many
complaints because the man pages generated lack the description used
to build the apropos database. Debian automated testing tool reports
this:
Tag: manpage-has-bad-whatis-entry
Type: warning
Info: Each manual page should start with a `NAME' section, which lists the
name and a brief description of the page seperated by '\-'. These sections
are parsed by `mandb' and stored in a database for the use of `apropos' and
`whatis', so they must be in a certain format. This manual page apparently
uses the wrong format and cannot be parsed by `mandb'.
.
For information on how `NAME' sections should be written see lexgrog(1).
See also groff_man(7) and groff_mdoc(7) for general information on writing
manual pages.
I'm attaching a patch with dummy descriptions, because I don't know
what those modules do. It would very nice if you could add those
missing descriptions.
--
Martín Ferrari
Message body not shown because it is not plain text.