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

["James R. Van Zandt" <jrv@debian.org>]

Package: lintian
Version: 1.24.2
Severity: normal

Lintian gave me this warning:
  
  W: emacspeak: manpage-has-errors-from-man usr/share/man/man1/emacspeak.1.gz 1: warning: `.' not defined
  N:
  N:   This man page provokes warnings or errors from man.
  N:   
  N:   "cannot adjust" or "can't break" are trouble with paragraph filling,
  N:   usually related to long lines. Adjustment can be helped by left
  N:   justifying, breaks can be helped with hyphenation, see "Manipulating
  N:   Filling and Adjusting" and "Manipulating Hyphenation" in the manual.
  N:   
  N:   "can't find numbered character" usually means latin1 etc in the input,
  N:   and this warning indicates characters will be missing from the output.
  N:   You can change to escapes like \[:a] described on the groff_char man
  N:   page.
  N:   
  N:   Other warnings are often formatting typos, like missing quotes around
  N:   a string argument to .IP. These are likely to result in lost or
  N:   malformed output. See the groff_man (or groff_mdoc if using mdoc) man
  N:   page for information on macros.
  N:   
  N:   This test uses man's --warnings option to enable groff warnings that
  N:   catch common mistakes, such as putting . or ' characters at the start
  N:   of a line when they are intended as literal text rather than groff
  N:   commands. This can be fixed either by reformatting the paragraph so
  N:   that these characters are not at the start of a line, or by adding a
  N:   zero-width space (\&) immediately before them.
  N:   
  N:   At worst, warning messages can be disabled with the .warn directive,
  N:   see "Debugging" in the groff manual.
  N:

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

                  - Jim Van Zandt


-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (990, 'unstable'), (500, 'oldstable'), (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.25 (SMP w/4 CPU cores; PREEMPT)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/bash

Versions of packages lintian depends on:
ii  binutils            2.18.1~cvs20080103-7 The GNU assembler, linker and bina
ii  diffstat            1.45-2               produces graph of changes introduc
ii  dpkg-dev            1.14.20              Debian package development tools
ii  file                4.24-4               Determines file type using "magic"
ii  gettext             0.17-3               GNU Internationalization utilities
ii  intltool-debian     0.35.0+20060710.1    Help i18n of RFC822 compliant conf
ii  libparse-debianchan 1.1.1-2              parse Debian changelogs and output
ii  libtimedate-perl    1.1600-9             Time and date functions for Perl
ii  liburi-perl         1.35.dfsg.1-1        Manipulates and accesses URI strin
ii  man-db              2.5.2-2              on-line manual pager
ii  perl [libdigest-sha 5.10.0-11            Larry Wall's Practical Extraction 

lintian recommends no packages.

-- no debconf information