All of lore.kernel.org
 help / color / mirror / Atom feed
From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: "Marc-André Lureau" <marcandre.lureau@redhat.com>,
	"Lukas Straub" <lukasstraub2@web.de>,
	"Alex Bennée" <alex.bennee@linaro.org>,
	"Richard Henderson" <richard.henderson@linaro.org>,
	"zhenwei pi" <zhenwei.pi@linux.dev>,
	"Jonathan Cameron" <jic23@kernel.org>,
	"Paolo Bonzini" <pbonzini@redhat.com>,
	"Stefan Hajnoczi" <stefanha@redhat.com>,
	"Markus Armbruster" <armbru@redhat.com>,
	"Vladimir Sementsov-Ogievskiy" <vsementsov@yandex-team.ru>,
	"Jiri Pirko" <jiri@resnulli.us>,
	"Philippe Mathieu-Daudé" <philmd@mailo.com>,
	qemu-block@nongnu.org, "Ani Sinha" <anisinha@redhat.com>,
	"Jason Wang" <jasowangio@gmail.com>,
	linux-cxl@vger.kernel.org,
	"Daniel P. Berrangé" <berrange@redhat.com>,
	"Igor Mammedov" <imammedo@redhat.com>,
	"Hanna Reitz" <hreitz@redhat.com>,
	"Alex Williamson" <alex@shazbot.org>,
	"Stefan Berger" <stefanb@linux.vnet.ibm.com>,
	"Michael S. Tsirkin" <mst@redhat.com>,
	"Laurent Vivier" <laurent@vivier.eu>,
	linux-edac@vger.kernel.org, "Michael Tokarev" <mjt@tls.msk.ru>,
	"John Snow" <jsnow@redhat.com>, "Fabiano Rosas" <farosas@suse.de>,
	"Zhao Liu" <zhao1.liu@intel.com>,
	"Gonglei (Arei)" <arei.gonglei@huawei.com>,
	"Eric Blake" <eblake@redhat.com>, "Peter Xu" <peterx@redhat.com>,
	"Gerd Hoffmann" <kraxel@redhat.com>,
	"Kevin Wolf" <kwolf@redhat.com>,
	"Mauro Carvalho Chehab" <mchehab+huawei@kernel.org>,
	qemu-trivial@nongnu.org, "Cédric Le Goater" <clg@redhat.com>
Subject: [PATCH v4 30/43] qapi: convert trivial intro sections for audio.json
Date: Mon, 31 Aug 2026 16:19:32 -0400	[thread overview]
Message-ID: <20260831201945.287730-31-jsnow@redhat.com> (raw)
In-Reply-To: <20260831201945.287730-1-jsnow@redhat.com>

Signed-off-by: John Snow <jsnow@redhat.com>
---
 qapi/audio.json | 88 ++++++++++++++++++-------------------------------
 1 file changed, 32 insertions(+), 56 deletions(-)

diff --git a/qapi/audio.json b/qapi/audio.json
index 2df87b97101..72190f20993 100644
--- a/qapi/audio.json
+++ b/qapi/audio.json
@@ -14,9 +14,8 @@
 
 ##
 # @AudiodevPerDirectionOptions:
-#
-# General audio backend options that are used for both playback and
-# recording.
+#     General audio backend options that are used for both playback
+#     and recording.
 #
 # @mixing-engine: use QEMU's mixing engine to mix all streams inside
 #     QEMU and convert audio formats when not supported by the
@@ -53,8 +52,7 @@
 
 ##
 # @AudiodevGenericOptions:
-#
-# Generic driver-specific options.
+#     Generic driver-specific options.
 #
 # @in: options of the capture stream
 #
@@ -69,8 +67,7 @@
 
 ##
 # @AudiodevDBusOptions:
-#
-# Options of the D-Bus audio backend.
+#     Options of the D-Bus audio backend.
 #
 # @in: options of the capture stream
 #
@@ -89,9 +86,8 @@
 
 ##
 # @AudiodevAlsaPerDirectionOptions:
-#
-# Options of the ALSA backend that are used for both playback and
-# recording.
+#     Options of the ALSA backend that are used for both playback and
+#     recording.
 #
 # @dev: the name of the ALSA device to use (default 'default')
 #
@@ -111,8 +107,7 @@
 
 ##
 # @AudiodevAlsaOptions:
-#
-# Options of the ALSA audio backend.
+#     Options of the ALSA audio backend.
 #
 # @in: options of the capture stream
 #
@@ -130,8 +125,7 @@
 
 ##
 # @AudiodevSndioOptions:
-#
-# Options of the sndio audio backend.
+#     Options of the sndio audio backend.
 #
 # @in: options of the capture stream
 #
@@ -152,9 +146,8 @@
 
 ##
 # @AudiodevCoreaudioPerDirectionOptions:
-#
-# Options of the Core Audio backend that are used for both playback
-# and recording.
+#     Options of the Core Audio backend that are used for both
+#     playback and recording.
 #
 # @buffer-count: number of buffers
 #
@@ -167,8 +160,7 @@
 
 ##
 # @AudiodevCoreaudioOptions:
-#
-# Options of the coreaudio audio backend.
+#     Options of the coreaudio audio backend.
 #
 # @in: options of the capture stream
 #
@@ -183,8 +175,7 @@
 
 ##
 # @AudiodevDsoundOptions:
-#
-# Options of the DirectSound audio backend.
+#     Options of the DirectSound audio backend.
 #
 # @in: options of the capture stream
 #
@@ -203,9 +194,8 @@
 
 ##
 # @AudiodevJackPerDirectionOptions:
-#
-# Options of the JACK backend that are used for both playback and
-# recording.
+#     Options of the JACK backend that are used for both playback and
+#     recording.
 #
 # @server-name: select from among several possible concurrent server
 #     instances (default: environment variable $JACK_DEFAULT_SERVER if
@@ -237,8 +227,7 @@
 
 ##
 # @AudiodevJackOptions:
-#
-# Options of the JACK audio backend.
+#     Options of the JACK audio backend.
 #
 # @in: options of the capture stream
 #
@@ -253,9 +242,8 @@
 
 ##
 # @AudiodevOssPerDirectionOptions:
-#
-# Options of the OSS backend that are used for both playback and
-# recording.
+#     Options of the OSS backend that are used for both playback and
+#     recording.
 #
 # @dev: file name of the OSS device (default '/dev/dsp')
 #
@@ -275,8 +263,7 @@
 
 ##
 # @AudiodevOssOptions:
-#
-# Options of the OSS audio backend.
+#     Options of the OSS audio backend.
 #
 # @in: options of the capture stream
 #
@@ -305,9 +292,8 @@
 
 ##
 # @AudiodevPaPerDirectionOptions:
-#
-# Options of the Pulseaudio backend that are used for both playback
-# and recording.
+#     Options of the Pulseaudio backend that are used for both
+#     playback and recording.
 #
 # @name: name of the sink/source to use
 #
@@ -330,8 +316,7 @@
 
 ##
 # @AudiodevPaOptions:
-#
-# Options of the PulseAudio audio backend.
+#     Options of the PulseAudio audio backend.
 #
 # @in: options of the capture stream
 #
@@ -349,9 +334,8 @@
 
 ##
 # @AudiodevPipewirePerDirectionOptions:
-#
-# Options of the PipeWire backend that are used for both playback and
-# recording.
+#     Options of the PipeWire backend that are used for both playback
+#     and recording.
 #
 # @name: name of the sink/source to use
 #
@@ -374,8 +358,7 @@
 
 ##
 # @AudiodevPipewireOptions:
-#
-# Options of the PipeWire audio backend.
+#     Options of the PipeWire audio backend.
 #
 # @in: options of the capture stream
 #
@@ -390,9 +373,8 @@
 
 ##
 # @AudiodevSdlPerDirectionOptions:
-#
-# Options of the SDL audio backend that are used for both playback and
-# recording.
+#     Options of the SDL audio backend that are used for both playback
+#     and recording.
 #
 # @buffer-count: number of buffers (default 4)
 #
@@ -405,8 +387,7 @@
 
 ##
 # @AudiodevSdlOptions:
-#
-# Options of the SDL audio backend.
+#     Options of the SDL audio backend.
 #
 # @in: options of the recording stream
 #
@@ -421,8 +402,7 @@
 
 ##
 # @AudiodevWavOptions:
-#
-# Options of the wav audio backend.
+#     Options of the wav audio backend.
 #
 # @in: options of the capture stream
 #
@@ -440,8 +420,7 @@
 
 ##
 # @AudioFormat:
-#
-# An enumeration of possible audio formats.
+#     An enumeration of possible audio formats.
 #
 # @u8: unsigned 8 bit integer
 #
@@ -464,8 +443,7 @@
 
 ##
 # @AudiodevDriver:
-#
-# An enumeration of possible audio backend drivers.
+#     An enumeration of possible audio backend drivers.
 #
 # @jack: JACK audio backend (since 5.1)
 #
@@ -488,8 +466,7 @@
 
 ##
 # @Audiodev:
-#
-# Options of an audio backend.
+#     Options of an audio backend.
 #
 # @id: identifier of the backend
 #
@@ -534,8 +511,7 @@
 
 ##
 # @query-audiodevs:
-#
-# Return information about audiodev configuration
+#     Return information about audiodev configuration
 #
 # Since: 8.0
 ##
-- 
2.55.0



  parent reply	other threads:[~2026-08-31 20:25 UTC|newest]

Thread overview: 49+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-31 20:19 [PATCH v4 00/43] qapi: convert (very) trivial intro sections John Snow
2026-08-31 20:19 ` [PATCH v4 01/43] qapi: convert trivial intro sections for error.json John Snow
2026-08-31 20:19 ` [PATCH v4 02/43] qapi: convert trivial intro sections for acpi-hest.json John Snow
2026-08-31 20:19 ` [PATCH v4 03/43] qapi: convert trivial intro sections for ebpf.json John Snow
2026-08-31 20:19 ` [PATCH v4 04/43] qapi: convert trivial intro sections for compat.json John Snow
2026-08-31 20:19 ` [PATCH v4 05/43] qapi: convert trivial intro sections for vfio.json John Snow
2026-08-31 20:19 ` [PATCH v4 06/43] qapi: convert trivial intro sections for trace.json John Snow
2026-08-31 20:19 ` [PATCH v4 07/43] qapi: convert trivial intro sections for misc-arm.json John Snow
2026-08-31 20:19 ` [PATCH v4 08/43] qapi: convert trivial intro sections for cryptodev.json John Snow
2026-08-31 20:19 ` [PATCH v4 09/43] qapi: convert trivial intro sections for machine-common.json John Snow
2026-08-31 20:19 ` [PATCH v4 10/43] qapi: convert trivial intro sections for accelerator.json John Snow
2026-08-31 20:19 ` [PATCH v4 11/43] qapi: convert trivial intro sections for authz.json John Snow
2026-08-31 20:19 ` [PATCH v4 12/43] qapi: convert trivial intro sections for yank.json John Snow
2026-08-31 20:19 ` [PATCH v4 13/43] qapi: convert trivial intro sections for replay.json John Snow
2026-08-31 20:19 ` [PATCH v4 14/43] qapi: convert trivial intro sections for machine-s390x.json John Snow
2026-08-31 20:19 ` [PATCH v4 15/43] qapi: convert trivial intro sections for acpi.json John Snow
2026-08-31 20:19 ` [PATCH v4 16/43] qapi: convert trivial intro sections for tpm.json John Snow
2026-08-31 20:19 ` [PATCH v4 17/43] qapi: convert trivial intro sections for qdev.json John Snow
2026-08-31 20:19 ` [PATCH v4 18/43] qapi: convert trivial intro sections for control.json John Snow
2026-08-31 20:19 ` [PATCH v4 19/43] qapi: convert trivial intro sections for dump.json John Snow
2026-08-31 20:19 ` [PATCH v4 20/43] qapi: convert trivial intro sections for common.json John Snow
2026-08-31 20:19 ` [PATCH v4 21/43] qapi: convert trivial intro sections for sockets.json John Snow
2026-08-31 20:19 ` [PATCH v4 22/43] qapi: convert trivial intro sections for transaction.json John Snow
2026-08-31 20:19 ` [PATCH v4 23/43] qapi: convert trivial intro sections for stats.json John Snow
2026-08-31 20:19 ` [PATCH v4 24/43] qapi: convert trivial intro sections for job.json John Snow
2026-08-31 20:19 ` [PATCH v4 25/43] qapi: convert trivial intro sections for pci.json John Snow
2026-08-31 20:19 ` [PATCH v4 26/43] qapi: convert trivial intro sections for introspect.json John Snow
2026-08-31 20:19 ` [PATCH v4 27/43] qapi: convert trivial intro sections for rocker.json John Snow
2026-08-31 20:19 ` [PATCH v4 28/43] qapi: convert trivial intro sections for misc-i386.json John Snow
2026-08-31 20:19 ` [PATCH v4 29/43] qapi: convert trivial intro sections for block-export.json John Snow
2026-08-31 20:19 ` John Snow [this message]
2026-08-31 20:19 ` [PATCH v4 31/43] qapi: convert trivial intro sections for block.json John Snow
2026-08-31 20:19 ` [PATCH v4 32/43] qapi: convert trivial intro sections for misc.json John Snow
2026-08-31 20:19 ` [PATCH v4 33/43] qapi: convert trivial intro sections for crypto.json John Snow
2026-08-31 20:19 ` [PATCH v4 34/43] qapi: convert trivial intro sections for cxl.json John Snow
2026-08-31 20:19 ` [PATCH v4 35/43] qapi: convert trivial intro sections for run-state.json John Snow
2026-08-31 20:19 ` [PATCH v4 36/43] qapi: convert trivial intro sections for char.json John Snow
2026-08-31 20:19 ` [PATCH v4 37/43] qapi: convert trivial intro sections for virtio.json John Snow
2026-08-31 20:19 ` [PATCH v4 38/43] qapi: convert trivial intro sections for net.json John Snow
2026-08-31 20:19 ` [PATCH v4 39/43] qapi: convert trivial intro sections for qom.json John Snow
2026-08-31 20:19 ` [PATCH v4 40/43] qapi: convert trivial intro sections for ui.json John Snow
2026-08-31 20:19 ` [PATCH v4 41/43] qapi: convert trivial intro sections for migration.json John Snow
2026-08-31 20:19 ` [PATCH v4 42/43] qapi: convert trivial intro sections for machine.json John Snow
2026-08-31 20:19 ` [PATCH v4 43/43] qapi: convert trivial intro sections for block-core.json John Snow
2026-09-01 11:05 ` [PATCH v4 00/43] qapi: convert (very) trivial intro sections Markus Armbruster
2026-09-01 17:01   ` John Snow
2026-09-02 10:58     ` Markus Armbruster
2026-09-02 17:24       ` John Snow
2026-09-03 10:03         ` 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=20260831201945.287730-31-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 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.