From b10dcecf7d71a076525bc2ac4b6bd72f4c453278 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Wed, 31 Aug 2016 17:28:42 +0200
Subject: client API: deprecate "no-..." option handling

The client API can do this (and there are apparently some libmpv using
projects which rely on this). But it's just unnecessary bloat as it
requires a separate code path from the option parser. It would be better
to remove this code. Formally deprecate it, including API bump and
warning in the API changes file to make it really clear.
---
 DOCS/man/options.rst | 34 ++++++++++++++++++----------------
 1 file changed, 18 insertions(+), 16 deletions(-)

(limited to 'DOCS/man/options.rst')

diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 7cc66dcb8d..f5a706940d 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -36,15 +36,32 @@ Track Selection
     See also ``--alang``. mpv normally prints available audio tracks on the
     terminal when starting playback of a file.
 
+    ``--audio`` is an alias for ``--aid``.
+
+    ``--aid=no`` or ``--audio=no`` or ``--no-audio`` disables audio playback.
+    (The latter variant does not work with the client API.)
+
 ``--sid=<ID|auto|no>``
     Display the subtitle stream specified by ``<ID>``. ``auto`` selects
     the default, ``no`` disables subtitles.
 
-    See also ``--slang``, ``--no-sub``.
+    ``--sub`` is an alias for ``--sid``.
+
+    ``--sid=no`` or ``--sub=no`` or ``--no-sub`` disables subtitle decoding.
+    (The latter variant does not work with the client API.)
 
 ``--vid=<ID|auto|no>``
     Select video channel. ``auto`` selects the default, ``no`` disables video.
 
+    ``--video`` is an alias for ``--vid``.
+
+    ``--vid=no`` or ``--video=no`` or ``--no-video`` disables video playback.
+    (The latter variant does not work with the client API.)
+
+    If vudeo is disabled, mpv will try to download the audio only if media is
+    streamed with youtube-dl, because it saves bandwidth. This is done by
+    setting the ytdl_format to "bestaudio/best" in the ytdl_hook.lua script.
+
 ``--ff-aid=<ID|auto|no>``, ``--ff-sid=<ID|auto|no>``, ``--ff-vid=<ID|auto|no>``
     Select audio/subtitle/video streams by the FFmpeg stream index. The FFmpeg
     stream index is relatively arbitrary, but useful when interacting with
@@ -517,14 +534,6 @@ Video
     ``--vf-clr`` exist to modify a previously specified list, but you
     should not need these for typical use.
 
-``--no-video``
-    Do not play video. With some demuxers this may not work. In those cases
-    you can try ``--vo=null`` instead.
-
-    mpv will try to download the audio only if media is streamed with
-    youtube-dl, because it saves bandwidth. This is done by setting the ytdl_format
-    to "bestaudio/best" in the ytdl_hook.lua script.
-
 ``--untimed``
     Do not sleep when outputting video frames. Useful for benchmarks when used
     with ``--no-audio.``
@@ -1092,9 +1101,6 @@ Audio
     Audio delay in seconds (positive or negative float value). Positive values
     delay the audio, and negative values delay the video.
 
-``--no-audio``
-    Do not play sound.
-
 ``--mute=<auto|yes|no>``
     Set startup audio mute status. ``auto`` (default) will not change the mute
     status.
@@ -1374,10 +1380,6 @@ Subtitles
     Subtitles in ASS format are normally not changed intentionally, but
     overriding them can be controlled with ``--ass-style-override``.
 
-
-``--no-sub``
-    Do not select any subtitle when the file is loaded.
-
 ``--sub-demuxer=<[+]name>``
     Force subtitle demuxer type for ``--sub-file``. Give the demuxer name as
     printed by ``--sub-demuxer=help``.
-- 
cgit v1.2.3