qemu-options.hx: Fix up the autogenerated rST
authorPeter Maydell <peter.maydell@linaro.org>
Fri, 28 Feb 2020 15:36:13 +0000 (15:36 +0000)
committerPeter Maydell <peter.maydell@linaro.org>
Fri, 6 Mar 2020 11:06:55 +0000 (11:06 +0000)
commit09ce5f2d6bd6739144a9bcebd71115fb825371e6
treead77f4d56db42d2a55d4d0eeb08f7b867125d388
parente2fcbf4263231f09723e60811c3419cf509225d6
qemu-options.hx: Fix up the autogenerated rST

This commit contains hand-written fixes for some issues with the
autogenerated rST fragments in qemu-options.hx:

 * Sphinx complains about the UTF-8 art table in the documentation of
   the -drive option.  Replace it with a proper rST format table.

 * rST does not like definition list entries with no actual
   definition, but it is possible to work around this by putting a
   single escaped literal space as the definition line.

 * The "-g widthxheight" option documentation suffers particularly
   badly from losing the distinction between italics and fixed-width
   as a result of the auto conversion, so put it back in again.

 * The script missed some places that use the |qemu_system| etc
   macros and need to be marked up as parsed-literal blocks.

 * The script autogenerated an expanded out version of the
   contents of qemu-option-trace.texi; replace it with an
   qemu-option-trace.rst.inc include.

This is sufficient that we can enable inclusion of the
option documentation from invocation.rst.

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Message-id: 20200228153619.9906-28-peter.maydell@linaro.org
Makefile
docs/system/invocation.rst
qemu-options.hx