From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Laurent Vivier" <laurent@vivier.eu>,
"Kostiantyn Kostiuk" <kkostiuk@redhat.com>,
"Michael S. Tsirkin" <mst@redhat.com>,
"Zhao Liu" <zhao1.liu@intel.com>,
"Michael Roth" <michael.roth@amd.com>,
"Pierrick Bouvier" <pierrick.bouvier@oss.qualcomm.com>,
"Daniel P. Berrangé" <berrange@redhat.com>,
"Jason Wang" <jasowangio@gmail.com>,
qemu-trivial@nongnu.org,
"Philippe Mathieu-Daudé" <philmd@oss.qualcomm.com>,
"Stefano Garzarella" <sgarzare@redhat.com>,
"Kashyap Chamarthy" <kchamart@redhat.com>,
"Eric Blake" <eblake@redhat.com>,
"Hanna Reitz" <hreitz@redhat.com>,
"Markus Armbruster" <armbru@redhat.com>,
"Kevin Wolf" <kwolf@redhat.com>,
qemu-block@nongnu.org, "Michael Tokarev" <mjt@tls.msk.ru>,
"John Snow" <jsnow@redhat.com>
Subject: [PATCH v2 1/8] qapi: convert/split remaining qapi/qmp intro sections
Date: Tue, 22 Sep 2026 16:55:58 -0400 [thread overview]
Message-ID: <20260922205605.501602-2-jsnow@redhat.com> (raw)
In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com>
A few slipped in during the mass conversion, get those too. Mostly
trivial conversion, with the exception of @x-qemu-io which introduces
a new split.
Signed-off-by: John Snow <jsnow@redhat.com>
---
qapi/block.json | 5 +++--
qapi/machine-s390x.json | 3 +--
qapi/machine.json | 3 +--
qapi/net.json | 24 ++++++++----------------
4 files changed, 13 insertions(+), 22 deletions(-)
diff --git a/qapi/block.json b/qapi/block.json
index 13c47e1eb44..0a88d405a26 100644
--- a/qapi/block.json
+++ b/qapi/block.json
@@ -597,9 +597,10 @@
##
# @x-qemu-io:
+# Run a qemu-io command on a block device.
#
-# Run a qemu-io command on a block device. Take either a block
-# backend name or a qdev ID to identify the device.
+# Take either a block backend name or a qdev ID to identify the
+# device.
#
# @device: the block backend name, node-name to run the
# command on.
diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json
index 670a1f9d926..8d8cbe2fb75 100644
--- a/qapi/machine-s390x.json
+++ b/qapi/machine-s390x.json
@@ -138,8 +138,7 @@
##
# @BootCertificates:
-#
-# Boot certificates for secure IPL.
+# Boot certificates for secure IPL.
#
# @path: path to an X.509 certificate file or a directory containing
# certificate files.
diff --git a/qapi/machine.json b/qapi/machine.json
index 1220116bf7d..6eb14c62851 100644
--- a/qapi/machine.json
+++ b/qapi/machine.json
@@ -1390,8 +1390,7 @@
##
# @SpMemDeviceInfo:
-#
-# sp-mem device state information
+# sp-mem device state information
#
# @id: device's ID
#
diff --git a/qapi/net.json b/qapi/net.json
index 2a186a71b93..f0312dfb714 100644
--- a/qapi/net.json
+++ b/qapi/net.json
@@ -1275,8 +1275,7 @@
##
# @UsernetInfo:
-#
-# Information about a user-mode network stack (slirp).
+# Information about a user-mode network stack (slirp).
#
# @hub-id: The hub id, if available.
#
@@ -1295,8 +1294,7 @@
##
# @x-query-usernet:
-#
-# Query user-mode network stack connection states.
+# Query user-mode network stack connection states.
#
# Features:
#
@@ -1319,8 +1317,7 @@
##
# @NetFilterInfo:
-#
-# Information about a netfilter attached to a network client.
+# Information about a netfilter attached to a network client.
#
# @name: filter object name (QOM path component)
#
@@ -1339,8 +1336,7 @@
##
# @NetworkClientInfo:
-#
-# Information about a network client.
+# Information about a network client.
#
# @name: unique network client identifier
#
@@ -1369,8 +1365,7 @@
##
# @NetHubPortInfo:
-#
-# Information about a hub port.
+# Information about a hub port.
#
# @name: hub port identifier
#
@@ -1385,8 +1380,7 @@
##
# @NetHubInfo:
-#
-# Information about a network hub.
+# Information about a network hub.
#
# @id: hub identifier
#
@@ -1401,8 +1395,7 @@
##
# @NetworkInfo:
-#
-# Information about the network configuration.
+# Information about the network configuration.
#
# @hubs: network hubs and their ports
#
@@ -1417,8 +1410,7 @@
##
# @x-query-network:
-#
-# Query the network configuration including hubs and clients.
+# Query the network configuration including hubs and clients.
#
# Features:
#
--
2.55.0
next prev parent reply other threads:[~2026-09-22 20:57 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-22 20:55 [PATCH v2 0/8] qapi: convert intros for qga, firmware, etc John Snow
2026-09-22 20:55 ` John Snow [this message]
2026-09-22 20:55 ` [PATCH v2 2/8] qapi: convert intro sections for unit tests John Snow
2026-09-23 6:07 ` Markus Armbruster
2026-09-23 17:17 ` John Snow
2026-09-22 20:56 ` [PATCH v2 3/8] qapi: convert trivial intros for qga/qapi-schema.json John Snow
2026-09-22 20:56 ` [PATCH v2 4/8] qapi: convert simple " John Snow
2026-09-22 20:56 ` [PATCH v2 5/8] qapi: split intros at natural cutoff points " John Snow
2026-09-23 6:25 ` Markus Armbruster
2026-09-23 17:18 ` John Snow
2026-09-22 20:56 ` [PATCH v2 6/8] qapi: split intros " John Snow
2026-09-22 20:56 ` [PATCH v2 7/8] qapi: convert intro sections for docs/interop/firmware.json John Snow
2026-09-22 20:56 ` [PATCH v2 8/8] qapi: convert intro sections for docs/interop/vhost-user.json John Snow
2026-09-23 6:45 ` [PATCH v2 0/8] qapi: convert intros for qga, firmware, etc Markus Armbruster
2026-09-23 6:49 ` Markus Armbruster
2026-09-23 17:19 ` 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=20260922205605.501602-2-jsnow@redhat.com \
--to=jsnow@redhat.com \
--cc=armbru@redhat.com \
--cc=berrange@redhat.com \
--cc=eblake@redhat.com \
--cc=hreitz@redhat.com \
--cc=jasowangio@gmail.com \
--cc=kchamart@redhat.com \
--cc=kkostiuk@redhat.com \
--cc=kwolf@redhat.com \
--cc=laurent@vivier.eu \
--cc=michael.roth@amd.com \
--cc=mjt@tls.msk.ru \
--cc=mst@redhat.com \
--cc=philmd@oss.qualcomm.com \
--cc=pierrick.bouvier@oss.qualcomm.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
--cc=qemu-trivial@nongnu.org \
--cc=sgarzare@redhat.com \
--cc=zhao1.liu@intel.com \
/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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.