On 27/07/2025 01:20, Collin Funk wrote:
In the Coreutils man pages we have occurrences of:
--option=[+]count
to indicate an optional '+' sign in the given number. The help2man
script generates poor output for these. This can be seen on the tail man
pages [1]. Here is the generated HTML:
<b>-c</b>, <b>--bytes</b>=<i>[</i>+]NUM
Specifically, the italic tag makes the '[' appear strange. However, the
case for:
--option=[-]count
looks much better. We can see this in the head man page [2]:
<b>-c</b>, <b>--bytes</b>=<i>[-]NUM</i>
The attached patch fixes it. WDYT?
I tagged bug-help2...@gnu.org, but I am not sure if it even exists
because I cannot find an archive. And AFAIK it is not version
controlled, only distributed through ftp.gnu.org.
Collin
[1] https://man7.org/linux/man-pages/man1/tail.1.html
[2] https://man7.org/linux/man-pages/man1/head.1.html
+1
CC'ing Brendan O'Dea just in case.
cheers,
Padraig