Re: [Docutils-users] manpage infilicity

[Guenter M. <mi...@us...>]

On 2019-04-07, D. Hugh Redelmeier wrote:
>| From: D. Hugh Redelmeier <hu...@mi...>

>| On Fedora 29, the dnf(1) has a formatting ugliness:

...

> But wait!  I do see problems with the input to nroff.

> It is generated by sphinx.  My impression is that sphinx is also a
> part of the docutils project.

Not exactly. Sphinx uses Docutils as a library for the conversion
but adds an additional layer.

So, the error may be in Sphinx, in the Docutils manpage writer, or in the 
input for Spinx or the Docutils manpage writer (should be a file with
reStructured text like "dnf.rst" or "dnf.txt".

There are some restrictions on the allowed input, especially for 
option lists. See
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#option-lists

Günter