Hi Mark

On Tue, Feb 3, 2026 at 7:49 PM Mark Cave-Ayland
<[email protected]> wrote:
>
> On 23/01/2026 07:49, [email protected] wrote:
>
> > From: Marc-André Lureau <[email protected]>
> >
> > Signed-off-by: Marc-André Lureau <[email protected]>
> > ---
> >   qemu-options.hx | 22 +++++++++++++++-------
> >   1 file changed, 15 insertions(+), 7 deletions(-)
> >
> > diff --git a/qemu-options.hx b/qemu-options.hx
> > index 455b8be8903..732934a6fa8 100644
> > --- a/qemu-options.hx
> > +++ b/qemu-options.hx
> > @@ -896,11 +896,16 @@ DEF("audiodev", HAS_ARG, QEMU_OPTION_audiodev,
> >       QEMU_ARCH_ALL)
> >   SRST
> >   ``-audiodev [driver=]driver,id=id[,prop[=value][,...]]``
> > -    Adds a new audio backend driver identified by id. There are global
> > -    and driver specific properties. Some values can be set differently
> > -    for input and output, they're marked with ``in|out.``. You can set
> > -    the input's property with ``in.prop`` and the output's property with
> > -    ``out.prop``. For example:
> > +    Adds a new audio backend driver identified by id.
> > +
> > +    If no audio backend is specified, QEMU will attempt to select a
> > +    default one. The ``-display`` option may influence which backend is
> > +    selected.
> > +
> > +    There are global and driver specific properties. Some values can be
> > +    set differently for input and output, they're marked with ``in|out.``.
> > +    You can set the input's property with ``in.prop`` and the output's
> > +    property with ``out.prop``. For example:
> >
> >       ::
> >
> > @@ -2172,8 +2177,11 @@ DEF("display", HAS_ARG, QEMU_OPTION_display,
> >       , QEMU_ARCH_ALL)
> >   SRST
> >   ``-display type``
> > -    Select type of display to use. Use ``-display help`` to list the 
> > available
> > -    display types. Valid values for type are
> > +    Select type of display to use. This may also influence the default
> > +    audio backend selection.
> > +
> > +    Use ``-display help`` to list the available display types. Valid values
> > +    for type are
> >
> >       ``spice-app[,gl=on|off]``
> >           Start QEMU as a Spice server and launch the default Spice client
>
> The documentation changes look fine in terms of describing how one
> option may influence the other, however there is no explicit mention in
> the documentation that selecting a dbus display with no audio backend
> will also use dbus for audio.
>
> Is it possible to mention this somewhere? Otherwise someone would have
> to go digging through the code to figure this out.

would something like that help?

@@ -2191,6 +2192,9 @@ SRST
     ``dbus``
         Export the display over D-Bus interfaces. (Since 7.0)

+        When no audio backend is specified, the dbus audio backend is used
+        by default.
+


-- 
Marc-André Lureau

Reply via email to