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 37/44] qapi: convert intro sections for char.json
Date: Thu, 23 Jul 2026 00:47:58 -0400 [thread overview]
Message-ID: <20260723044805.527643-38-jsnow@redhat.com> (raw)
In-Reply-To: <20260723044805.527643-1-jsnow@redhat.com>
(Trivial)
Signed-off-by: John Snow <jsnow@redhat.com>
---
qapi/char.json | 90 +++++++++++++++++---------------------------------
1 file changed, 30 insertions(+), 60 deletions(-)
diff --git a/qapi/char.json b/qapi/char.json
index abaccefa97e..7ae67eedff8 100644
--- a/qapi/char.json
+++ b/qapi/char.json
@@ -12,8 +12,7 @@
##
# @ChardevInfo:
-#
-# Information about a character device.
+# Information about a character device.
#
# @label: the label of the character device
#
@@ -35,8 +34,7 @@
##
# @query-chardev:
-#
-# Return information about current character devices.
+# Return information about current character devices.
#
# Since: 0.14
#
@@ -68,8 +66,7 @@
##
# @ChardevBackendInfo:
-#
-# Information about a character device backend
+# Information about a character device backend
#
# @name: The backend name
#
@@ -79,8 +76,7 @@
##
# @query-chardev-backends:
-#
-# Return information about character device backends.
+# Return information about character device backends.
#
# Since: 2.0
#
@@ -108,8 +104,7 @@
##
# @DataFormat:
-#
-# An enumeration of data format.
+# An enumeration of data format.
#
# @utf8: Data is a UTF-8 string (RFC 3629)
#
@@ -122,8 +117,7 @@
##
# @ringbuf-write:
-#
-# Write to a ring buffer character device.
+# Write to a ring buffer character device.
#
# @device: the ring buffer character device name
#
@@ -154,8 +148,7 @@
##
# @ringbuf-read:
-#
-# Read from a ring buffer character device.
+# Read from a ring buffer character device.
#
# @device: the ring buffer character device name
#
@@ -189,8 +182,7 @@
##
# @ChardevCommon:
-#
-# Configuration shared across all chardev backends
+# Configuration shared across all chardev backends
#
# @logfile: The name of a logfile to save output
#
@@ -209,8 +201,7 @@
##
# @ChardevFile:
-#
-# Configuration info for file chardevs.
+# Configuration info for file chardevs.
#
# @in: The name of the input file
#
@@ -229,8 +220,7 @@
##
# @ChardevHostdev:
-#
-# Configuration info for device and pipe chardevs.
+# Configuration info for device and pipe chardevs.
#
# @device: The name of the special file for the device, i.e.
# /dev/ttyS0 on Unix or COM1: on Windows
@@ -243,8 +233,7 @@
##
# @ChardevSocket:
-#
-# Configuration info for (stream) socket chardevs.
+# Configuration info for (stream) socket chardevs.
#
# @addr: socket address to listen on (server=true) or connect to
# (server=false)
@@ -295,8 +284,7 @@
##
# @ChardevUdp:
-#
-# Configuration info for datagram socket chardevs.
+# Configuration info for datagram socket chardevs.
#
# @remote: remote address
#
@@ -311,8 +299,7 @@
##
# @ChardevMux:
-#
-# Configuration info for mux chardevs.
+# Configuration info for mux chardevs.
#
# @chardev: name of the base chardev.
#
@@ -324,8 +311,7 @@
##
# @ChardevHub:
-#
-# Configuration info for hub chardevs.
+# Configuration info for hub chardevs.
#
# @chardevs: IDs to be added to this hub (maximum 4 devices).
#
@@ -337,8 +323,7 @@
##
# @ChardevStdio:
-#
-# Configuration info for stdio chardevs.
+# Configuration info for stdio chardevs.
#
# @signal: Allow signals (such as SIGINT triggered by ^C) be delivered
# to QEMU. Default: true.
@@ -351,8 +336,7 @@
##
# @ChardevSpiceChannel:
-#
-# Configuration info for spice vm channel chardevs.
+# Configuration info for spice vm channel chardevs.
#
# @type: kind of channel (for example vdagent).
#
@@ -365,8 +349,7 @@
##
# @ChardevSpicePort:
-#
-# Configuration info for spice port chardevs.
+# Configuration info for spice port chardevs.
#
# @fqdn: name of the channel (see docs/spice-port-fqdn.txt)
#
@@ -379,8 +362,7 @@
##
# @ChardevVCEncoding:
-#
-# Character encoding expected from the guest on a virtual console.
+# Character encoding expected from the guest on a virtual console.
#
# @cp437: CP437 (8-bit Extended ASCII / VGA). Every byte maps
# directly to a glyph; suitable for DOS or other guests that
@@ -397,8 +379,7 @@
##
# @ChardevDBus:
-#
-# Configuration info for DBus chardevs.
+# Configuration info for DBus chardevs.
#
# @name: name of the channel (following docs/spice-port-fqdn.txt)
#
@@ -415,8 +396,7 @@
##
# @ChardevVC:
-#
-# Configuration info for virtual console chardevs.
+# Configuration info for virtual console chardevs.
#
# @width: console width, in pixels
#
@@ -445,8 +425,7 @@
##
# @ChardevRingbuf:
-#
-# Configuration info for ring buffer chardevs.
+# Configuration info for ring buffer chardevs.
#
# @size: ring buffer size, must be power of two, default is 65536
#
@@ -458,8 +437,7 @@
##
# @ChardevQemuVDAgent:
-#
-# Configuration info for QEMU vdagent implementation.
+# Configuration info for QEMU vdagent implementation.
#
# @mouse: enable/disable mouse, default is enabled.
#
@@ -475,8 +453,7 @@
##
# @ChardevPty:
-#
-# Configuration info for pty implementation.
+# Configuration info for pty implementation.
#
# @path: optional path to create a symbolic link that points to the
# allocated PTY
@@ -723,8 +700,7 @@
##
# @ChardevBackend:
-#
-# Configuration info for the new chardev backend.
+# Configuration info for the new chardev backend.
#
# @type: backend type
#
@@ -767,8 +743,7 @@
##
# @ChardevReturn:
-#
-# Return info about the chardev backend just created.
+# Return info about the chardev backend just created.
#
# @pty: name of the slave pseudoterminal device, present if and only
# if a chardev of type 'pty' was created
@@ -780,8 +755,7 @@
##
# @chardev-add:
-#
-# Add a character device backend
+# Add a character device backend
#
# @id: the chardev's ID, must be unique
#
@@ -818,8 +792,7 @@
##
# @chardev-change:
-#
-# Change a character device backend
+# Change a character device backend
#
# @id: the chardev's ID
#
@@ -859,8 +832,7 @@
##
# @chardev-remove:
-#
-# Remove a character device backend
+# Remove a character device backend
#
# @id: the chardev's ID, must not be in use
#
@@ -876,8 +848,7 @@
##
# @chardev-send-break:
-#
-# Send a break to a character device
+# Send a break to a character device
#
# @id: the chardev's ID
#
@@ -893,8 +864,7 @@
##
# @VSERPORT_CHANGE:
-#
-# Emitted when the guest opens or closes a virtio-serial port.
+# Emitted when the guest opens or closes a virtio-serial port.
#
# @id: device identifier of the virtio-serial port
#
--
2.55.0
next prev parent reply other threads:[~2026-07-23 4:54 UTC|newest]
Thread overview: 52+ 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 10:19 ` Lukas Straub
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 ` [PATCH v2 33/44] qapi: convert trivial intro sections for misc.json John Snow
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 ` John Snow [this message]
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 13:00 ` Markus Armbruster
2026-07-23 4:48 ` [PATCH v2 41/44] qapi: convert trivial intro sections for ui.json John Snow
2026-07-23 12:59 ` Markus Armbruster
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
2026-07-23 13:01 ` Markus Armbruster
2026-07-23 12:57 ` [PATCH v2 00/44] qapi: convert trivial 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=20260723044805.527643-38-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