From cf61928eecd87ba29324e501a3e4a0efde25d874 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Wed, 3 Oct 2012 16:50:13 +0200
Subject: vo_gl, options: remove doublebuffering option (--double)

Useless. It complicated the code and caused flicker, and was useless
otherwise. The manpage describes this option as "should not normally
be used".

One possibly useful effect from the point of view of the user was that
vsync was disabled. You can do this with the --vsync option, or by
changing X/driver settings directly.
---
 DOCS/man/en/options.rst | 4 ----
 1 file changed, 4 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index c52c8b307e..bf297018a9 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -489,10 +489,6 @@
 
     ``--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).
-- 
cgit v1.2.3


From 8f8f6e6d9d27eef37640b363214a775647a0f2f4 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Wed, 3 Oct 2012 17:00:37 +0200
Subject: sub: remove logic for disabling hinting on scaled EOSD

This was an extremely obscure setting, as it was used only with vo_gl
if its scaled-osd suboption was used. If you really want this, you can
set the desired ass-hinting value directly, and there will be literally
no loss in functionality.

Note that this didn't actually test whether the EOSD was scaled.
Basically, it only checked whether vo_gl had the scaled-osd suboption
set.
---
 DOCS/man/en/options.rst | 2 --
 1 file changed, 2 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index bf297018a9..0b623859e5 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -163,8 +163,6 @@
     :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).
 
-- 
cgit v1.2.3


From fd5c4a19849b768986a0e652bb2f398c922f42dd Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Sun, 7 Oct 2012 22:02:03 +0200
Subject: Remove things related to old OSD

To ease changing all the VOs to the new OSD rendering, fallbacks,
conversions, support code etc. was left all over the code. Now that
all VOs have been changed, all that code is inactive. Remove it.

Strip down spudec.c. We don't need the old grayscale and scaling stuff
anymore. (Not removing spudec itself yet - I'm not confident that the
libavcodec DVD sub decoder is sufficient, and it would also require
some hacks to get DVD palette and resolution information from libdvdread
to libavcodec.)

The option --spuaa, --spualign, --spugauss were used with the old sub
scaling code, and don't do anything anymore.
---
 DOCS/man/en/options.rst | 24 ------------------------
 1 file changed, 24 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index ca245f6d32..3be707bfad 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1781,30 +1781,6 @@
 --speed=<0.01-100>
     Slow down or speed up playback by the factor given as parameter.
 
---spuaa=<mode>
-    Antialiasing/scaling mode for DVD/VOBsub. A value of 16 may be added to
-    <mode> in order to force scaling even when original and scaled frame size
-    already match. This can be employed to e.g. smooth subtitles with gaussian
-    blur. Available modes are:
-
-    :0: none (fastest, very ugly)
-    :1: approximate (broken?)
-    :2: full (slow)
-    :3: bilinear (default, fast and not too bad)
-    :4: uses swscaler gaussian blur (looks very good)
-
---spualign=<-1-2>
-    Specify how SPU (DVD/VOBsub) subtitles should be aligned.
-
-    :-1:  Original position
-    :0:   Align at top (original behavior, default).
-    :1:   Align at center.
-    :2:   Align at bottom.
-
---spugauss=<0.0-3.0>
-    Variance parameter of gaussian used by ``--spuaa=4``. Higher means more
-    blur (default: 1.0).
-
 --srate=<Hz>
     Select the output sample rate to be used (of course sound cards have
     limits on this). If the sample frequency selected is different from that
-- 
cgit v1.2.3


From 4d11f32162b08e3b48ae382e2ed0a151035f8aea Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Fri, 19 Oct 2012 19:25:18 +0200
Subject: VO, sub: refactor

Remove VFCTRL_DRAW_OSD, VFCAP_EOSD_FILTER, VFCAP_EOSD_RGBA, VFCAP_EOSD,
VOCTRL_DRAW_EOSD, VOCTRL_GET_EOSD_RES, VOCTRL_QUERY_EOSD_FORMAT.

Remove draw_osd_with_eosd(), which rendered the OSD by calling
VOCTRL_DRAW_EOSD. Change VOs to call osd_draw() directly, which takes
a callback as argument. (This basically works like the old OSD API,
except multiple OSD bitmap formats are supported and caching is
possible.)

Remove all mentions of "eosd". It's simply "osd" now.

Make OSD size per-OSD-object, as they can be different when using
vf_sub. Include display_par/video_par in resolution change detection.

Fix the issue with margin borders in vo_corevideo.
---
 DOCS/man/en/vf.rst | 6 +++---
 DOCS/man/en/vo.rst | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst
index d46bd5bc06..b5a672e236 100644
--- a/DOCS/man/en/vf.rst
+++ b/DOCS/man/en/vf.rst
@@ -664,14 +664,14 @@ screenshot
     ``Taking screenshots`` section for details.
 
 ass
-    Moves SSA/ASS subtitle rendering to an arbitrary point in the filter
+    Moves subtitle rendering to an arbitrary point in the filter
     chain, or force subtitle rendering in the video filter as opposed to using
-    video output EOSD support. See the ``--ass`` option.
+    video output OSD support.
 
     *EXAMPLE*:
 
     ``--vf=ass,eq``
-        Moves SSA/ASS rendering before the eq filter. This will put both
+        Moves sub rendering before the eq filter. This will put both
         subtitle colors and video under the influence of the video equalizer
         settings.
 
diff --git a/DOCS/man/en/vo.rst b/DOCS/man/en/vo.rst
index 6248073944..09d12e2994 100644
--- a/DOCS/man/en/vo.rst
+++ b/DOCS/man/en/vo.rst
@@ -171,8 +171,8 @@ direct3d_shaders (Windows only)
         Never render YUV video with more than 8 bits per component.
         (Using this flag will force software conversion to 8 bit.)
 
-    disable-eosd
-        Disable EOSD rendering for subtitles.
+    disable-osd
+        Disable OSD rendering for subtitles.
         (Using this flag might force the insertion of the 'ass' video filter,
         which will render the subtitles in software.)
 
-- 
cgit v1.2.3


From 11ed093182f29c796ba6fd08f6c5c80e8fdb9349 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Sat, 20 Oct 2012 23:32:45 +0200
Subject: screenshot: allow taking screenshots with subtitles

This adds a new screenshot mode "subtitles", which basically takes the
video frame as decoded, and renders subtitles into it.

This may fail for some pixel formats, because libswscale sucks. If this
becomes ever a real problem, the code could be changed to convert the
image to RGBA first (or whatever the image writer wants), and then
render the subtitles into it. This would avoid the additional image
copy needed with vo_xv too. But for now, it seems better to go with the
current method in the common case: vo_opengl creates an image copy
anyway, and drawing bitmaps to yv12 is better, as no color space
conversion is involved in draw_bmp.c's up/downsampling conversion.
---
 DOCS/man/en/input.rst | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 74c4929684..63593c53ca 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -104,6 +104,9 @@ screenshot [single|each-frame] [video|window]
         Save the video image, in its original resolution. Typically without
         OSD or subtitles, but the exact behavior depends on the selected video
         output.
+    <subtitles>
+        Like ``video``, but add subtitles. Some video outputs may still include
+        the OSD in the output under certain circumstances.
     <window>
         Save the contents of the mplayer window. Typically scaled, with OSD and
         subtitles. The exact behavior depends on the selected video output, and
-- 
cgit v1.2.3


From 48ce4ab7f9259977f426d52b51601a54dbe15465 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Sat, 20 Oct 2012 23:58:02 +0200
Subject: screenshot: change "screenshot" input command

"screenshot" now maps to "screenshot subtitles" by default, instead of
"screenshot video". Swap the argument order: the more useful argument
should come first. Remove the compatibility aliases for numeric choices
(e.g. "screenshot 1 0" won't work anymore).
---
 DOCS/man/en/changes.rst |  3 ++-
 DOCS/man/en/input.rst   | 30 +++++++++++++++---------------
 DOCS/man/en/mpv.rst     |  5 +++--
 3 files changed, 20 insertions(+), 18 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
index 402bdbd336..725385a2b1 100644
--- a/DOCS/man/en/changes.rst
+++ b/DOCS/man/en/changes.rst
@@ -52,7 +52,8 @@ General changes for mplayer2 to mpv
 * Improved OpenGL output (``vo_opengl``)
 * Make ``--softvol`` default (**mpv** is not a mixer control panel)
 * Improved support for .cue files
-* Screenshot improvements (can save screenshots as JPG, configurable filenames)
+* Screenshot improvements (can save screenshots as JPG, configurable filenames,
+  support not taking screenshots with or without subtitles)
 * Removal of teletext support
 * Replace image VOs (``vo_jpeg`` etc.) with ``vo_image``
 * Remove ``vo_gif89a``, ``vo_md5sum``, ``vo_yuv4mpeg`` (the plan is to merge
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 63593c53ca..18e5b824e1 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -87,31 +87,31 @@ cycle <property> [up|down]
 speed_mult <value>
     Multiply the ``speed`` property by the given value.
 
-screenshot [single|each-frame] [video|window]
+screenshot [subtitles|video|window] [single|each-frame]
     Take a screenshot.
 
     First argument:
 
+    <subtitles> (default)
+        Save the video image, in its original resolution, and with subtitles.
+        Some video outputs may still include the OSD in the output under certain
+        circumstances.
+    <video>
+        Like ``subtitles``, but typically without OSD or subtitles. The exact
+        behavior depends on the selected video output.
+    <window>
+        Save the contents of the mplayer window. Typically scaled, with OSD and
+        subtitles. The exact behavior depends on the selected video output, and
+        if no support is available, this will act like ``video``.
+
+    Second argument:
+
     <single> (default)
         Take a single screenshot.
     <each-frame>
         Take a screenshot each frame. Issue this command again to stop taking
         screenshots.
 
-    Second argument:
-
-    <video> (default)
-        Save the video image, in its original resolution. Typically without
-        OSD or subtitles, but the exact behavior depends on the selected video
-        output.
-    <subtitles>
-        Like ``video``, but add subtitles. Some video outputs may still include
-        the OSD in the output under certain circumstances.
-    <window>
-        Save the contents of the mplayer window. Typically scaled, with OSD and
-        subtitles. The exact behavior depends on the selected video output, and
-        if not support is available, this will act like ``video``.
-
 playlist_next [weak|force]
     Go to the next entry on the playlist.
 
diff --git a/DOCS/man/en/mpv.rst b/DOCS/man/en/mpv.rst
index 6de386fdf9..bf2ce0a770 100644
--- a/DOCS/man/en/mpv.rst
+++ b/DOCS/man/en/mpv.rst
@@ -162,7 +162,8 @@ s
     Take a screenshot.
 
 S
-    Start/stop taking screenshots.
+    Take a screenshot, without subtitles. (Whether this works depends on VO
+    driver support.)
 
 I
     Show filename on the OSD.
@@ -420,7 +421,7 @@ slave mode command, which is by default bound to the ``s`` key. Files named
 available number - no files will be overwritten.
 
 A screenshot will usually contain the unscaled video contents at the end of the
-video filter chain. Some video output drivers will include subtitles and OSD in
+video filter chain and subtitles. Some video output drivers will include OSD in
 the video frame as well - this is because of technical restrictions.
 
 The ``screenshot`` video filter is normally not required when using a
-- 
cgit v1.2.3


From 796e5638ac6bd5e13e0f69e2b9557ba0af1718cd Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Sun, 21 Oct 2012 12:33:18 +0200
Subject: manpage: optional input command args can't just be omitted

Fix the "grammar" of such commands to be hopefully less confusing. Also,
add the "-" for such arguments, which skips optional arguments without
changing their default value.

Also change some mentions of "mplayer" to "mpv".
---
 DOCS/man/en/input.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 18e5b824e1..08eaed9456 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -14,7 +14,7 @@ with shift.
 
 A list of special keys can be obtained with
 
-| **mplayer** --input=keylist
+| **mpv** --input=keylist
 
 In general, keys can be combined with ``Shift``, ``Ctrl`` and ``Alt``:
 
@@ -45,7 +45,7 @@ ignore
     disabling default bindings, without disabling all bindings with
     ``--input=default-bindings=no``.
 
-seek <seconds> [relative|absolute|absolute-percent] [default-precise|exact|keyframes]
+seek <seconds> [relative|absolute|absolute-percent|- [default-precise|exact|keyframes]]
     Change the playback position. By default, seeks by a relative amount of
     seconds.
 
@@ -87,7 +87,7 @@ cycle <property> [up|down]
 speed_mult <value>
     Multiply the ``speed`` property by the given value.
 
-screenshot [subtitles|video|window] [single|each-frame]
+screenshot [subtitles|video|window|- [single|each-frame]]
     Take a screenshot.
 
     First argument:
@@ -100,7 +100,7 @@ screenshot [subtitles|video|window] [single|each-frame]
         Like ``subtitles``, but typically without OSD or subtitles. The exact
         behavior depends on the selected video output.
     <window>
-        Save the contents of the mplayer window. Typically scaled, with OSD and
+        Save the contents of the mpv window. Typically scaled, with OSD and
         subtitles. The exact behavior depends on the selected video output, and
         if no support is available, this will act like ``video``.
 
@@ -167,7 +167,7 @@ print_text "<string>"
     Print text to stdout. The string can contain properties, which are expanded
     like in ``--playing-msg``.
 
-show_text "<string>" [<duration>] [<level>]
+show_text "<string>" [<duration>|- [<level>]]
     Show text on the OSD. The string can contain properties, which are expanded
     like in ``--playing-msg``. This can be used to show playback time, filename,
     and so on.
@@ -223,7 +223,7 @@ pausing_keep_force. (Should these be made official?)
 Properties
 ----------
 
-Properties are used to set mplayer options during runtime, or to query arbitrary
+Properties are used to set mpv options during runtime, or to query arbitrary
 information. They can be manipulated with the ``set``/``add``/``cycle``
 commands, and retrieved with ``show_text``, or anything else that uses property
 expansion. (See ``--playing-msg`` how properties are expanded.)
-- 
cgit v1.2.3


From 773668b6e85d4da4d252cb4ad8abd50448d70c7c Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Sun, 21 Oct 2012 18:31:34 +0200
Subject: VF: rename vf_ass to vf_sub

This reflects the fact that this filter now renders all types of
subtitles, not just ASS subtitles.

Always compile this filter, not just on CONFIG_ASS.

Note that --no-ass still disables auto-inserting this filter. It's the
only way to disable auto-insertion, so keep it even though it's not
really ASS specific anymore. --no-ass also disables using libass for
rendering text subs directly.
---
 DOCS/man/en/vf.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst
index b5a672e236..31947e82b6 100644
--- a/DOCS/man/en/vf.rst
+++ b/DOCS/man/en/vf.rst
@@ -663,14 +663,14 @@ screenshot
     not always safe to insert this filter by default. See the
     ``Taking screenshots`` section for details.
 
-ass
+sub
     Moves subtitle rendering to an arbitrary point in the filter
     chain, or force subtitle rendering in the video filter as opposed to using
     video output OSD support.
 
     *EXAMPLE*:
 
-    ``--vf=ass,eq``
+    ``--vf=sub,eq``
         Moves sub rendering before the eq filter. This will put both
         subtitle colors and video under the influence of the video equalizer
         settings.
-- 
cgit v1.2.3


From 2afd7ebb4e96b91cc552fff5badf237dadb28212 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Mon, 22 Oct 2012 16:15:52 +0200
Subject: options: remove subtitle related options that did nothing

Most of these cased working when the OSD was switched to libass, or
didn't do anything even before that.

Also don't recursively include subreader.h in sub.h.
---
 DOCS/man/en/options.rst | 29 -----------------------------
 1 file changed, 29 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 3be707bfad..01a4610e20 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1831,15 +1831,6 @@
     Use/display these subtitle files. Only one file can be displayed at the
     same time.
 
---sub-bg-alpha=<0-255>
-    Specify the alpha channel value for subtitles and OSD backgrounds. Big
-    values mean more transparency. 0 means completely transparent.
-
---sub-bg-color=<0-255>
-    Specify the color value for subtitles and OSD backgrounds. Currently
-    subtitles are grayscale so this value is equivalent to the intensity of
-    the color. 255 means white and 0 black.
-
 --sub-demuxer=<[+]name>
     Force subtitle demuxer type for ``--subfile``. Using a '+' before the name
     will force it, this will skip some checks! Give the demuxer name as
@@ -1921,19 +1912,6 @@
     :2: proportional to movie width
     :3: proportional to movie diagonal (default)
 
---subfont-blur=<0-8>
-    Sets the font blur radius (default: 2).
-
---subfont-encoding=<value>
-    Sets the font encoding. When set to 'unicode', all the glyphs from the
-    font file will be rendered and unicode will be used (default: unicode).
-
---subfont-osd-scale=<0-100>
-    Sets the autoscale coefficient of the OSD elements (default: 4).
-
---subfont-outline=<0-8>
-    Sets the font outline thickness (default: 2).
-
 --subfont-text-scale=<0-100>
     Sets the subtitle text autoscale coefficient as percentage of the screen
     size (default: 3.5).
@@ -1949,10 +1927,6 @@
     position of the subtitle in % of the screen height.
     Can be useful with ``--vf=expand``.
 
---subwidth=<10-100>
-    Specify the maximum width of subtitles on the screen. Useful for TV-out.
-    The value is the width of the subtitle in % of the screen width.
-
 --sws=<n>
     Specify the software scaler algorithm to be used with the ``--zoom``
     option. This affects video output drivers which lack hardware
@@ -2198,9 +2172,6 @@
         the device (default: 50). A signal strength higher than this value will
         indicate that the currently scanning channel is active.
 
---unicode
-    Tells mpv to handle the subtitle file as unicode.
-
 --use-filedir-conf
     Look for a file-specific configuration file in the same directory as the
     file that is being played.
-- 
cgit v1.2.3


From a8824f12ddfe66585db43fb0f92d7c90b5bbd19d Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Tue, 23 Oct 2012 21:23:53 +0200
Subject: options: remove --subfont-autoscale (changes default font scale)

The code for this option attempted to emulate the old as-documented
behavior. It wasn't very good at it, and now that the old OSD code has
been removed, it's entirely pointless.

This removes the factor 1.7 with which --subfont-text-scale was
multiplied.
---
 DOCS/man/en/options.rst | 12 ------------
 1 file changed, 12 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 01a4610e20..dbd37c4c03 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1900,18 +1900,6 @@
     Sets the subtitle font (see ``--font``). If no ``--subfont`` is given,
     ``--font`` is used for subtitles too.
 
---subfont-autoscale=<0-3>
-    Sets the autoscale mode.
-
-    *NOTE*: 0 means that text scale and OSD scale are font heights in points.
-
-    The mode can be:
-
-    :0: no autoscale
-    :1: proportional to movie height
-    :2: proportional to movie width
-    :3: proportional to movie diagonal (default)
-
 --subfont-text-scale=<0-100>
     Sets the subtitle text autoscale coefficient as percentage of the screen
     size (default: 3.5).
-- 
cgit v1.2.3


From 3d98e8c674066809844cd35dfe02b28a07f91d77 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Tue, 23 Oct 2012 22:17:21 +0200
Subject: options: remove --ffactor switch

This controlled the generation of the palette for DVD subs if no palette
was found. The option name and description is confusing, and it was
probably barely useful. Remove the option, and hardcode the behavior to
the option's default value.
---
 DOCS/man/en/options.rst | 8 --------
 1 file changed, 8 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index dbd37c4c03..6a8b81cd7f 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -571,14 +571,6 @@
     reliable enough), the filename extension is used to select the demuxer.
     Always falls back on content-based demuxer selection.
 
---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
-- 
cgit v1.2.3


From 10295b080dd3f3e4ffe947a15c8a327446ce8276 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Wed, 24 Oct 2012 01:06:00 +0200
Subject: manpage: cleanup

Removing text about things that have been removed from the code long
ago, other fixes.
---
 DOCS/man/en/ao.rst      |   2 +-
 DOCS/man/en/changes.rst |  24 ++++----
 DOCS/man/en/input.rst   |  28 ++++++---
 DOCS/man/en/mpv.rst     |  88 +++++---------------------
 DOCS/man/en/options.rst | 161 ++++++++++++++----------------------------------
 DOCS/man/en/vo.rst      |   7 ++-
 6 files changed, 96 insertions(+), 214 deletions(-)

(limited to 'DOCS/man')

diff --git a/DOCS/man/en/ao.rst b/DOCS/man/en/ao.rst
index 412d9ac939..ae0432784f 100644
--- a/DOCS/man/en/ao.rst
+++ b/DOCS/man/en/ao.rst
@@ -94,7 +94,7 @@ dsound (Windows only)
 
 null
     Produces no audio output but maintains video playback speed. Use
-    ``--nosound`` for benchmarking.
+    ``--no-audio`` for benchmarking.
 
 pcm
     raw PCM/wave file writer audio output
diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
index 725385a2b1..a11942ce5b 100644
--- a/DOCS/man/en/changes.rst
+++ b/DOCS/man/en/changes.rst
@@ -43,25 +43,27 @@ General changes for mplayer2 to mpv
   decades old hardware
 * Removal of support for dead platforms
 * Generally improved MS Windows support (dealing with unicode filenames,
-  improved ``vo_direct3d``, improve window handling)
+  improved ``--vo=direct3d``, improved window handling)
 * Better OSD rendering (using libass). This has full unicode support, and
   languages like Arabic should be better supported.
 * Cleaned up terminal output (nicer status line, less useless noise)
 * Support for playing URLs of popular streaming sites directly
   (e.g. ``mpv https://www.youtube.com/watch?v=...``)
-* Improved OpenGL output (``vo_opengl``)
+* Improved OpenGL output (``--vo=opengl-hq``)
 * Make ``--softvol`` default (**mpv** is not a mixer control panel)
 * Improved support for .cue files
-* Screenshot improvements (can save screenshots as JPG, configurable filenames,
-  support not taking screenshots with or without subtitles)
+* Screenshot improvements (can save screenshots as JPG or PNG, configurable
+  filenames, support for taking screenshots with or without subtitles)
 * Removal of teletext support
-* Replace image VOs (``vo_jpeg`` etc.) with ``vo_image``
-* Remove ``vo_gif89a``, ``vo_md5sum``, ``vo_yuv4mpeg`` (the plan is to merge
-  divverent's encoding branch, which provides support for all of these)
+* Replace image VOs (``--vo=jpeg`` etc.) with ``--vo=image``
 * Do not lose settings when playing a new file in the same player instance
 * New location for config files, new name for the binary. (Planned change.)
 * Slave mode compatibility broken (see below)
 * Encoding functionality (replacement for mencoder)
+  (Remove ``--vo=gif89a``, ``--vo=md5sum``, ``--vo=yuv4mpeg``, as encoding can
+  handle these use cases.)
+* Image subtitles (DVDs etc.) are rendered in color and use more correct
+  positioning
 * General code cleanups
 * Many more changes
 
@@ -81,7 +83,7 @@ Command line switches
   know about this change.
 
   (The new syntax was introduced in mplayer2.)
-* In general, negating a switch like ``-noopt`` now has to be written as
+* In general, negating switches like ``-noopt`` now have to be written as
   ``-no-opt``, or better ``--no-opt``.
 * Per-file options are not the default anymore. You can explicitly specify
   file local options. See ``Usage`` section.
@@ -150,8 +152,8 @@ Other
   mplayer. A proper slave mode application needed tons of code and hacks to get
   it right. The main problem is that slave mode is a bad and incomplete
   interface, and to get around that, applications parsed output messages
-  intended for users. It's hard to know just which messages are parsed by some
-  slave mode application, and as such it's virtually impossible to improve
+  intended for users. It's hard to know which messages exactly are parsed by
+  slave mode applications. This makes it virtually impossible to improve
   terminal output intended for users without possibly breaking something.
 
   This is absolutely insane, and **mpv** will not try to keep slave mode
@@ -163,7 +165,7 @@ Policy for removed features
 
 Features are a good thing, because they make users happy. As such, it is
 attempted to preserve useful features as far as possible. But if a feature is
-likely to be not used by many, and causes otherwise problems, it will be
+likely to be not used by many, and causes problems otherwise, it will be
 removed. Developers should not be burdened with fixing or cleaning up code that
 has no actual use.
 
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 08eaed9456..2f6e0b1e09 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -20,10 +20,18 @@ In general, keys can be combined with ``Shift``, ``Ctrl`` and ``Alt``:
 
 | ctrl+q quit
 
+**mpv** can be started in input test mode, which displays key bindings and the
+commands they're bound to on the OSD, instead of running the commands:
+
+| **mpv** --input=test --demuxer=rawvideo --rawvideo=w=1280:h=720 /dev/zero
+
+(Commands which normally close the player will not work in this mode, and you
+must kill **mpv** externally to make it exit.)
+
 General input command syntax
 ----------------------------
 
-`[Shift+][Ctrl+][Alt+][Meta+]<key> [<prefix>] <command> (<argument>)*`
+`[Shift+][Ctrl+][Alt+][Meta+]<key> [<prefixes>] <command> (<argument>)*`
 
 Newlines always start a new binding. ``#`` starts a comment (outside of quoted
 string arguments). To bind commands to the ``#`` key, ``SHARP`` can be used.
@@ -56,7 +64,7 @@ seek <seconds> [relative|absolute|absolute-percent|- [default-precise|exact|keyf
     absolute
         Seek to a given time.
     absolute-percent
-        Seek to agiven percent position.
+        Seek to a given percent position.
 
     The third argument defines how exact the seek is:
 
@@ -207,9 +215,9 @@ osd-bar
     If possible, show a bar with this command. Seek commands will show the
     progress bar, property changing commands may show the newly set value.
 osd-msg
-    If possible, show an OSD message with this command. The seek command shows
-    the current playback time (like ``show_progress``), property changing
-    commands show the newly set value as text.
+    If possible, show an OSD message with this command. Seek command show
+    the current playback time, property changing commands show the newly set
+    value as text.
 osd-msg-bar
     Combine osd-bar and osd-msg.
 
@@ -256,7 +264,7 @@ edition                     x current MKV edition number
 titles                        number of DVD titles
 chapters                      number of chapters
 editions                      number of MKV editions
-angle                         current DVD angle
+angle                       x current DVD angle
 metadata                      metadata key/value pairs
 metadata/<key>                value of metedata entry <key>
 pause                       x pause status (bool)
@@ -306,8 +314,8 @@ sub-scale                   x subtitle font size multiplicator
 ass-use-margins             x see ``--ass-use-margins``
 ass-vsfilter-aspect-compat  x see ``--ass-vsfilter-aspect-compat``
 ass-style-override          x see ``--ass-style-override``
-tv-brightness
-tv-contrast
-tv-saturation
-tv-hue
+tv-brightness               x
+tv-contrast                 x
+tv-saturation               x
+tv-hue                      x
 =========================== = ==================================================
diff --git a/DOCS/man/en/mpv.rst b/DOCS/man/en/mpv.rst
index bf2ce0a770..96ccb10691 100644
--- a/DOCS/man/en/mpv.rst
+++ b/DOCS/man/en/mpv.rst
@@ -18,9 +18,6 @@ Synopsis
 | **mpv** \mf://[filemask|\@listfile] [-mf options] [options]
 | **mpv** [cdda|cddb]://track[-endtrack][:speed][/device] [options]
 | **mpv** [file|mms[t]|http|http\_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]:// [user:pass\@]URL[:port] [options]
-| **mpv** \sdp://file [options]
-| **mpv** \mpst://host[:port]/URL [options]
-| **mpv** \tivo://host/[list|llist|fsid] [options]
 
 
 DESCRIPTION
@@ -48,13 +45,11 @@ keyboard control
 
 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).
+    (see ``--hr-seek``).
 
 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).
+    ``--hr-seek``).
 
 PGUP and PGDWN
     Seek forward/backward 10 minutes.
@@ -149,15 +144,9 @@ V
     Toggle subtitle VSFilter aspect compatibility mode. See
     ``--ass-vsfilter-aspect-compat`` for more info.
 
-C (``--capture`` only)
-    Start/stop capturing the primary stream.
-
 r and t
     Move subtitles up/down.
 
-i (``--edlout`` mode only)
-    Set start or end of an EDL skip and write it out to the given file.
-
 s
     Take a screenshot.
 
@@ -174,7 +163,7 @@ P
 ! and @
     Seek to the beginning of the previous/next chapter.
 
-D (``--vo=vdpau``, ``--vf=yadif``, ``--vf=kerndeint`` only)
+D (``--vo=vdpau``, ``--vf=yadif`` only)
     Activate/deactivate deinterlacer.
 
 A
@@ -184,8 +173,7 @@ c
     Change YUV colorspace.
 
 (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``).)
+corresponding adjustment, or the software equalizer (``--vf=eq2``).)
 
 1 and 2
     Adjust contrast.
@@ -305,7 +293,7 @@ affects all files. Example:
 | file2.mkv | --a --b --c             |
 +-----------+-------------------------+
 
-Also, if any option is changed at runtime (via slave commands), they aren't
+Also, if any option is changed at runtime (via input commands), they aren't
 reset when a new file is played.
 
 Sometimes, it's useful to change options per-file. This can be achieved by
@@ -341,9 +329,8 @@ your configuration directory (e.g. ``/etc/mpv`` or
 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.
+that work without values can be enabled by setting them to *yes* and disabled by
+setting them to *no*. Even suboptions can be specified in this way.
 
 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
@@ -359,8 +346,8 @@ as the file played and then tries to load any file-specific configuration.
 
 *EXAMPLE MPV CONFIGURATION FILE:*
 
-| # Use gl3 video output by default.
-| vo=gl3
+| # Use opengl video output by default.
+| vo=opengl
 | # I love practicing handstands while watching videos.
 | flip=yes
 | # Decode multiple files from PNG,
@@ -416,12 +403,13 @@ Taking screenshots
 ==================
 
 Screenshots of the currently played file can be taken using the 'screenshot'
-slave mode command, which is by default bound to the ``s`` key. Files named
-``shotNNNN.png`` will be saved in the working directory, using the first
+input mode command, which is by default bound to the ``s`` key. Files named
+``shotNNNN.jpg`` will be saved in the working directory, using the first
 available number - no files will be overwritten.
 
 A screenshot will usually contain the unscaled video contents at the end of the
-video filter chain and subtitles. Some video output drivers will include OSD in
+video filter chain and subtitles. By default the ``S`` takes screenshots without
+subtitles. Some video output drivers will always include subtitles and OSD in
 the video frame as well - this is because of technical restrictions.
 
 The ``screenshot`` video filter is normally not required when using a
@@ -443,10 +431,6 @@ ENVIRONMENT VARIABLES
 There are a number of environment variables that can be used to control the
 behavior of mpv.
 
-``MPV_CHARSET`` (see also ``--msgcharset``)
-    Convert console messages to the specified charset (default: autodetect). A
-    value of "noconv" means no conversion.
-
 ``MPV_HOME``
     Directory where mpv looks for user settings.
 
@@ -520,29 +504,6 @@ libdvdcss:
     ``HOME``
         FIXME: Document this.
 
-libao2:
-    ``AUDIOSERVER``
-        Specifies the Network Audio System server to which the nas audio
-        output driver should connect and the transport that should be used. If
-        unset DISPLAY is used instead. The transport can be one of tcp and
-        unix. Syntax is ``tcp/<somehost>:<someport>``,
-        ``<somehost>:<instancenumber>`` or ``[unix]:<instancenumber>``. The
-        NAS base port is 8000 and <instancenumber> is added to that.
-
-        *EXAMPLES*:
-
-        ``AUDIOSERVER=somehost:0``
-             Connect to NAS server on somehost using default port and
-             transport.
-        ``AUDIOSERVER=tcp/somehost:8000``
-             Connect to NAS server on somehost listening on TCP port 8000.
-        ``AUDIOSERVER=(unix)?:0``
-             Connect to NAS server instance 0 on localhost using unix domain
-             sockets.
-
-    ``DISPLAY``
-        FIXME: Document this.
-
 osdep:
     ``TERM``
         FIXME: Document this.
@@ -551,9 +512,6 @@ libvo:
     ``DISPLAY``
         FIXME: Document this.
 
-    ``FRAMEBUFFER``
-        FIXME: Document this.
-
     ``HOME``
         FIXME: Document this.
 
@@ -640,7 +598,7 @@ Play DVD video from a directory with VOB files:
     ``mpv dvd://1 --dvd-device=/path/to/directory/``
 
 Stream from HTTP:
-    ``mpv http://mpv.hq/example.avi``
+    ``mpv http://example.com/example.avi``
 
 Stream using RTSP:
     ``mpv rtsp://server.example.com/streamName``
@@ -648,24 +606,6 @@ Stream using RTSP:
 input from standard V4L:
     ``mpv tv:// --tv=driver=v4l:width=640:height=480:outfmt=i420 --vc=rawi420 --vo=xv``
 
-Play DTS-CD with passthrough:
-    ``mpv --ac=hwdts --rawaudio=format=0x2001 --cdrom-device=/dev/cdrom cdda://``
-
-    You can also use ``--afm=hwac3`` instead of ``--ac=hwdts``. Adjust
-    ``/dev/cdrom`` to match the CD-ROM device on your system. If your external
-    receiver supports decoding raw DTS streams, you can directly play it via
-    ``cdda://`` without setting format, hwac3 or hwdts.
-
-Play a 6-channel AAC file with only two speakers:
-    ``mpv --rawaudio=format=0xff --demuxer=rawaudio --af=pan=2:.32:.32:.39:.06:.06:.39:.17:-.17:-.17:.17:.33:.33 adts_he-aac160_51.aac``
-
-    You might want to play a bit with the pan values (e.g multiply with a
-    value) to increase volume or avoid clipping.
-
-checkerboard invert with geq filter:
-    ``mpv --vf=geq='128+(p(X\,Y)-128)*(0.5-gt(mod(X/SW\,128)\,64))*(0.5-gt(mod(Y/SH\,128)\,64))*4'``
-
-
 AUTHORS
 =======
 
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 6a8b81cd7f..3db799590e 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -19,16 +19,6 @@
 
     *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
@@ -85,7 +75,6 @@
     *EXAMPLE*:
 
     :``--afm=ffmpeg``:    Try FFmpeg's libavcodec codecs first.
-    :``--afm=acm,dshow``: Try Win32 codecs first.
 
 --aid=<ID|auto|no>
     Select audio channel. ``auto`` selects the default, ``no`` disables audio.
@@ -130,9 +119,9 @@
     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.
+    *NOTE*: With ``--ass``, some of the ASS subtitle options work for non-ASS
+    text subtitles only, because ASS subtitles include their own styling
+    information.
 
 --ass-border-color=<value>
     Sets the border (outline) color for text subtitles. The color format is
@@ -245,6 +234,8 @@
     is also used to set the maximum delivery bandwidth allowing faster cache
     filling and stream dumping.
 
+    *NOTE*: probably broken/useless.
+
 --untimed
     Do not sleep when outputting video frames. Useful for benchmarks when used
     with --no-audio.
@@ -322,7 +313,7 @@
         Add <value> sectors to the values reported when addressing tracks. May
         be negative.
 
-    (no)skip
+    (no-)skip
         (Never) accept imperfect data reconstruction.
 
 --cdrom-device=<path>
@@ -398,12 +389,6 @@
     :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
@@ -544,6 +529,8 @@
     EDL entries later. See http://www.mplayerhq.hu/DOCS/HTML/en/edl.html for
     details.
 
+    *NOTE*: broken.
+
 --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
@@ -591,15 +578,6 @@
 --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
@@ -637,6 +615,8 @@
 --fps=<float>
     Override video framerate. Useful if the original value is wrong or missing.
 
+    *NOTE*: Works in ``--no-correct-pts`` mode only.
+
 --framedrop=<no|yes|hard>
     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
@@ -644,15 +624,11 @@
     decoding and output of any frame can be skipped, and will lead to an even
     worse playback experience.
 
-    Practical use of this feature is questionable. Disabled by default.
+    *NOTE*: Practical use of this feature is questionable. Disabled by default.
 
 --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).
-
 --fullscreen
 --fs
     Fullscreen playback (centers movie, and paints black bands around it).
@@ -755,7 +731,7 @@
     Command that is executed every 30 seconds during playback via *system()* -
     i.e. using the shell.
 
-    *NOTE*: mpv uses this command without any checking, it is your
+    *NOTE*: mpv 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 ``--no-video`` but works with
@@ -773,7 +749,7 @@
     --heartbeat-cmd="gnome-screensaver-command -p" file``
 
 --help
-    Show short summary of options and key bindings.
+    Show short summary of options.
 
 --hr-mp3-seek
     Only affects the internal ``audio`` demuxer, which is not used by default
@@ -834,14 +810,7 @@
     drivers.
 
 --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 mpv output
-    and (hopefully) shellescapes the filenames.
+    Deprecated. Use ``TOOLS/mpv_identify.sh``.
 
 --idle
     Makes mpv wait idly instead of quitting when there is no file to play.
@@ -901,7 +870,7 @@
     ar-rate
         Number of key presses to generate per second on autorepeat.
 
-    (no)default-bindings
+    (no-)default-bindings
         Use the key bindings that mpv ships with by default.
 
     keylist
@@ -1139,7 +1108,7 @@
     generated from a different AVI, but this is sure to cause unfavorable
     results.
 
-    *NOTE*: This option is obsolete now that mpv has OpenDML support.
+    *NOTE*: This option is obsolete now that MPlayer has OpenDML support.
 
 --loop=<number|inf|no>
     Loops playback <number> times. ``inf`` means forever and ``no`` disables
@@ -1320,7 +1289,7 @@
     values mean multiples of the default range. Negative numbers mean you can
     zoom in up to a factor of ``--panscanrange=+1``. E.g. ``--panscanrange=-3``
     allows a zoom factor of up to 4. This feature is experimental. Do not
-    report bugs unless you are using ``--vo=gl``.
+    report bugs unless you are using ``--vo=opengl``.
 
 --passwd=<password>
     Used with some network protocols. Specify password for HTTP authentication.
@@ -1349,7 +1318,7 @@
     $$
         Expands to ``$``.
     $}
-        Expands to ``}``. (To produce this character inside rexursive
+        Expands to ``}``. (To produce this character inside recursive
         expansion.)
     $>
         Disable property expansion and special handling of ``$`` for the rest
@@ -1371,19 +1340,12 @@
     sources. Do NOT use ``--playlist`` with random internet sources or files
     you don't trust!
 
-    *NOTE*: This option is considered an entry so options found after it will
-    apply only to the elements of this playlist.
-
     FIXME: This needs to be clarified and documented thoroughly.
 
 --pp=<quality>
-    This option only works when decoding video with Win32 DirectShow DLLs with
-    internal postprocessing routines. See also ``--vf=pp``. Set the DLL
-    postprocess level. The valid range of ``--pp`` values varies by codec, it
-    is mostly 0-6, where 0=disable, 6=slowest/best.
+    See also ``--vf=pp``.
 
 --pphelp
-    Show a summary about the available postprocess filters and their usage.
     See also ``--vf=pp``.
 
 --prefer-ipv4
@@ -1585,18 +1547,6 @@
     images may cover the movie window, though. May not work with all video
     output drivers.
 
---rtsp-destination
-    Used with ``rtsp://`` URLs to force the destination IP address to be
-    bound. This option may be useful with some RTSP server which do not send
-    RTP packets to the right interface. If the connection to the RTSP server
-    fails, use ``-v`` to see which IP address mpv tries to bind to and try
-    to force it to one assigned to your computer instead.
-
---rtsp-port
-    Used with ``rtsp://`` URLs to force the client's port number. This option
-    may be useful if you are behind a router and want to forward the RTSP
-    stream from the server to a specific client.
-
 --saturation=<-100-100>
     Adjust the saturation of the video signal (default: 0). You can get
     grayscale output with this option. Not supported by all video output
@@ -1606,7 +1556,7 @@
     Force index rebuilding and dump the index to <filename>. Currently this
     only works with AVI files.
 
-    *NOTE*: This option is obsolete now that mpv has OpenDML support.
+    *NOTE*: This option is obsolete now that MPlayer has OpenDML support.
 
 --sb=<n>
     Seek to byte position. Useful for playback from CD-ROM images or VOB files
@@ -1683,9 +1633,9 @@
         insert the number of the current month as number. You have to use
         multiple ``%tX`` specifiers to build a full date/time string.
     ``%{prop[:fallback text]}``
-        Insert the value of the slave property 'prop'. E.g. %{filename} is the
-        same as %f. If the property doesn't exist or is not available, nothing
-        is inserted, unless a fallback is specified.
+        Insert the value of the slave property 'prop'. E.g. ``%{filename}`` is
+        the same as ``%f``. If the property doesn't exist or is not available,
+        an error text is inserted, unless a fallback is specified.
     ``%%``
         Replaced with the ``%`` character itself.
 
@@ -1759,10 +1709,10 @@
     :yes:   always use the volume filter
     :auto:  prefer the volume filter if the audio driver uses the system mixer (default)
 
-    The intention with ``auto`` is to avoid changing system mixer settings with
-    default settings. mpv is a video player, not a mixer panel. On the other
-    hand, mixer controls should be used for sound servers like PulseAudio, which
-    provide per-application volume.
+    The intention of ``auto`` is to avoid changing system mixer settings from
+    within mpv with default settings. mpv is a video player, not a mixer panel.
+    On the other hand, mixer controls are enabled for sound servers like
+    PulseAudio, which provide per-application volume.
 
 --softvol-max=<10.0-10000.0>
     Set the maximum amplification level in percent (default: 200). A value of
@@ -1800,11 +1750,12 @@
     :chs=<h>:       chroma horizontal shifting
     :cvs=<v>:       chroma vertical shifting
 
-    *EXAMPLE*: ``--vf=scale=-ssf=lgb=3.0``
+    *EXAMPLE*: ``--vf=scale --ssf=lgb=3.0``
 
 --sstep=<sec>
-    Skip <sec> seconds after every frame. Since mpv will only seek to
-    the next keyframe unless you use ``--hr-seek`` this may be inexact.
+    Skip <sec> seconds after every frame.
+
+    *NOTE*: without ``--hr-seek``, skipping will snap to keyframes.
 
 --stereo=<mode>
     Select type of MP2/MP3 stereo output.
@@ -1884,17 +1835,17 @@
     Delays subtitles by <sec> seconds. Can be negative.
 
 --subfile=<filename>
-    (BETA CODE)
-    Currently useless. Same as ``--audiofile``, but for subtitle streams
-    (OggDS?).
+    Open the given file with a demuxer, and use its subtitle streams. Same as
+    ``--audiofile``, but for subtitle streams.
+
+    Use ``--sub`` for normal text subtitle files.
 
 --subfont=<pattern-or-filename>
     Sets the subtitle font (see ``--font``). If no ``--subfont`` is given,
     ``--font`` is used for subtitles too.
 
 --subfont-text-scale=<0-100>
-    Sets the subtitle text autoscale coefficient as percentage of the screen
-    size (default: 3.5).
+    Factor for the text subtitle and OSD font size (default: 6).
 
 --subfps=<rate>
     Specify the framerate of the subtitle file (default: movie fps).
@@ -1938,8 +1889,9 @@
     console. The escape sequence should move the pointer to the beginning of
     the line used for the OSD and clear it (default: ``^[[A\r^[[K``).
 
---title
-    Set the window title. Properties are expanded (see ``--playing-msg``).
+--title=<string>
+    Set the window title. Properties are expanded on playback start
+    (see ``--playing-msg``).
 
 --tv=<option1:option2:...>
     This option tunes various properties of the TV capture module. For
@@ -2181,13 +2133,6 @@
 
     *NOTE*: See ``--vc=help`` for a full list of available codecs.
 
-    *EXAMPLE*:
-
-    :``--vc=divx``:             Force Win32/VfW DivX codec, no fallback.
-    :``--vc=-divxds,-divx,``:   Skip Win32 DivX codecs.
-    :``--vc=ffmpeg12,mpeg12,``: Try libavcodec's MPEG-1/2 codec, then
-                                libmpeg2, then others.
-
 --vf=<filter1[=parameter1:parameter2:...],filter2,...>
     Specify a list of video filters to apply to the video stream. See
     :ref:`video_filters` for details and descriptions of the available filters.
@@ -2202,14 +2147,6 @@
 
     *NOTE*: See ``--vfm=help`` for a full list of available codec families.
 
-    *EXAMPLE*:
-
-    :``--vfm=ffmpeg,dshow,vfw``:
-        Try the libavcodec, then Directshow, then VfW codecs and fall back on
-        others, if they do not work.
-    :``--vfm=xanim``:
-        Try XAnim codecs first.
-
 --vid=<ID|auto|no>
     Select video channel. ``auto`` selects the default, ``no`` disables video.
 
@@ -2235,21 +2172,15 @@
     (default: 3).
 
 --volume=<-1-100>
-    Set the startup volume in the mixer, either hardware or software (if used
-    with ``--softvol``). A value of -1 (the default) will not change the
-    volume. See also ``--af=volume``.
+    Set the startup volume. A value of -1 (the default) will not change the
+    volume. See also ``--softvol``.
 
 --no-vsync
-    Tries to disable vsync.
+    Tries to disable vsync. (Effective with some video outputs only.)
 
 --wid=<ID>
-    (X11, OpenGL and DirectX only)
-    This tells mpv to attach to an existing window. Useful to embed
-    mpv in a browser (e.g. the plugger extension). Earlier this option
-    always filled the given window completely, thus aspect scaling, panscan,
-    etc were no longer handled by mpv but had to be managed by the
-    application that created the window. Now aspect is maintained by default.
-    If you don't want that use ``--no-keepaspect``.
+    (X11 and win32 only)
+    This tells mpv to attach to an existing window.See ``--slave-broken``.
 
 --x=<width>
     Scale image to width <width> (if software/hardware scaling is available).
@@ -2302,6 +2233,4 @@
     Disables aspect calculations.
 
 --zoom
-    Allow software scaling, where available. This will allow scaling with
-    output drivers (like x11) that do not support hardware scaling,
-    where mpv disables scaling by default for performance reasons.
+    Useful for ``--vo=x11`` only. Enables scaling.
diff --git a/DOCS/man/en/vo.rst b/DOCS/man/en/vo.rst
index 09d12e2994..67832fe862 100644
--- a/DOCS/man/en/vo.rst
+++ b/DOCS/man/en/vo.rst
@@ -58,6 +58,8 @@ x11 (X11 only)
     Shared memory video output driver without hardware acceleration that works
     whenever X11 is present.
 
+    *NOTE*: this is a fallback only, and shouldn't be normally used.
+
 vdpau (X11 only)
     Uses the VDPAU interface to display and optionally also decode video.
     Hardware decoding is used with ``--vc=ffmpeg12vdpau``,
@@ -233,8 +235,9 @@ opengl
     OpenGL video output driver. It supports extended scaling methods, dithering
     and color management.
 
-    By default, it tries to use fast and fail-safe settings. Use the driver
-    ``opengl-hq`` to use this driver with a high quality rendering preset.
+    By default, it tries to use fast and fail-safe settings. Use the alias
+    ``opengl-hq`` to use this driver with defaults set for high quality
+    rendering.
 
     Requires at least OpenGL 2.1 and the GL_ARB_texture_rg extension. For older
     drivers, ``opengl-old`` may work.
-- 
cgit v1.2.3