From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Alex Bennée" <alex.bennee@linaro.org>,
"Lukas Straub" <lukasstraub2@web.de>,
"Vladimir Sementsov-Ogievskiy" <vsementsov@yandex-team.ru>,
"Zhao Liu" <zhao1.liu@intel.com>,
"Laurent Vivier" <laurent@vivier.eu>,
"Markus Armbruster" <armbru@redhat.com>,
"Gonglei (Arei)" <arei.gonglei@huawei.com>,
"Philippe Mathieu-Daudé" <philmd@mailo.com>,
"Alex Williamson" <alex@shazbot.org>,
"zhenwei pi" <zhenwei.pi@linux.dev>,
"Hanna Reitz" <hreitz@redhat.com>,
"Ani Sinha" <anisinha@redhat.com>,
qemu-block@nongnu.org, "Paolo Bonzini" <pbonzini@redhat.com>,
"Peter Xu" <peterx@redhat.com>, "Kevin Wolf" <kwolf@redhat.com>,
linux-cxl@vger.kernel.org, "Jiri Pirko" <jiri@resnulli.us>,
"Daniel P. Berrangé" <berrange@redhat.com>,
"Stefan Berger" <stefanb@linux.vnet.ibm.com>,
"Fabiano Rosas" <farosas@suse.de>, "John Snow" <jsnow@redhat.com>,
"Stefan Hajnoczi" <stefanha@redhat.com>,
"Michael Tokarev" <mjt@tls.msk.ru>,
"Igor Mammedov" <imammedo@redhat.com>,
"Michael S. Tsirkin" <mst@redhat.com>,
"Gerd Hoffmann" <kraxel@redhat.com>,
"Mauro Carvalho Chehab" <mchehab+huawei@kernel.org>,
linux-edac@vger.kernel.org,
"Marc-André Lureau" <marcandre.lureau@redhat.com>,
"Richard Henderson" <richard.henderson@linaro.org>,
"Eric Blake" <eblake@redhat.com>,
"Cédric Le Goater" <clg@redhat.com>,
"Jason Wang" <jasowangio@gmail.com>,
qemu-trivial@nongnu.org, "Jonathan Cameron" <jic23@kernel.org>
Subject: [PATCH v2 33/44] qapi: convert trivial intro sections for misc.json
Date: Thu, 23 Jul 2026 00:47:54 -0400 [thread overview]
Message-ID: <20260723044805.527643-34-jsnow@redhat.com> (raw)
In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com>
Signed-off-by: John Snow <jsnow@redhat.com>
---
qapi/misc.json | 74 ++++++++++++++++++--------------------------------
1 file changed, 27 insertions(+), 47 deletions(-)
diff --git a/qapi/misc.json b/qapi/misc.json
index 22b7afed9f6..b3c2a1421f3 100644
--- a/qapi/misc.json
+++ b/qapi/misc.json
@@ -44,8 +44,7 @@
##
# @NameInfo:
-#
-# Guest name information.
+# Guest name information.
#
# @name: The name of the guest
#
@@ -55,8 +54,7 @@
##
# @query-name:
-#
-# Return the name information of a guest.
+# Return the name information of a guest.
#
# Since: 0.14
#
@@ -69,8 +67,7 @@
##
# @IOThreadInfo:
-#
-# Information about an iothread
+# Information about an iothread
#
# @id: the identifier of the iothread
#
@@ -137,8 +134,7 @@
##
# @stop:
-#
-# Stop guest VM execution.
+# Stop guest VM execution.
#
# Since: 0.14
#
@@ -159,8 +155,7 @@
##
# @cont:
-#
-# Resume guest VM execution.
+# Resume guest VM execution.
#
# Since: 0.14
#
@@ -208,8 +203,7 @@
##
# @human-monitor-command:
-#
-# Execute a command on the human monitor and return the output.
+# Execute a command on the human monitor and return the output.
#
# @command-line: the command to execute in the human monitor
#
@@ -251,8 +245,7 @@
##
# @getfd:
-#
-# Receive a file descriptor via SCM rights and assign it a name
+# Receive a file descriptor via SCM rights and assign it a name
#
# @fdname: file descriptor name
#
@@ -273,11 +266,10 @@
##
# @get-win32-socket:
-#
-# Add a socket that was duplicated to QEMU process with
-# WSADuplicateSocketW() via WSASocket() & WSAPROTOCOL_INFOW structure
-# and assign it a name (the SOCKET is associated with a CRT file
-# descriptor)
+# Add a socket that was duplicated to QEMU process with
+# WSADuplicateSocketW() via WSASocket() & WSAPROTOCOL_INFOW
+# structure and assign it a name (the SOCKET is associated with a
+# CRT file descriptor)
#
# @info: the WSAPROTOCOL_INFOW structure (encoded in base64)
#
@@ -301,8 +293,7 @@
##
# @closefd:
-#
-# Close a file descriptor previously passed via SCM rights
+# Close a file descriptor previously passed via SCM rights
#
# @fdname: file descriptor name
#
@@ -317,8 +308,7 @@
##
# @AddfdInfo:
-#
-# Information about a file descriptor that was added to an fd set.
+# Information about a file descriptor that was added to an fd set.
#
# @fdset-id: The ID of the fd set that @fd was added to.
#
@@ -331,8 +321,8 @@
##
# @add-fd:
-#
-# Add a file descriptor, that was passed via SCM rights, to an fd set.
+# Add a file descriptor, that was passed via SCM rights, to an fd
+# set.
#
# @fdset-id: The ID of the fd set to add the file descriptor to.
#
@@ -361,8 +351,7 @@
##
# @remove-fd:
-#
-# Remove a file descriptor from an fd set.
+# Remove a file descriptor from an fd set.
#
# @fdset-id: The ID of the fd set that the file descriptor belongs to.
#
@@ -387,8 +376,7 @@
##
# @FdsetFdInfo:
-#
-# Information about a file descriptor that belongs to an fd set.
+# Information about a file descriptor that belongs to an fd set.
#
# @fd: The file descriptor value.
#
@@ -401,8 +389,7 @@
##
# @FdsetInfo:
-#
-# Information about an fd set.
+# Information about an fd set.
#
# @fdset-id: The ID of the fd set.
#
@@ -415,8 +402,7 @@
##
# @query-fdsets:
-#
-# Return information describing all fd sets.
+# Return information describing all fd sets.
#
# Since: 1.2
#
@@ -457,8 +443,7 @@
##
# @CommandLineParameterType:
-#
-# Possible types for an option parameter.
+# Possible types for an option parameter.
#
# @string: accepts a character string
#
@@ -476,8 +461,7 @@
##
# @CommandLineParameterInfo:
-#
-# Details about a single parameter of a command line option.
+# Details about a single parameter of a command line option.
#
# @name: parameter name
#
@@ -497,9 +481,8 @@
##
# @CommandLineOptionInfo:
-#
-# Details about a command line option, including its list of parameter
-# details
+# Details about a command line option, including its list of
+# parameter details
#
# @option: option name
#
@@ -512,8 +495,7 @@
##
# @query-command-line-options:
-#
-# Query command line option schema.
+# Query command line option schema.
#
# @option: option name
#
@@ -552,8 +534,7 @@
##
# @RTC_CHANGE:
-#
-# Emitted when the guest changes the RTC time.
+# Emitted when the guest changes the RTC time.
#
# @offset: offset in seconds between base RTC clock (as specified by
# -rtc base), and new RTC clock value
@@ -577,9 +558,8 @@
##
# @VFU_CLIENT_HANGUP:
-#
-# Emitted when the client of a TYPE_VFIO_USER_SERVER closes the
-# communication channel
+# Emitted when the client of a TYPE_VFIO_USER_SERVER closes the
+# communication channel
#
# @vfu-id: ID of the TYPE_VFIO_USER_SERVER object. It is the last
# component of @vfu-qom-path referenced below
--
2.55.0
next prev parent reply other threads:[~2026-07-23 4:54 UTC|newest]
Thread overview: 47+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-23 4:47 [PATCH v2 00/44] qapi: convert trivial intro sections John Snow
2026-07-23 4:47 ` [PATCH v2 01/44] qapi: convert intro sections for error.json John Snow
2026-07-23 4:47 ` [PATCH v2 02/44] qapi: convert intro sections for acpi-hest.json John Snow
2026-07-23 7:29 ` Mauro Carvalho Chehab
2026-07-23 4:47 ` [PATCH v2 03/44] qapi: convert intro sections for ebpf.json John Snow
2026-07-23 4:47 ` [PATCH v2 04/44] qapi: convert intro sections for uefi.json John Snow
2026-07-23 4:47 ` [PATCH v2 05/44] qapi: convert trivial intro sections for compat.json John Snow
2026-07-23 4:47 ` [PATCH v2 06/44] qapi: convert intro sections for vfio.json John Snow
2026-07-23 4:47 ` [PATCH v2 07/44] qapi: convert intro sections for trace.json John Snow
2026-07-23 4:47 ` [PATCH v2 08/44] qapi: convert trivial intro sections for misc-arm.json John Snow
2026-07-23 4:47 ` [PATCH v2 09/44] qapi: convert intro sections for cryptodev.json John Snow
2026-07-23 9:11 ` zhenwei pi
2026-07-23 4:47 ` [PATCH v2 10/44] qapi: convert intro sections for machine-common.json John Snow
2026-07-23 4:47 ` [PATCH v2 11/44] qapi: convert intro sections for accelerator.json John Snow
2026-07-23 4:47 ` [PATCH v2 12/44] qapi: convert intro sections for authz.json John Snow
2026-07-23 4:47 ` [PATCH v2 13/44] qapi: convert trivial intro sections for yank.json John Snow
2026-07-23 4:47 ` [PATCH v2 14/44] qapi: convert intro sections for replay.json John Snow
2026-07-23 4:47 ` [PATCH v2 15/44] qapi: convert trivial intro sections for machine-s390x.json John Snow
2026-07-23 4:47 ` [PATCH v2 16/44] qapi: convert trivial intro sections for acpi.json John Snow
2026-07-23 4:47 ` [PATCH v2 17/44] qapi: convert intro sections for tpm.json John Snow
2026-07-23 4:47 ` [PATCH v2 18/44] qapi: convert trivial intro sections for qdev.json John Snow
2026-07-23 4:47 ` [PATCH v2 19/44] qapi: convert trivial intro sections for control.json John Snow
2026-07-23 4:47 ` [PATCH v2 20/44] qapi: convert intro sections for dump.json John Snow
2026-07-23 4:47 ` [PATCH v2 21/44] qapi: convert intro sections for common.json John Snow
2026-07-23 4:47 ` [PATCH v2 22/44] qapi: convert intro sections for sockets.json John Snow
2026-07-23 4:47 ` [PATCH v2 23/44] qapi: convert trivial intro sections for transaction.json John Snow
2026-07-23 4:47 ` [PATCH v2 24/44] qapi: convert trivial intro sections for stats.json John Snow
2026-07-23 4:47 ` [PATCH v2 25/44] qapi: convert trivial intro sections for job.json John Snow
2026-07-23 4:47 ` [PATCH v2 26/44] qapi: convert intro sections for pci.json John Snow
2026-07-23 4:47 ` [PATCH v2 27/44] qapi: convert trivial intro sections for introspect.json John Snow
2026-07-23 4:47 ` [PATCH v2 28/44] qapi: convert intro sections for rocker.json John Snow
2026-07-23 4:47 ` [PATCH v2 29/44] qapi: convert trivial intro sections for misc-i386.json John Snow
2026-07-23 4:47 ` [PATCH v2 30/44] qapi: convert trivial intro sections for block-export.json John Snow
2026-07-23 4:47 ` [PATCH v2 31/44] qapi: convert intro sections for audio.json John Snow
2026-07-23 4:47 ` [PATCH v2 32/44] qapi: convert trivial intro sections for block.json John Snow
2026-07-23 4:47 ` John Snow [this message]
2026-07-23 4:47 ` [PATCH v2 34/44] qapi: convert trivial intro sections for crypto.json John Snow
2026-07-23 4:47 ` [PATCH v2 35/44] qapi: convert intro sections for cxl.json John Snow
2026-07-23 4:47 ` [PATCH v2 36/44] qapi: convert trivial intro sections for run-state.json John Snow
2026-07-23 4:47 ` [PATCH v2 37/44] qapi: convert intro sections for char.json John Snow
2026-07-23 4:47 ` [PATCH v2 38/44] qapi: convert intro sections for virtio.json John Snow
2026-07-23 4:48 ` [PATCH v2 39/44] qapi: convert trivial intro sections for net.json John Snow
2026-07-23 4:48 ` [PATCH v2 40/44] qapi: convert trivial intro sections for qom.json John Snow
2026-07-23 4:48 ` [PATCH v2 41/44] qapi: convert trivial intro sections for ui.json John Snow
2026-07-23 4:48 ` [PATCH v2 42/44] qapi: convert trivial intro sections for migration.json John Snow
2026-07-23 4:48 ` [PATCH v2 43/44] qapi: convert trivial intro sections for machine.json John Snow
2026-07-23 4:48 ` [PATCH v2 44/44] qapi: convert trivial intro sections for block-core.json John Snow
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260723044805.527643-34-jsnow@redhat.com \
--to=jsnow@redhat.com \
--cc=alex.bennee@linaro.org \
--cc=alex@shazbot.org \
--cc=anisinha@redhat.com \
--cc=arei.gonglei@huawei.com \
--cc=armbru@redhat.com \
--cc=berrange@redhat.com \
--cc=clg@redhat.com \
--cc=eblake@redhat.com \
--cc=farosas@suse.de \
--cc=hreitz@redhat.com \
--cc=imammedo@redhat.com \
--cc=jasowangio@gmail.com \
--cc=jic23@kernel.org \
--cc=jiri@resnulli.us \
--cc=kraxel@redhat.com \
--cc=kwolf@redhat.com \
--cc=laurent@vivier.eu \
--cc=linux-cxl@vger.kernel.org \
--cc=linux-edac@vger.kernel.org \
--cc=lukasstraub2@web.de \
--cc=marcandre.lureau@redhat.com \
--cc=mchehab+huawei@kernel.org \
--cc=mjt@tls.msk.ru \
--cc=mst@redhat.com \
--cc=pbonzini@redhat.com \
--cc=peterx@redhat.com \
--cc=philmd@mailo.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
--cc=qemu-trivial@nongnu.org \
--cc=richard.henderson@linaro.org \
--cc=stefanb@linux.vnet.ibm.com \
--cc=stefanha@redhat.com \
--cc=vsementsov@yandex-team.ru \
--cc=zhao1.liu@intel.com \
--cc=zhenwei.pi@linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox