summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorDudemanguy <random342@airmail.cc>2023-12-28 10:16:42 -0600
committerDudemanguy <random342@airmail.cc>2024-01-13 03:26:06 +0000
commit2ad96079e99b33e24c912f9b2f5129c1309abede (patch)
treedd297b38b4b967122e56b29869e22fd55b1d5e4d /DOCS/man/options.rst
parent871f7a152a3f0b3561a627d21f7417d10ac9c25c (diff)
downloadmpv-2ad96079e99b33e24c912f9b2f5129c1309abede.tar.bz2
mpv-2ad96079e99b33e24c912f9b2f5129c1309abede.tar.xz
player: add forced choice to subs-with-matching-audio
fe875083b3d30b06ef77745f40570e8f63afec2 confused things a bit and made --no-subs-with-matching-audio actually mean what it says: no subtitles if the languages match. However, the option actually meant no non-forced subtitles not no subtitles at all. This isn't really intuitive so instead of changing the behavior back to the old way (we already have a release since then), add a third option "forced" which is equivalent to the old meaning of --no-subs-with-matching audio. Fixes #13151.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst12
1 files changed, 7 insertions, 5 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 14d848ec56..28eeb7d064 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -135,11 +135,13 @@ Track Selection
Note that if ``--lavfi-complex`` is set before playback is started, the
referenced tracks are always selected.
-``--subs-with-matching-audio=<yes|no>``
- When autoselecting a subtitle track, select a full/non-forced one even if the selected
- audio stream matches your preferred subtitle language (default: yes). If this option is
- set to ``no``, a non-forced subtitle track that matches the audio language will never be
- autoselected by mpv regardless of the value of ``--slang`` or ``--subs-fallback``.
+``--subs-with-matching-audio=<yes|forced|no>``
+ When autoselecting a subtitle track, select it even if the selected audio
+ stream matches you preferred subtitle language (default: yes). If this
+ option is set to ``no``, then no subtitle track that matches the audio
+ language will ever be autoselected by mpv regardless of ``--slang`` or
+ ``subs-fallback``. If set to ``forced``, then only forced subtitles
+ will be selected.
``--subs-match-os-language=<yes|no>``
When autoselecting a subtitle track, select the track that matches the language of your OS