Re: [PATCH 07/43] docs: update -soundhw -> -device list

[Thomas Huth <thuth@redhat.com>]

On 21/10/2025 11.02, marcandre.lureau@redhat.com wrote:
> From: Marc-André Lureau <marcandre.lureau@redhat.com>
> 
> (note: I wonder if pcspk was really an option when -soundhw was
> available, since it was not user-creatable)

Running an old version of QEMU:

$ i386-softmmu/qemu-system-i386 -soundhw help
Valid sound card names (comma separated):
sb16        Creative Sound Blaster 16
es1370      ENSONIQ AudioPCI ES1370
ac97        Intel 82801AA AC97 Audio
adlib       Yamaha YM3812 (OPL2)
gus         Gravis Ultrasound GF1
cs4231a     CS4231A
hda         Intel HD Audio
pcspk       PC speaker

... it seems like it was at least selectable there (no clue whether it 
worked as expected, though).

> Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
> ---
>   docs/qdev-device-use.txt | 6 ++++--
>   1 file changed, 4 insertions(+), 2 deletions(-)
> 
> diff --git a/docs/qdev-device-use.txt b/docs/qdev-device-use.txt
> index c98c86d828..043ae46114 100644
> --- a/docs/qdev-device-use.txt
> +++ b/docs/qdev-device-use.txt
> @@ -324,8 +324,10 @@ Map from -soundhw sound card name to -device:
>       gus         -device gus,iobase=IOADDR,irq=IRQ,dma=DMA,freq=F
>       hda         -device intel-hda,msi=MSI -device hda-duplex
>       sb16        -device sb16,iobase=IOADDR,irq=IRQ,dma=DMA,dma16=DMA16,version=V
> -    adlib       not yet available with -device
> -    pcspk       not yet available with -device
> +    adlib       -device adlib,iobase=IOADDR,freq=F
> +
> +    pcspk       Not available with -device,
> +                but audiodev can be set with -machine pcspk-audiodev=<name>
>   
>   For PCI devices, you can add bus=PCI-BUS,addr=DEVFN to control the PCI
>   device address, as usual.

Reviewed-by: Thomas Huth <thuth@redhat.com>