From 13786dc643fe250a9560792ef342751585ea15e9 Mon Sep 17 00:00:00 2001 From: wm4 Date: Mon, 5 Sep 2016 21:07:30 +0200 Subject: audio/out: deprecate device sub-options We have --audio-device, which can force the device. Also add something describing to this extent to the manpage. --- DOCS/man/options.rst | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) (limited to 'DOCS/man/options.rst') diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 6668849320..5d361d10b3 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -995,21 +995,18 @@ Audio ``--audio-device=`` Use the given audio device. This consists of the audio output name, e.g. ``alsa``, followed by ``/``, followed by the audio output specific device - name. + name. The default value for this option is ``auto``, which tries every audio + output in preference order with the default device. You can list audio devices with ``--audio-device=help``. This outputs the device name in quotes, followed by a description. The device name is what - you have to pass to the ``--audio-device`` option. - - The default value for this option is ``auto``, which tries every audio - output in preference order with the default device. - - Note that many AOs have a ``device`` sub-option, which overrides the - device selection of this option (but not the audio output selection). - Likewise, forcing an AO with ``--ao`` will override the audio output - selection of ``--audio-device`` (but not the device selection). + you have to pass to the ``--audio-device`` option. The list of audio devices + can be retrieved by API by using the ``audio-device-list`` property. - Currently not implemented for most AOs. + While the option normally takes one of the strings as indicated by the + methods above, you can also force the device for most AOs by building it + manually. For example ``name/foobar`` forces the AO ``name`` to use the + device ``foobar``. ``--audio-fallback-to-null=`` If no audio device can be opened, behave as if ``--ao=null`` was given. This -- cgit v1.2.3