From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Markus Armbruster" <armbru@redhat.com>,
"Peter Xu" <peterx@redhat.com>,
"Junjie Cao" <junjie.cao@intel.com>,
"Michael Roth" <michael.roth@amd.com>,
"Paolo Bonzini" <pbonzini@redhat.com>,
"Zhao Liu" <zhao1.liu@intel.com>,
linux-cxl@vger.kernel.org, "Jason Wang" <jasowangio@gmail.com>,
"Eric Blake" <eblake@redhat.com>,
"Fabiano Rosas" <farosas@suse.de>,
"Philippe Mathieu-Daudé" <philmd@oss.qualcomm.com>,
"Kevin Wolf" <kwolf@redhat.com>,
"Hanna Reitz" <hreitz@redhat.com>,
qemu-block@nongnu.org,
"Philippe Mathieu-Daudé" <philmd@mailo.com>,
"Lukas Straub" <lukasstraub2@web.de>,
"Jonathan Cameron" <jic23@kernel.org>,
"John Snow" <jsnow@redhat.com>
Subject: [PATCH v5 6/7] qapi: convert intro sections with "TODO" markers
Date: Thu, 17 Sep 2026 15:46:13 -0400 [thread overview]
Message-ID: <20260917194614.549584-7-jsnow@redhat.com> (raw)
In-Reply-To: <20260917194614.549584-1-jsnow@redhat.com>
This patch converts intro sections that are immediately followed by a
"TODO:" that was formerly used to demarcate the stub member insertion
point.
Signed-off-by: John Snow <jsnow@redhat.com>
---
qapi/machine.json | 7 ++-----
qapi/migration.json | 10 ++--------
qapi/net.json | 9 +++------
qapi/yank.json | 5 +----
4 files changed, 8 insertions(+), 23 deletions(-)
diff --git a/qapi/machine.json b/qapi/machine.json
index a58e373dd70..84d95c8d87f 100644
--- a/qapi/machine.json
+++ b/qapi/machine.json
@@ -1244,11 +1244,8 @@
##
# @query-memory-size-summary:
-#
-# Return the amount of initially allocated and present hotpluggable
-# (if enabled) memory in bytes.
-#
-# TODO: This line is a hack to separate the example from the body
+# Return the amount of initially allocated and present
+# hotpluggable (if enabled) memory in bytes.
#
# .. qmp-example::
#
diff --git a/qapi/migration.json b/qapi/migration.json
index 0428f777882..d571c06fc20 100644
--- a/qapi/migration.json
+++ b/qapi/migration.json
@@ -1617,10 +1617,7 @@
##
# @query-xen-replication-status:
-#
-# Query replication status while the vm is running.
-#
-# TODO: This line is a hack to separate the example from the body
+# Query replication status while the vm is running.
#
# .. qmp-example::
#
@@ -1670,10 +1667,7 @@
##
# @query-colo-status:
-#
-# Query COLO status while the vm is running.
-#
-# TODO: This line is a hack to separate the example from the body
+# Query COLO status while the vm is running.
#
# .. qmp-example::
#
diff --git a/qapi/net.json b/qapi/net.json
index 526108ca0bb..d0bacb4dcfe 100644
--- a/qapi/net.json
+++ b/qapi/net.json
@@ -1159,12 +1159,9 @@
##
# @announce-self:
-#
-# Trigger generation of broadcast RARP frames to update network
-# switches. This can be useful when network bonds fail-over the
-# active slave.
-#
-# TODO: This line is a hack to separate the example from the body
+# Trigger generation of broadcast RARP frames to update network
+# switches. This can be useful when network bonds fail-over the
+# active slave.
#
# .. qmp-example::
#
diff --git a/qapi/yank.json b/qapi/yank.json
index 8ac4b773653..187a0952e66 100644
--- a/qapi/yank.json
+++ b/qapi/yank.json
@@ -96,10 +96,7 @@
##
# @query-yank:
-#
-# Query yank instances. See `YankInstance` for more information.
-#
-# TODO: This line is a hack to separate the example from the body
+# Query yank instances. See `YankInstance` for more information.
#
# .. qmp-example::
#
--
2.55.0
next prev parent reply other threads:[~2026-09-17 19:47 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-17 19:46 [PATCH v5 0/7] qapi: convert remaining "simple" intro sections John Snow
2026-09-17 19:46 ` [PATCH v5 1/7] qapi: convert remaining simple intros for block-export.json John Snow
2026-09-17 19:46 ` [PATCH v5 2/7] qapi: convert remaining simple intros for cxl.json John Snow
2026-09-22 0:39 ` Jonathan Cameron
2026-09-17 19:46 ` [PATCH v5 3/7] qapi: convert remaining simple intros for machine.json John Snow
2026-09-17 19:46 ` [PATCH v5 4/7] qapi: convert remaining simple intros for block-core.json John Snow
2026-09-17 19:46 ` [PATCH v5 5/7] qapi/parser: fix intermediate "intro" detection John Snow
2026-09-17 19:46 ` John Snow [this message]
2026-09-17 19:46 ` [PATCH v5 7/7] qapi: convert intro sections followed by notes/examples John Snow
2026-09-18 8:03 ` [PATCH v5 0/7] qapi: convert remaining "simple" intro sections Markus Armbruster
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=20260917194614.549584-7-jsnow@redhat.com \
--to=jsnow@redhat.com \
--cc=armbru@redhat.com \
--cc=eblake@redhat.com \
--cc=farosas@suse.de \
--cc=hreitz@redhat.com \
--cc=jasowangio@gmail.com \
--cc=jic23@kernel.org \
--cc=junjie.cao@intel.com \
--cc=kwolf@redhat.com \
--cc=linux-cxl@vger.kernel.org \
--cc=lukasstraub2@web.de \
--cc=michael.roth@amd.com \
--cc=pbonzini@redhat.com \
--cc=peterx@redhat.com \
--cc=philmd@mailo.com \
--cc=philmd@oss.qualcomm.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
--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.