qemu/docs/system
Peter Maydell 09ce5f2d6b 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
2020-03-06 11:06:55 +00:00
..
build-platforms.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
build-platforms.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
conf.py docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
cpu-models-mips.rst.inc docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
cpu-models-mips.texi qemu-doc: split CPU models doc between MIPS and x86 parts 2020-03-06 10:04:57 +00:00
cpu-models-x86.rst.inc docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
cpu-models-x86.texi qemu-doc: split CPU models doc between MIPS and x86 parts 2020-03-06 10:04:57 +00:00
deprecated.rst docs/system: convert the documentation of deprecated features to rST. 2020-03-06 10:05:12 +00:00
deprecated.texi qemu-doc: move included files to docs/system 2020-03-06 10:04:57 +00:00
gdb.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
gdb.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
images.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
images.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
index.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
invocation.rst qemu-options.hx: Fix up the autogenerated rST 2020-03-06 11:06:55 +00:00
invocation.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
ivshmem.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
ivshmem.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
keys.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
keys.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
license.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
license.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
linuxboot.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
linuxboot.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
managed-startup.rst docs/system: convert managed startup to rST. 2020-03-06 10:05:12 +00:00
managed-startup.texi qemu-doc: move qemu-tech.texi into main section 2020-03-06 10:04:57 +00:00
monitor.rst hmp-commands-info.hx: Add rST documentation fragments 2020-03-06 10:05:12 +00:00
monitor.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
mux-chardev.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
mux-chardev.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
net.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
net.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
qemu-block-drivers.rst docs: Create defs.rst.inc as a place to define substitutions 2020-03-06 10:04:58 +00:00
qemu-block-drivers.rst.inc docs/system: put qemu-block-drivers body in an included file 2020-03-06 10:04:58 +00:00
qemu-cpu-models.rst docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
qemu-option-trace.texi qemu-doc: move included files to docs/system 2020-03-06 10:04:57 +00:00
quickstart.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
quickstart.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
security.rst docs/system: Convert security.texi to rST format 2020-03-06 10:05:12 +00:00
security.texi qemu-doc: move included files to docs/system 2020-03-06 10:04:57 +00:00
target-arm.rst docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
target-arm.texi docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
target-i386.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
target-i386.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-m68k.rst docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
target-m68k.texi docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
target-mips.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
target-mips.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-ppc.rst docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-ppc.texi docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-sparc64.rst docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-sparc64.texi docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-sparc.rst docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-sparc.texi docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-xtensa.rst docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
target-xtensa.texi docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
targets.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
tls.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
tls.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
usb.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
usb.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
vfio-ap.rst docs: rstfy vfio-ap documentation 2020-02-26 18:57:07 +01:00
vnc-security.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
vnc-security.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00