path: root/DOCS
diff options
authorwm4 <wm4@nowhere>2017-04-10 21:19:13 +0200
committerwm4 <wm4@nowhere>2017-04-10 21:19:13 +0200
commit6dea8fceda981481798f6f492db54c6fd8708c3b (patch)
tree909de256cf9fd15602eb1f37eff72eedbb1c7acc /DOCS
parent759ac6cc93bd1895a8f9233b8e9256889bdef6aa (diff)
options: deprecate --loop
Also "announce" the plans to undeprecate it with changed semantics later. The deprecation period is needed to warn script authors and client API users (etc.) of the change. This is done because everyone seems to expect --loop to loop the current file, not the playlist. Even in cases when only 1 file is on the playlist, the --loop-file semantics seem to be preferred.
Diffstat (limited to 'DOCS')
2 files changed, 9 insertions, 2 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 0584409eb9..f3605016a8 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -41,6 +41,8 @@ Interface changes
support for lavfi filters still has some differences, such as how strings
are escaped.) If this happens, the non-deprecated builtin filters might be
moved to "somewhere else" syntax-wise.
+ - deprecate --loop - after a deprecation period, it will be undeprecated,
+ but changed to alias --loop-file
--- mpv 0.24.0 ---
- deprecate --hwdec-api and replace it with --opengl-hwdec-interop.
The new option accepts both --hwdec values, as well as named backends.
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 1a5bd637b7..ecf8d8ada3 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -134,17 +134,22 @@ Playback Control
speed higher than normal automatically inserts the ``scaletempo`` audio
-``--loop=<N|inf|force|no>``, ``--loop``
+``--loop-playlist=<N|inf|force|no>``, ``--loop-playlist``
Loops playback ``N`` times. A value of ``1`` plays it one time (default),
``2`` two times, etc. ``inf`` means forever. ``no`` is the same as ``1`` and
disables looping. If several files are specified on command line, the
- entire playlist is looped. ``--loop`` is the same as ``--loop=inf``.
+ entire playlist is looped. ``--loop-playlist`` is the same as
+ ``--loop-playlist=inf``.
The ``force`` mode is like ``inf``, but does not skip playlist entries
which have been marked as failing. This means the player might waste CPU
time trying to loop a file that doesn't exist. But it might be useful for
playing webradios under very bad network conditions.
+ Currently a deprecated alias to ``--loop-playlist``. After a deprecation
+ period, it will be undeprecated, but changed to alias ``--loop-file``.
Start the player in paused state.