Re: [Docutils-users] manpage infilicity

[D. H. R. <hu...@mi...>]

Oops: this might be a problem with Sphinx, not rst2doc.
I've not figured out the plumbing.

| From: D. Hugh Redelmeier <hu...@mi...>
| 
| 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>