]> git.ipfire.org Git - thirdparty/util-linux.git/commit
getopt.1.adoc: render synopsis rules on separate lines
authorJohannes Altmanninger <aclopte@gmail.com>
Sun, 6 Feb 2022 06:11:58 +0000 (07:11 +0100)
committerKarel Zak <kzak@redhat.com>
Mon, 7 Feb 2022 09:52:05 +0000 (10:52 +0100)
commit55bcc40952001c189f1aec865d30ad3f9536fe81
tree7f7168a84926f76e409916077825bf0e86da7fe1
parentcd1e7e27f81aad430f0e35c737af03cfc44e4d67
getopt.1.adoc: render synopsis rules on separate lines

AsciiDoc ignores single line breaks, so the synopsis of

*getopt* _variant1_
*getopt* _variant2_

will render as one line in the manpage.

Fix this by adding a blank line in between two rules, like we do
elsewhere.  This means that the manpage also has blank lines.

*getopt* _variant1_

*getopt* _variant2_

Alternative solution: we could avoid the blank lines like below,
but that'd be inconsistent with our other manpages.

*getopt* _variant1_ +
*getopt* _variant2_ +

or, equivalently, use the verse[*] directive

[verse]
*getopt* _variant1_
*getopt* _variant2_

[*]: https://docs.asciidoctor.org/asciidoc/latest/blocks/verses/

Signed-off-by: Johannes Altmanninger <aclopte@gmail.com>
misc-utils/getopt.1.adoc