[Docutils-users] manpage infilicity

[D. H. R. <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>