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, 2517 insertions, 0 deletions

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
new file mode 100644
index 0000000000..0fea91078c
--- /dev/null
+++ b/DOCS/man/en/options.rst
@@ -0,0 +1,2517 @@
+--a52drc=<level>
+    Select the Dynamic Range Compression level for AC-3 audio streams. <level>
+    is a float value ranging from 0 to 1, where 0 means no compression and 1
+    (which is the default) means full compression (make loud passages more
+    silent and vice versa). Values up to 2 are also accepted, but are purely
+    experimental. This option only shows an effect if the AC-3 stream contains
+    the required range compression information.
+
+--abs=<value>
+    (``--ao=oss`` only) (OBSOLETE)
+    Override audio driver/card buffer size detection.
+
+--ac=<[-\|+]codec1,[-\|+]codec2,...[,]>
+    Specify a priority list of audio codecs to be used, according to their
+    codec name in codecs.conf. Use a '-' before the codec name to omit it.
+    Use a '+' before the codec name to force it, this will likely crash! If
+    the list has a trailing ',' MPlayer will fall back on codecs not contained
+    in the list.
+
+    *NOTE*: See ``--ac=help`` for a full list of available codecs.
+
+    *EXAMPLE*:
+
+    :``--ac=mp3acm``:     Force the l3codeca.acm MP3 codec.
+    :``--ac=mad,``:       Try libmad first, then fall back on others.
+    :``--ac=hwac3,a52,``: Try hardware AC-3 passthrough, software AC-3, then
+                          others.
+    :``--ac=hwdts,``:     Try hardware DTS passthrough, then fall back on
+                          others.
+    :``--ac=-ffmp3,``:    Skip FFmpeg's MP3 decoder.
+
+--adapter=<value>
+    Set the graphics card that will receive the image. You can get a list of
+    available cards when you run this option with ``-v``. Currently only works
+    with the directx video output driver.
+
+--af=<filter1[=parameter1:parameter2:...],filter2,...>
+    Specify a list of audio filters to apply to the audio stream. See
+    :ref:`audio_filters` for details and descriptions of the available filters.
+    The option variants ``--af-add``, ``--af-pre``, ``--af-del`` and
+    ``--af-clr`` exist to modify a previously specified list, but you
+    shouldn't need these for typical use.
+
+--af-adv=<force=(0-7):list=(filters)>
+    See also ``--af``.
+    Specify advanced audio filter options:
+
+    force=<0-7>
+        Forces the insertion of audio filters to one of the following:
+
+        0
+            Use completely automatic filter insertion (currently identical to
+            1).
+        1
+            Optimize for accuracy (default).
+        2
+            Optimize for speed. *Warning*: Some features in the audio filters
+            may silently fail, and the sound quality may drop.
+        3
+            Use no automatic insertion of filters and no optimization.
+            *Warning*: It may be possible to crash MPlayer using this setting.
+        4
+            Use automatic insertion of filters according to 0 above, but use
+            floating point processing when possible.
+        5
+            Use automatic insertion of filters according to 1 above, but use
+            floating point processing when possible.
+        6
+            Use automatic insertion of filters according to 2 above, but use
+            floating point processing when possible.
+        7
+            Use no automatic insertion of filters according to 3 above, and
+            use floating point processing when possible.
+
+    list=<filters>
+        Same as ``--af``.
+
+--afm=<driver1,driver2,...>
+    Specify a priority list of audio codec families to be used, according to
+    their codec name in codecs.conf. Falls back on the default codecs if none
+    of the given codec families work.
+
+    *NOTE*: See ``--afm=help`` for a full list of available codec families.
+
+    *EXAMPLE*:
+
+    :``--afm=ffmpeg``:    Try FFmpeg's libavcodec codecs first.
+    :``--afm=acm,dshow``: Try Win32 codecs first.
+
+--aid=<ID>
+    Select audio channel (MPEG: 0-31, AVI/OGM: 1-99, ASF/RM: 0-127, VOB(AC-3):
+    128-159, VOB(LPCM): 160-191, MPEG-TS 17-8190). MPlayer prints the
+    available audio IDs when run in verbose (-v) mode. When playing an MPEG-TS
+    stream, MPlayer will use the first program (if present) with the chosen
+    audio stream. See also ``--alang``.
+
+--alang=<languagecode[,languagecode,...]>
+    Specify a priority list of audio languages to use. Different container
+    formats employ different language codes. DVDs use ISO 639-1 two letter
+    language codes, Matroska, MPEG-TS and NUT use ISO 639-2 three letter
+    language codes while OGM uses a free-form identifier. MPlayer prints the
+    available languages when run in verbose (``-v``) mode. See also ``--aid``.
+
+    *EXAMPLE*:
+
+    ``mplayer dvd://1 --alang=hu,en``
+        Chooses the Hungarian language track on a DVD and falls back on
+        English if Hungarian is not available.
+    ``mplayer --alang=jpn example.mkv``
+        Plays a Matroska file in Japanese.
+
+--ao=<driver1[:suboption1[=value]:...],driver2,...[,]>
+    Specify a priority list of audio output drivers to be used. For
+    interactive use you'd normally specify a single one to use, but in
+    configuration files specifying a list of fallbacks may make sense. See
+    :ref:`audio_outputs` for details and descriptions of available drivers.
+
+--ar, --no-ar
+      Enable/disable AppleIR remote support. Enabled by default.
+
+--aspect=<ratio>
+    Override movie aspect ratio, in case aspect information is incorrect or
+    missing in the file being played. See also ``--noaspect``.
+
+    *EXAMPLE*:
+
+    - ``--aspect=4:3``  or ``--aspect=1.3333``
+    - ``--aspect=16:9`` or ``--aspect=1.7777``
+
+--ass, --no-ass
+    Use libass to render all text subtitles. This enables support for the
+    native styling of SSA/ASS subtitles, and also support for some styling
+    features in other subtitle formats by conversion to ASS markup. Enabled by
+    default if the player was compiled with libass support.
+
+    *NOTE*: Some of the other subtitle options were written for the old
+    non-libass subtitle rendering system and may not work the same way or at
+    all with libass rendering enabled.
+
+--ass-border-color=<value>
+    Sets the border (outline) color for text subtitles. The color format is
+    RRGGBBAA.
+
+--ass-bottom-margin=<value>
+    Adds a black band at the bottom of the frame. The SSA/ASS renderer can
+    place subtitles there (with ``--ass-use-margins``).
+
+--ass-color=<value>
+    Sets the color for text subtitles. The color format is RRGGBBAA.
+
+--ass-font-scale=<value>
+    Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
+
+--ass-force-style=<[Style.]Param=Value[,...]>
+    Override some style or script info parameters.
+
+    *EXAMPLE*:
+
+    - ``--ass-force-style=FontName=Arial,Default.Bold=1``
+    - ``--ass-force-style=PlayResY=768``
+
+--ass-hinting=<type>
+    Set hinting type. <type> can be:
+
+    :0:       no hinting
+    :1:       FreeType autohinter, light mode
+    :2:       FreeType autohinter, normal mode
+    :3:       font native hinter
+    :0-3 + 4: The same, but hinting will only be performed if the OSD is
+              rendered at screen resolution and will therefore not be scaled.
+
+    The default value is 0 (no hinting).
+
+--ass-line-spacing=<value>
+    Set line spacing value for SSA/ASS renderer.
+
+--ass-styles=<filename>
+    Load all SSA/ASS styles found in the specified file and use them for
+    rendering text subtitles. The syntax of the file is exactly like the ``[V4
+    Styles]`` / ``[V4+ Styles]`` section of SSA/ASS.
+
+--ass-top-margin=<value>
+    Adds a black band at the top of the frame. The SSA/ASS renderer can place
+    toptitles there (with ``--ass-use-margins``).
+
+--ass-use-margins
+    Enables placing toptitles and subtitles in black borders when they are
+    available.
+
+--ass-vsfilter-aspect-compat
+    Stretch SSA/ASS subtitles when playing anamorphic videos for compatibility
+    with traditional VSFilter behavior. This switch has no effect when the
+    video is stored with square pixels.
+
+    The renderer historically most commonly used for the SSA/ASS subtitle
+    formats, VSFilter, had questionable behavior that resulted in subtitles
+    being stretched too if the video was stored in anamorphic format that
+    required scaling for display.  This behavior is usually undesirable and
+    newer VSFilter versions may behave differently. However, many existing
+    scripts compensate for the stretching by modifying things in the opposite
+    direction.  Thus if such scripts are displayed "correctly" they will not
+    appear as intended.  This switch enables emulation of the old VSFilter
+    behavior (undesirable but expected by many existing scripts).
+
+    Enabled by default.
+
+--audio-demuxer=<[+]name>
+    Force audio demuxer type when using ``--audiofile``. Use a '+' before the
+    name to force it, this will skip some checks! Give the demuxer name as
+    printed by ``--audio-demuxer=help``. ``--audio-demuxer=audio`` forces MP3.
+
+--audiofile=<filename>
+    Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
+    movie.
+
+--audiofile-cache=<kBytes>
+    Enables caching for the stream used by ``--audiofile``, using the
+    specified amount of memory.
+
+--ausid=<ID>
+    Select audio substream channel. Currently the valid range is 0x55..0x75
+    and applies only to MPEG-TS when handled by the native demuxer (not by
+    libavformat). The format type may not be correctly identified because of
+    how this information (or lack thereof) is embedded in the stream, but it
+    will demux correctly the audio streams when multiple substreams are
+    present. MPlayer prints the available substream IDs when run with
+    ``--identify``. See also ``--alang``.
+
+--autoq=<quality>
+    Used 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.
+
+--autosub, --no-autosub
+    Load additional subtitle files matching the video filename. Enabled by
+    default. See also ``--sub-fuzziness``.
+
+--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.
+
+--bandwidth=<Bytes>
+    Specify the maximum bandwidth for network streaming (for servers that are
+    able to send content in different bitrates). Useful if you want to watch
+    live streamed media behind a slow connection. With Real RTSP streaming, it
+    is also used to set the maximum delivery bandwidth allowing faster cache
+    filling and stream dumping.
+
+--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.
+
+    *NOTE*: With this option MPlayer will also ignore frame duration when
+    playing only video (you can think of that as infinite fps).
+
+--bluray-angle=<ID>
+    Some Blu-ray discs contain scenes that can be viewed from multiple angles.
+    Here you can tell MPlayer which angles to use (default: 1).
+
+--bluray-chapter=<ID>
+    (Blu-ray only)
+    Tells MPlayer which Blu-ray chapter to start the current title from
+    (default: 1).
+
+--bluray-device=<path>
+    (Blu-ray only)
+    Specify the Blu-ray disc location. Must be a directory with Blu-ray
+    structure.
+
+--border, --no-border
+    Play movie with window border and decorations. Since this is on by
+    default, use ``--no-border`` to disable the standard window decorations.
+
+--bpp=<depth>
+    Override the autodetected color depth. Only supported by the fbdev, dga,
+    svga, vesa video output drivers.
+
+--brightness=<-100-100>
+    Adjust the brightness of the video signal (default: 0). Not supported by
+    all video output drivers.
+
+--cache=<kBytes>
+    Enable caching of the input stream (if not already enabled) and set the
+    size of the cache in kilobytes. Caching is enabled by default (with a
+    default cache size) for network streams. May be useful when playing files
+    from slow media, but can also have negative effects, especially with file
+    formats that require a lot of seeking, such as mp4. See also ``--nocache``.
+
+--cache-min=<percentage>
+    Playback will start when the cache has been filled up to <percentage> of
+    the total.
+
+--cache-seek-min=<percentage>
+    If a seek is to be made to a position within <percentage> of the cache
+    size from the current position, MPlayer will wait for the cache to be
+    filled to this position rather than performing a stream seek (default:
+    50).
+
+--capture
+    Allows capturing the primary stream (not additional audio tracks or other
+    kind of streams) into the file specified by ``--dumpfile`` or by default.
+    If this option is given, capturing can be started and stopped by pressing
+    the key bound to this function (see section `INTERACTIVE CONTROL`_). Same
+    as for ``--dumpstream``, this will likely not produce usable results for
+    anything else than MPEG streams. Note that, due to cache latencies,
+    captured data may begin and end somewhat delayed compared to what you see
+    displayed.
+
+--cdda=<option1:option2>
+    This option can be used to tune the CD Audio reading feature of MPlayer.
+
+    Available options are:
+
+    speed=<value>
+        Set CD spin speed.
+
+    paranoia=<0-2>
+        Set paranoia level. Values other than 0 seem to break playback of
+        anything but the first track.
+
+        :0: disable checking (default)
+        :1: overlap checking only
+        :2: full data correction and verification
+
+    generic-dev=<value>
+        Use specified generic SCSI device.
+
+    sector-size=<value>
+        Set atomic read size.
+
+    overlap=<value>
+        Force minimum overlap search during verification to <value> sectors.
+
+    toc-bias
+        Assume that the beginning offset of track 1 as reported in the TOC
+        will be addressed as LBA 0. Some Toshiba drives need this for getting
+        track boundaries correct.
+
+    toc-offset=<value>
+        Add <value> sectors to the values reported when addressing tracks. May
+        be negative.
+
+    (no)skip
+        (Never) accept imperfect data reconstruction.
+
+--cdrom-device=<path>
+    Specify the CD-ROM device (default: ``/dev/cdrom``).
+
+--channels=<number>
+    Request the number of playback channels (default: 2). MPlayer asks the
+    decoder to decode the audio into as many channels as specified. Then it is
+    up to the decoder to fulfill the requirement. This is usually only
+    important when playing videos with AC-3 audio (like DVDs). In that case
+    liba52 does the decoding by default and correctly downmixes the audio into
+    the requested number of channels. To directly control the number of output
+    channels independently of how many channels are decoded, use the channels
+    filter (``--af=channels``).
+
+    *NOTE*: This option is honored by codecs (AC-3 only), filters (surround)
+    and audio output drivers (OSS at least).
+
+    Available options are:
+
+    :2: stereo
+    :4: surround
+    :6: full 5.1
+    :8: full 7.1
+
+--chapter=<start[-end]>
+    Specify which chapter to start playing at. Optionally specify which
+    chapter to end playing at (default: 1).
+
+--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.
+
+--codecpath=<dir>
+    Specify a directory for binary codecs.
+
+--codecs-file=<filename>
+    Override the standard search path and use the specified file instead of
+    the builtin codecs.conf.
+
+--colormatrix=<colorspace>
+    Controls the YUV to RGB color space conversion when playing video. There
+    are various standards. Normally, BT.601 should be used for SD video, and
+    BT.709 for HD video. (This is done by default.) Using incorrect color space
+    results in slightly under or over saturated and shifted colors.
+
+    The color space conversion is additionally influenced by the related
+    options --colormatrix-input-range and --colormatrix-output-range.
+
+    These options are not always supported. Different video outputs provide
+    varying degrees of support. The gl and vdpau video output drivers usually
+    offer full support. The xv output can set the color space if the system
+    video driver supports it, but not input and output levels. The scale video
+    filter can configure color space and input levels, but only if the output
+    format is RGB (if the video output driver supports RGB output, you can
+    force this with ``-vf scale,format=rgba``).
+
+    If this option is set to ``auto`` (which is the default), the color space
+    will be selected automatically. This is done using a simple heuristic that
+    attempts to distinguish SD and HD video. If the video is larger than
+    1279x576 pixels, BT.709 (HD) will be used; otherwise BT.601 (SD) is
+    selected.
+
+    Available color spaces are:
+
+    :auto:          automatic selection (default)
+    :BT.601:        ITU-R BT.601 (SD)
+    :BT.709:        ITU-R BT.709 (HD)
+    :SMPTE-240M:    SMPTE-240M
+    :sd:            alias for BT.601
+    :hd:            alias for BT.709
+    :0:             compatibility alias for auto (do not use)
+    :1:             compatibility alias for BT.601 (do not use)
+    :2:             compatibility alias for BT.709 (do not use)
+    :3:             compatibility alias for SMPTE-240M (do not use)
+
+--colormatrix-input-range=<color-range>
+    YUV color levels used with YUV to RGB conversion. This option is only
+    necessary when playing broken files, which don't follow standard color
+    levels.
+
+    The same limitations as with --colormatrix apply.
+
+    Available color ranges are:
+
+    :auto:      automatic selection (normally limited range) (default)
+    :limited:   limited range (16-235 for luma, 16-240 for chroma)
+    :full:      full range (16-235 for luma, 0-255 for chroma)
+
+--colormatrix-output-range=<color-range>
+    RGB color levels used with YUV to RGB conversion. Normally, output devices
+    such as PC monitors use full range color levels. However, some TVs and
+    video monitors expect studio level RGB. Providing full range output to a
+    device expecting studio level input results in crushed blacks and whites,
+    the reverse in dim grey blacks and dim whites.
+
+    The same limitations as with --colormatrix apply.
+
+    Available color ranges are:
+
+    :auto:      automatic selection (equals to full range) (default)
+    :limited:   limited range (16-235 per component), studio levels
+    :full:      full range (0-255 per component), PC levels
+
+--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. See also
+    ``--nocolorkey``.
+
+--consolecontrols, --no-consolecontrols
+    ``--no-consolecontrols`` prevents the player 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.
+
+--contrast=<-100-100>
+    Adjust the contrast of the video signal (default: 0). Not supported by all
+    video output drivers.
+
+--cookies, --no-cookies
+    (network only)
+    Support cookies when making HTTP requests. Disabled by default.
+
+--cookies-file=<filename>
+    (network only)
+    Read HTTP cookies from <filename> (default: ``~/.mozilla/`` and
+    ``~/.netscape/``) and skip reading from default locations. The file is
+    assumed to be in Netscape format.
+
+--correct-pts, --no-correct-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.
+
+--crash-debug
+    DEBUG CODE.
+    Automatically attaches gdb upon crash or **SIGTRAP**. Support must be
+    compiled in by configuring with ``--enable-crash-debug``.
+
+--cursor-autohide-delay=<number>
+    Make mouse cursor automatically hide after given number of milliseconds.
+    A value of -1 will disable cursor autohide. A value of -2 means the cursor
+    will stay hidden. Supported by video output drivers which use X11 or
+    OS X Cocoa.
+
+--delay=<sec>
+    audio delay in seconds (positive or negative float value) Negative values
+    delay the audio, and positive values delay the video.
+
+--demuxer=<[+]name>
+    Force demuxer type. Use a '+' before the name to force it, this will skip
+    some checks! Give the demuxer name as printed by ``--demuxer=help``.
+
+--display=<name>
+    (X11 only)
+    Specify the hostname and display number of the X server you want to
+    display on.
+
+    *EXAMPLE*:
+
+    ``--display=xtest.localdomain:0``
+
+--double, --no-double
+    Double buffering. The option to disable this exists mostly for debugging
+    purposes and should not normally be used.
+
+--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).
+
+--dr
+    Turns on direct rendering (not supported by all codecs and video outputs)
+
+    *WARNING*: May cause OSD/SUB corruption!
+
+--dumpaudio
+    Dumps raw compressed audio stream to ``./stream.dump`` (useful with
+    MPEG/AC-3, in most other cases the resulting file will not be playable).
+    If you give more than one of ``--dumpaudio``, ``--dumpvideo``,
+    ``--dumpstream`` on the command line only the last one will work.
+
+--dumpfile=<filename>
+    Specify which file MPlayer should dump to. Should be used together with
+    ``--dumpaudio`` / ``--dumpvideo`` / ``--dumpstream`` / ``--capture``.
+
+--dumpjacosub
+    Convert the given subtitle (specified with the ``--sub`` option) to the
+    time-based JACOsub subtitle format. Creates a ``dumpsub.js`` file in the
+    current directory.
+
+--dumpmicrodvdsub
+    Convert the given subtitle (specified with the ``--sub`` option) to the
+    MicroDVD subtitle format. Creates a dumpsub.sub file in the current
+    directory.
+
+--dumpmpsub
+    Convert the given subtitle (specified with the ``--sub`` option) to
+    MPlayer's subtitle format, MPsub. Creates a dump.mpsub file in the current
+    directory.
+
+--dumpsami
+    Convert the given subtitle (specified with the ``--sub`` option) to the
+    time-based SAMI subtitle format. Creates a ``dumpsub.smi`` file in the
+    current directory.
+
+--dumpsrtsub
+    Convert the given subtitle (specified with the ``--sub`` option) to the
+    time-based SubViewer (SRT) subtitle format. Creates a ``dumpsub.srt`` file
+    in the current directory.
+
+    *NOTE*: Some broken hardware players choke on SRT subtitle files with Unix
+    line endings. If you are unlucky enough to have such a box, pass your
+    subtitle files through ``unix2dos`` or a similar program to replace Unix
+    line endings with DOS/Windows line endings.
+
+--dumpstream
+    Dumps the raw stream to ``./stream.dump``. Useful when ripping from DVD or
+    network. If you give more than one of ``--dumpaudio``, ``--dumpvideo``,
+    ``--dumpstream`` on the command line only the last one will work.
+
+--dumpsub
+    BETA CODE.
+    Dumps the subtitle substream from VOB streams. Also see the **--dump*sub**
+    options.
+
+--dumpvideo
+    Dump raw compressed video stream to ``./stream.dump`` (not very usable).
+    If you give more than one of ``--dumpaudio``, ``--dumpvideo``,
+    ``--dumpstream`` on the command line only the last one will work.
+
+--dvbin=<options>
+    Pass the following parameters to the DVB input module, in order to
+    override the default ones:
+
+    :card=<1-4>:      Specifies using card number 1-4 (default: 1).
+    :file=<filename>: Instructs MPlayer to read the channels list from
+                      <filename>. Default is
+                      ``~/.mplayer/channels.conf.{sat,ter,cbl,atsc}`` (based
+                      on your card type) or ``~/.mplayer/channels.conf`` as a
+                      last resort.
+    :timeout=<1-30>:  Maximum number of seconds to wait when trying to tune a
+                      frequency before giving up (default: 30).
+
+--dvd-device=<path>
+    Specify the DVD device or .iso filename (default: ``/dev/dvd``). You can
+    also specify a directory that contains files previously copied directly
+    from a DVD (with e.g. vobcopy).
+
+--dvd-speed=<speed>
+    Try to limit DVD speed (default: 0, no change). DVD base speed is 1385
+    kB/s, so a 8x drive can read at speeds up to 11080 kB/s. Slower speeds
+    make the drive more quiet. For watching DVDs 2700 kB/s should be quiet and
+    fast enough. MPlayer resets the speed to the drive default value on close.
+    Values of at least 100 mean speed in kB/s. Values less than 100 mean
+    multiples of 1385 kB/s, i.e. ``--dvd-speed=8`` selects 11080 kB/s.
+
+    *NOTE*: You need write access to the DVD device to change the speed.
+
+--dvdangle=<ID>
+    Some DVD discs contain scenes that can be viewed from multiple angles.
+    Here you can tell MPlayer which angles to use (default: 1).
+
+--edition=<ID>
+    (Matroska files only)
+    Specify the edition (set of chapters) to use, where 0 is the first. If set
+    to -1 (the default), MPlayer will choose the first edition declared as a
+    default, or if there is no default, the first edition defined.
+
+--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.
+
+--embeddedfonts, --no-embeddedfonts
+    Use fonts embedded in Matroska container files and ASS scripts (default:
+    enabled). These fonts can be used for SSA/ASS subtitle rendering
+    (``--ass`` option).
+
+--endpos=<[[hh:]mm:]ss[.ms]>
+    Stop at given time.
+
+    *NOTE*: When used in conjunction with ``--ss`` option, ``--endpos`` time
+    will shift forward by seconds specified with ``--ss``.
+
+    *EXAMPLE*:
+
+    ``--endpos=56``
+        Stop at 56 seconds.
+    ``--endpos=01:10:00``
+        Stop at 1 hour 10 minutes.
+    ``--ss=10 --endpos=56``
+        Stop at 1 minute 6 seconds.
+
+--extbased, --no-extbased
+    Enabled by default.
+    Disables extension-based demuxer selection. By default, when the file type
+    (demuxer) cannot be detected reliably (the file has no header or it is not
+    reliable enough), the filename extension is used to select the demuxer.
+    Always falls back on content-based demuxer selection.
+
+--fbmode=<modename>
+    (``--vo=fbdev`` only)
+    Change video mode to the one that is labeled as <modename> in
+    ``/etc/fb.modes``.
+
+    *NOTE*: VESA framebuffer does not support mode changing.
+
+--fbmodeconfig=<filename>
+    (``--vo=fbdev`` only)
+    Override framebuffer mode configuration file (default: ``/etc/fb.modes``).
+
+--ffactor=<number>
+    Resample the font alphamap. Can be:
+
+    :0:    plain white fonts
+    :0.75: very narrow black outline (default)
+    :1:    narrow black outline
+    :10:   bold black outline
+
+--field-dominance=<-1-1>
+    Set first field for interlaced content. Useful for deinterlacers that
+    double the framerate: ``--vf=tfields=1``, ``--vf=yadif=1`` and
+    ``--vo=vdpau:deint``.
+
+    :-1: auto (default): If the decoder does not export the appropriate
+         information, it falls back to 0 (top field first).
+    :0:  top field first
+    :1:  bottom field first
+
+--fixed-vo, --no-fixed-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 ``--no-fixed-vo`` to
+    disable and create a new window whenever the video stream changes. Some of
+    the older drivers may not be *fixed-vo* compliant.
+
+--flip
+    Flip image upside-down.
+
+--flip-hebrew
+    Turns on flipping subtitles using FriBiDi.
+
+--flip-hebrew-commas, --no-flip-hebrew-commas
+    Enabled by default.
+    Change FriBiDi's assumptions about the placements of commas in subtitles.
+    Use this if commas in subtitles are shown at the start of a sentence
+    instead of at the end.
+
+--font=<pattern-or-filename>
+    Specify font to use for OSD and for subtitles that do not themselves
+    specify a particular font. See also ``--subfont``. With fontconfig enabled
+    the argument is a fontconfig pattern and the default is ``sans``. Without
+    fontconfig the argument is a filename and the default is
+    ``~/.mplayer/subfont.ttf`` with freetype enabled, or
+    ``~/.mplayer/font/font.desc`` without it.
+
+    *EXAMPLE*:
+
+    - ``--font=~/.mplayer/arial-14/font.desc``  (no fontconfig or freetype)
+    - ``--font=~/.mplayer/arialuni.ttf`` (no fontconfig)
+    - ``--font='Bitstream Vera Sans'`` (usual case with fontconfig)
+    - ``--font='Bitstream Vera Sans:style=Bold'`` (usual case with fontconfig)
+
+--fontconfig, --no-fontconfig
+    Enables the use of fontconfig managed fonts. Enabled by default.
+
+--force-window-position
+    Forcefully move MPlayer's video output window to default location whenever
+    there is a change in video parameters, video stream or file. This used to
+    be the default behavior. Currently only affects X11 VOs.
+
+--forcedsubsonly
+    Display only forced subtitles for the DVD subtitle stream selected by e.g.
+    ``--slang``.
+
+--forceidx
+    Force index rebuilding. Useful for files with broken index (A/V desync,
+    etc). This will enable seeking in files where seeking was not possible.
+
+    *NOTE*: This option only works if the underlying media supports seeking
+    (i.e. not with stdin, pipe, etc).
+
+--format=<format>
+    Select the sample format used for output from the audio filter layer to
+    the sound card. The values that <format> can adopt are listed below in the
+    description of the ``format`` audio filter.
+
+--fps=<float>
+    Override video framerate. Useful if the original value is wrong or missing.
+
+--framedrop
+    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. May produce unwatchably choppy output. See also
+    ``--hardframedrop``.
+
+--frames=<number>
+    Play/convert only first <number> frames, then quit.
+
+--fribidi-charset=<name>
+    Specifies the character set that will be passed to FriBiDi when decoding
+    non-UTF-8 subtitles (default: ISO8859-8).
+
+--fs
+    Fullscreen playback (centers movie, and paints black bands around it).
+
+--fsmode-dontuse=<0-31>
+    OBSOLETE, use the ``--fs`` option.
+    Try this option if you still experience fullscreen problems.
+
+--fstype=<type1,type2,...>
+    (X11 only)
+    Specify a priority list of fullscreen modes to be used. You can negate the
+    modes by prefixing them with '-'. If you experience problems like the
+    fullscreen window being covered by other windows try using a different
+    order.
+
+    *NOTE*: See ``--fstype=help`` for a full list of available modes.
+
+    The available types are:
+
+    above
+        Use the ``_NETWM_STATE_ABOVE`` hint if available.
+    below
+        Use the ``_NETWM_STATE_BELOW`` hint if available.
+    fullscreen
+        Use the ``_NETWM_STATE_FULLSCREEN`` hint if available.
+    layer
+        Use the ``_WIN_LAYER`` hint with the default layer.
+    layer=<0...15>
+        Use the ``_WIN_LAYER`` hint with the given layer number.
+    netwm
+        Force NETWM style.
+    none
+        Clear the list of modes; you can add modes to enable afterward.
+    stays_on_top
+        Use ``_NETWM_STATE_STAYS_ON_TOP`` hint if available.
+
+    *EXAMPLE*:
+
+    ``--fstype=layer,stays_on_top,above,fullscreen``
+         Default order, will be used as a fallback if incorrect or
+         unsupported modes are specified.
+    ``--fstype=fullscreen``
+         Fixes fullscreen switching on OpenBox 1.x.
+
+--gamma=<-100-100>
+    Adjust the gamma of the video signal (default: 0). Not supported by all
+    video output drivers.
+
+--gapless-audio
+    Try to play consecutive audio files with no silence or disruption at the
+    point of file change. This feature is implemented in a simple manner and
+    relies on audio output device buffering to continue playback while moving
+    from one file to another. If playback of the new file starts slowly, for
+    example because it's played from a remote network location or because you
+    have specified cache settings that require time for the initial cache
+    fill, then the buffered audio may run out before playback of the new file
+    can start.
+
+    *NOTE*: The audio device is opened using parameters chosen according to
+    the first file played and is then kept open for gapless playback. This
+    means that if the first file for example has a low samplerate then the
+    following files may get resampled to the same low samplerate, resulting in
+    reduced sound quality. If you play files with different parameters,
+    consider using options such as ``--srate`` and ``--format`` to explicitly
+    select what the shared output format will be.
+
+--geometry=<x[%][:y[%]]>, --geometry=<[WxH][+-x+-y]>
+    Adjust where the output is on the screen initially. The x and y
+    specifications are in pixels measured from the top-left of the screen to
+    the top-left of the image being displayed, however if a percentage sign is
+    given after the argument it turns the value into a percentage of the