Description
Specify which documentation you found a problem with
Generated manpage curl.1
The problem
Debian's lintian flagged the following issue when I packaged the latest version:
W: curl: groff-message troff:<standard input>:1315: warning: expected numeric expression, got 'f' [usr/share/man/man1/curl.1.gz:1]
This is regarding the line ".IP "false" (default)"
which is under the section for --ech <config>
.
The generated website looks correct at https://curl.se/docs/manpage.html:
The values allowed for can be:
false (default)
Do not attempt ECH
But the manpage is missing that line, I can see it in the manpage source, it just doesn't get rendered, the result is:
The values allowed for can be:
Do not attempt ECH
I believe something is breaking on scripts/managen
due to the https://github.com/curl/curl/blob/master/docs/cmdline-opts/ech.md?plain=1#L23
My wild guess is that the presence of (default)
is throwing off some managen logic to translate the double quotes. Grepping through the source code, this is the first case where the docs have a pattern of ## "something" (default)
.
I would assume it's something simple to fix, but I'm still dealing with a packaging issue regarding multi-arch on the Debian side that I need to fix first (to get the package uploaded).