new ac/vc/afm/vfm/ao/vo options

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@7601 b3059339-0415-0410-9bf9-f77b7e298cf2

DOCS/mplayer.1

@@ -783,21 +783,24 @@ Specify the VobSub subtitle id. Valid values range from 0 to 31.
 .B \-abs <value> (OBSOLETE)
 Override audio driver/card buffer size detection, \-ao oss only
 .TP
-.B \-ao <driver>[:<device>]
+.B \-ao <driver1[:device],driver2,...>
-Select audio output driver and optionally device. "device" is valid with
+Specify a priority list of audio output drivers (optionally with device) to be
-SDL, too, it means subdriver then.
+used. "device" is valid with SDL, too, it means subdriver then.
 
 .I NOTE:
 .br
 To get a full list of available drivers, see \-ao help.
+.br
+If the list has a trailing ',' it will fallback to drivers not listed.
 
 .I EXAMPLE
 .PD 0
 .RSs
-.IPs "\-ao oss:/dev/dsp1"
+.IPs "\-ao oss:/dev/dsp1,"
-specifies the sound device to use with OSS (replaces the old \-dsp option)
+try to use OSS with the specified sound device and fallback to others if it
+fails
 .IPs "\-ao sdl:esd"
-specifies the SDL subdriver
+specify the SDL subdriver
 .RE
 .PD 1
 .
@@ -1043,20 +1046,23 @@ vertical resolution.
 Try to change to a better video mode. dga, x11/xv (XF86VidMode) and sdl
 output drivers support it.
 .TP
-.B \-vo <driver>[:<device>]
+.B \-vo <driver1[:device],driver2,...>
-Select video output driver and optionally device. "device" is valid with
+Specify a priority list of video output drivers (optionally with device) to be
-SDL and GGI too, it means subdriver then.
+used. "device" is valid with SDL and GGI, too, it means subdriver then.
 
 .I NOTE:
 .br
 See \-vo help for a full list of available drivers.
+.br
+If the list has a trailing ',' it will fallback to drivers not listed.
 
 .I EXAMPLE:
 .PD 0
 .RSs
-\-vo xmga
+\-vo xmga,xv,
-.br
+Try Matrox kernel driver, then Xv driver, then others
 \-vo sdl:aalib
+specify the SDL subdriver
 .RE
 .PD 1
 .
@@ -1132,38 +1138,36 @@ is centered by default.
 
 .SH "DECODING/FILTERING OPTIONS"
 .TP
-.B \-ac <codec name>
+.B \-ac <[-]codec1,codec2,...>
-Force usage of a specific audio codec, according to its codec name in
+Specify a priority list of audio codecs to be used, according to their codec
-codecs.conf.
+name in codecs.conf. Use a '-' before the codec name to omit it.
 
 .I NOTE:
 .br
 See \-ac help for a full list of available codecs.
+.br
+If the list has a trailing ',' it will fallback to codecs not listed.
 
 .I EXAMPLE:
 .PD 0
 .RSs
-.IPs "\-ac mp3"
-use mp3lib
-.IPs "\-ac mad"
-use libmad
 .IPs "\-ac mp3acm"
-use l3codeca.acm MP3 codec
+force l3codeca.acm MP3 codec
-.IPs "\-ac ac3"
+.IPs "\-ac mad,"
-use AC3 codec
+try libmad first, then fallback to others
-.IPs "\-ac hwac3"
+.IPs "\-ac ,mp3"
-enable hardware AC3 passthrough (see documentation)
+try others first, then fallback to mp3lib
-.IPs "\-ac vorbis"
+.IPs "\-ac hwac3,ac3,"
-use libvorbis
+try hardware AC3 passthrough, then normal AC3 codec, then others
-.IPs "\-ac ffmp3"
+.IPs "\-ac -ffmp3,"
-use FFmpeg's MP3 decoder (SLOW)
+try other codecs except FFmpeg's MP3 decoder
 .RE
 .PD 1
 .
 .TP
-.B \-afm <driver name>
+.B \-afm <driver1,driver2,...>
-Force usage of a specific audio codec family, according to its driver name
+Specify a priority list of audio drivers to be used, according to their driver
-in codecs.conf and fall back to default if it failed.
+name in codecs.conf. It falls back to default if none is ok.
 
 .I NOTE:
 .br
@@ -1173,9 +1177,9 @@ See \-afm help for a full list of available drivers.
 .PD 0
 .RSs
 .IPs "\-afm ffmpeg"
-use FFmpeg's libavcodec (mp1/2/3)
+try FFmpeg's libavcodec (mp1/2/3) first
-.IPs "\-afm acm"
+.IPs "\-afm acm,dshow"
-use a matching Win32 codec
+try Win32 codecs first
 .RE
 .PD 1
 .
@@ -1400,34 +1404,36 @@ bicubic spline
 .PD 1
 .
 .TP
-.B \-vc <codec name>
+.B \-vc <[-]codec1,codec2,...>
-Force usage of a specific video codec, according to its codec name in
+Specify a priority list of video codecs to be used, according to their codec
-codecs.conf.
+name in codecs.conf. Use a '-' before the codec name to omit it.
 
 .I NOTE:
 .br
 See \-vc help for a full list of available codecs.
+.br
+If the list has a trailing ',' it will fallback to codecs not listed.
 
 .I EXAMPLE:
 .PD 0
 .RSs
 .IPs "\-vc divx"
-use Win32/VFW DivX codec
+force Win32/VFW DivX codec, no fallback
-.IPs "\-vc divxds"
+.IPs "\-vc divx4,"
-use Win32/DShow DivX codec
+try divx4linux codec first, then fallback to others
-.IPs "\-vc ffdivx"
+.IPs "\-vc -divxds,-divx,"
-use libavcodec's DivX codec
+try other codecs except Win32 DivX codec
-.IPs "\-vc ffmpeg12"
+.IPs "\-vc ffmpeg12,mpeg12,"
-use libavcodec's MPEG1/2 codec
+try libavcodec's MPEG1/2 codec, then libmpeg2, then others
-.IPs "\-vc divx4"
+.IPs "\-vc ,ffdivx"
-use divx4linux codec
+try others (non-crashing codecs), fallback to libavcodec's DivX codec
 .RE
 .PD 1
 .
 .TP
-.B \-vfm <driver name>
+.B \-vfm <driver1,driver2,...>
-Force usage of a specific video codec family, according to its driver name
+Specify a priority list of video drivers to be used, according to their driver
-in codecs.conf and fall back to default if it failed.
+name in codecs.conf. It falls back to default if none is ok.
 
 .I NOTE:
 .br
@@ -1441,18 +1447,15 @@ See \-vfm help for a full list of available drivers.
 .I EXAMPLE:
 .PD 0
 .RSs
-.IPs "\-vfm ffmpeg"
+.IPs "\-vfm ffmpeg,dshow,vfw"
-use libavcodec codecs
+try the libavcodec, then Directshow, then VFW codecs and fallback to the others, if
-.IPs "\-vfm vfw"
+still none is ok
-use VFW (Win32) codecs
 .IPs "\-vfm odivx"
-use OpenDivX/DivX4 codec (YV12) (same as \-vc odivx but fallback)
+try OpenDivX/DivX4 codecs (YV12) first
-.IPs "\-vfm dshow"
-use DirectShow (Win32) codecs
 .IPs "\-vfm divx4"
-use DivX4 codec (YUY2) (same as \-vc divx4 but fallback)
+try DivX4 codecs (YUY2) first
 .IPs "\-vfm xanim"
-use XAnim codecs
+try XAnim codecs first
 .RE
 .PD 1
 .