package: sympa
severity: minor

W: sympa: manpage-has-errors-from-man usr/share/man/man5/sympa.conf.5.gz 222: 
warning [p 2, 2.2i]: 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

-- 
Ecommerce and Linux consulting + Perl and web application programming.
Debian and Sympa administration. Provisioning with Ansible.

Reply via email to