On Tue, Aug 19, 2008 at 6:26 PM, Galen Charlton <galen.charlton@liblime.com> wrote:
Another problem of the current code is that all manpages generated from koha perl modules are invalid. They are missing the required head lines. I put in http://www-id.imag.fr/~danjean/lintian.txt the warnings of the lintian tool (automatic debian tool to check package quality). Do you think it is better to fix these doc (ie adding the few lines in each file) or to remove this doc from the Debian package ? I think that fixing is better, but it cannot be done automatically: a 'brief description' is needed so it must be filled by people knowing the modules.
Fixing the POD is better.
I agree. I've opened up bug 2538 for this work <http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2538>. extra points for anyone who can write a test case that looks for files missing =NAME tags. -Andy