summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2016-09-18 13:38:45 +0200
committerwm4 <wm4@nowhere>2016-09-18 16:08:21 +0200
commit9e972ed7d28c33bf612452682f229fa14ef017ea (patch)
tree747742a503bf7d866a3f99efb9821b34c552c627 /DOCS/man/options.rst
parent62d4a3891a152253a91f2054dd7b24c1aa5d285f (diff)
downloadmpv-9e972ed7d28c33bf612452682f229fa14ef017ea.tar.bz2
mpv-9e972ed7d28c33bf612452682f229fa14ef017ea.tar.xz
options: rename/deprecate --playlist-pos
Conflicts with the "playlist-pos" property. They're really a bit too different, and since the --playlist-pos option is relatively new and obscure, just rename it to get this out of the way.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst8
1 files changed, 5 insertions, 3 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index cefd12eae5..349d948834 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -157,17 +157,19 @@ Playback Control
See also: ``--start``.
-``--playlist-pos=<no|index>``
+``--playlist-start=<auto|index>``
Set which file on the internal playlist to start playback with. The index
- is an integer, with 0 meaning the first file. The value ``no`` means that
+ is an integer, with 0 meaning the first file. The value ``auto`` means that
the selection of the entry to play is left to the playback resume mechanism
(default). If an entry with the given index doesn't exist, the behavior is
unspecified and might change in future mpv versions. The same applies if
the playlist contains further playlists (don't expect any reasonable
behavior). Passing a playlist file to mpv should work with this option,
- though. E.g. ``mpv playlist.m3u --playlist-pos=123`` will work as expected,
+ though. E.g. ``mpv playlist.m3u --playlist-start=123`` will work as expected,
as long as ``playlist.m3u`` does not link to further playlists.
+ The value ``no`` is a deprecated alias for ``auto``.
+
``--playlist=<filename>``
Play files according to a playlist file (Supports some common formats. If
no format is detected, it will be treated as list of files, separated by