changeset 5988:de86623c35ef

merging mplayer+mencodre manpage, reorganized by section, updated by Jonas Jermann <jjermann@gmx.net>
author arpi
date Sun, 05 May 2002 21:04:25 +0000
parents 08c552788216
children f50142e50a2b
files DOCS/mencoder.1 DOCS/mplayer.1
diffstat 2 files changed, 1023 insertions(+), 1053 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/mencoder.1	Sun May 05 18:58:42 2002 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,442 +0,0 @@
-.\" MEncoder (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users>
-.\" This manpage was/is done by Gabucino
-.\"
-.TH "MEncoder" "1" "2002-05-03"
-
-.SH NAME
-mencoder \- Movie Encoder for Linux
-
-.SH "SYNOPSIS"
-.B mencoder
-.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ]\ [\-o\ file]
-.BR
-.B mencoder
-.RB [global\ options]\ \fIfile1\fP\ [specific\ options]\ [file2]\ [specific\ options]\ [\-o\ file]
-.BR
-.B mencoder
-.RB [global\ options]\ {\fIgroup\ of\ files\ and\ options\fP}\ [group\ specific\ options]\ [\-o\ file]
-.BR
-.B mencoder
-.RB [dvd|vcd|tv]://[title]\ [options]\ [\-o\ file]
-.BR
-.B mencoder
-.RB [mms|http]://URL[:port]\ [options]\ [\-o\ file]
-
-.SH DESCRIPTION
-.B mencoder
-MEncoder (MPlayer's Movie Encoder) is a simple movie encoder, designed to
-encode MPlayer-playable movies (AVI/DVD/VCD/VOB/MPG/MOV/VIV/VIV/FLI/RM/NUV/NET)
-to other MPlayer-playable formats (see below).  It encodes to DivX4 
-(1, 2 or 3 passes), xvid, codecs of libavcodec, PCM/MP3/VBRMP3 audio. 
-Also has stream copying abilities, a powerfull plugin system
-(crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more.
-
-.SH "OPTIONS"
-.I NOTE
-Every "flag" option has "noflag" pair, e.g. -flag opposite is -noflag
-.BR
-.I NOTE
-CHECK THE HTML DOCUMENTATION TOO!
-.BR
-.I NOTE
-As MEncoder uses the same 'libmpdemux' as MPlayer, their options are
-_sometimes the same_! So although for example the -sid option isn't
-mentioned here, you can use it in MEncoder too! (for encoding DVD with
-subtitles)
-.TP
-.B \-ac3file <filename>
-.TP
-.B \-ac <codec name>
-Use specified codec (according to codecs.conf) for decoding input audio
-stream.
-.TP
-.B \-afm <codec family>
-Force decoding by using a specific codec FAMILY, and FALLBACK to default
-if failed.  For examples see MPlayer manpage.
-.TP
-.B \-aid <stream id>
-If the source media contains multiple audio streams (for example DVDs), encode
-the specified one.
-.TP
-.B \-audiofile <filename>
-Copy audio from external file.
-.TP
-.B \-chapter <chapter id>
-Use with -dvd option (see above). Start encoding at the specified chapter.
-.TP
-.B \-divx4opts <options>
-If encoding to DivX4, you can specify its parameters here, like:
-
-  -divx4opts br=1800:deinterlace:key=250
-
-Available options:
-
-  help              get help
-  br=<value>        specify bitrate in
-                    kbit <4\-16000> or
-                    bit  <16001\-24000000>
-  key=<value>       maximum keyframe interval
-                    (in frames)
-  deinterlace       enable deinterlacing
-                    (don't use, DivX4 is buggy!)
-  q=<value>         quality (1\-fastest, 5\-best)
-  min_quant=<value> minimum quantizer (0\-32)
-  max_quant=<value> maximum quantizer (0\-32)
-  rc_period=<value> rate control period
-  rc_reaction_period=<value> 
-                    rate control reaction period
-  rc_reaction_ratio=<value> 
-                    rate control reaction ratio
-  crispness=<value> (0\-100)
-.TP
-.B \-dvd <title id>
-Encode the specified DVD title.
-.TP
-.B \-dvdangle <angle id>
-Use with -dvd option (see above), and if the DVD disc has multiple angles.
-It will encode the angle specified here.
-.TP
-.B \-dvdkey <CSS key>
-Used to decrypt CSS-encrypted streams on hard disk (with given CSS decrypt
-key).
-.TP
-.B \-endpos <time>
-Stop encoding at given time. Can be specified in many was :
-
-    -endpos 56       encode only 56 seconds
-    -endpos 01:10:00 encode only 1 hours
-
-Can be used in conjuction with -ss!
-.TP
-.B \-ffourcc fourcc
-Can be used to force the video fourcc of the output file. For example -ffourcc
-div3 will have the output file contain "div3" as video fourcc.
-.TP
-.B \-frames <number>
-Encode only given number of frames.
-.TP
-.B \-include
-Specify config file to be parsed after the default
-.TP
-.B \-lameopts <options>
-If encoding to MP3 with libmp3lame, you can specify its parameters here, like:
-
-  -lameopts br=192:cbr
-
-Available options:
-
-    help            get help
-    vbr=<value>     variable bitrate method
-                      0=cbr
-                      1=mt
-                      2=rh(default)
-                      3=abr
-                      4=mtrh
-    abr             average bitrate
-    cbr             constant bitrate
-    br=<value>      specify bitrate in
-                    kbit <0-1024>
-                    (only for CBR and ABR)
-    q=<value>       Quality
-                    (0-highest, 9-low)
-                    (for VBR)
-    aq=<value>      ?
-    ratio=<value>   compression ratio <1-100>
-    vol=<value>     set audio input gain <0-10>
-    mode=<value>    0=stereo
-                    1=joint-stereo
-                    2=dualchannel
-                    3=mono
-                    (default: auto)
-    padding=<value> 0=no
-                    1=all
-                    2=adjust
-.TP
-.B \-lavcopts <options>
-If encoding with a codec from libavcodec, you can specify its parameters here,
-like:
-
-  -lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
-
-Available options:
-
-  help             get help
-
-  vcodec=<value>   use the specified codec :
-                     mjpeg - Motion JPEG
-                     h263 - H263
-                     h263p - H263 Plus
-                     mpeg4 - DivX 4/5
-                     msmpeg4 - DivX 3
-                     rv10 - an old RealVideo codec
-                     mpeg1video - MPEG1 video :)
-                   There's no default, you must
-                   specify it.
-
-  vbitrate=<value> specify bitrate in
-                   kbit <4-16000> or
-                   bit  <16001-24000000>
-                   (warning: 1kbit = 1000 bits)
-                   default = 800k
-
-  vratetol=<value> approximated *filesize* tolerance
-                   in kbits.
-                   (warning: 1kbit = 1000 bits)
-                   default = 1024*8 kbits = 1MByte
-
-  keyint=<value>    interval between keyframes
-                   (specify in frames, >300 are not
-                   recommended)
-                   default = 250 (one key frame every
-                   ten seconds in a 25fps movie)
-
-  vhq              high quality mode, macro blocks
-                   will be encoded multiple times and
-                   the smallest will be used.
-                   default = HQ disabled
-
-  vme=<value>      [0..5] motion estimation method :
-                     0 - no ME at all
-                     1 - ME_FULL
-                     2 - ME_LOG
-                     3 - ME_PHODS
-                     4 - ME_EPZS
-                     5 - ME_X1
-                   EPZS usually gives best results,
-                   but you can try X1 too. FULL is
-                   very slow and the others are
-                   experimental.
-                   default = EPZS
-
-  vqcomp=<value>   if the value is set to 1.0, the
-                   quantizer will stay nearly
-                   constant (high motion scenes will
-                   look bad). If it's 0.0, the
-                   quantizer will be changed
-                   to make all frames approximately
-                   equally sized (low motion scenes
-                   will look bad).
-                   default = 0.5
-
-  vqblur=<value>   blurs the quantizer graph over
-                   time.
-                      0.0 : no blur
-                      1.0 : average all past
-                            quantizers
-                   default = 0.5
-
-  vqscale=<value>  [2..31] gives each frame the same
-                   quantizer (selects fixed quantizer
-                   mode).
-                   default = 0 (fixed quantizer mode
-                   disabled)
-
-  vrc_strategy=<value>
-                   [0..2] different strategies to
-                   decide which frames should get
-                   which quantizer.
-                   default = 2
-
-  v4mv             4 motion vectors per macroblock,
-                   may gives you slightly better
-                   quality, can only be used in HQ
-                   mode and is buggy with B frames
-                   currently.
-                   default = disabled
-
-  vpass=<value>    [1,2] select internal first pass
-                   or second pass of 2-pass mode.
-                   default = 0 (1-pass mode)
-
-The next 3 options apply only to I & P frames :
-
-  vqmin=<value>    [1..31] minimum quantizer,
-                   default = 3
-
-  vqmax=<value>    [1..31] maximum quantizer
-                   default = 15
-
-  vqdiff=<value>   [1..31] quantizer difference.
-                   Limits the maximum quantizer
-                   difference between frames.
-                   default = 3
-
-The following options apply only to B frames :
-
-  vmax_b_frames=<value>
-                   [0..4] maximum number of frames
-                   between each I/P frame.
-                   default = 0 (B-frames generation
-                   disabled)
-
-  vb_strategy=<value>
-                   strategy to choose between
-                   I/P/B frames :
-                     0 allways use max B
-                     1 avoid B frames in high
-                       motion / scene change (can
-                       lead to filesize miss
-                       prediction)
-                   default = 0
-
-  vb_qfactor=XXX   quantizer factor between b
-                   and i/p frames (larger means
-                   higher quantizer for b frames)
-                   default = 2.0
-
-In fixed quantizer mode you can use those options :
-  vqscale, vmax_b_frames, vhq, vme, keyint
-
-You can use the following options only in pass 1 of 2-pass mode or in 1-pass mode :
-  vqblur, vqdiff
-
-You can use the following options only in pass 2 of 2-pass mode :
-  vrc_strategy, vb_strategy
-
-All other options can be used in all modes.
-.TP
-.B \-mc\ <seconds/frame>
-Maximum sync correction per frame (in seconds).
-Use -mc 0 to disable input A/V sync.
-.TP
-.B \-mf <multifile options>
-Used when encoding from multiple JPEG files.
-Its sub-options are:
-
-  on             turns on multifile support
-  w=<value>      width of the output file [autodetected]
-  h=<value>      height of the output file [autodetected]
-  fps=<value>    fps of the output file [default: 25fps]
-  type=<value>   type of input files (jpeg, png)
-.TP
-.B \-nobps
-Used only for AVIs. Doesn't use the bps value in the AVI header, instead
-calculates it.
-.TP
-.B \-nosound
-Encode only video, no audio stream.
-.TP
-.B \-o <filename>
-Outputs to the given filename, instead of the default 'test.avi'.
-.TP
-.B \-oac <codec name>
-Encode with the given codec (codec names are from codecs.conf,
-use -ovc help to get a list of available codecs).
-Examples:
-
-  -oac copy      no encoding, just streamcopy
-  -oac pcm       encode to uncompressed PCM
-  -oac mp3lame   encode to MP3 (using Lame)
-.TP
-.B \-ofps <fps>
-The output file will have different frame/sec than the source.
-You MUST set it for variable fps (asf, some mov) and progressive
-(29.97fps telecined mpeg) files.
-.TP
-.B \-ovc <codec name>
-Encode with the given codec (codec names are from codecs.conf, 
-use -ovc help to get a list of available codecs).
-Examples:
-
-  -ovc copy      no encoding, just streamcopy
-  -ovc divx4     encode to DivX4/DivX5 or XviD
-  -ovc rawrgb    encode to uncompressed RGB24
-  -ovc lavc      encode with a libavcodec codec
-.TP
-.B \-pass <1/2>
-With this you can encode 2pass DivX4 files. First encode with -pass 1, then
-with the same parameters, encode with -pass 2.
-NOTE: for libavcodec 2-pass use -lavcopts vpass=1/2 instead of -pass 1/2
-.TP
-.B \-passlogfile <filename>
-When encoding in 2pass mode, MEncoder dumps first pass' informations
-to the given file instead of the default divx2pass.log.
-.TP
-.B \-pp <value>
-See man mplayer.
-.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
-
-Can start only from keyframes!
-.TP
-.B \-sub <filename>
-Given VOBsub/text subtitle will be encoded INTO the output file. Text
-subtitles need fonts properly installed.
-.TP
-.B \-sws <software scaler type>
-Type of scaling method (use with -vop scale=w:h)
-
-    0   fast bilinear (default)
-    1   bilinear
-    2   bicubic (best quality)
-    3   ?
-    4   nearest neighbor (bad quality)
-    5   area averageing scaling support
-.TP
-.B \-v, \-\-verbose
-Increase verbosity.
-.TP
-.B \-vc <codec name>
-Use specified codec (according to codecs.conf) for decoding input video
-stream.
-.TP
-.B \-vcd <track>
-Encode the specified VCD track.
-.TP
-.B \-vfm <codec family>
-Force decoding by using a specific codec FAMILY, and FALLBACK to default
-if failed.  For examples see MPlayer manpage.
-.TP
-.B \-vid <stream id>
-If the source media contains multiple video streams, encode the specified one.
-
-.SH "EXAMPLES"
-.B Encoding DVD title #2
-mencoder -dvd 2 -o title2.avi
-.TP
-.B Encoding DVD title #2, only selected chapters
-mencoder -dvd 2 -chapter 10-15 -o title2.avi
-.TP
-.B The same, but with libavcodec family, MJPEG compression
-mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg -ffourcc mjpg
-.TP
-.B Encoding all *.jpg files in the current dir
-mencoder \*.jpg -mf on:w=800:h=600:fps=25 -o output.avi
-.TP
-.B Encoding from HTTP
-mencoder http://mplayer.hq/example.avi -o example.avi
-.TP
-.B Encoding from tuner (see documentation!)
-mencoder -tv on:driver=v4l:width=640:height=480 -o tv.avi
-.TP
-.B Encoding from a pipe
-rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- -
-.TP
-.B Encoding multiple *.vob files
-cat *.vob | mencoder <options> -
-  
-.SH BUGS
-Probably. PLEASE, double-check the documentation (especially bugreports.html),
-the FAQ and the mail archive before!
-
-Send your complete bugreports to the MPlayer-users mailing list at
-<mplayer-users@mplayerhq.hu>. We love complete bugreports :)
-
-.SH AUTHORS
-Check documentation!
-
-MPlayer is (C) 2000\-2002
-.I Arpad Gereoffy <sendmail@to.mplayer-users>
-
-This manpage is written and maintained by
-.I Gabucino <sendmail@to.mplayer\-users>.
-
-.SH STANDARD DISCLAIMER
-Use only at your own risk! There may be errors and inaccuracies that could 
-be damaging to your system or your eye. Proceed with caution, and although
-this is highly unlikely, the author doesn't take any responsibility for that!
-.\" end of file
--- a/DOCS/mplayer.1	Sun May 05 18:58:42 2002 +0000
+++ b/DOCS/mplayer.1	Sun May 05 21:04:25 2002 +0000
@@ -1,10 +1,13 @@
 .\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users>
-.\" This manpage was/is done by Gabucino
+.\" This manpage was/is done by Gabucino <sendmail@to.mplayer-users>
+.\" (Patches done by Jonas Jermann <sendmail@to.mplayer-users>)
 .\" 
-.TH "MPlayer" "1" "2002-05-03"
+.TH "MPlayer" "1" "2002-05-04"
 
 .SH "NAME"
 mplayer \- Movie Player for Linux
+.br
+mencoder \- Movie Encoder for Linux
 
 .SH "SYNOPSIS"
 .B mplayer
@@ -20,12 +23,18 @@
 .RB [dvd|vcd|tv]://[title]\ [options]
 .br
 .B mplayer
-.RB [mms|http]://URL[:port]\ [options]
+.RB [mms|http|http_proxy|ftp]://URL[:port]\ [options]
+.br
+.B mencoder
+.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ]\ [\-o\ file]
+.br
+.B gmplayer
+.RB [options]\ [\-skin\ skin]
 
 .SH "DESCRIPTION"
 .B mplayer
 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,
+CPUs, see DOCS 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, DivX 3/4/5 and even WMV movies too
 (and you don't need the avifile library at all!).
@@ -44,228 +53,162 @@
 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* (see documentation).
+.B mencoder
+(MPlayer's Movie Encoder) is a simple movie encoder, designed to
+encode MPlayer-playable movies (AVI/DVD/VCD/VOB/MPG/MOV/VIV/VIV/FLI/RM/NUV/NET)
+to other MPlayer-playable formats (see below).  It encodes to DivX4 
+(1, 2 or 3 passes), xvid, codecs of libavcodec, PCM/MP3/VBRMP3 audio. 
+Also has stream copying abilities, a powerfull plugin system
+(crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more.
+
+.B gmplayer
+is MPlayer with a graphical user interface.
+It has the same options as MPlayer.
+
+.SH GENERAL NOTES
+Every "flag" option has "noflag" pair, e.g. \-fs opposite is \-nofs.
+.br
+.B Check the html documentation too!
+
+.SH "DEMUXER/STREAM OPTIONS"
+.TP
+.B \-aid <id>
+Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...]
 .br
 .I NOTE:
-The GUI code is STILL exterimental, it is under heavy development, parts of it (for example: playlist) not yet implemented.
-.TP 
-.B \-gui
-Start MPlayer in GUI mode.
-.TP 
-.B \-skin <skin\ directory>
-Load skin from this directory (WITHOUT path name!). For example '\-skin fittyfene' tries these:
-
-    /usr/local/share/mplayer/Skin/fittyfene
-    ~/.mplayer/Skin/fittyfene
-
-.SH "DVD OPTIONS"
-.I NOTE:
-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 \-alang\ <audio\ stream\ language>
+Use \-alang to define the language by name.
+.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>[-<end chapter id>]
+.TP
+.B \-audio\-demuxer <number>
+Force audio demuxer type for \-audiofile. 
+Give the demuxer ID as defined in demuxers.h.
+.TP
+.B \-audiofile <filename>
+Play audio from an external file (WAV, MP3 or Vorbis)
+.TP
+.B \-cdrom\-device <path\ to\ device>
+Override default CDROM drive name /dev/cdrom
+.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 \-chapter <chapter\ id>[-<end chapter id>]
 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>
+.TP
+.B \-demuxer <number>
+Force demuxer type. Give the demuxer ID as defined in demuxers.h.
+.TP
+.B \-dumpaudio (MPLAYER only)
+Dumps raw compressed audio stream to ./stream.dump (usefull with mpeg/ac3)
+.TP
+.B \-dumpfile <filename> (MPLAYER only)
+Specify to which file MPlayer should dump to. Should be used together
+with \-dumpaudio/\-dumpvideo/\-dumpstream.
+.TP
+.B \-dumpstream (MPLAYER only)
+Dumps the raw steram to ./stream.dump . Useful for example
+when ripping from DVD or network.
+.TP
+.B \-dumpsub (MPLAYER only)
+Dumps the subtitle substream from VOB streams.
+.TP
+.B \-dumpvideo (MPLAYER only)
+Dump raw compressed video stream to ./stream.dump (not very usable)
+.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>
+sometimes '1' are trailers, and '2' is the real movie. Sometimes deinterlacing
+is required for DVD playback: see '\-pp 0x20000' or '\-npp lb' options too. 
+.TP
+.B \-dvd\-device <path\ to\ device>
 Override default DVD device name /dev/dvd
-.TP 
-.B \-dvdangle\ <angle\ id>
+.TP
+.B \-dvdangle <angle\ id>
 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 
+.TP
 .B \-dvdauth <DVD\ device>
 (old-style DVD option) Turns on DVD authentication using the given device.
-.TP 
+.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 
+.TP
+.B \-dvdnav (BETA CODE) 
 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.
-.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"
-.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).
-If using OSS, you can specify which sound device to use like this:
-
-    \-ao oss:/dev/dsp1     (replaces the old \-dsp option)
-
-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:
-
-    \-aspect 4:3  or \-aspect 1.3333
-    \-aspect 16:9 or \-aspect 1.7777
-.TP 
-.B \-audiofile\ <filename>
-Play audio from an external file (WAV, MP3 or Vorbis)
-.TP 
-.B \-autoq\ <quality>
-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 
-.B \-benchmark
-Prints some statistics on CPU usage and dropped frames at the end.
-Used in combination with \-nosound and \-vo null for benchmarking only video codec.
-.TP 
-.B \-cdrom\-device\ <path\ to\ device>
-Override default CDROM drive name /dev/cdrom
-.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:
-
-    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 \-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 \-fps <value>
+Force frame rate (if value is wrong in the header) (float number)
+.TP
+.B \-frames <number>
+MPlayer plays <number> frames, then quits.
 .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.
+.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 \-mf\ <multifile\ options>
-Used when decoding from multiple PNG or JPEG files. The sub\-options are separated by ":"
+.B \-idx (see \-forceidx option too!)
+Rebuilds INDEX of the AVI if no INDEX was found, 
+thus allowing seeking. Useful with broken/incomplete
+downloads, or badly created AVIs.
+.TP
+.B \-mc <seconds/frame>
+Maximum A-V sync correction per frame (in seconds)
+.TP
+.B \-mf <option1:option2:...>
+Used when decoding from multiple PNG or JPEG files.
 (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
+    w=<value>     width of the output (autodetect)
+    h=<value>     height of the output (autodetect)
+    fps=<value>   fps of the output (default: 25)
     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!)
+.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).
+Helps with some AVI files with broken header.
+.TP
+.B \-skipopening
+Skip dvd opening (dvdnav only).
+.TP
+.B \-sb <byte\ position> (see \-ss option too!)
+Seek to byte position. Useful for playback from cdrom 
+images / vob files with junk at the beginning.
+.TP
+.B \-srate <Hz>
+Specifies Hz to playback audio on. Has effect on playback speed!
+.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 
-.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!)
-(default: the same fps as the movie)
-.TP 
-.B \-subpos <0 \- 100>
-Specify the position of subtitles on screen
-.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:
+.TP
+.B \-tv <option1:option2:...>
+This option enables the TV grabbing feature of MPlayer (see documentation). 
+Available options are:
 
     on                use TV input
     noaudio           no sound
@@ -279,40 +222,19 @@
     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>
+.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).
+.TP
+.B \-vid <id>
+Select video channel [MPG: 0\-15  ASF:  0\-255 ]
+.TP
+.B \-vivo <sub\-options> (DEBUG CODE)
+Force audio parameters for the .vivo demuxer (for debugging purposes)
 
-You can get the list of available drivers executing
-.I mplayer \-vo help
+
+.SH "DECODING/FILTERING OPTIONS"
 .TP
-.B \-vobsub\ <vobsub\ file\ without\ extention>
-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 
-.B \-vobsubid\ <vobsub\ subtitle\ id>
-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!) or help in fine-tuning codec/driver parameters.
-.TP
-.B \-aa*
-Used for \-vo aa. You can get a list and an explanation of available options executing
-.I mplayer \-aahelp
-.TP 
 .B \-ac <codec name>
 Force usage of a specific audio codec, according to its name in codecs.conf,
 for example:
@@ -325,221 +247,34 @@
     \-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 \-aofile <filename>
-Filename for \-ao pcm.
-.TP
-.B \-aop\ <sub\-options>
-Specify audio plugin(s) and their options, separated by ":" (see documentation!!).
-Available sub\-options are:
-
-    list=[plugins]  comma separated list of plugins
-                    (resample, format, surround, format, volume, extrastereo, volnorm)
-    delay=<sec>     example plugin, don't use!
-    format=<format> output format (format plugin only)
-    fout=<Hz>       output frequency (resample plugin only)
-    volume=<0-255>  volume (volume plugin only)
-    mul=<value>     stereo coefficient, defaults to 1 (extrastereo plugin only)
-    softclip        compressor/"soft\-clipping" capabilities (volume plugin only)
-    
-.TP 
-.B \-audio\-demuxer <number>
-Force audio demuxer type for \-audiofile. Give the demuxer ID as defined in
-demuxers.h.
-.TP
-.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 \-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
-
-    Stereo         2
-    Surround       4
-    Full 5.1       6
+.B \-afm <1\-12> (OBSOLETE)
+Force usage of a specific audio format. For example:
 
-Currently this option is only honoured for AC3 audio.
-.TP 
-.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 \-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 \-dumpaudio
-Writes audio stream of the file to ./stream.dump (mostly usable
-with mpeg/ac3)
+    \-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!
 .TP
-.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 \-aspect <ratio>
+Override aspect ratio of movies. It's autodetected on MPEG files, but can't be
+autodetected on most AVI files. Examples:
+
+    \-aspect 4:3  or \-aspect 1.3333
+    \-aspect 16:9 or \-aspect 1.7777
+.TP
 .B \-flip
-Flip image upside-down.
-.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 (except B) frames, video may skip. Usefull for playback on slow VGA card/bus.
-.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.
-
-    \-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.
+Flip image upside-down
 .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 if no INDEX was found, 
-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
-    js\-dev         specifies the joystick device
-                   to use
-                   (default is /dev/input/js0)
-
-.I NOTE:
-Autorepeat is currently only supported by joysticks.
-.TP 
-.B \-jpeg <sub\-options> 
-Specify options for for JPEG output, separated by ":" (see documentation!).
-Available sub\-options are [no]progressiv, [no]baseline, 
-optimize, smooth, quality and outdir.
-.TP 
-.B \-mc\ <seconds/frame>
-Maximum A-V sync correction per frame (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). Helps with some AVI files with broken header.
-.TP 
-.B \-nojoystick
-Turns off joystick support. Default is on, if compiled in.
-.TP 
-.B \-nolirc
-Turns off lirc support.
+.B \-nosound
+Don't play/encode sound
 .TP
-.B \-nortc
-Turns off usage of /dev/rtc (real-time clock)
-.TP
-.B \-noslices
-Disable the use of draw_slice by codecs.
-.TP
-.B \-nowaveheader  (-ao pcm only)
-Don't include wave header. Used for RAW PCM.
-.TP 
-.B \-npp\ <options>
+.B \-npp <option1,option2,...>
 This option allows to give more litterate options for postprocessing, 
 and is another way of calling it (not with \-pp).
 
@@ -547,7 +282,7 @@
     '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb'
     '\-pp 0x7f'    <=> '\-npp hb,vb,dr,al'
 
-The options for \-npp are a coma separated list you can get by executing
+You can get a list of options for \-npp by executing
 .I mplayer \-npp help
 .br
 These keywords accept a '\-' prefix to disable the option.
@@ -568,14 +303,20 @@
     '\-npp hb:y,vb:a \-autoq 6' means 'deblock horizontal only luminance, and
     automatically switch vertical deblocking on/off depending on available 
     cpu time'
-.TP 
-.B \-pp\ <quality> (see \-npp option too!)
+.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.
+Value given by -pp is sent to the codec, if the codec has built-in postprocess
+filter (newer win32 DShow DLLs, divx4linux) otherwise the external postprocess
+filter plugin (-vop pp) is auto-loaded and used. Note, that -npp only works
+with external pp. Also note, that you can use the built-in and external pp at the
+same time, use -pp to set internal pp, and -vop pp=value to set up the external!
 
-This is the numerical mode to use postprocessing. The '\-npp' option described
+The valid range of -pp value for built-in pp filters vary on codecs, mostly
+0-6, where 0=disable 6=slowest/best.
+
+For the external pp filter, 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.
 
@@ -584,59 +325,35 @@
     \-pp 0x20000 <=> \-npp lb (deinterlacing \- for DVD/MPEG2 playback e.g.)
     \-pp 0x7f    <=> \-npp hb,vb,dr,al (smooth the images)
 .TP
-.B \-red_intensity <\-1000\ \-\ 1000>
-Adjust intensity of red component of video signal (default 0).
+.B \-ssf <mode> (BETA CODE)
+Specifies SwScaler parameters. Available options are:
+
+    lgb=[0..100]   gaussian blur filter (luma) 
+    cgb=[0..100]   gaussian blur filter (chroma)
+    ls=[0..100]    sharpen filter (luma)
+    cs=[0..100]    sharpen filter (chroma)
+    cvs=x          chroma vertival shifting
+    chs=x          chroma horizontal shifting
 .TP
-.B \-saturation <\-1000\ \-\ 1000>
-Adjust saturation of video output (default 0). You can get grayscale output 
-with this option.
-.TP 
-.B \-sb\ <byte\ position> (see \-ss option too!)
-Seek to byte position. Useful for playback from cdrom images / vob files with junk at the beginning.
-.TP 
-.B \-screenw\ <pixels> \-screenh\ <pixels>
-If you use an output driver which can't know the resolution of the screen
-(fbdev/x11 and/or TVout) this is where you can specify the horizontal and vertical
-resolution.
-.TP 
-.B \-slave
-This option switches on slave mode. This is intended for use
-of MPlayer as a backend to other programs. Instead of intercepting keyboard
-events, MPlayer will read simplistic command lines from its stdin.
-See section
-.B SLAVE MODE PROTOCOL
-For the syntax.
-.TP 
-.B \-softsleep
-Uses high quality software timers. Efficient as the RTC, doesn't need root,
-but requires more CPU.
-.TP 
-.B \-srate <Hz>
-Specifies Hz to playback audio on. Has effect on playback speed!
-.TP 
-.B \-sstep <sec>
-Specifies seconds between displayed frames. Usefull for slideshows.
-.TP 
 .B \-stereo <mode>
 Select type of MP2/MP3 stereo output.
 
     Stereo          0
     Left channel    1
     Right channel   2
-.TP 
-.B \-subcp\ codepage
-If your system supports iconv(3), you can use this option to
-specify codepage of the subtitle. Examples:
+.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:
 
-    \-subcp   latin2
-    \-subcp   cp1250
-.TP 
-.B \-unicode
-Tells MPlayer to handle the subtitle file as UNICODE.
-.TP 
-.B \-utf8
-Tells MPlayer to handle the subtitle file as UTF8.
-.TP 
+    0   fast bilinear (default)
+    1   bilinear
+    2   bicubic (best quality)
+    3   ?
+    4   nearest neighbor (bad quality)
+    5   area averageing scaling support
+.TP
 .B \-vc <codec name>
 Force usage of a specific video codec, according to its name in codecs.conf,
 for example:
@@ -648,113 +365,8 @@
     \-vc divx4      use ProjectMayo's DivX codec
 
 See '\-vc help' for FULL list!
-.TP 
-.B \-vid\ <id>
-Select video channel [MPG: 0\-15  ASF:  0\-255 ]
-.TP 
-.B \-vop <plugin>
-Activate video filters (see documentation!). 
-Available plugins are:
-
-    crop[=w:h:x:y]     simple cropping plugin
-    expand[=w:h:x:y:o] expanding and (optional) OSD rendering plugin
-    flip               flips image upside-down
-    mirror             horizontal mirroring
-    rotate[=x]         rotate image +/\- 90 degrees
-    scale[=w:h]        software scaling (zoom) and yuv<\->rgb colorspace conversion
-    yuy2               forced software YV12/I420 \-> YUY2 conversion
-    rgb2bgr[=swap]     RGB 24/32 <\-> BGR 24/32 colorspace conversion (default)
-                       optional with R<\->B swapping
-    palette            RGB/BGR 8 \-> RGB/BGR 15/16/24/32 colorspace conversion using palette
-    format[=fourcc]    restrict the list of supported colorspaces to a single fourcc
-                       (default 'yuy2', may be rgb12, bgr24, yv12 etc...)
-    pp[=flags]         postprocessing filter (see \-pp option)
-    lavc               fast software YV12\->MPEG1 conversion
-    fame               fast software YV12\->MPEG1 conversion
 .TP
-.B \-vsync
-Enables VBI for vesa
-.TP 
-.B \-wid\ <window\ id>
-This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a
-browser (with the plugger extension for instance)
-.TP 
-.B \-xineramascreen <screen\ number>
-In Xinerama configurations (i.e. a single desktop that spans across multiple
-displays) this option tells MPlayer which screen to display movie on. Range 0 \- ...
-.TP 
-.B \-x\ <x>
-Scale image to x width (if sw/hw scaling available). Disables aspect calcs.
-.TP 
-.B \-xy\ <x>
-    x<=8   Scale image by factor <x>
-    x>8    Set width to <x> and calculate height to keep correct aspect ratio
-.TP 
-.B \-y\ <y>
-Scale image to y height (if sw/hw scaling available). Disables aspect calcs.
-.TP 
-.B \-zoom
-Allow software scaling, where available. Could be used to force scaling with -vop scale
-(-vop scale will IGNORE options -x/-y/-xy/-fs/-aspect without -zoom)
-.TP 
-.B \-z\ <0\-9>
-Specifies compression level for PNG output (-vo png)
-    0   no compression
-    9   max compression
-.TP
-.B \-zr*
-Used for \-vo zr. You can get a list and an explanation of available options executing
-.I mplayer \-zrhelp
-
-.SH "ALPHA/BETA CODE"
-.I NOTE:
-These are included in this manpage just for completeness! These may or may NOT
-work! If you don't know what are these, you DON'T need these! In either case,
-double\-check the documentation!
-.TP 
-.B \-dumpvideo
-Dump raw compressed video stream to ./stream.dump (not very usable)
-.TP 
-.B \-ssf <mode>
-Specifies SwScaler filters. Available modes are:
-
-    lgb   gaussian blur filter (luma) 
-    cgb   gaussian blur filter (chroma)
-    cvs   chroma vertival shifting
-    chs   chroma horizontal shifting
-    ls    sharpen filter (luma)
-    cs    sharpen filter (chroma)
-.TP 
-.B \-sub\-demuxer <number>
-Force subtitle demuxer type for \-subfile.
-.TP 
-.B \-subfile <filename>
-Currently useless. Same as \-audiofile, but for subtitle streams. (OggDS?)
-.TP 
-.B \-vivo <sub\-options>
-Force audio parameters for the .vivo demuxer (for debugging purposes)
-
-.SH "OBSOLETE OPTIONS"
-.I NOTE:
-These options are obsoleted and may be removed in future.
-.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!
-.TP 
-.B \-dapsync
-Use alternative A/V sync method.
-.TP 
-.B \-vfm <1\-12>
+.B \-vfm <1\-12> (OBSOLETE)
 Force usage of a specific codec FAMILY, and FALLBACK to default if failed.
 For example:
 
@@ -774,15 +386,703 @@
 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 \-vop <plugin3, plugin2, plugin1, ...>
+Activate coma separated list of video filters (see documentation!).
+Available plugins are:
+
+    crop[=w:h:x:y]     simple cropping plugin
+    expand[=w:h:x:y:o] expanding and (optional) OSD rendering plugin
+    flip               flips image upside-down
+    mirror             horizontal mirroring
+    rotate[=x]         rotate image +/\- 90 degrees
+    scale[=w:h]        software scaling (zoom) and yuv<\->rgb colorspace conversion
+    yuy2               forced software YV12/I420 \-> YUY2 conversion
+    rgb2bgr[=swap]     RGB 24/32 <\-> BGR 24/32 colorspace conversion (default)
+                       optional with R<\->B swapping
+    palette            RGB/BGR 8 \-> RGB/BGR 15/16/24/32 colorspace conversion using palette
+    format[=fourcc]    restrict the list of supported colorspaces to a single fourcc
+                       (default 'yuy2', may be rgb12, bgr24, yv12 etc...)
+    pp[=flags]         postprocessing filter (see \-pp option)
+    lavc               fast software YV12\->MPEG1 conversion using libavcodec
+    fame               fast software YV12\->MPEG1 conversion using libfame
+.TP
+.B \-x <x> (MPLAYER only)
+Scale image to x width (if sw/hw scaling available). Disables aspect calcs.
+.TP
+.B \-xy <x> (MPLAYER only)
+    x<=8   Scale image by factor <x>
+    x>8    Set width to <x> and calculate height to keep correct aspect ratio
+.TP
+.B \-y <y>
+Scale image to y height (if sw/hw scaling available). Disables aspect calcs.
+.TP
+.B \-zoom
+Allow software scaling, where available. Could be used to force scaling with -vop scale
+(-vop scale will IGNORE options -x/-y/-xy/-fs/-aspect without -zoom)
+
+
+.SH "OSD/SUB OPTIONS"
+.I NOTE:
+See -vop expand too.
+.TP
+.B \-dumpmpsub (MPLAYER only)
+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 \-ifo <vobsub\ ifo\ file>
+Indicate the file that will be used to load palette and frame size for VOBSUB
+subtitles.
+.TP
+.B \-ffactor <number>
+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
+.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 \-noautosub
+Turns off automatic subtitles
+.TP
+.B \-osdlevel <0\-2> (MPLAYER only)
+Specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer)
+(default = 2)
+.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.
+.br
+.I NOTE:
+Use \-slang to define the subtitle language by name.
+.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
+.B \-sub <subtitle\ file>
+Use/display this subtitle file
+.TP
+.B \-subcp\ codepage
+If your system supports iconv(3), you can use this option to
+specify codepage of the subtitle. Examples:
+
+    \-subcp   latin2
+    \-subcp   cp1250
+.TP
+.B \-sub\-demuxer <number> (BETA CODE)
+Force subtitle demuxer type for \-subfile.
+.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!)
+(default: the same fps as the movie)
+.TP
+.B \-subfile <filename> (BETA CODE)
+Currently useless. Same as \-audiofile, but for subtitle streams. (OggDS?)
+.TP
+.B \-subpos <0 \- 100> (usefull with -vop expand)
+Specify the position of subtitles on screen
+.TP
+.B \-unicode
+Tells MPlayer to handle the subtitle file as UNICODE.
+.TP
+.B \-utf8
+Tells MPlayer to handle the subtitle file as UTF8.
+.TP
+.B \-vobsub <vobsub\ file\ without\ extention>
+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
+.B \-vobsubid <vobsub\ subtitle\ id>
+Specify the VobSub subtitle id. Valid values range from 0 to 31.
+
+
+.SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
+.TP
+.B \-abs <value>  [OBSOLETE]
+Override audio driver/card buffer size detection, -ao oss only
+.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).
+If using OSS, you can specify which sound device to use like this:
+
+    \-ao oss:/dev/dsp1     (replaces the old \-dsp option)
+
+You can get the list of available drivers executing
+.I mplayer \-ao help
+.TP
+.B \-aofile <filename>
+Filename for \-ao pcm.
+.TP
+.B \-aop <plugin1:plugin2:...>
+Specify audio plugin(s) and their options (see documentation!!).
+Available sub\-options are:
+
+    list=[plugins]  comma separated list of plugins
+                    (resample, format, surround, format, volume, extrastereo, volnorm)
+    delay=<sec>     example plugin, don't use!
+    format=<format> output format (format plugin only)
+    fout=<Hz>       output frequency (resample plugin only)
+    volume=<0-255>  volume (volume plugin only)
+    mul=<value>     stereo coefficient, defaults to 1 (extrastereo plugin only)
+    softclip        compressor/"soft\-clipping" capabilities (volume plugin only)
+.TP
+.B \-channels <n>
+Select number of audio output channels to be used
+
+    Stereo         2
+    Surround       4
+    Full 5.1       6
+
+Currently this option is only honoured for AC3 audio, and/or the surround plugin.
+.TP
+.B \-delay <secs>
+Audio delay in seconds (may be +/\- float value)
+.TP
+.B \-mixer <device>
+This option will tell MPlayer to use a different device for mixing than
+/dev/mixer.
+.TP
+.B \-nowaveheader  (-ao pcm only)
+Don't include wave header. Used for RAW PCM.
+
+
+.SH "VIDEO OUTPUT OPTIONS (MPLAYER ONLY)"
+.TP
+.B \-aa*
+Used for \-vo aa. You can get a list and an explanation of available options executing
+.I mplayer \-aahelp
+.TP
+.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 \-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 \-contrast <\-1000\ \-\ 1000>
+Adjust contrast of video output (default 0). Works in similar manner as brightness.
+.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 \-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 \-dr
+Turns on direct rendering (not supported by all codecs and video outputs)
+(default is off).
+.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 \-forcexv (SDL only)
+Force using XVideo
+.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 \-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.
+
+    \-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 \-hue <\-1000\ \-\ 1000>
+Adjust hue of video signal (default 0). You can get colored negative
+of image with this option.
+.TP
+.B \-jpeg <sub\-options> 
+Specify options for the JPEG output (-vo jpeg), separated by ":" (see documentation!).
+Available sub\-options are [no]progressiv, [no]baseline, 
+optimize, smooth, quality and outdir.
+.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 \-monitoraspect <ratio>
+Set aspect ratio of your screen. Examples:
+
+    \-monitoraspect 4:3  or 1.3333
+    \-monitoraspect 16:9 or 1.7777
+.TP
+.B \-noslices
+Disable drawing video by 16-pixel height slices/bands, instead draws the
+while frame in a single run. May be faster or slower, depending on card/cache.
+It has effect only with libmpeg2 and libavcodec codecs.
+.TP
+.B \-red_intensity <\-1000\ \-\ 1000>
+Adjust intensity of red component of video signal (default 0).
+.TP
+.B \-saturation <\-1000\ \-\ 1000>
+Adjust saturation of video output (default 0). You can get grayscale output 
+with this option.
+.TP
+.B \-rootwin
+Play movie in the root window (desktop background) instead of opening
+a new one. Works only with x11, xv, xmga, xvidix drivers.
+.TP
+.B \-screenw <pixels> \-screenh <pixels>
+If you use an output driver which can't know the resolution of the screen
+(fbdev/x11 and/or TVout) this is where you can specify the horizontal and vertical
+resolution.
+.TP
+.B \-vm
+Try to change to a better video mode. dga, x11/xv (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 \-vsync
+Enables VBI for vesa
+.TP
+.B \-wid <window\ id>
+This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a
+browser (with the plugger extension for instance)
+.TP
+.B \-xineramascreen <screen\ number>
+In Xinerama configurations (i.e. a single desktop that spans across multiple
+displays) this option tells MPlayer which screen to display movie on. Range 0 \- ...
+.TP
+.B \-z <0\-9>
+Specifies compression level for PNG output (-vo png)
+    0   no compression
+    9   max compression
+.TP
+.B \-zr*
+Used for \-vo zr. You can get a list and an explanation of available options executing
+.I mplayer \-zrhelp
+
+
+.SH "PLAYER OPTIONS (MPLAYER ONLY)"
+.TP
+.B \-autoq <quality> (use with -vop pp!)
+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
+.B \-benchmark
+Prints some statistics on CPU usage and dropped frames at the end.
+Used in combination with \-nosound and \-vo null for benchmarking only video codec.
+.TP
+.B \-dapsync (OBSOLETE)
+Use alternative A/V sync method.
+.TP
+.B \-framedrop (see \-hardframedrop option too!)
+Frame dropping: decode all (except B) frames, video may skip. Usefull for playback on slow VGA card/bus.
+.TP
+.B \-gui (BETA CODE)
+Start MPlayer in GUI mode.
+.TP
+.B \-h, \-\-help
+Show short summary of options
+.TP
+.B \-hardframedrop
+More intense frame dropping (breaks decoding). Leads to image disortion!
+.TP
+.B \-input <commands>
+This option can be used to configure certain parts of the input system.
+Relative path are relative to $HOME/.mplayer.
+
+    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
+    js\-dev         specifies the joystick device
+                   to use
+                   (default is /dev/input/js0)
+
+.I NOTE:
+Autorepeat is currently only supported by joysticks
+.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 \-nojoystick
+Turns off joystick support. Default is on, if compiled in
+.TP
+.B \-nolirc
+Turns off lirc support
+.TP
+.B \-nortc
+Turns off usage of /dev/rtc (real-time clock)
+.TP
+.B \-noskip
+Don't skip frames
+.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 \-skin <skin\ directory> (BETA CODE)
+Load skin from this directory (WITHOUT path name!). For example '\-skin fittyfene' tries these:
+
+    /usr/local/share/mplayer/Skin/fittyfene
+    ~/.mplayer/Skin/fittyfene
+.TP
+.B \-slave
+This option switches on slave mode. This is intended for use
+of MPlayer as a backend to other programs. Instead of intercepting keyboard
+events, MPlayer will read simplistic command lines from its stdin.
+See section
+.B SLAVE MODE PROTOCOL
+For the syntax.
+.TP
+.B \-softsleep
+Uses high quality software timers. Efficient as the RTC, doesn't need root,
+but requires more CPU.
+.TP
+.B \-sstep <sec>
+Specifies seconds between displayed frames. Usefull for slideshows.
+.TP
+.B \-use-stdin
+
+
+.SH "ENCODING OPTIONS (MENCODER ONLY)"
+.TP
+.B \-divx4opts <options>
+If encoding to DivX4, you can specify its parameters here, like:
+
+  -divx4opts br=1800:deinterlace:key=250
+
+Available options:
+
+  help               get help
+  br=<value>         specify bitrate in
+                     kbit <4\-16000> or
+                     bit  <16001\-24000000>
+  key=<value>        maximum keyframe interval
+                     (in frames)
+  deinterlace        enable deinterlacing
+                     (don't use, DivX4 is buggy!)
+  q=<1\-5>            quality (1\-fastest, 5\-best)
+  min_quant=<0\-32>   minimum quantizer
+  max_quant=<0\-32>   maximum quantizer
+  rc_period=<value>  rate control period
+  rc_reaction_period=<value> 
+                     rate control reaction period
+  rc_reaction_ratio=<value> 
+                     rate control reaction ratio
+  crispness=<0\-100>  specify crispness/smoothness
+.TP
+.B \-endpos <time>
+Stop encoding at given time. Can be specified in many was :
+
+    -endpos 56       encode only 56 seconds
+    -endpos 01:10:00 encode only 1 hours
+
+Can be used in conjuction with -ss!
+.TP
+.B \-ffourcc fourcc
+Can be used to override the video fourcc of the output file. For example -ffourcc
+div3 will have the output file contain "div3" as video fourcc.
+.TP
+.B \-include <config\ file>
+Specify config file to be parsed after the default
+.TP
+.B \-lameopts <options>
+If encoding to MP3 with libmp3lame, you can specify its parameters here, like:
+
+  -lameopts br=192:cbr
+
+Available options:
+
+    help            get help
+    vbr=<value>     variable bitrate method
+                      0=cbr
+                      1=mt
+                      2=rh(default)
+                      3=abr
+                      4=mtrh
+    abr             average bitrate
+    cbr             constant bitrate
+    br=<value>      specify bitrate in
+                    kbit <0-1024>
+                    (only for CBR and ABR)
+    q=<value>       Quality
+                    (0-highest, 9-low)
+                    (for VBR)
+    aq=<value>      ?
+    ratio=<value>   compression ratio <1-100>
+    vol=<value>     set audio input gain <0-10>
+    mode=<value>    0=stereo
+                    1=joint-stereo
+                    2=dualchannel
+                    3=mono
+                    (default: auto)
+    padding=<value> 0=no
+                    1=all
+                    2=adjust
+.TP
+.B \-lavcopts <options>
+If encoding with a codec from libavcodec, you can specify its parameters here,
+like:
+
+  -lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
+
+Available options:
+
+  help             get help
+
+  vcodec=<value>   use the specified codec :
+                     mjpeg - Motion JPEG
+                     h263 - H263
+                     h263p - H263 Plus
+                     mpeg4 - DivX 4/5
+                     msmpeg4 - DivX 3
+                     rv10 - an old RealVideo codec
+                     mpeg1video - MPEG1 video :)
+                   There's no default, you must
+                   specify it.
+
+  vbitrate=<value> specify bitrate in
+                   kbit <4-16000> or
+                   bit  <16001-24000000>
+                   (warning: 1kbit = 1000 bits)
+                   default = 800k
+
+  vratetol=<value> approximated *filesize* tolerance
+                   in kbits.
+                   (warning: 1kbit = 1000 bits)
+                   default = 1024*8 kbits = 1MByte
+
+  keyint=<value>    interval between keyframes
+                   (specify in frames, >300 are not
+                   recommended)
+                   default = 250 (one key frame every
+                   ten seconds in a 25fps movie)
+
+  vhq              high quality mode, macro blocks
+                   will be encoded multiple times and
+                   the smallest will be used.
+                   default = HQ disabled
+
+  vme=<0\-5>      motion estimation method :
+                     0 - no ME at all
+                     1 - ME_FULL
+                     2 - ME_LOG
+                     3 - ME_PHODS
+                     4 - ME_EPZS
+                     5 - ME_X1
+                   EPZS usually gives best results,
+                   but you can try X1 too. FULL is
+                   very slow and the others are
+                   experimental.
+                   default = EPZS
+
+  vqcomp=<value>   if the value is set to 1.0, the
+                   quantizer will stay nearly
+                   constant (high motion scenes will
+                   look bad). If it's 0.0, the
+                   quantizer will be changed
+                   to make all frames approximately
+                   equally sized (low motion scenes
+                   will look bad).
+                   default = 0.5
+
+  vqblur=<0\-1>    blurs the quantizer graph over
+                   time.
+                      0.0 : no blur
+                      1.0 : average all past
+                            quantizers
+                   default = 0.5
+
+  vqscale=<2\-31>  gives each frame the same
+                   quantizer (selects fixed quantizer
+                   mode).
+                   default = 0 (fixed quantizer mode
+                   disabled)
+
+  vrc_strategy=<0\-2>
+                   different strategies to
+                   decide which frames should get
+                   which quantizer.
+                   default = 2
+
+  v4mv             4 motion vectors per macroblock,
+                   may gives you slightly better
+                   quality, can only be used in HQ
+                   mode and is buggy with B frames
+                   currently.
+                   default = disabled
+
+  vpass=<1/2>      select internal first pass
+                   or second pass of 2-pass mode.
+                   default = 0 (1-pass mode)
+
+The next 3 options apply only to I & P frames :
+
+  vqmin=<1\-31>    minimum quantizer,
+                   default = 3
+
+  vqmax=<1\-31>    maximum quantizer
+                   default = 15
+
+  vqdiff=<1\-31>   quantizer difference.
+                   Limits the maximum quantizer
+                   difference between frames.
+                   default = 3
+
+The following options apply only to B frames :
+
+  vmax_b_frames=<0\-4>
+                   maximum number of frames
+                   between each I/P frame.
+                   default = 0 (B-frames generation
+                   disabled)
+
+  vb_strategy=<value>
+                   strategy to choose between
+                   I/P/B frames :
+                     0 allways use max B
+                     1 avoid B frames in high
+                       motion / scene change (can
+                       lead to filesize miss
+                       prediction)
+                   default = 0
+
+  vb_qfactor=<value>
+                   quantizer factor between b
+                   and i/p frames (larger means
+                   higher quantizer for b frames)
+                   default = 2.0
+
+In fixed quantizer mode you can use those options :
+  vqscale, vmax_b_frames, vhq, vme, keyint
+
+You can use the following options only in pass 1 of 2-pass mode or in 1-pass mode :
+  vqblur, vqdiff
+
+You can use the following options only in pass 2 of 2-pass mode :
+  vrc_strategy, vb_strategy
+
+All other options can be used in all modes.
+.TP
+.B \-o <filename>
+Outputs to the given filename, instead of the default 'test.avi'.
+.TP
+.B \-oac <codec name>
+Encode with the given codec (codec names are from codecs.conf,
+use -ovc help to get a list of available codecs).
+Examples:
+
+  -oac copy      no encoding, just streamcopy
+  -oac pcm       encode to uncompressed PCM
+  -oac mp3lame   encode to MP3 (using Lame)
+.TP
+.B \-ofps <fps>
+The output file will have different frame/sec than the source.
+You MUST set it for variable fps (asf, some mov) and progressive
+(29.97fps telecined mpeg) files.
+.TP
+.B \-ovc <codec name>
+Encode with the given codec (codec names are from codecs.conf, 
+use -ovc help to get a list of available codecs).
+Examples:
+
+  -ovc copy      no encoding, just streamcopy
+  -ovc divx4     encode to DivX4/DivX5 or XviD
+  -ovc rawrgb    encode to uncompressed RGB24
+  -ovc lavc      encode with a libavcodec codec
+.TP
+.B \-pass <1/2>
+With this you can encode 2pass DivX4 files. First encode with -pass 1, then
+with the same parameters, encode with -pass 2.
+NOTE: for libavcodec 2-pass use -lavcopts vpass=1/2 instead of -pass 1/2
+.TP
+.B \-passlogfile <filename>
+When encoding in 2pass mode, MEncoder dumps first pass' informations
+to the given file instead of the default divx2pass.log.
+.TP
+.B \-skiplimit <value>
+Maximal skipable frames after non-skipped one 
+(-noskiplimit for unlimited number)
+.TP
+.B \-v, \-\-verbose
+Enable verbose output (more \-v means more verbosity)
+
 
 .SH "KEYBOARD CONTROL"
 .I NOTE:
-Use the new input system to change the default keys (edit input.conf).
-There is support for Joystick and LIRC too (see documentation).
+MPlayer has a fully configurable, command driven, control layer
+which allow you to control MPlayer using keyboard, mouse, joystick 
+or remote control (using lirc).
+.B See documentation!
+.br
+.I NOTE:
+The default config file for the input system is 
+$HOME/.mplayer/input.conf but it can be overrided 
+using the -input conf option.
 .br
 .I NOTE:
 These keys may/may not work, depending on your video output driver.
-.TP 
+.TP
 .B general control
 <\-  and  \->     seek backward/forward  10 seconds
 .br
@@ -790,7 +1090,12 @@
 .br
 pgup and pgdown seek backward/forward  10 minutes
 .br
-< and >		 previous/next file
+< and >		 backward/forward in playlist
+.br
+HOME and END    go to next/previous playtree entry in 
+                the parent list
+.br
+INS and DEL     go to next/previous alternative source (asx playlist only)
 .br
 p / SPACE       pause movie (press any key)
 .br
@@ -820,8 +1125,10 @@
 5 and 6         adjust hue
 .br
 7 and 8         adjust saturation
-.TP 
+.TP
 .B GUI keyboard control
+, and .         previous / next file
+.br
 gray \- and +    decrease/increase volume
 .br
 ENTER           start playing
@@ -852,21 +1159,90 @@
 .br
 S               select
 
+
 .SH "SLAVE MODE PROTOCOL"
 If the \-slave switch is given, playback is controlled by a 
 line\-based protocol. If the new input is enabled (default)
 each line must contain one command otherwise one of the 
 following tokens:
-.TP 
-       stop            pause playback
+.TP
+.B Commands
 .br
-play            resume playback
 .br
-seek <num>      continue at second NUM
+seek <value> [type=<0/1>]
+                Seek to some place in the movie.
+                Type 0 is a relative seek of +/-
+                <value> seconds. Type 1 seek to
+                <value> % in the movie.
+
+audio_delay <value>
+                Adjust the audio delay of val seconds
+
+quit            Quit MPlayer
+
+pause           Pause/unpause the playback
+
+grap_frames     Somebody know ?
+
+pt_step <value> [force=<value>]
+                Go to next/prev entry in playtree. 
+
+pt_up_step <value> [force=<value>]
+                Like pt_step but it jump to next/prev 
+                in the parent list.
+
+alt_src_step <value>
+                When more than one source is available
+                it select the next/previous one (only 
+                supported by asx playlist).
+
+sub_delay <value> [abs=<value>]
+                Adjust the subtitles delay of +/- <value>
+                seconds or set it to <value> seconds when 
+                abs is non zero.
+
+osd [level=<value>]
+                Toggle osd mode or set it to level when 
+                level > 0.
+
+volume <dir>    Increase/decrease volume
+
+contrast <value> [abs=<value>]
 .br
-skip <num>      skip NUM seconds (may be negative)
+brightness <value> [abs=<value>]
+.br
+hue <value> [abs=<value>]
 .br
-quit            exit MPlayer
+saturation <value> [abs=<value>]
+                Set/Adjust video paramters.
+                <value> range from -100 to 100.
+
+frame_drop [type=<value>]
+                Toggle/Set frame dropping mode.
+
+sub_pos <value> Adjust subtitles position.
+
+vo_fullscreen   Switch fullscreen mode.
+
+tv_step_channel <dir>
+                Select next/previous tv channel.
+
+tv_step_norm    Change TV norm.
+
+tv_step_chanlist 
+                Change channel list.
+
+gui_loadfile   
+.br
+gui_loadsubtitle
+.br
+gui_about
+.br
+gui_play
+.br
+gui_stop
+                GUI actions
+
 
 .SH "FILES"
 .BR /etc/mplayer.conf\ \ \ \ \ 
@@ -876,7 +1252,7 @@
 User settings
 .br
 .BR ~/.mplayer/input.conf\ 
-Input bindings
+Input bindings. See '\-input keylist' for full keylist!
 .br
 .BR ~/.mplayer/font/\ \ \ \ \ \ 
 Font directory. There must be a font.desc file and files with .RAW extension.
@@ -893,35 +1269,66 @@
 .br
     ~/.mplayer/default.sub
 
+
 .SH "EXAMPLES"
+.TP
 .B Quickstart DVD playing
 mplayer \-dvd 1
-.TP 
+.TP
 .B Play only chapters 5, 6, 7
 mplayer \-dvd 1 \-chapter 5\-7
-.TP 
+.TP
 .B Multiangle DVD playing
 mplayer \-dvd 1 \-dvdangle 2
-.TP 
+.TP
 .B Playing from a different DVD device
 mplayer \-dvd 1 \-dvd\-device /dev/dvd2
-.TP 
+.TP
+.B Old style DVD (VOB) playing
+mplayer \-dvdauth /dev/dvd /mnt/dvd/VIDEO_TS/VTS_02_4.VOB
+.TP
 .B Stream from HTTP
 mplayer http://mplayer.hq/example.avi
-.TP 
+.TP
 .B Convert subtitle to MPsub (to ./dump.mpsub)
 mplayer dummy.avi \-sub source.sub \-dumpmpsub
 .TP
 .B Input from standard V4L
 mplayer \-tv on:driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv
+.TP
+.B Encoding DVD title #2, only selected chapters
+mencoder -dvd 2 -chapter 10-15 -o title2.avi
+.TP
+.B Encoding DVD title #2, resizing to 640x480
+mencoder -dvd 2 -vop scale=640:480 -o title2.avi
+.TP
+.B Encoding DVD title #2, resizing to 512xHHH (keep aspect ratio)
+mencoder -dvd 2 -vop scale -zoom -xy 512 -o title2.avi
+.TP
+.B The same, but with libavcodec family, MPEG4 (Divx5) compression
+mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=1800
+.TP
+.B Encoding all *.jpg files in the current dir
+mencoder \*.jpg -mf on:fps=25 -o output.avi
+.TP
+.B Encoding from tuner (see documentation!)
+mencoder -tv on:driver=v4l:width=640:height=480 -o tv.avi
+.TP
+.B Encoding from a pipe
+rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- -
+.TP
+.B Encoding multiple *.vob files
+cat *.vob | mencoder <options> -
 
-.SH "BUGS"
+
+".SH "BUGS"
 Probably. PLEASE, double-check the documentation (especially bugreports.html),
 the FAQ and the mail archive before!
 
 Send your complete bugreports to the MPlayer-users mailing list at
 <mplayer-users@mplayerhq.hu>. We love complete bugreports :)
 
+
 .SH "AUTHORS"
 Check documentation!
 
@@ -931,6 +1338,11 @@
 This manpage is written and maintained by
 .I Gabucino <sendmail@to.mplayer\-users>.
 
+(Patches done by
+.I Jonas Jermann <sendmail@to.mplayer\-users>
+)
+
+
 .SH "STANDARD DISCLAIMER"
 Use only at your own risk! There may be errors and inaccuracies that could
 be damaging to your system or your eye. Proceed with caution, and although