qemu/qapi
Markus Armbruster 8fa2020647 qapi: Improve documentation around job state @concluded
We use "the query list" in a few places.  It's not entirely obvious
what that means.  It's actually the output of query-jobs or
query-block-jobs.

Documentation of @auto-dismiss talks about the job disappearing from
the query list when it reaches state @concluded.  This is less than
precise.  The job doesn't merely disappear from the query list, it
disappears, period.

Documentation of JobStatus @concluded explains "the job will remain in
the query list until it is dismissed".  Again less than precise.  It
remains in state @concluded until dismissed.

Rephrase without use of "the query list" for clarity and precision.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20250527073916.1243024-14-armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
2025-06-03 08:34:57 +02:00
..
acpi.json
audio.json qapi: Correct spelling of QEMU in doc comments 2025-06-03 08:34:56 +02:00
authz.json
block-core.json qapi: Improve documentation around job state @concluded 2025-06-03 08:34:57 +02:00
block-export.json qapi: Correct spelling of QEMU in doc comments 2025-06-03 08:34:56 +02:00
block.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
char.json qapi: Correct spelling of QEMU in doc comments 2025-06-03 08:34:56 +02:00
common.json
compat.json
control.json
crypto.json
cryptodev.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
cxl.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
dump.json qapi: Use proper markup instead of CAPS for emphasis in doc comments 2025-06-03 08:34:57 +02:00
ebpf.json
error.json
introspect.json qapi: Correct spelling of QEMU in doc comments 2025-06-03 08:34:56 +02:00
job.json qapi: Improve documentation around job state @concluded 2025-06-03 08:34:57 +02:00
machine-common.json
machine-s390x.json
machine.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
meson.build
migration.json qapi: Use proper markup instead of CAPS for emphasis in doc comments 2025-06-03 08:34:57 +02:00
misc-arm.json
misc-i386.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
misc.json qapi: Use proper markup instead of CAPS for emphasis in doc comments 2025-06-03 08:34:57 +02:00
net.json qapi: Avoid breaking lines within (since X.Y) 2025-06-03 08:34:56 +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-type-helpers.c
qapi-util.c
qapi-visit-core.c
qdev.json
qmp-dispatch.c
qmp-event.c
qmp-registry.c
qobject-input-visitor.c
qobject-output-visitor.c
qom.json
replay.json
rocker.json
run-state.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
sockets.json
stats.json
string-input-visitor.c
string-output-visitor.c
tpm.json
trace-events
trace.h
trace.json
transaction.json qapi: Fix capitalization in doc comments 2025-06-03 08:34:57 +02:00
uefi.json qapi: Correct spelling of QEMU in doc comments 2025-06-03 08:34:56 +02:00
ui.json qapi: Correct spelling of QEMU in doc comments 2025-06-03 08:34:56 +02:00
vfio.json
virtio.json
yank.json