summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2016-08-31 17:28:42 +0200
committerwm4 <wm4@nowhere>2016-08-31 22:16:43 +0200
commitb10dcecf7d71a076525bc2ac4b6bd72f4c453278 (patch)
treee638153d212784b4466934d254e5475a83cd98fe /DOCS/man/options.rst
parent7dde096d8a6d9e82cac82bec439fef47d078f352 (diff)
downloadmpv-b10dcecf7d71a076525bc2ac4b6bd72f4c453278.tar.bz2
mpv-b10dcecf7d71a076525bc2ac4b6bd72f4c453278.tar.xz
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.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst34
1 files changed, 18 insertions, 16 deletions
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``.