Re: manpage format fixes

Hi,

> > the debian package checker lintian complained about some manpage format
> > problems in the clearsilver package.
> > 
> > Attached you find a patch that fixes these issues.
> 
> So, the manpages are actually generated from the header comments using
> the python script at scripts/document.py

oh - good to know ...


> I think most of these are just a matter of adding a concise description
> to the "function name" portion, which I've added to the header files.

yes - lintian reported these errors as "manpage-has-bad-whatis-entry".
They seem to hinder mandb to create the keyword based index for these manpages.
Thus the "apropos" (same as "man -k") and "whatis" features would not work for
these packages.


> Is there a name for the lint checker, is it something I can run myself
> without creating a debian package?  I have an ubuntu box which should
> have it available.

yes, it should be available in ubunty as "lintian".
Just run "lintian ???.deb" to get the warning messages for a binary package.
It does not work for a source tree.
The mentioned warning messages occurred in the clearsilver-dev package 0.10.4-1.

Lars