manpage: merge new manpage

About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.

Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.

Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.

Committers:

* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)

Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.

[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man

1 files changed, 7902 insertions, 0 deletions

diff --git a/DOCS/man/en/mplayer-old.1 b/DOCS/man/en/mplayer-old.1
new file mode 100644
index 0000000000..0e1ff45516
--- /dev/null
+++ b/DOCS/man/en/mplayer-old.1
@@ -0,0 +1,7902 @@
+.\" $Revision$
+.\" MPlayer (C) 2000-2010 MPlayer Team
+.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
+.
+.\" --------------------------------------------------------------------------
+.\" Macro definitions
+.\" --------------------------------------------------------------------------
+.
+.\" define indentation for suboptions
+.nr SS 5
+.\" add new suboption
+.de IPs
+.IP "\\$1" \n(SS
+..
+.\" begin of first level suboptions, end with .RE
+.de RSs
+.RS 10
+..
+.\" begin of 2nd level suboptions
+.de RSss
+.PD 0
+.RS \n(SS+3
+..
+.\" end of 2nd level suboptions
+.de REss
+.RE
+.PD 1
+..
+.
+.\" --------------------------------------------------------------------------
+.\" Title
+.\" --------------------------------------------------------------------------
+.
+.TH MPlayer 1 "2009-03-25" "The MPlayer Project" "The Movie Player"
+.
+.SH NAME
+mplayer \- movie player
+.
+.\" --------------------------------------------------------------------------
+.\" Synopsis
+.\" --------------------------------------------------------------------------
+.
+.SH SYNOPSIS
+.na
+.nh
+.B mplayer
+[options] [file|URL|playlist|\-]
+.
+.br
+.B mplayer
+[options] file1
+[specific options] [file2] [specific options]
+.
+.br
+.B mplayer
+[options]
+{group of files and options}
+[group-specific options]
+.
+.br
+.B mplayer
+[br]://[title][/device]
+[options]
+.
+.br
+.B mplayer
+[dvd|dvdnav]://[title|[start_title]\-end_title][/device]
+[options]
+.
+.br
+.B mplayer
+vcd://track[/device]
+.
+.br
+.B mplayer
+tv://[channel][/input_id]
+[options]
+.
+.br
+.B mplayer
+radio://[channel|frequency][/capture]
+[options]
+.
+.br
+.B mplayer
+pvr://
+[options]
+.
+.br
+.B mplayer
+dvb://[card_number@]channel
+[options]
+.
+.br
+.B mplayer
+mf://[filemask|@listfile]
+[\-mf options] [options]
+.
+.br
+.B mplayer
+[cdda|cddb]://track[\-endtrack][:speed][/device]
+[options]
+.
+.br
+.B mplayer
+cue://file[:track]
+[options]
+.
+.br
+.B mplayer
+[file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]://
+[user:pass@]URL[:port] [options]
+.
+.br
+.B mplayer
+sdp://file
+[options]
+.
+.br
+.B mplayer
+mpst://host[:port]/URL
+[options]
+.
+.br
+.B mplayer
+tivo://host/[list|llist|fsid]
+[options]
+.ad
+.hy
+.
+.\" --------------------------------------------------------------------------
+.\" Description
+.\" --------------------------------------------------------------------------
+.
+.SH DESCRIPTION
+.B mplayer
+is a movie player for Linux (runs on many other platforms and CPU
+architectures, see the documentation).
+It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, Ogg/\:OGM,
+MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
+native and binary codecs.
+You can watch VCD, SVCD, DVD, Blu\-ray, 3ivx, DivX 3/4/5, WMV and even H.264 movies,
+too.
+.PP
+MPlayer supports a wide range of video and audio output drivers.
+It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB,
+Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers),
+VESA (on every VESA-compatible card, even without X11), some low-level
+card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder
+boards, such as the Siemens DVB, Hauppauge PVR (IVTV) and DXR3/\:Hollywood+.
+Most of them support software or hardware scaling, so you can enjoy movies in
+fullscreen mode.
+.PP
+MPlayer has an onscreen display (OSD) for status information, nice big
+antialiased shaded subtitles and visual feedback for keyboard controls.
+European/\:ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
+fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM,
+SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and
+DVD subtitles (SPU streams, VOBsub and Closed Captions).
+.PP
+Usage examples to get you started quickly can be found at the end
+of this man page.
+.PP
+.B Also see the HTML documentation!
+.
+.
+.\" --------------------------------------------------------------------------
+.\" interactive control
+.\" --------------------------------------------------------------------------
+.
+.SH "INTERACTIVE CONTROL"
+MPlayer has a fully configurable, command-driven control layer
+which allows you to control MPlayer using keyboard, mouse, joystick
+or remote control (with LIRC).
+See the \-input option for ways to customize it.
+.
+.TP
+.B keyboard control
+.PD 0
+.RS
+.IPs "LEFT and RIGHT"
+Seek backward/\:forward 10 seconds.
+Shift+arrow does a 1 second exact seek (see \-hr\-seek; currently modifier
+keys like shift only work if used in an X output window).
+.IPs "UP and DOWN"
+Seek forward/\:backward 1 minute.
+Shift+arrow does a 5 second exact seek (see \-hr\-seek; currently modifier
+keys like shift only work if used in an X output window).
+.IPs "PGUP and PGDWN"
+Seek forward/\:backward 10 minutes.
+.IPs "[ and ]"
+Decrease/increase current playback speed by 10%.
+.IPs "{ and }"
+Halve/double current playback speed.
+.IPs "BACKSPACE"
+Reset playback speed to normal.
+.IPs "< and >"
+Go backward/\:forward in the playlist.
+.IPs "ENTER"
+Go forward in the playlist, even over the end.
+.IPs "HOME and END"
+next/\:previous playtree entry in the parent list
+.IPs "INS and DEL (ASX playlist only)"
+next/\:previous alternative source.
+.IPs "p / SPACE"
+Pause (pressing again unpauses).
+.IPs ".\ \ \ \ "
+Step forward.
+Pressing once will pause movie, every consecutive press will play one frame
+and then go into pause mode again.
+.IPs "q / ESC"
+Stop playing and quit.
+.IPs "U\ \ \ \ "
+Stop playing (and quit if \-idle is not used).
+.IPs "+ and \-"
+Adjust audio delay by +/\- 0.1 seconds.
+.IPs "/ and *"
+Decrease/\:increase volume.
+.IPs "9 and 0"
+Decrease/\:increase volume.
+.IPs "( and )"
+Adjust audio balance in favor of left/\:right channel.
+.IPs "m\ \ \ \ "
+Mute sound.
+.IPs "_ (MPEG-TS, AVI and libavformat only)"
+Cycle through the available video tracks.
+.IPs "# (DVD, Blu-ray, MPEG, Matroska, AVI and libavformat only)"
+Cycle through the available audio tracks.
+.IPs "TAB (MPEG-TS and libavformat only)"
+Cycle through the available programs.
+.IPs "f\ \ \ \ "
+Toggle fullscreen (also see \-fs).
+.IPs "T\ \ \ \ "
+Toggle stay-on-top (also see \-ontop).
+.IPs "w and e"
+Decrease/\:increase pan-and-scan range.
+.IPs "o\ \ \ \ "
+Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
+.IPs "d\ \ \ \ "
+Toggle frame dropping states: none / skip display / skip decoding
+(see \-framedrop and \-hardframedrop).
+.IPs "v\ \ \ \ "
+Toggle subtitle visibility.
+.IPs "j and J"
+Cycle through the available subtitles.
+.IPs "y and g"
+Step forward/backward in the subtitle list.
+.IPs "F\ \ \ \ "
+Toggle displaying "forced subtitles".
+.IPs "a\ \ \ \ "
+Toggle subtitle alignment: top / middle / bottom.
+.IPs "x and z"
+Adjust subtitle delay by +/\- 0.1 seconds.
+.IPs "V\ \ \ \ "
+Toggle subtitle VSFilter aspect compatibility mode.
+See -ass\-vsfilter\-aspect\-compat for more info.
+.IPs "C (\-capture only)"
+Start/stop capturing the primary stream.
+.IPs "r and t"
+Move subtitles up/down.
+.IPs "i (\-edlout mode only)"
+Set start or end of an EDL skip and write it out to the given file.
+.IPs "s (\-vf screenshot only)"
+Take a screenshot.
+.IPs "S (\-vf screenshot only)"
+Start/stop taking screenshots.
+.IPs "I\ \ \ \ "
+Show filename on the OSD.
+.IPs "P\ \ \ \ "
+Show progression bar, elapsed time and total duration on the OSD.
+.IPs "! and @"
+Seek to the beginning of the previous/next chapter.
+.IPs "D (\-vo vdpau, \-vf yadif, \-vf kerndeint only)"
+Activate/deactivate deinterlacer.
+.IPs "A\ \ \ \ "
+Cycle through the available DVD angles.
+.IPs "c (currently -vo vdpau and -vo xv only)"
+Change YUV colorspace.
+.RE
+.PD 1
+.PP
+.RS
+(The following keys are valid only when using a video output that supports
+the corresponding adjustment, the software equalizer
+(\-vf eq or \-vf eq2) or hue filter (\-vf hue).)
+.RE
+.PP
+.PD 0
+.RS
+.IPs "1 and 2"
+Adjust contrast.
+.IPs "3 and 4"
+Adjust brightness.
+.IPs "5 and 6"
+Adjust hue.
+.IPs "7 and 8"
+Adjust saturation.
+.RE
+.PD 1
+.PP
+.RS
+(The following keys are valid only when using the quartz or corevideo
+video output driver.)
+.RE
+.PP
+.PD 0
+.RS
+.IPs "command + 0"
+Resize movie window to half its original size.
+.IPs "command + 1"
+Resize movie window to its original size.
+.IPs "command + 2"
+Resize movie window to double its original size.
+.IPs "command + f"
+Toggle fullscreen (also see \-fs).
+.IPs "command + [ and command + ]"
+Set movie window alpha.
+.RE
+.PD 1
+.PP
+.RS
+(The following keys are valid only when using the sdl
+video output driver.)
+.RE
+.PP
+.PD 0
+.RS
+.IPs "c\ \ \ \ "
+Cycle through available fullscreen modes.
+.IPs "n\ \ \ \ "
+Restore original mode.
+.RE
+.PD 1
+.PP
+.RS
+(The following keys are valid if you have a keyboard
+with multimedia keys.)
+.RE
+.PP
+.PD 0
+.RS
+.IPs PAUSE
+Pause.
+.IPs "STOP\ "
+Stop playing and quit.
+.IPs "PREVIOUS and NEXT"
+Seek backward/\:forward 1 minute.
+.RE
+.PD 1
+.PP
+.RS
+(The following keys are only valid if you compiled with TV or DVB input
+support and will take precedence over the keys defined above.)
+.RE
+.PP
+.PD 0
+.RS
+.IPs "h and k"
+Select previous/\:next channel.
+.IPs "n\ \ \ \ "
+Change norm.
+.IPs "u\ \ \ \ "
+Change channel list.
+.RE
+.PD 1
+.PP
+.RS
+(The following keys are only valid if you compiled with dvdnav
+support: They are used to navigate the menus.)
+.RE
+.PP
+.PD 0
+.RS
+.IPs "keypad 8"
+Select button up.
+.IPs "keypad 2"
+Select button down.
+.IPs "keypad 4"
+Select button left.
+.IPs "keypad 6"
+Select button right.
+.IPs "keypad 5"
+Return to main menu.
+.IPs "keypad 7"
+Return to nearest menu (the order of preference is: chapter->title->root).
+.IPs "keypad ENTER"
+Confirm choice.
+.RE
+.PD 1
+.PP
+.RS
+.
+(The following keys are used for controlling TV teletext. The data may
+come from either an analog TV source or an MPEG transport stream.)
+.RE
+.PP
+.PD 0
+.RS
+.IPs "X\ \ \ \ "
+Switch teletext on/\:off.
+.IPs "Q and W"
+Go to next/\:prev teletext page.
+.RE
+.PD 1
+.
+.TP
+.B mouse control
+.PD 0
+.RS
+.IPs "button 3 and button 4"
+Seek backward/\:forward 1 minute.
+.IPs "button 5 and button 6"
+Decrease/\:increase volume.
+.RE
+.PD 1
+.
+.TP
+.B joystick control
+.PD 0
+.RS
+.IPs "left and right"
+Seek backward/\:forward 10 seconds.
+.IPs "up and down"
+Seek forward/\:backward 1 minute.
+.IPs "button 1"
+Pause.
+.IPs "button 2"
+Toggle OSD states: none / seek / seek + timer / seek + timer + total time.
+.IPs "button 3 and button 4"
+Decrease/\:increase volume.
+.RE
+.PD 1
+.
+.
+.\" --------------------------------------------------------------------------
+.\" Usage
+.\" --------------------------------------------------------------------------
+.
+.SH "USAGE"
+Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
+\-fs option is \-nofs.
+.PP
+If an option is marked as (XXX only), it will only work in combination with
+the XXX option or if XXX is compiled in.
+.PP
+.I NOTE:
+The suboption parser (used for example for \-ao pcm suboptions) supports
+a special kind of string-escaping intended for use with external GUIs.
+.br
+It has the following format:
+.br
+%n%string_of_length_n
+.br
+.I EXAMPLES:
+.br
+mplayer \-ao pcm:file=%10%C:test.wav test.avi
+.br
+Or in a script:
+.br
+mplayer \-ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
+.PP
+.
+.\" --------------------------------------------------------------------------
+.\" Configuration files
+.\" --------------------------------------------------------------------------
+.
+.SH "CONFIGURATION FILES"
+You can put all of the options in configuration files which will be read
+every time MPlayer is run.
+The system-wide configuration file 'mplayer.conf' is in your configuration
+directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
+specific one is '~/\:.mplayer/\:config'.
+User specific options override system-wide options and options given on the
+command line override either.
+The syntax of the configuration files is 'option=<value>', everything after
+a '#' is considered a comment.
+Options that work without values can be enabled by setting them to 'yes'
+or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'.
+Even suboptions can be specified in this way.
+.PP
+You can also write file-specific configuration files.
+If you wish to have a configuration file for a file called 'movie.avi', create a file
+named 'movie.avi.conf' with the file-specific options in it and put it in
+~/.mplayer/.
+You can also put the configuration file in the same directory as the file to
+be played, as long as you give the \-use\-filedir\-conf option (either on the
+command line or in your global config file).
+If a file-specific configuration file is found in the same directory, no
+file-specific configuration is loaded from ~/.mplayer.
+In addition, the \-use\-filedir\-conf option enables directory-specific
+configuration files.
+For this, MPlayer first tries to load a mplayer.conf from the same directory as
+the file played and then tries to load any file-specific configuration.
+.PP
+.I EXAMPLE MPLAYER CONFIGURATION FILE:
+.sp 1
+.nf
+# Use Matrox driver by default.
+vo=xmga
+# I love practicing handstands while watching videos.
+flip=yes
+# Decode multiple files from PNG,
+# start with mf://filemask
+mf=type=png:fps=25
+# Eerie negative images are cool.
+vf=eq2=1.0:\-0.8
+.fi
+.
+.\" --------------------------------------------------------------------------
+.\" Profiles
+.\" --------------------------------------------------------------------------
+.
+.SH "PROFILES"
+To ease working with different configurations profiles can be defined in the
+configuration files.
+A profile starts with its name between square brackets, e.g.\& '[my-profile]'.
+All following options will be part of the profile.
+A description (shown by \-profile help) can be defined with the profile-desc
+option.
+To end the profile, start another one or use the profile name 'default'
+to continue with normal options.
+.fi
+.PP
+.I "EXAMPLE MPLAYER PROFILE:"
+.sp 1
+.nf
+
+[protocol.dvd]
+profile-desc="profile for dvd:// streams"
+vf=pp=hb/vb/dr/al/fd
+alang=en
+
+[protocol.dvdnav]
+profile-desc="profile for dvdnav:// streams"
+profile=protocol.dvd
+mouse-movements=yes
+nocache=yes
+
+[extension.flv]
+profile-desc="profile for .flv files"
+flip=yes
+
+[vo.pnm]
+outdir=/tmp
+
+[ao.alsa]
+device=spdif
+.fi
+.
+.\" --------------------------------------------------------------------------
+.\" Options
+.\" --------------------------------------------------------------------------
+.
+.SH "GENERAL OPTIONS"
+.
+.TP
+.B \-codecpath <dir>
+Specify a directory for binary codecs.
+.
+.TP
+.B \-codecs\-file <filename> (also see \-afm, \-ac, \-vfm, \-vc)
+Override the standard search path and use the specified file
+instead of the builtin codecs.conf.
+.
+.TP
+.B \-include <configuration file>
+Specify configuration file to be parsed after the default ones.
+.
+.TP
+.B \-list\-options
+Prints all available options.
+.
+.TP
+.B \-msgcharset <charset>
+Convert console messages to the specified character set (default: autodetect).
+Text will be in the encoding specified with the \-\-charset configure option.
+Set this to "noconv" to disable conversion (for e.g.\& iconv problems).
+.br
+.I NOTE:
+The option takes effect after command line parsing has finished.
+The MPLAYER_CHARSET environment variable can help you get rid of
+the first lines of garbled output.
+.
+.TP
+.B \-msgcolor
+Enable colorful console output on terminals that support ANSI color.
+.
+.TP
+.B \-msglevel <all=<level>:<module>=<level>:...>
+Control verbosity directly for each module.
+The 'all' module changes the verbosity of all the modules not
+explicitly specified on the command line.
+See '\-msglevel help' for a list of all modules.
+.br
+.I NOTE:
+Some messages are printed before the command line is parsed and are
+therefore not affected by \-msglevel.
+To control these messages you have to use the MPLAYER_VERBOSE environment
+variable, see its description below for details.
+.br
+Available levels:
+.PD 0
+.RSs
+.IPs "\-1"
+complete silence
+.IPs " 0"
+fatal messages only
+.IPs " 1"
+error messages
+.IPs " 2"
+warning messages
+.IPs " 3"
+short hints
+.IPs " 4"
+informational messages
+.IPs " 5"
+status messages (default)
+.IPs " 6"
+verbose messages
+.IPs " 7"
+debug level 2
+.IPs " 8"
+debug level 3
+.IPs " 9"
+debug level 4
+.RE
+.PD 1
+.
+.TP
+.B \-msgmodule
+Prepend module name in front of each console message.
+.
+.TP
+.B \-noconfig <options>
+Do not parse selected configuration files.
+.br
+.I NOTE:
+If \-include or \-use\-filedir\-conf options are
+specified at the command line, they will be honoured.
+.sp 1
+Available options are:
+.PD 0
+.RSs
+.IPs "all\ \ "
+all configuration files
+.IPs system
+system configuration file
+.IPs "user\ "
+user configuration file
+.RE
+.PD 1
+.
+.TP
+.B "\-quiet\ "
+Make console output less verbose; in particular, prevents the status line
+(i.e.\& A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.
+Particularly useful on slow terminals or broken ones which do not properly
+handle carriage return (i.e.\& \\r).
+.
+.TP
+.B \-priority <prio> (Windows and OS/2 only)
+Set process priority for MPlayer according to the predefined
+priorities available under Windows and OS/2.
+Possible values of <prio>:
+.RSs
+idle|belownormal|normal|abovenormal|high|realtime
+.RE
+.sp 1
+.RS
+.I WARNING:
+Using realtime priority can cause system lockup.
+.RE
+.
+.TP
+.B \-profile <profile1,profile2,...>
+Use the given profile(s), \-profile help displays a list of the defined profiles.
+.
+.TP
+.B \-really\-quiet (also see \-quiet)
+Display even less output and status messages than with \-quiet.
+.
+.TP
+.B \-show\-profile <profile>
+Show the description and content of a profile.
+.
+.TP
+.B \-use\-filedir\-conf
+Look for a file-specific configuration file in the same directory as
+the file that is being played.
+.br
+.I WARNING:
+May be dangerous if playing from untrusted media.
+.
+.TP
+.B "\-v\ \ \ \ \ "
+Increment verbosity level, one level for each \-v
+found on the command line.
+.
+.
+.
+.SH "PLAYER OPTIONS"
+.
+.TP
+.B \-autoq <quality> (use with \-vf [s]pp)
+Dynamically changes the level of postprocessing depending on the available spare
+CPU time.
+The number you specify will be the maximum level used.
+Usually you can use some big number.
+You have to use \-vf [s]pp without parameters in order for this to work.
+.
+.TP
+.B \-autosync <factor>
+Gradually adjusts the A/V sync based on audio delay measurements.
+Specifying \-autosync 0, the default, will cause frame timing to be based
+entirely on audio delay measurements.
+Specifying \-autosync 1 will do the same, but will subtly change the A/V
+correction algorithm.
+An uneven video framerate in a movie which plays fine with \-nosound can
+often be helped by setting this to an integer value greater than 1.
+The higher the value, the closer the timing will be to \-nosound.
+Try \-autosync 30 to smooth out problems with sound drivers which do
+not implement a perfect audio delay measurement.
+With this value, if large A/V sync offsets occur, they will only take about
+1 or 2 seconds to settle out.
+This delay in reaction time to sudden A/V offsets should be the only
+side-effect of turning this option on, for all sound drivers.
+.
+.TP
+.B \-benchmark
+Prints some statistics on CPU usage and dropped frames at the end of playback.
+Use in combination with \-nosound and \-vo null for benchmarking only the
+video codec.
+.br
+.I NOTE:
+With this option MPlayer will also ignore frame duration when playing
+only video (you can think of that as infinite fps).
+.
+.TP
+.B \-chapter\-merge\-threshold <number>
+Threshold for merging almost consecutive ordered chapter parts
+in milliseconds (default: 100).
+Some Matroska files with ordered chapters have inaccurate chapter
+end timestamps, causing a small gap between the end of one chapter and
+the start of the next one when they should match.
+If the end of one playback part is less than the given threshold away
+from the start of the next one then keep playing video normally over the
+chapter change instead of doing a seek.
+.
+.TP
+.B \-colorkey <number>
+Changes the colorkey to an RGB value of your choice.
+0x000000 is black and 0xffffff is white.
+Only supported by the fbdev, svga, vesa, xmga,
+xover, xv (see \-vo xv:ck) and directx video output drivers.
+.
+.TP
+.B \-nocolorkey
+Disables colorkeying.
+Only supported by the fbdev, svga, vesa, xmga,
+xover, xv (see \-vo xv:ck) and directx video output drivers.
+.
+.TP
+.B \-correct\-pts, \-nocorrect\-pts
+Switches MPlayer to a mode where timestamps for video frames
+are calculated differently and video filters which add new frames or
+modify timestamps of existing ones are supported.
+Now enabled automatically for most common file formats.
+The more accurate timestamps can be visible for example when playing
+subtitles timed to scene changes with the \-ass option.
+Without \-correct\-pts the subtitle timing will typically be off by some frames.
+This option does not work correctly with some demuxers and codecs.
+.
+.TP
+.B \-crash\-debug (DEBUG CODE)
+Automatically attaches gdb upon crash or SIGTRAP.
+Support must be compiled in by configuring with \-\-enable\-crash\-debug.
+.
+.TP
+.B \-doubleclick\-time
+Time in milliseconds to recognize two consecutive button presses as
+a double-click (default: 300).
+Set to 0 to let your windowing system decide what a double-click is
+(\-vo directx only).
+.
+.TP
+.B \-edlout <filename>
+Creates a new file and writes edit decision list (EDL) records to it.
+During playback, the user hits 'i' to mark the start or end of a skip block.
+This provides a starting point from which the user can fine-tune EDL entries
+later.
+See http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details.
+.
+.TP
+.B \-fixed\-vo, \-nofixed\-vo
+\-fixed\-vo enforces a fixed video system for multiple files (one
+(un)initialization for all files).
+Therefore only one window will be opened for all files.
+Now enabled by default, use \-nofixed\-vo to disable and create a new window
+whenever the video stream changes.
+Some of the older drivers may not be fixed-vo compliant.
+.
+.TP
+.B \-framedrop (also see \-hardframedrop, experimental without \-nocorrect\-pts)
+Skip displaying some frames to maintain A/V sync on slow systems.
+Video filters are not applied to such frames.
+For B-frames even decoding is skipped completely.
+.
+.TP
+.B \-h, \-help, \-\-help
+Show short summary of options.
+.
+.TP
+.B \-hardframedrop (experimental without \-nocorrect\-pts)
+More intense frame dropping (breaks decoding).
+Leads to image distortion!
+Note that especially the libmpeg2 decoder may crash with this,
+so consider using "\-vc ffmpeg12,".
+.
+.TP
+.B \-heartbeat\-cmd
+Command that is executed every 30 seconds during playback via system() -
+i.e.\& using the shell.
+.sp 1
+.I NOTE:
+MPlayer uses this command without any checking, it is your responsibility
+to ensure it does not cause security problems (e.g.\& make sure to use full
+paths if "." is in your path like on Windows).
+It also only works when playing video (i.e.\& not with \-novideo but works with \-vo null).
+.sp 1
+This can be "misused" to disable screensavers that do not support the proper
+X API (also see \-stop\-xscreensaver).
+If you think this is too complicated, ask the author of the screensaver
+program to support the proper X APIs.
+.sp 1
+.I EXAMPLE for xscreensaver:
+mplayer \-heartbeat\-cmd "xscreensaver\-command \-deactivate" file
+.sp 1
+.I EXAMPLE for GNOME screensaver:
+mplayer \-heartbeat\-cmd "gnome\-screensaver\-command \-p" file
+.RE
+.PD 1
+.
+.TP
+.B \-hr\-seek off|absolute|always
+Select when to use precise seeks that are not limited to keyframes.
+Such seeks require decoding video from the previous keyframe up to the target
+position and so can take some time depending on decoding performance.
+For some video formats precise seeks are disabled. This option selects the
+default choice to use for seeks; it's possible to explicitly override that
+default in the definition of key bindings and in slave mode commands.
+.PD 0
+.RSs
+.IPs off
+Never use precise seeks.
+.IPs absolute
+Use precise seeks if the seek is to an absolute position in the file,
+such as a chapter seek, but not for relative seeks like the default
+behavior of arrow keys (default).
+.IPs always
+Use precise seeks whenever possible.
+.RE
+.PD 1
+.
+.TP
+.B \-identify
+Shorthand for \-msglevel identify=4.
+Show file parameters in an easily parseable format.
+Also prints more detailed information about subtitle and audio
+track languages and IDs.
+In some cases you can get more information by using \-msglevel identify=6.
+For example, for a DVD or Blu\-ray it will list the chapters and time length
+of each title, as well as a disk ID.
+Combine this with \-frames 0 to suppress all video output.
+The wrapper script TOOLS/\:midentify.sh suppresses the other MPlayer output and
+(hopefully) shellescapes the filenames.
+.
+.TP
+.B \-idle (also see \-slave)
+Makes MPlayer wait idly instead of quitting when there is no file to play.
+Mostly useful in slave mode where MPlayer can be controlled
+through input commands.
+.
+.TP
+.B \-input <commands>
+This option can be used to configure certain parts of the input system.
+Paths are relative to ~/.mplayer/.
+.br
+.I NOTE:
+Autorepeat is currently only supported by joysticks.
+.sp 1
+Available commands are:
+.sp 1
+.PD 0
+.RSs
+.IPs conf=<filename>
+Specify input configuration file other than the default
+~/\:.mplayer/\:input.conf.
+~/\:.mplayer/\:<filename> is assumed if no full path is given.
+.IPs ar-dev=<device>
+Device to be used for Apple IR Remote (default is autodetected, Linux only).
+.IPs ar-delay
+Delay in milliseconds before we start to autorepeat a key (0 to disable).
+.IPs ar-rate
+Number of key presses to generate per second on autorepeat.
+.IPs (no)default-bindings
+Use the key bindings that MPlayer ships with by default.
+.IPs keylist
+Prints all keys that can be bound to commands.
+.IPs cmdlist
+Prints all commands that can be bound to keys.
+.IPs js-dev
+Specifies the joystick device to use (default: /dev/\:input/\:js0).
+.IPs file=<filename>
+Read commands from the given file.
+Mostly useful with a FIFO.
+.br
+.I NOTE:
+When the given file is a FIFO MPlayer opens both ends so you can do
+several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
+.RE
+.PD 1
+.
+.TP
+.B \-key\-fifo\-size <2\-65000>
+Specify the size of the FIFO that buffers key events (default: 7).
+If it is too small some events may be lost.
+The main disadvantage of setting it to a very large value is that if you
+hold down a key triggering some particularly slow command then the player
+may be unresponsive while it processes all the queued commands.
+.
+.TP
+.B \-lircconf <filename> (LIRC only)
+Specifies a configuration file for LIRC (default: ~/.lircrc).
+.
+.TP
+.B \-list\-properties
+Print a list of the available properties.
+.
+.TP
+.B \-loop <number>
+Loops movie playback <number> times.
+0 means forever.
+.
+.TP
+.B \-menu (OSD menu only)
+Turn on OSD menu support.
+.
+.TP
+.B \-menu\-cfg <filename> (OSD menu only)
+Use an alternative menu.conf.
+.
+.TP
+.B \-menu\-chroot <path> (OSD menu only)
+Chroot the file selection menu to a specific location.
+.sp 1
+.I EXAMPLE:
+.PD 0
+.RSs
+.IPs "\-menu\-chroot /home"
+Will restrict the file selection menu to /\:home and downward (i.e.\& no
+access to / will be possible, but /home/user_name will).
+.RE
+.PD 1
+.
+.TP
+.B \-menu\-keepdir (OSD menu only)
+File browser starts from the last known location instead of current directory.
+.
+.TP
+.B \-menu\-root <value> (OSD menu only)
+Specify the main menu.
+.
+.TP
+.B \-menu\-startup (OSD menu only)
+Display the main menu at MPlayer startup.
+.
+.TP
+.B \-mouse\-movements
+Permit MPlayer to receive pointer events reported by the video
+output driver.
+Necessary to select the buttons in DVD menus.
+Supported for X11-based VOs (x11, xv, etc) and the gl, gl2, direct3d and
+corevideo VOs.
+.
+.TP
+.B \-noar
+Turns off AppleIR remote support.
+.
+.TP
+.B \-noconsolecontrols
+Prevent MPlayer from reading key events from standard input.
+Useful when reading data from standard input.
+This is automatically enabled when \- is found on the command line.
+There are situations where you have to set it manually, e.g.\&
+if you open /dev/\:stdin (or the equivalent on your system), use stdin
+in a playlist or intend to read from stdin later on via the loadfile or
+loadlist slave commands.
+.
+.TP
+.B \-noinitial-audio-sync
+When starting a video file or after events such as seeking MPlayer will by
+default modify the audio stream to make it start from the same timestamp as
+video, by either inserting silence at the start or cutting away the first
+samples.
+This option disables that functionality and makes the player behave like
+older MPlayer versions did: video and audio are both started immediately
+even if their start timestamps differ, and then video timing is gradually
+adjusted if necessary to reach correct synchronization later.
+.
+.TP
+.B \-nojoystick
+Turns off joystick support.
+.
+.TP
+.B \-nolirc
+Turns off LIRC support.
+.
+.TP
+.B \-nomouseinput
+Disable mouse button press/\:release input (mozplayerxp's context menu relies
+on this option).
+.TP
+.B \-noordered\-chapters
+Disable support for Matroska ordered chapters.
+MPlayer will not load or search for video segments from other files,
+and will also ignore any chapter order specified for the main file.
+.
+.TP
+.B \-pts\-association\-mode auto|decode|sort
+Select the method used to determine which container packet timestamp
+corresponds to a particular output frame from the video decoder.
+Normally you shouldn't need to change this option.
+.PD 0
+.RSs
+.IPs auto
+Try to pick a working mode from the ones below automatically (default)
+.IPs decoder
+Use decoder reordering functionality.
+.IPs sort
+Maintain a buffer of unused pts values and use the lowest value for the frame.
+.RE
+.PD 1
+.
+.TP
+.B \-rtc (RTC only)
+Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
+mechanism.
+This wakes up the process every 1/1024 seconds to check the current time.
+Useless with modern Linux kernels configured for desktop use as they already
+wake up the process with similar accuracy when using normal timed sleep.
+.
+.TP
+.B \-playing\-msg <string>
+Print out a string before starting playback.
+The following expansions are supported:
+.RSs
+.IPs ${NAME}
+Expand to the value of the property NAME.
+.IPs ?(NAME:TEXT)
+Expand TEXT only if the property NAME is available.
+.IPs ?(!NAME:TEXT)
+Expand TEXT only if the property NAME is not available.
+.RE
+.
+.TP
+.B \-playlist <filename>
+Play files according to a playlist file (ASX, Winamp, SMIL, or
+one-file-per-line format).
+.br
+.I WARNING:
+The way MPlayer parses and uses playlist files is not safe against
+maliciously constructed files.
+Such files may trigger harmful actions.