qemu/docs/devel
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
..
acpi-bits.rst Add my old and new work email mapping and use work email to support biosbits 2023-04-21 03:08:21 -04:00
atomics.rst docs: explain effect of smp_read_barrier_depends() on modern architectures 2023-04-20 11:17:36 +02:00
bitops.rst
blkdebug.txt
blkverify.txt
block-coroutine-wrapper.rst
build-system.rst
ci-definitions.rst.inc
ci-jobs.rst.inc
ci-runners.rst.inc
ci.rst
clocks.rst
code-of-conduct.rst
conflict-resolution.rst
control-flow-integrity.rst
decodetree.rst
ebpf_rss.rst
fuzzing.rst docs/fuzz: remove mentions of fork-based fuzzing 2023-02-16 23:02:46 -05:00
index-api.rst
index-build.rst
index-internals.rst
index-process.rst
index-tcg.rst
index.rst
kconfig.rst docs/devel/kconfig.rst: Fix incorrect markup 2023-04-20 10:21:16 +01:00
loads-stores.rst
lockcnt.txt
maintainers.rst
memory.rst
migration.rst
modules.rst
multi-process.rst
multi-thread-tcg.rst
multiple-iothreads.txt
qapi-code-gen.rst qapi: Fix bullet list markup in documentation 2023-04-28 11:48:34 +02:00
qgraph.rst
qom.rst docs/devel: mention the spacing requirement for QOM 2023-04-27 14:58:51 +01:00
qtest.rst
rcu.txt
replay.rst
reset.rst
s390-dasd-ipl.rst
secure-coding-practices.rst
stable-process.rst
style.rst docs/style: call out the use of GUARD macros 2023-04-27 14:58:51 +01:00
submitting-a-patch.rst
submitting-a-pull-request.rst
tcg-icount.rst
tcg-ops.rst docs/devel/tcg-ops: Drop recommendation to free temps 2023-03-05 13:44:08 -08:00
tcg-plugins.rst
tcg.rst
testing.rst testing: update ubuntu2004 to ubuntu2204 2023-03-01 10:31:46 +00:00
tracing.rst
trivial-patches.rst
ui.rst
vfio-migration.rst docs/devel: Document VFIO device dirty page tracking 2023-03-07 10:21:22 -07:00
virtio-backends.rst
virtio-migration.txt
writing-monitor-commands.rst