Bug#495713: lintian: false positive for incorrect pic macro usage in manual pages
On Tue, Aug 19, 2008 at 02:52:02PM -0700, Russ Allbery wrote:
> Roger Leigh <rleigh@debian.org> writes:
>
> > If a man page contains
> >
> > '\" p
> >
> > on the first line, it tells man that it needs preprocessing with pic(1).
> > pic(1) requires the use of .PS and .PE (PIC start and PIC end) macros,
> > between which the pic drawing is specified.
> >
> > wanna-build.1 (wanna-build, source sbuild) is flagged by lintian:
> >
> > % lintian -i sbuild_0.57.4-1_i386.changes
> > W: wanna-build: manpage-has-errors-from-man usr/share/man/man1/wanna-build.1.gz 55: warning: `PS' not defined
> >
> > However, man(1) when invoked by a user does not issue any warnings,
> > because the manual page is correct.
> >
> > Please could you teach lintian to allow .PS/.PE macros if pic is
> > enabled. The same also applies to tbl (.TS etc.), eqn and other
> > packages also supported by man. If man is being invoked to do the
> > check, perhaps some option is missing?
>
> Lintian indeed doesn't know anything about *roff syntax and just runs man
> --warnings. If you run man --warnings -l <path> >/dev/null on the file,
> do you get the same error message?
Yes:
<standard input>:55: warning: `PS' not defined
<standard input>:83: warning: `PE' not defined
<standard input>:119: warning: `.changes' not defined
It works fine for a tbl-using manual page, so perhaps it is a man-db
bug for pic. I'm afraid I don't know enough about the man internals to
verify this, but it would probably be most appropriate to reassign to man-db.
Thanks,
Roger
--
.''`. Roger Leigh
: :' : Debian GNU/Linux http://people.debian.org/~rleigh/
`. `' Printing on GNU/Linux? http://gutenprint.sourceforge.net/
`- GPG Public Key: 0x25BFB848 Please GPG sign your mail.
Reply to: