On Wed, Jan 08, 2020 at 08:26:22AM +0000, Bob Ham wrote: >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
There is really not much that can be done to deal with the long arguments, sorry. You may need to add a lintian override for that one, as it does actually appear to render, despite the warning. The "*** warning ***" message needs to be changed in order that it looks reasonable in both the --help output, and on the manuage page. I've attached a shell script which outputs an amended --help text for qmi-firmware-update which may work better. Use "help2man X | man -l -" to test, where "X" is the filename you saved it to. Make sure that file is executable. The output from the script also adjusts the Usage in the output to work with help2man. What is expected is: Usage: program [ARGS] What this program does. which is not what qmi-firmware-update is producing. See the info page for the recommended format: info '(help2man)--help recommendations' --bod
