Package: help2man
Version: 1.47.8
Severity: normal

Hi,

I'm creating a package of an updated version of libqmi which uses
help2man to generate its man pages.  Unfortunately, the resulting man
pages have issues which cause lintian checks for the package to fail:

W: libqmi-utils: manpage-has-errors-from-man 
usr/share/man/man1/qmi-firmware-update.1.gz 99: warning [p 2, 6.5i, div 
'an-div', 0.0i]: can't break line
W: libqmi-utils: manpage-has-errors-from-man usr/share/man/man1/qmicli.1.gz 76: 
warning [p 2, 1.5i, div 'an-div', 0.0i]: cannot adjust line

Running the lintian checks manually gives:

$ MANROFFSEQ='' MANWIDTH=80 man --warnings -E UTF-8 -l -Tutf8 -Z 
./debian/libqmi-utils/usr/share/man/man1/qmi-firmware-update.1.gz >/dev/null
troff: <standard input>:99: warning [p 2, 6.5i, div 'an-div', 0.0i]: can't 
break line
troff: <standard input>:102: warning [p 2, 7.0i]: can't break line
$ MANROFFSEQ='' MANWIDTH=80 man --warnings -E UTF-8 -l -Tutf8 -Z 
./debian/libqmi-utils/usr/share/man/man1/qmicli.1.gz >/dev/null
troff: <standard input>:76: warning [p 2, 1.5i, div 'an-div', 0.0i]: cannot 
adjust line
troff: <standard input>:246: warning [p 4, 7.0i, div 'an-div', 0.0i]: cannot 
adjust line
troff: <standard input>:392: warning [p 6, 10.8i, div 'an-div', 0.0i]: cannot 
adjust line
troff: <standard input>:573: warning [p 9, 6.8i, div 'an-div', 0.0i]: cannot 
adjust line

I will attach the offending man pages to this bug report.  Here is the
line causing the top warning from qmicli.1.gz:

\fB\-\-dms\-uim\-set\-pin\-protection\fR=\fI\,[\/\fR(PIN|PIN2),(disable|enable),(current
 PIN)]

The identifiers used in libqmi and family tend to be verbose and long
which I guess is where the problem lies.

Regards,

Bob


-- System Information:
Debian Release: 10.2
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-debug'), (500, 'stable')
Architecture: arm64 (aarch64)

Kernel: Linux 5.3.0-gd8eac4f95 (SMP w/4 CPU cores; PREEMPT)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), 
LANGUAGE=en_GB:en (charmap=UTF-8)
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages help2man depends on:
ii  dpkg                    1.19.7
ii  install-info            6.5.0.dfsg.1-4+b1
ii  libc6                   2.28-10
ii  liblocale-gettext-perl  1.07-3+b4
ii  perl                    5.28.1-6

help2man recommends no packages.

help2man suggests no packages.

-- no debconf information

Attachment: qmi-firmware-update.1.gz
Description: application/gzip

Attachment: qmicli.1.gz
Description: application/gzip

Reply via email to