[Pkg-sql-ledger-discussion] r388 - debian/ledgersmb.lintian-overrides

[Raphael Hertzog]

On Sun, 08 Jan 2012, Robert James Clay wrote:
> 
> On Sun, 2012-01-08 at 20:40 -0500, pkg-sql-ledger-commit-owner wrote:
> > Log:
> > Override manpage-has-bad-whatis-entry Lintian Warnings.
> > 
> > Modified: ledger-smb/trunk/debian/ledgersmb.lintian-overrides
> > ===================================================================
> > ....
> > +# Override instances of the manpage-has-bad-whatis-entry Lintian warning,
> > +# which results from issues with the pod NAME entries in the cooresponding
> > +# Perl source files.
> > +ledgersmb: manpage-has-bad-whatis-entry
> 
>    The reason I'm putting that in is that I've found some 50 Perl source
> files that have various types of issues with the pod NAME entries in the
> files, which end up causing the above Lintian warnings after the man
> pages are created from them.  For instance: some don't have the short
> description, and some don't have the dash ("-") or have a comma or colon
> instead.  
> 
>    There are at least a couple of files that also have spelling errors
> and I'll likely address those first.  (Patch plus upstream bug.)

I don't think this justifies an override. Those are issues that should
be fixed and not hidden.

It's not a big deal if they are not fixed immediately and if they keep
showing up for some time. OTOH, they are all really easy to fix by
enhancing the POD in the corresponding source files.

Cheers,
-- 
Raphaël Hertzog ◈ Debian Developer

Pre-order a copy of the Debian Administrator's Handbook and help
liberate it: http://debian-handbook.info/liberation/