Skip to content

Formatting improvements for the man page

Mario Blättermann requested to merge mariobl-guest/help2man:master into master

I've changed some things to get closer to common formatting rules.

First, command options should be formatted bold in a man page. This works so far for --help and --version:

%s generates a man page out of --help and --version output.

But "%s", which expands to the command name, remains plain, but it shouldn't – it is help2man itself and should be also bold. Don't know how to reach this...

Second, the "info" in the Texinfo section, is a link to an external command. This should be a real link to the appropriate man page including section number. Not that big improvement for the terminal output, but it has an interesting side effect: HTML renderers detect this correctly and create a clickable hyperlink to that man page; see the perle(1) link in the online man page collection of Archlinux [1].

[1] https://man.archlinux.org/man/extra/help2man/help2man.1.en#INCLUDE_FILES

Merge request reports