summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-06-13 02:05:37 +0200
committerwm4 <wm4@nowhere>2014-06-13 02:05:37 +0200
commit98a31d5937e8397d8fcd0fefe56630a1cd765cf0 (patch)
tree047059fc97815b1ddafd35f1e68717a09cfed61e /DOCS
parenta7a14be088b6af60a506db04e5ee864112bc5544 (diff)
downloadmpv-98a31d5937e8397d8fcd0fefe56630a1cd765cf0.tar.bz2
mpv-98a31d5937e8397d8fcd0fefe56630a1cd765cf0.tar.xz
options: turn --idx, --forceidx into --index
Also clarify the semantics. It seems --idx didn't do anything. Possibly it used to change how the now removed legacy demuxers like demux_avi used to behave. Or maybe it was accidental. --forceidx basically becomes --index=force. It's possible that new index modes will be added in the future, so I'm keeping it extensible, instead of e.g. creating --force-index.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/changes.rst2
-rw-r--r--DOCS/man/en/options.rst21
2 files changed, 9 insertions, 14 deletions
diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
index 01a210fae8..f1f336ac7c 100644
--- a/DOCS/man/en/changes.rst
+++ b/DOCS/man/en/changes.rst
@@ -158,11 +158,13 @@ Command Line Switches
``-endpos`` ``--length``
``-font`` ``--osd-font``
``-forcedsubsonly`` ``--sub-forced-only``
+ ``-forceidx`` ``--index``
``-format`` ``--audio-format``
``-fsmode-dontuse`` (removed)
``-fstype`` ``--x11-netwm`` (changed semantics)
``-hardframedrop`` ``--framedrop=hard``
``-identify`` (removed; use TOOLS/mpv_identify.sh)
+ ``-idx`` ``--index``
``-lavdopts ...`` ``--vd-lavc-...``
``-lavfdopts`` ``--demuxer-lavf-...``
``-lircconf`` ``--input-lirc-conf``
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index d121fe2adc..e7044c53d8 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -826,15 +826,6 @@ OPTIONS
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).
-
``--fps=<float>``
Override video framerate. Useful if the original value is wrong or missing.
@@ -1129,11 +1120,13 @@ OPTIONS
Mostly useful in slave mode, where mpv can be controlled through input
commands (see also ``--slave-broken``).
-``--idx``
- Rebuilds index of files if no index was found, allowing seeking. Useful
- with broken/incomplete downloads or badly created files. Now this is done
- automatically by the demuxers used for most video formats, meaning that
- this switch has no effect in the typical case. See also ``--forceidx``.
+``--index=<mode>``
+ Controls how to seek in files. Note that if the index is missing from a
+ file, it will be built on the fly by default, so you don't need to change
+ this. But it might help with some broken files.
+
+ :default: use an index if the file has one, or build it if missing
+ :recreate: don't read or use the file's index
.. note::