manpage infilicity
"D. Hugh Redelmeier" <[email protected]>
| Newsgroups | gmane.text.docutils.user |
|---|---|
| Message-ID | <[email protected]> |
On Fedora 29, the dnf(1) has a formatting ugliness:
--disableexcludes=[all|main|<repoid>], --disableexcludep‐
kgs=[all|main|<repoid>]
Disable the configuration file excludes. Takes one of the following
three options:
(I hope your MUA doesn't muck that up.)
The .rst is:
``--disableexcludes=[all|main|<repoid>], --disableexcludepkgs=[all|main|<repoid>]``
Disable the configuration file excludes. Takes one of the following three options:
Clearly, to a human, rst2man should break this differently:
--disableexcludes=[all|main|<repoid>],
--disableexcludepkgs=[all|main|<repoid>]
Disable the configuration file excludes. Takes one of the following three options:
Why?
- placing a break in a keyword instead of at a space is wrong
- placing a break in a keyword instead of at a word boundary is wrong
- breaking a keyword at a random spot is wrong (although finding
syllable boundaries in made-up words is difficult)
- turning the single space into 15 spaces is just putting salt on the wound
Is this a bug in rst2man or a bug in the dnf.rst file?
<https://github.com/rpm-software-management/dnf/blob/master/doc/command_ref.rst>