qemu/qapi
Markus Armbruster 4622c70689 qapi storage-daemon/qapi: Fix documentation section structure
In the QEMU QMP Reference Manual, subsection "Block core (VM
unrelated)" is empty.  Its contents is at the end of subsection
"Background jobs" instead.  That's because qapi/job.json is included
first from qapi/block-core.json, which makes qapi/job.json's
documentation go between qapi/block-core.json's subsection heading and
contents.

In the QEMU Storage Daemon QMP Reference Manual, section "Block
Devices" contains nothing but an empty subsection "Block core (VM
unrelated)".  The latter's contents is at the end section "Socket data
types", along with subsection "Block device exports".  Subsection
"Background jobs" is at the end of section "Cryptography".  All this
is because storage-daemon/qapi/qapi-schema.json includes modules in a
confused order.

Fix both as follows.

Turn subsection "Background jobs" into a section.

Move it before section "Block devices" in the QEMU QMP Reference
Manual, by including qapi/jobs.json right before qapi/block.json.

Reorder include directives in storage-daemon/qapi/qapi-schema.json to
match the order in qapi/qapi-schema.json, so that the QEMU Storage
Daemon QMP Reference Manual's section structure the QEMU QMP Reference
Manual's.

In the QEMU QMP Reference Manual, qapi/cryptodev.json's documentation
is at the end of section "Virtio devices".  That's because it lacks a
section heading, and therefore gets squashed into whatever section
happens to precede it.

Add section heading so it's in section "Cryptography devices".

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>
Reviewed-by: Eric Blake <eblake@redhat.com>
Acked-by: zhenwei pi <pizhenwei@bytedance.com>
Message-Id: <20230425064223.820979-17-armbru@redhat.com>
2023-04-28 11:48:34 +02:00
..
acpi.json
audio.json qapi, audio: Make introspection reflect build configuration more closely 2023-01-30 15:43:55 +01:00
authz.json
block-core.json qapi: Format since information the conventional way: (since X.Y) 2023-04-28 11:48:34 +02:00
block-export.json qapi: Fix bullet list markup in documentation 2023-04-28 11:48:34 +02:00
block.json qapi: Tidy up examples 2023-04-28 11:48:34 +02:00
char.json qapi: Tidy up examples 2023-04-28 11:48:34 +02:00
common.json
compat.json
control.json qapi: Fix unintended definition lists in documentation 2023-04-28 11:48:34 +02:00
crypto.json
cryptodev.json qapi storage-daemon/qapi: Fix documentation section structure 2023-04-28 11:48:34 +02:00
cxl.json hw/mem/cxl_type3: Add CXL RAS Error Injection Support. 2023-03-07 12:39:00 -05:00
dump.json
error.json
introspect.json
job.json qapi storage-daemon/qapi: Fix documentation section structure 2023-04-28 11:48:34 +02:00
machine-target.json qapi: Fix misspelled references 2023-04-28 11:48:34 +02:00
machine.json qapi: Fix misspelled section tags in doc comments 2023-04-28 11:48:34 +02:00
meson.build hw/mem/cxl_type3: Add CXL RAS Error Injection Support. 2023-03-07 12:39:00 -05:00
migration.json qapi: Fix misspelled section tags in doc comments 2023-04-28 11:48:34 +02:00
misc-target.json i386/xen: add monitor commands to test event injection 2023-03-01 08:22:50 +00:00
misc.json qapi: Tidy up examples 2023-04-28 11:48:34 +02:00
net.json qapi: Replace ad hoc "since" documentation by member documentation 2023-04-28 11:48:34 +02:00
opts-visitor.c
pci.json
pragma.json
qapi-clone-visitor.c
qapi-dealloc-visitor.c
qapi-forward-visitor.c
qapi-schema.json qapi storage-daemon/qapi: Fix documentation section structure 2023-04-28 11:48:34 +02:00
qapi-type-helpers.c
qapi-util.c
qapi-visit-core.c
qdev.json qapi: Tidy up examples 2023-04-28 11:48:34 +02:00
qmp-dispatch.c monitor: mark mixed functions that can suspend 2023-04-20 11:17:35 +02:00
qmp-event.c
qmp-registry.c
qobject-input-visitor.c
qobject-output-visitor.c
qom.json qapi: Tidy up examples 2023-04-28 11:48:34 +02:00
rdma.json qapi: Fix argument documentation markup 2023-04-28 11:48:34 +02:00
replay.json qapi: Tidy up examples 2023-04-28 11:48:34 +02:00
rocker.json
run-state.json qapi: Replace ad hoc "since" documentation by member documentation 2023-04-28 11:48:34 +02:00
sockets.json
stats.json qapi: Format since information the conventional way: (since X.Y) 2023-04-28 11:48:34 +02:00
string-input-visitor.c
string-output-visitor.c
tpm.json qapi: Format since information the conventional way: (since X.Y) 2023-04-28 11:48:34 +02:00
trace-events
trace.h
trace.json qapi: Fix bullet list markup in documentation 2023-04-28 11:48:34 +02:00
transaction.json
ui.json qapi: Format since information the conventional way: (since X.Y) 2023-04-28 11:48:34 +02:00
virtio.json Fix several typos in documentation (found by codespell) 2022-11-11 09:39:25 +01:00
yank.json qapi: Fix bullet list markup in documentation 2023-04-28 11:48:34 +02:00