qemu/docs
Markus Armbruster c110102898 qapi: Fix bullet list markup in documentation
Peter Maydell's commit 100cc4fe0f explains:

    rST insists on a blank line before and after a bulleted list [...]
    Add some extra blank lines in the doc comments so they're
    acceptable rST input.

It missed one in qapi/trace.json.

Paolo Bonzini later added another instance in qapi/stats.json,
providing further, if unintended, evidence for his quip that rST is
the Perl of ASCII-based markups.

Both are parsed as ordinary paragraph, resulting in garbled output.

John Snow missed the need for a blank line when converting
docs/devel/qapi-code-gen.txt to rST.

Add the blank lines we need to get the bullet lists recognized as
such.

Kevin Wolf and Lukas Straub added two more, but indented.  Sphinx
recognizes them as (indented) bullet lists.  The indentation looks
slightly off.

Insert a blank line and delete the extra indentation.

Fixes: 100cc4fe0f (qapi: Add blank lines before bulleted lists)
Fixes: 467ef823d8 (qmp: add filtering of statistics by target vCPU)
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@yandex-team.ru>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <20230425064223.820979-10-armbru@redhat.com>
[Fix of docs/devel/qapi-code-gen.rst squashed, commit message adjusted]
2023-04-28 11:48:34 +02:00
..
_templates
about Revert "docs/about/deprecated: Deprecate 32-bit arm hosts for system emulation" 2023-03-24 12:10:49 +01:00
config docs/config: Set the "kvm" accelerator via "[accel]" section 2023-03-08 08:57:42 +01:00
devel qapi: Fix bullet list markup in documentation 2023-04-28 11:48:34 +02:00
interop qapi: @foo should be used to reference, not `foo` 2023-04-28 11:48:34 +02:00
specs virtio,pc,pci: fixes, features, cleanups 2023-04-25 09:13:27 +01:00
sphinx docs/sphinx/kerneldoc.py: Honour --enable-werror 2023-03-16 14:39:10 +01:00
sphinx-static
spin
system docs/system: remove excessive punctuation from guest-loader docs 2023-04-27 14:58:41 +01:00
tools
user
block-replication.txt
bypass-iommu.txt
COLO-FT.txt
colo-proxy.txt
conf.py
defs.rst.inc
igd-assign.txt
image-fuzzer.txt
index.rst
memory-hotplug.txt
meson.build docs/sphinx/kerneldoc.py: Honour --enable-werror 2023-03-16 14:39:10 +01:00
multi-thread-compression.txt
multiseat.txt
nvdimm.txt
pci_expander_bridge.txt
pcie.txt
pcie_pci_bridge.txt
pcie_sriov.txt docs: Remove obsolete descriptions of SR-IOV support 2023-04-24 22:56:55 -04:00
pvrdma.txt
qcow2-cache.txt
qdev-device-use.txt
qemu-option-trace.rst.inc
qemupciserial.inf
rdma.txt
spice-port-fqdn.txt
throttle.txt
u2f.txt
xbzrle.txt
xen-save-devices-state.txt