Bug#492930: lintian: quote command to reproduce man page format errors

["Adam D. Barratt" <adam@adam-barratt.org.uk>]

On Tue, 2008-07-29 at 19:55 -0400, James R. Van Zandt wrote:
> Lintian gave me this warning:
>   
>   W: emacspeak: manpage-has-errors-from-man usr/share/man/man1/emacspeak.1.gz 1: warning: `.' not defined
[...]
>   N:   This man page provokes warnings or errors from man.
>   N:   This test uses man's --warnings option to enable groff warnings that
[...]
> I couldn't reproduce the warning with man, making it difficult to fix
> the bug.  Eventually I resorted to scanning a 6MB strace log of the
> lintian run, and found an nroff command that would reproduce the
> error.  That nroff command should appear in the lintian extended help
> for this error:
> 
>        nroff -mandoc -wmac -Tascii foo.1.gz

That command shouldn't be included in the tag information, as it's not
what lintian is running. As the current text indicates, lintian is using
"man --warnings"; more specifically, having cleansed the environment,
it's running:

	LANG=C man --warnings -l foo.1.gz > /dev/null

(see /usr/share/lintian/checks/manpages; much easier than a 6MB
strace :-)

Adam