#182 lintian warnings about manpages
Hello while pacakging taurus 3.6.0, I got these messages.
Cheers
Frederic
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/tau2taurus.1.gz
N:
N: The whatis entry for this manual page (the brief description found in
N: the NAME section) is of the form:
N:
N: program - manual page for program
N:
N: This conveys no information about what the program is for and is
N: repetitive. The short description should contain brief information about
N: what the program is for to aid in searching with apropos and similar
N: programs.
N:
N: If this manpage was generated by help2man, use the -n option to provide
N: a more meaningful description.
N:
N: Severity: normal, Certainty: certain
N:
N: Check: manpages, Type: binary
N:
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusconfigbrowser.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/tauruscurve.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusdemo.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusdesigner.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusdevicepanel.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusdoc.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusform.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusgui.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusimage.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/tauruspanel.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusplot.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusremotelogmonitor.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurustrend.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurustrend1d.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurustrend2d.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusui.1.gz
W: python-taurus: manpage-has-useless-whatis-entry usr/share/man/man1/taurusuic4.1.gz
W: python-taurus: manpage-has-errors-from-man usr/share/man/man1/taurusuic4.1.gz 4: warning [p 1, 1.0i]: can't break line
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 groff
N: manual (see info groff).
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 a
N: string argument to .IP. These are likely to result in lost or malformed
N: output. See the groff_man (or groff_mdoc if using mdoc) man page for
N: 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 of
N: a line when they are intended as literal text rather than groff
N: commands. This can be fixed either by reformatting the paragraph so that
N: 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, see
N: "Debugging" in the groff manual.
N:
N: Lintian also stricter in regards to declaring manpage preprocessors.
N:
N: To test this for yourself you can use the following command:
N: LC_ALL=en_US.UTF-8 MANROFFSEQ='' MANWIDTH=80 \
N: man --warnings -E UTF-8 -l -Tutf8 -Z <file> >/dev/null
N:
N: Refer to the groff_man(7) manual page and the groff_mdoc(7) manual page
N: for details.
N:
N: Severity: normal, Certainty: certain
N:
N: Check: manpages, Type: binary
N: