Commit 4160e5d262 for qemu.org
commit 4160e5d26277d00903838f734afdc4831c8000c1
Author: John Snow <jsnow@redhat.com>
Date: Mon Sep 28 15:25:56 2026 -0400
qapi: split intro sections for data structs
The structs of concern in this patch are those for which no other QAPI
definition (currently) uses as a data type to describe its own
arguments or as a branch of a union: i.e. they are not currently
eligible to be inlined and as such the precise semantics of their
intro/details split is *currently* of less concern.
Of course, they could be inlined in the future, so the semantics of
this split are still worth investigating.
Signed-off-by: John Snow <jsnow@redhat.com>
Message-ID: <20260928192557.509157-10-jsnow@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
diff --git a/qapi/acpi.json b/qapi/acpi.json
index 291a04a7ea..82e82d7cf8 100644
--- a/qapi/acpi.json
+++ b/qapi/acpi.json
@@ -13,8 +13,7 @@
##
# @AcpiTableOptions:
-#
-# Specify an ACPI table on the command line to load.
+# Specify an ACPI table on the command line to load.
#
# At most one of @file and @data can be specified. The list of files
# specified by any one of them is loaded and concatenated in order.
diff --git a/qapi/block-core.json b/qapi/block-core.json
index 13981d7e69..741c8165c0 100644
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -843,9 +843,8 @@
##
# @BlockMeasureInfo:
-#
-# Image file size calculation information. This structure describes
-# the size requirements for creating a new image file.
+# Image file size calculation information. This structure
+# describes the size requirements for creating a new image file.
#
# The size requirements depend on the new image file format. File
# size always equals virtual disk size for the 'raw' format, even for
diff --git a/qapi/compat.json b/qapi/compat.json
index a512c77ffd..0f90ea1f52 100644
--- a/qapi/compat.json
+++ b/qapi/compat.json
@@ -53,10 +53,9 @@
##
# @CompatPolicy:
+# Policy for handling deprecated management interfaces.
#
-# Policy for handling deprecated management interfaces.
-#
-# This is intended for testing users of the management interfaces.
+# This is intended for testing users of the management interfaces.
#
# Limitation: covers only syntactic aspects of QMP, i.e. stuff tagged
# with feature 'deprecated' or 'unstable'. We may want to extend it
diff --git a/qapi/machine.json b/qapi/machine.json
index 75cbeca185..d09424b870 100644
--- a/qapi/machine.json
+++ b/qapi/machine.json
@@ -1634,9 +1634,9 @@
##
# @SMPConfiguration:
-#
-# Schema for CPU topology configuration. A missing value lets QEMU
-# figure out a suitable value based on the ones that are provided.
+# Schema for CPU topology configuration. A missing value lets
+# QEMU figure out a suitable value based on the ones that are
+# provided.
#
# The members other than @cpus and @maxcpus define a topology of
# containers.
@@ -1895,8 +1895,7 @@
##
# @CpuModelInfo:
-#
-# Virtual CPU model.
+# Virtual CPU model.
#
# A CPU model consists of the name of a CPU definition, to which delta
# changes are applied (e.g. features added/removed). Most magic