applied goth (Jonas Jermann)'s patch

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

1 files changed, 790 insertions, 767 deletions

diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1
index 82b65f09a4..0487d34ca2 100644
--- a/DOCS/mplayer.1
+++ b/DOCS/mplayer.1
@@ -1,513 +1,555 @@
-.\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users>
+
 .\" This manpage was/is done by Gabucino
-.\"
-.TH MPlayer 1
-.SH NAME
+.\" 
+.TH "MPlayer" "1" "2002-04-13"
+
+.SH "NAME"
 mplayer \- Movie Player for Linux
-.SH SYNOPSIS
+
+.SH "SYNOPSIS"
+.B mplayer
+.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ |\ ...]
+.br
+.B mplayer
+.RB [global\ options]\ \fIfile1\fP\ [specific\ options]\ [file2]\ [specific\ options]\ ...
+.br
+.B mplayer
+.RB [global\ options]\ {\fIgroup\ of\ files\ and\ options\fP}\ [group\ specific\ options]\ ...
+.br
+.B mplayer
+.RB [dvd|vcd|tv]://[id|options]
+
+.SH "DESCRIPTION"
 .B mplayer
-.RB [ \-gui ]
-.RB [ \-v ]
-.RB [ \-help / -h / --help ]
-.RB [ \-quiet ]
-.RB [ \-vo\ <driver>[:<device>] ]
-.RB [ \-ao\ <driver>[:<device>] ]
-.RB [ \-vcd\ <track\ number> ]
-.RB [ \-cdrom-device\ <path\ to\ device> ]
-.RB [ \-sb\ <byte\ position> ]
-.RB [ \-nosound ]
-.RB [ \-audiofile\ <filename> ]
-.RB [ \-subfile\ <filename> ]
-.RB [ \-abs\ <bytes> ]
-.RB [ \-delay\ <secs> ]
-.RB [ \-nobps ]
-.RB [ \-aid\ <id> ]
-.RB [ \-alang\ <audio\ stream\ languages> ]
-.RB [ \-vid\ <id> ]
-.RB [ \-fps\ <rate> ]
-.RB [ \-mc\ <seconds/5f> ]
-.RB [ \-fs ]
-.RB [ \-dr ]
-.RB [ \-vm ]
-.RB [ \-zoom ]
-.RB [ \-x\ <x> ]
-.RB [ \-y\ <y> ]
-.RB [ \-sws\ <software\ scaler\ type> ]
-.RB [ \-xy\ <factor> ]
-.RB [ \-pp\ <quality> ]
-.RB [ \-include\ <config\ file> ]
-.RB [ \-lircconf\ <config\ file> ]
-.RB [ \-ffactor\ <number> ]
-.RB [ \-sub\ <filename> ]
-.RB [ \-subfps\ <rate> ]
-.RB [ \-subdelay\ <seconds> ]
-.RB [ \-vobsub\ <vobsub\ file\ without\ extention> ]
-.RB [ \-vobsubid\ <vobsub\ subtitle\ id> ]
-.RB [ \-ifo\ <vobsub\ ifo\ file> ]
-.RB [ \-z\ <0-9> ]
-.RB [ \-idx ]
-.RB [ \-noidx ]
-.RB [ \-forceidx ]
-.RB [ \-nodshow ]
-.RB [ \-noxv ]
-.RB [ \-forcexv ]
-.RB [ \-ss\ <time> ]
-.RB [ \-dumpaudio ]
-.RB [ \-dumpvideo ]
-.RB [ \-dumpstream ]
-.RB [ \-noframedrop ]
-.RB [ \-framedrop ]
-.RB [ \-double ]
-.RB [ \-stereo\ <mode> ]
-.RB [ \-channels\ <n> ]
-.RB [ \-srate\ <Hz> ]
-.RB [ \-osdlevel\ <level> ]
-.RB [ \-config\ <file> ]
-.RB [ \-display\ <name> ]
-.RB [ \-xineramascreen\ <screen\ number> ]
-.RB [ \-wid\ <window\ id> ]
-.RB [ \-unicode ]
-.RB [ \-utf8 ]
-.RB [ \-fsmode\ <mode> ]
-.RB [ \-vc\ <video\ codec\ name> ]
-.RB [ \-ac\ <audio\ codec\ name> ]
-.RB [ \-vfm\ <video\ codec\ family> ]
-.RB [ \-afm\ <audio\ codec\ family> ]
-.RB [ \-frames\ <number> ]
-.RB [ \-autoq\ <quality> ]
-.RB [ \-fb\ <device> ]
-.RB [ \-fbmode\ <modename> ]
-.RB [ \-fbmodeconfig\ <filename> ]
-.RB [ \-monitor_hfreq\ <horizontal\ frequency\ range> ]
-.RB [ \-monitor_vfreq\ <vertical\ frequency\ range> ]
-.RB [ \-monitor_dotclock\ <dotclock\ (or\ pixelclock)\ range> ]
-.RB [ \-benchmark ]
-.RB [ \-dvd\ <title\ id> ]
-.RB [ \-dvd-device\ <path\ to\ device> ]
-.RB [ \-chapter\ <chapter\ id> ]
-.RB [ \-dvdangle\ <angle\ id> ]
-.RB [ \-alang\ <country\ code> ]
-.RB [ \-slang\ <country\ code> ]
-.RB [ \-sid\ <subtitle \id> ]
-.RB [ \-dvdkey\ <key> ]
-.RB [ \-skin\ <skin\ name> ]
-.RB [ \-aspect\ <ratio> ]
-.RB [ \-monitoraspect\ <ratio> ]
-.RB [ \-subcp\ <codepage> ]
-.RB [ \-dumpmpsub ]
-.RB [ \-dumpfile ]
-.RB [ \-dumpsub ]
-.RB [ \-screenw\ <pixels> ]
-.RB [ \-screenh\ <pixels> ]
-.RB [ \-cache\ <kbytes> ]
-.RB [ \-bpp\ <depth> ]
-.RB [ \-flip ]
-.RB [ \-playlist\ <filename> ]
-.RB [ \-slave ]
-.RB [ \-loop\ <num> ]
-.RB [ \-mixer\ <device> ]
-.RB [ \-tv\ <suboptions> ]
-.RB [ \-dapsync ]
-.RB [ \-softsleep ]
-.RB [ \-rootwin ]
-.RB [ \-font\ <path\ to\ font.desc\ file> ]
-.RB [ \-conf\ <path\ to\ input.conf\ file> ]
-.RB [ \-input\ <commands> ]
-.RB [ \-nojoystick ]
-.RB [ \-nolirc ]
-.RB [ \-demuxer\ <number> ]
-.RB [ \-audio-demuxer\ <number> ]
-.RB [ \-sub-demuxer\ <number> ]
-.RB [ \-hr-mp3-seek ]
-.I < - | file | URL | device >
-.PP
-.SH DESCRIPTION
-.I mplayer
-MPlayer is a movie player for LINUX (runs on many other Unices, and non-x86
-CPUs, see section 6). It plays most MPEG, AVI, MOV/QT and ASF/WMV files, supported by
-many native and Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, and even
-DivX movies too (and you don't need the avifile library at all!).
-
-Another big feature of mplayer is the wide range of supported output drivers :
-X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, GGI, SDL (and all the drivers
-they support), VESA (on every VESA compatible card, even without X!), and some
-lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too! Most of them
-supports software or hardware scaling, so you can enjoy movies in fullscreen.
-
-Several subtitles types are supported (curently 9 !) and the fonts are
-rendered with nice big antialiased shaded fonts ! Of course there is support
-for european/ISO 8859-1,2 (hungarian, english, czech, etc), cyrillic, korean
-fonts.
-.LP
+is a movie player for LINUX (runs on many other Unices, and non\-x86
+CPUs, see section 6). It plays most MPEG, VOB, AVI, VIVO, ASF/WMV, QT/MOV, FLI,
+RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and
+Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, and even DivX movies too
+(and you don't need the avifile library at all!).
+
+Another big feature of mplayer is the wide range of supported output drivers.
+It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use
+GGI and SDL (and this way all their drivers) and some lowlevel card-specific drivers
+(for Matrox, 3Dfx and Radeon) too!
+.br
+Most of them supports software or hardware scaling, so you can enjoy movies in fullscreen.
+MPlayer supports displaying through some hardware MPEG decoder boards, such as the DVB and
+DXR3/Hollywood+!
+
+Nice big antialiased shaded subtitles with european/ISO 8859-1,2 (hungarian, english, czech, 
+etc), cyrillic, korean fonts are supported (10 supported subtitle formats: MicroDVD, SubRip, 
+SubViewer, SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, VobSub, and our 
+own: MPsub).
+
 .SH "GUI OPTIONS"
 .I NOTE:
-The GUI code has to be compiled in *explicitly*, for details see the
-documentation.
-.TP
+The GUI code has to be compiled in *explicitly* (see documentation).
+.TP 
 .B \-gui
-start MPlayer in GUI mode.
-.TP
+Start MPlayer in GUI mode.
+.TP 
 .B \-skin <skin\ directory>
-load skin from this directory (WITHOUT path name!). For example '-skin fittyfene' tries these :
+Load skin from this directory (WITHOUT path name!). For example '\-skin fittyfene' tries these:
 
     /usr/local/share/mplayer/Skin/fittyfene
     ~/.mplayer/Skin/fittyfene
-.LP
+
 .SH "DVD OPTIONS"
 .I NOTE:
-These options are valid only with DVD support compiled in. For details,
-see the documentation.
+These options are valid only with DVD support compiled in (see documentation).
+.br
 .I NOTE:
-DVD playback sometimes requires deinterlacing: see '-pp 0x20000' or '-npp lb' options.
-.TP
-.B \-dvd\ titleid
-tell MPlayer which movies (marked with titleid) to play. For example
-sometimes '1' are trailers, and '2' is the real movie.
-.TP
-.B \-dvd-device\ <path\ to\ device>
-override default DVD device name /dev/dvd
-.TP
+DVD playback sometimes requires deinterlacing: see '\-pp 0x20000' or '\-npp lb' options.
+.TP 
+.B \-alang\ <audio\ stream\ language>
+Used when playing DVD disks. Expects a two\-letter country code(s) as
+parameter, and always tries to play back audio streams those language
+matches the given code. For example: \-alang hu,en will always try to play
+hungarian or if it's non\-existant then english audio streams if there are any.
+.TP 
 .B \-chapter\ <chapter\ id>
-specify which chapter to start playing at. Optionally specify which chapter to
+Specify which chapter to start playing at. Optionally specify which chapter to
 end playing at. Examples can be found below.
-.TP
+.TP 
+.B \-csslib <filename>
+(old-style DVD option) This option is used to override the default location of libcss.so
+.TP 
+.B \-dvd\ <title\ id>
+Tell MPlayer which movies (marked with titleid) to play. For example
+sometimes '1' are trailers, and '2' is the real movie.
+.TP 
+.B \-dvd\-device\ <path\ to\ device>
+Override default DVD device name /dev/dvd
+.TP 
 .B \-dvdangle\ <angle\ id>
-some DVD discs contain scenes that can be viewed from multiple angles.
+Some DVD discs contain scenes that can be viewed from multiple angles.
 Here you can tell MPlayer which angles to use. Examples can be found below.
-.TP
-.B \-alang\ <audio\ stream\ language>
-Used when playing DVD disks. Expects a two-letter country code(s) as
-parameter, and always tries to play back audio streams those language
-matches the given code. For example: -alang hu,en will always try to play
-hungarian or if it's non-existant then english audio streams if there are any.
-.TP
-.B \-slang\ <subtitle\ language>
-See the -sid option, but this one needs a two-letter parameter, a country code.
-Like: -slang hu,en will always select hungarian or if it's non existant then
-english subtitles, if there are any. For the list of available subtitles, use
-with the -v switch and look at the output.
-.TP
+.TP 
+.B \-dvdauth <DVD\ device>
+(old-style DVD option) Turns on DVD authentication using the given device.
+.TP 
+.B \-dvdkey <CSS\ key>
+(old-style DVD option) When decoding from non-DVD, this option gives the CSS key needed 
+to crack the DVD (the key is printed when authenticating with DVD).
+.TP 
+.B \-dvdnav 
+Force usage of libdvdnav.
+.TP 
 .B \-sid\ <id>
 Turns on DVD subtitle displaying. Also, you MUST specify a number which
-corresponds to a DVD subtitle language (0-31). For the list of available
-subtitles, use with the -v switch and look at the output.
-.LP
+corresponds to a DVD subtitle language (0\-31). For the list of available
+subtitles, use with the \-v switch and look at the output.
+.br
+.I NOTE:
+Use \-slang to define the subtitle language by name.
+.TP 
+.B \-skipopening
+Skip dvd opening (dvdnav only).
+.TP 
+.B \-slang\ <subtitle\ language>
+See the \-sid option, but this one needs a two\-letter parameter, a country code.
+Like: \-slang hu,en will always select hungarian or if it's non existant then
+english subtitles, if there are any. For the list of available subtitles, use
+with the \-v switch and look at the output.
+ 
 .SH "GENERAL OPTIONS"
-.TP
-.I NOTE
-Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs
-.TP
-.B \-vo\ <driver>[:<device>]
-select video output driver and optinaly device. "device" is valid with
-SDL and GGI too, it means sub-driver then (for example: -vo sdl:aalib).
-
-you can get the list of available drivers executing
-.I mplayer -vo help
-
-.TP
+.I NOTE:
+Every "flag" option has "noflag" pair, e.g. \-fs opposite is \-nofs
+.TP 
 .B \-ao\ <driver>[:<device>]
-select audio output driver and optinaly device. "device" is valid with
-SDL too, it means sub-driver then (for example: -vo sdl:esd).
+Select audio output driver and optinaly device. "device" is valid with
+SDL too, it means sub\-driver then (for example: \-vo sdl:esd).
+If using OSS, you can specify which sound device to use like this:
 
-If using OSS, you can specify which sound device to use like this :
--ao oss:/dev/dsp1     (replaces the old -dsp option)
+    \-ao oss:/dev/dsp1     (replaces the old \-dsp option)
 
-you can get the list of available drivers executing
-.I mplayer -ao help
+You can get the list of available drivers executing
+.I mplayer \-ao help
+.TP 
+.B \-aspect <ratio>
+Set aspect ratio of movies. It's autodetected on MPEG files, and can't be
+autodetected on AVI files. Examples:
 
-.TP
-.B \-vcd\ <track>
-play video cd track from device instead of plain file
-.TP
-.B \-cdrom-device\ <path\ to\ device>
-override default CDROM drive name /dev/cdrom
-.TP
-.B \-nosound
-don't play sound
-.TP
+    \-aspect 4:3  or \-aspect 1.3333
+    \-aspect 16:9 or \-aspect 1.7777
+.TP 
 .B \-audiofile\ <filename>
-play audio from an external file (MP3, AC3, Vorbis, etc)
-.TP
-.B \-fs
-fullscreen playing (centers movie, and makes black
-bands around it). Toggle it with the 'f' key (not all video
-outputs support it).
-.TP
-.B \-dr
-turns on direct rendering (not supported by all codecs and video outputs).
-Default is off.
-.TP
-.B \-vm
-try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl
-output drivers support it.
-.TP
-.B \-zoom
-use software scaling, where available (use with -nofs). svga, x11, vesa
-output drivers support it.
-.TP
-.B \-flip
-flip image (useful for example for old Indeo codecs). Supported only(?)
-by the 'sdl' and 'x11' outputs.
-.TP
-.B \-x\ <x>
-scale image to x width (if driver suppports)
-.TP
-.B \-y\ <y>
-scale image to y height (if driver supports)
-.TP
-.B \-sws\ <software\ scaler\ type>
-this option sets the quality (and speed, respectively) of the software scaler,
-with the -zoom option. For example with x11 or other outputs which lack
-hardware acceleration. Possible settings are :
-
-    0 - fast bilinear (default)
-    1 - bilinear
-    2 - bicubic (best quality)
-    3 - ?
-    4 - nearest neighbor (bad quality)
-    5 - area averageing scaling support
-.TP
-.B \-xy\ <factor>
-scale image by <factor>
-.TP
+Play audio from an external file (MP3, AC3, Vorbis, etc)
+.TP 
 .B \-autoq\ <quality>
-dynamically changes the level of postprocess, depending on spare CPU time
+Dynamically changes the level of postprocess, depending on spare CPU time
 available. The number you specify will be the maximum level used. Usually you
-can use some big number. You may not use together with -pp but it's ok with
--npp !
-.TP
+can use some big number. You may not use together with \-pp but it's ok with
+\-npp!
+.TP 
+.B \-benchmark
+Used in combination with \-nosound and \-vo null for benchmarking.
+.TP 
+.B \-cdrom\-device\ <path\ to\ device>
+Override default CDROM drive name /dev/cdrom
+.TP 
+.B \-conf\ <path\ to\ input.conf\ file>
+Get input bindings from an alternative input.conf file (default:
+~/.mplayer/input.conf).
+.TP 
+.B \-dr
+Turns on direct rendering (not supported by all codecs and video outputs)
+(default is off).
+.TP 
 .B \-ffactor\ <number>
-resample alphamap of the font. Can be:
+Resample alphamap of the font. Can be:
 
-        0    plain white fonts
-        0.75 very narrow black outline [default]
-        1    narrow black outline
-        10   bold black outline
+    0    plain white fonts
+    0.75 very narrow black outline [default]
+    1    narrow black outline
+    10   bold black outline
+.TP 
+.B \-font\ <path\ to\ font.desc\ file>
+Search for the OSD/SUB fonts in an alternative directory (default:
+~/.mplayer/font/font.desc). For example:
+
+    \-font ~/.mplayer/arial\-14/font.desc
+.TP 
+.B \-fs
+Fullscreen playing (centers movie, and makes black
+bands around it). Toggle it with the 'f' key (not all video
+outputs support it).
 .TP
+.B \-h, --help
+Show short summary of options
+.TP 
+.B \-ifo <vobsub\ ifo\ file>
+Indicate the file that will be used to load palette and frame size for VOBSUB
+subtitles.
+.TP 
+.B \-lircconf\ <config\ file>
+Specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc
+.TP 
+.B \-loop\ <num>
+Loops movie playback <num> times. 0 means forever.
+.TP
+.B \-mf\ <multifile\ options>
+Used when decoding from multiple JPEG files. The sub\-options are separated by ":"
+(see documentation). They are:
+
+    on            turns on multifile support
+    w=<value>     width of the output
+    h=<value>     height of the output
+    fps=<value>   fps of the output
+    type=<value>  type of input files (available types : jpeg, png)
+.TP 
+.B \-mixer\ <device>
+This option will tell MPlayer to use a different device for mixing than
+/dev/mixer.
+.TP 
+.B \-monitoraspect <ratio>
+Set aspect ratio of your screen. Examples:
+
+    \-monitoraspect 4:3  or 1.3333
+    \-monitoraspect 16:9 or 1.7777
+.TP 
+.B \-noautosub
+Turns off automatic subtitles
+.TP 
+.B \-nosound
+Don't play sound
+.TP 
+.B \-osdlevel\ <level>
+Specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer)
+(default = 2)
+.TP 
+.B \-playlist <file>
+Play files according to this filelist (1 file/row or Winamp or ASX format).
+.TP 
+.B \-quiet
+Display less output, status messages.
+.TP 
+.B \-rootwin
+Play movie in the root window (desktop background) instead of opening
+a new one. Works only with the xv and xmga drivers.
+.TP 
+.B \-ss\ <time> (see \-sb option too!)
+Seek to given time position. For example:
+
+    \-ss 56         seeks to 56 seconds
+    \-ss 01:10:00   seeks to 1 hour 10 min
+.TP 
 .B \-sub\ <subtitle\ file>
-use/display this subtitle file
-.TP
+Use/display this subtitle file
+.TP 
+.B \-subdelay\ <sec>
+Delays subtitles by <sec> seconds. Can be negative.
+.TP 
 .B \-subfps\ <rate>
-specify frame/sec rate of subtitle file (float number)
-(ONLY for frame-based SUB files, i.e. NOT MicroDVD format!)
+Specify frame/sec rate of subtitle file (float number)
+(ONLY for frame\-based SUB files, i.e. NOT MicroDVD format!)
 (default: the same fps as the movie)
-.TP
-.B \-subdelay\ <sec>
-delays subtitles by <sec> seconds. Can be negative.
+.TP 
+.B \-subpos <0 \- 100>
+Specify the position of subtitles
+.TP 
+.B \-sws\ <software\ scaler\ type>
+This option sets the quality (and speed, respectively) of the software scaler,
+with the \-zoom option. For example with x11 or other outputs which lack
+hardware acceleration. Possible settings are:
+
+    0 \- fast bilinear (default)
+    1 \- bilinear
+    2 \- bicubic (best quality)
+    3 \- ?
+    4 \- nearest neighbor (bad quality)
+    5 \- area averageing scaling support
+.TP 
+.B \-tv\ <sub\-options>
+This option enables the TV grabbing feature of MPlayer. The sub\-options are separated
+by ":" (see documentation). They are:
+
+    on                use TV input
+    noaudio           no sound
+    driver=<value>    available: dummy, v4l
+    device=<value>    specify other device than the default /dev/video0
+    input=<value>     available: television, s-video, composite, etc
+    freq=<value>      specify the frequency to set the tuner (e.g. 511.250)
+    outfmt=<value>    output format of the tuner (rgb32, rgb24, yv12, uyvy, i420)
+    width=<value>     the width of the output window
+    height=<value>    the height of the output window
+    norm=<value>      available: PAL, SECAM, NTSC
+    channel=<value>   set the tuner to the given channel
+    chanlist=<value>  available: us-bcast, us-cable, europe-west, europe-east, etc
+.TP 
+.B \-v
+Enable verbose output (more \-v means more verbosity)
+.TP 
+.B \-vcd\ <track>
+Play video cd track from device instead of plain file
+.TP 
+.B \-vm
+Try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl
+output drivers support it.
+.TP 
+.B \-vo\ <driver>[:<device>]
+Select video output driver and optinally device. "device" is valid with
+SDL and GGI too, it means sub\-driver then (for example: \-vo sdl:aalib).
+
+You can get the list of available drivers executing
+.I mplayer \-vo help
 .TP
 .B \-vobsub\ <vobsub\ file\ without\ extention>
-specify the VobSub files that are to be used for subtitle.  This is
+Specify the VobSub files that are to be used for subtitle. This is
 the full pathname without extensions, i.e. without the ".idx", ".ifo"
 or ".sub".
-.TP
+.TP 
 .B \-vobsubid\ <vobsub\ subtitle\ id>
-specify the VobSub subtitle id.  Valid values range from 0 to 31.
-.TP
-.B \-ifo <vobsub ifo file>
-indicate the file that will be used to load palette and frame size for VOBSUB
-subtitles.
-.TP
-.B \-osdlevel\ <level>
-specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer)
-(default = 2)
-.TP
-.B \-lircconf\ <config\ file>
-specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc
-.TP
-.B \-v
-enable verbose output (more -v means more verbosity)
-.TP
-.B \-quiet
-display less output, status messages.
-.TP
-.B \-benchmark
-used in combination with -nosound and -vo null for benchmarking.
-.TP
-.B \-aspect <ratio>
-set aspect ratio of movies. It's autodetected on MPEG files, and can't be
-autodetected on AVI files. Examples:
-
-    -aspect 4:3  or -aspect 1.3333
-    -aspect 16:9 or -aspect 1.7777
+Specify the VobSub subtitle id. Valid values range from 0 to 31.
 
+.SH "ADVANCED OPTIONS"
+.I NOTE:
+These options can help you solve your particular problem (see documentation too!).
 .TP
-.B \-monitoraspect <ratio>
-set aspect ratio of your screen. Examples:
-
-    -monitoraspect 4:3  or 1.3333
-    -monitoraspect 16:9 or 1.7777
-
-.TP
-.B \-playlist <file>
-play files according to this filelist (1 file/row or Winamp or ASX format).
-.TP
-.B \-ss\ <time>
-seek to given time position. For example :
-
-    -ss 56         seeks to 56 seconds
-    -ss 01:10:00   seeks to 1 hour 10 min
-
-.TP
-.B \-loop\ <num>
-loops movie playback <num> times. 0 means forever.
-.TP
-.B \-mixer\ <device>
-this option will tell MPlayer to use a different device for mixing than
-/dev/mixer.
-.TP
-.B \-master
-obsoleted option, use Software audio mixer plugin instead (see DOCS).
-.TP
-.B \-tv\ <suboptions>
-this option enables the TV grabbing feature of MPlayer. For complete
-documentation, please see documentation.html chapter 2.5
-.TP
-.B \-rootwin
-play movie in the root window (desktop background) instead of opening
-a new one. Works only with the xv and xmga drivers.
+.B \-aa*
+Used for \-vo aa. You can get a list and an explanation of available options executing
+.I mplayer \-aahelp
+.TP 
+.B \-abs\ <bytes>
+Sound card audio buffer size (in bytes, default: measuring)
+.TP 
+.B \-ac <name>
+Force usage of a specific audio codec, according to its name in codecs.conf,
+for example:
+
+    \-ac mp3        use libmp3 MP3 codec
+    \-ac mp3acm     use l3codeca.acm MP3 codec
+    \-ac ac3        use AC3 codec
+    \-ac hwac3      enable Hardware AC3 passthrough (see documentation)
+    \-ac vorbis     use libvorbis
+    \-ac ffmp3      use ffmpeg's MP3 decoder (SLOW)
+
+See '\-ac help' for FULL list!
+.TP 
+.B \-aid\ <id>
+Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...]
+.br
+.I NOTE:
+Use \-alang to define the language by name.
 .TP
-.B \-font\ <path\ to\ font.desc\ file>
-search for the OSD/SUB fonts in an alternative directory (default :
-~/.mplayer/font/font.desc). For example:
-
-    -font ~/.mplayer/arial-14/font.desc
+.B \-aofile <filename>
+Filename for \-ao pcm.
 .TP
-.B \-conf\ <path\ to\ input.conf\ file>
-get input bindings from an alternative input.conf file (default :
-~/.mplayer/input.conf).
-.IP
-.SH "ADVANCED OPTIONS"
+.B \-aop\ <sub\-options>
+Specify audio plugin(s) and their options (see documentation!!).
+.TP 
+.B \-audio\-demuxer <number>
+Force audio demuxer type for \-audiofile. Give the demuxer ID as defined in
+demuxers.h.
 .TP
-.I NOTE
-These options can help you solve your particular problem.. Also, see the
-documentation !
+.B \-blue_intensity <\-1000\ \-\ 1000>
+Adjust intensity of blue component of video signal (default 0).
+.TP 
+.B \-bpp\ <depth>
+Use different color depth than autodetect. Not all \-vo drivers support
+it (fbdev, dga2, svga, vesa).
 .TP
-.B \-vc <name>
-force usage of a specific video codec, according to its name in codecs.conf,
-for example :
+.B \-brightness <\-1000\ \-\ 1000>
+Adjust brightness of video output (default 0). It changes intensity of 
+RGB components of video signal from black to white screen.
+.TP 
+.B \-cache\ <kbytes>
+This option specifies how much memory to use when precaching a file/URL.
+Especially useful on slow media (default is \-nocache).
+.TP 
+.B \-channels <n>
+Select number of audio output channels to be used
 
-    -vc divx       use VFW DivX codec
-    -vc divxds     use DirectShow DivX codec
-    -vc ffdivx     use libavcodec's DivX codec
-    -vc ffmpeg12   use libavcodec's MPEG1/2 codec
-    -vc divx4      use ProjectMayo's DivX codec
+    Stereo         2
+    Surround       4
+    Full 5.1       6
 
-See '-vc help' for FULL list !
+Currently this option is only honoured for AC3 audio.
+.TP 
+.B \-config <config\ file>
+Specifies where to search for config file
 .TP
-.B \-ac <name>
-force usage of a specific audio codec, according to its name in codecs.conf,
-for example :
-
-    -ac mp3        use libmp3 MP3 codec
-    -ac mp3acm     use l3codeca.acm MP3 codec
-    -ac ac3        use AC3 codec
-    -ac hwac3      enable Hardware AC3 passthrough
-                   (see documentation)
-    -ac vorbis     use libvorbis
-    -ac ffmp3      use ffmpeg's MP3 decoder (SLOW)
-
-See '-ac help' for FULL list !
+.B \-contrast <\-1000\ \-\ 1000>
+Adjust contrast of video output (default 0). Works in similar manner as brightness.
+.TP 
+.B \-delay\ <secs>
+Audio delay in seconds (may be +/\- float value)
+.TP 
+.B \-demuxer <number>
+Force demuxer type. Give the demuxer ID as defined in demuxers.h.
+.TP 
+.B \-display <name>
+Specify the hostname and display number of the X server you want
+to display on. For example: \-display xtest.localdomain:0
+.TP 
+.B \-dumpaudio
+Writes audio stream of the file to ./stream.dump (mostly usable
+with mpeg/ac3)
 .TP
-.B \-vfm <1-12>
-force usage of a specific codec FAMILY, and FALLBACK to default if failed.
-For example:
-
-    -vfm 2         use VFW (Win32) codecs
-    -vfm 3         use OpenDivX/DivX4 codec (YV12)
-                   (same as -vc odivx but fallback)
-    -vfm 4         use DirectShow (Win32) codecs
-    -vfm 5         use libavcodec codecs
-    -vfm 7         use DivX4 codec (YUY2)
-                   (same as -vc divx4 but fallback)
-    -vfm 10        use XAnim codecs
+.B \-dumpfile <filename>
+Specify to which file MPlayer should dump to. Should be used together 
+with \-dumpaudio/\-dumpvideo.
+.TP 
+.B \-dumpmpsub
+Convert the given subtitle (specified with the \-sub switch) to MPlayer's
+subtitle format, MPsub. Creates a dump.mpsub file in current directory.
+.TP 
+.B \-dumpstream
+Dumps the file to ./stream.dump . Useful for example
+when ripping from DVD.
+.TP 
+.B \-fb\ <device> (FBdev or DirectFB only)
+Specifies the framebuffer device to use. By default it uses /dev/fb0.
+.TP 
+.B \-fbmode\ <modename> (FBdev only)
+Change videomode to the one that is labelled as <modename> in /etc/fb.modes.
+.br
+.I NOTE:
+VESA framebuffer doesn't support mode changing.
+.TP 
+.B \-fbmodeconfig\ <filename> (FBdev only)
+Use this config file instead of the default /etc/fb.modes.
+Only valid for the fbdev driver.
+.TP 
+.B \-forceidx
+Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc).
+Seeking will be possible. You can fix the index permanently with
+MEncoder (see the documentation).
+.TP 
+.B \-forcexv (SDL only)
+Force using XVideo
+.TP 
+.B \-fps\ <value>
+Force frame rate (if value is wrong in the header) (float number)
+.TP 
+.B \-framedrop (see \-hardframedrop option too!)
+Frame dropping: decode all frames, video may skip
+.TP 
+.B \-frames\ <number>
+MPlayer plays <number> frames, then quits.
+.TP 
+.B \-fsmode\ <mode>
+This option workarounds some problems when using specific windowmanagers and
+fullscreen mode. If you experience fullscreen problems, try changing this
+value between 0 and 7.
 
-See -vc help for FULL list !
+    \-fsmode 0      new method
+    \-fsmode 1      ICCCWM patch
+                   (for KDE2/icewm)
+    \-fsmode 2      old method
+    \-fsmode 3      ICCCWM patch
+                   plus Motif method
+.TP
+.B \-green_intensity <\-1000\ \-\ 1000>
+Adjust intensity of green component of video signal (default 0).
+.TP
+.B \-hardframedrop
+More intense frame dropping (breaks decoding). Leads to image disortion!
+.TP 
+.B \-hr\-mp3\-seek
+Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, as
+we need to seek to the very exact position to keep A/V sync. It can be slow
+especially when seeking backwards \- it has to rewind to the beginning to find
+the exact frame.
+.TP
+.B \-hue <\-1000\ \-\ 1000>
+Adjust hue of video signal (default 0). You can get colored negative
+of image with this option.
+.TP 
+.B \-idx (see \-forceidx option too!)
+Rebuilds INDEX of the AVI, thus allowing seeking. Useful with broken/incomplete
+downloads, or badly created AVIs.
+.TP 
+.B \-include <configfile>
+Specify config file to be parsed after the default
+.TP 
+.B \-input <commands>
+This option can be used to configure certain parts of the input system.
+        conf=<file> read alternative input.conf.
+                    If given without pathname,
+                    $HOME/.mplayer is assumed.
+        ar\-delay    delay in msec before we start
+                    to autorepeat a key
+                    (0 to disable)
+        ar\-rate     how many keypress/second when
+                    we autorepeat
+        keylist     prints all keys that can be
+                    bound to
+        cmdlist     prints all commands that can
+                    be bound
 
 .I NOTE:
-if libdivxdecore support was compiled in, then type 3 and 7 now contains
-just the same DivX4 codec, but different APIs to reach it. For difference
-between them and when to use which, check the DivX4 section in the
-documentation.
-.TP
-.B \-afm <1-12>
-force usage of a specific audio format. For example:
-
-    -afm 1         use libmp3 (mp2/mp3, but not mp1)
-    -afm 2         suppose raw PCM audio
-    -afm 3         use libac3
-    -afm 4         use a matching Win32 codec
-    -afm 5         use aLaw/uLaw driver
-    -afm 10        use libvorbis
-    -afm 11        use ffmpeg's MP3 decoder (even mp1)
-
-See -ac help for FULL list !
+Autorepeat is currently only supported by joysticks.
+.TP 
+.B \-mc\ <seconds/5frame>
+Maximum sync correction per 5 frames (in seconds)
+.TP 
+.B \-monitor_dotclock <dotclock\ (or\ pixelclock) range>  (FBdev only)
+Look into etc/example.conf for further information and in DOCS/video.html.
+.TP 
+.B \-monitor_hfreq <horizontal frequency range>  (FBdev only)
+.TP 
+.B \-monitor_vfreq <vertical frequency range>  (FBdev only)
+.TP 
+.B \-ni
+Force usage of non\-interleaved AVI parser (fixes playing
+of some bad AVI files).
+.TP 
+.B \-nobps
+Don't use avg. byte/sec value for A\-V sync (AVI).
+.TP 
+.B \-double
+enables doublebuffering. Fixes flicker by storing two frames in memory, and
+displaying one while decoding another. Can effect OSD. Needs twice the memory
+than a single buffer, so it won't work on cards with very few video memory.
+.TP 
+.B \-nodshow
+Disables usage of DirectShow video codecs
+.TP 
+.B \-noframedrop
+No frame dropping: every frame is played, audio and video may be out of
+sync (default)
+.TP 
+.B \-noidx
+Disregards INDEX of the AVI. Useful for files with broken index (desyncs, etc).
+Seeking will NOT be possible. You can fix the index permanently
+with MEncoder (see documentation).
+.TP 
+.B \-nojoystick
+Turns off joystick support. Default is on, if compiled in.
+.TP 
+.B \-nolirc
+Turns off lirc support.
 .TP
-.B \-sb\ <byte\ position>
-seek to byte position
+.B \-nortc
+Turns off rtc
 .TP
-.B \-bpp\ <depth>
-use different color depth than autodetect. Not all -vo drivers support
-it (fbdev, dga2, svga, vesa).
-.TP
-.B \-pp\ <quality> (see -npp option too !)
-apply postprocess filter on decoded image
-
-Postprocessing effect depends on the codec and works only for MPEG1/2,
-libavcodec codecs (ff*). It doesn't work for Win32/XAnim codecs.
-
-This is the numerical mode to use postprocessing. The '-npp' option described
-below has the same effects but with letters. To have several filters at the
-same time, simply add the hexadecimal values.
-
-.I EXAMPLE:
-The following values are known to give good results:
-    \-pp 0x20000 <=> \-npp lb (deinterlacing - for DVD/MPEG2 playback e.g.)
-    \-pp 0x7f    <=> \-npp hb,vb,dr,al (smooth the images)
+.B \-noslices
+Disable the use of draw_slice by codecs.
 .TP
+.B \-nowaveheader
+Don't include wave header. Used for RAW PCM.
+.TP 
+.B \-noxv (SDL only)
+Disable XVideo hardware acceleration
+.TP 
 .B \-npp\ <options>
-This option allows to give more litterate options for postprocessing, and is
-another way of calling it (not with -pp).
+This option allows to give more litterate options for postprocessing, 
+and is another way of calling it (not with \-pp).
 
 .I EXAMPLE:
-    '-pp 0x2007f' <=> '-npp hb,vb,dr,al,lb'
-    '-pp 0x7f'    <=> '-npp hb,vb,dr,al'
-
-The options for -npp are a coma separated list of the keywords below:
-    help                 : display the options available and exit MPlayer
-    de or default        : hdeblock:a,vdeblock:a,
-                           dering:a,autolevels,tmpnoise:a:150:200:400
-    fa or fast           : x1hdeblock:a,x1vdeblock:a,
-                           dering:a,autolevels,tmpnoise:a:150:200:400
-    hb or hdeblock       : horizontal deblocking filter
-                           (luminance: 0x2 chrominance: 0x20)
-        + 1st threshold  : default is 1, higher means stronger deblocking
-        + 2nd threshold  : default is 40, lower means stronger deblocking
-    vb or vdeblock       : vertical deblocking filter
-                           (luminance: 0x1 chrominance: 0x10)
-        + 2 thresholds   : shared with hdeblock thresholds
-    hr or rkhdeblock     : Ramkishor & Karandikar's horizontal deblock
-                           filter (0x1000)
-    vr or rkvdeblock     : R&K's vertical deblock filter (0x100)
-    h1 or x1hdeblock     : x1 horizontal deblock filter (0x2000)
-    v1 or x1vdeblock     : y1 horizontal deblock filter (0x200)
-    dr or dering         : dering
-                           (luminance: 0x4 chrominance: 0x40)
-    al or autolevels     : auto brightness/contrast correction (0x8)
-    lb or linblenddeint  : linear blend deinterlacing (0x20000)
-    li or linipoldeint   : linear interpolation deinterlacing (0x10000)
-    ci or cubicipoldeint : cubic interpolation deinterlacing (0x40000)
-    md or mediandeint    : median deinterlacing (0x80000)
-    tn or tmpnoise       : temporal noise reducer (0x100000)
-