Re: manpage infilicity

"D. Hugh Redelmeier" <[email protected]>
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
Oops: this might be a problem with Sphinx, not rst2doc.
I've not figured out the plumbing.

| From: D. Hugh Redelmeier <[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>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.