Re: [PATCH v4 18/20] audio: add soundhw deprecation notice

[Eric Blake]

On 6/24/20 6:30 AM, Gerd Hoffmann wrote:
> Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
> ---
>   docs/system/deprecated.rst | 9 +++++++++
>   1 file changed, 9 insertions(+)
>
> diff --git a/docs/system/deprecated.rst b/docs/system/deprecated.rst
> index 3a255591c341..4cbf3bba3944 100644
> --- a/docs/system/deprecated.rst
> +++ b/docs/system/deprecated.rst
> @@ -82,6 +82,15 @@ should specify an ``audiodev=`` property.  Additionally, 
> when using
>   vnc, you should specify an ``audiodev=`` propery if you plan to
>   transmit audio through the VNC protocol.
>   
> +Creating sound card devices using ``-soundhw`` (since 5.1)
> +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
> +
> +Sound card devices should be created using ``-device`` instead.  The
> +names are the same for most devices.  The exceptions are ``hda`` which
> +needs two devices (``-device intel-hda --device hda-duplex``) and

Both spellings work, but it looks inconsistent to have one -device and 
the other --device.

> +``pcspk`` which can be activated using ``-machine
> +pcspk-audiodev=<name>``.
> +
>   ``-mon ...,control=readline,pretty=on|off`` (since 4.1)
>   '''''''''''''''''''''''''''''''''''''''''''''''''''''''
>   

--
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3226
Virtualization:  qemu.org | libvirt.org