path: root/DOCS
diff options
authorwm4 <wm4@nowhere>2013-07-21 21:51:51 +0200
committerwm4 <wm4@nowhere>2013-07-21 23:27:31 +0200
commit2111d7bc05721002299703160e0dc37a5e84a94b (patch)
treed1665284b3eedb219d4021ba750b0fc5148c0b3b /DOCS
parent38f81c618eb55b3e022c33482986b515e25be554 (diff)
ao_alsa: use new option API (changes syntax)
This changes how device names are handled. Before this commit, device names were mangled in strange ways to avoid clashing with the option parser syntax. "." was replaced with ",", and "=" with ":" (the user had to do the inverse to get the correct device name). The "new" option parser has multiple ways to escape option strings, so we don't need this confusing hack anymore. Add an explicit note to the manpage as well.
Diffstat (limited to 'DOCS')
1 files changed, 10 insertions, 3 deletions
diff --git a/DOCS/man/en/ao.rst b/DOCS/man/en/ao.rst
index 8ccb8a6711..82f77c6e6d 100644
--- a/DOCS/man/en/ao.rst
+++ b/DOCS/man/en/ao.rst
@@ -25,13 +25,20 @@ Available audio output drivers are:
``alsa`` (Linux only)
ALSA 0.9/1.x audio output driver
- ``noblock``
+ ``no-block``
Sets noblock-mode.
- Sets the device name. Replace any ',' with '.' and any ':' with '=' in
- the ALSA device name. For hwac3 output via S/PDIF, use an "iec958" or
+ Sets the device name. For ac3 output via S/PDIF, use an "iec958" or
"spdif" device, unless you really know how to set it correctly.
+ .. note::
+ MPlayer and mplayer2 required you to replace any ',' with '.' and
+ any ':' with '=' in the ALSA device name. mpv does not do this anymore.
+ Instead, quote the device name:
+ ``--ao=alsa:device=[plug:surround50]``
OSS audio output driver