qemu-e2k/docs/system
Peter Maydell de1572ca49 docs: Create defs.rst.inc as a place to define substitutions
Rather than accumulating generally useful rST substitution
definitions in individual rST files, create a defs.rst.inc where we
can define these.  To start with it has the |qemu_system| definition
from qemu-block-drivers.rst.

Add a comment noting a pitfall where putting literal markup in the
definition of |qemu_system| makes it misrender manpage output; this
means the point-of-use must handle the literal markup (which is
almost always done by having it inside a parsed-literal block).

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Kashyap Chamarthy <kchamart@redhat.com>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Message-id: 20200228153619.9906-15-peter.maydell@linaro.org
2020-03-06 10:04:58 +00:00
..
build-platforms.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
conf.py qemu-block-drivers: Convert to rST 2020-01-23 15:34:04 +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.texi qemu-doc: split CPU models doc between MIPS and x86 parts 2020-03-06 10:04:57 +00:00
deprecated.texi qemu-doc: move included files to docs/system 2020-03-06 10:04:57 +00:00
gdb.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +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: put qemu-block-drivers body in an included file 2020-03-06 10:04:58 +00:00
invocation.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
ivshmem.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
keys.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
license.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
linuxboot.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00
managed-startup.texi qemu-doc: move qemu-tech.texi into main section 2020-03-06 10:04:57 +00:00
monitor.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
mux-chardev.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +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.texi qemu-doc: split CPU models doc between MIPS and x86 parts 2020-03-06 10:04:57 +00:00
qemu-option-trace.texi qemu-doc: move included files to docs/system 2020-03-06 10:04:57 +00:00
quickstart.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
security.texi qemu-doc: move included files to docs/system 2020-03-06 10:04:57 +00:00
target-arm.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-i386.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-m68k.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-mips.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-ppc.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-sparc.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-sparc64.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
target-xtensa.texi qemu-doc: remove indices other than findex 2020-03-06 10:04:58 +00:00
tls.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +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.texi qemu-doc: split qemu-doc.texi in multiple files 2020-03-06 10:04:57 +00:00