RepoMirrors
/
mpv
mirror of https://github.com/mpv-player/mpv
1
0
Fork 0
Code Issues Releases Wiki Activity

DOCS/man/input.rst: document breaking change of loadfile index argument 

As an instance of "extraordinary circumstances", such incompatibility
must be extensively documented.
This commit is contained in:
nanahi 2024-05-16 02:44:49 -04:00 committed by Kacper Michajłow
parent d890f369df
commit 8143779e24
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
DOCS/man/input.rst
View File

@ -487,7 +487,7 @@ Remember to quote string arguments in input.conf (see `Flat command syntax`_).
``insert-at-play`` actions. When used with those actions, the new item will
be inserted at the index position in the playlist, or appended to the end if
index is less than 0 or greater than the size of the playlist. This argument
will be ignored for all other actions.
will be ignored for all other actions. This argument is added in mpv 0.38.0.
The fourth argument is a list of options and values which should be set
while the file is playing. It is of the form ``opt1=value1,opt2=value2,..``.
@ -496,6 +496,14 @@ Remember to quote string arguments in input.conf (see `Flat command syntax`_).
options are set during playback, and restored to the previous value at end
of playback (see `Per-File Options`_).
.. warning::
Since mpv 0.38.0, an insertion index argument is added as the third argument.
This breaks all existing uses of this command which make use of the argument
to include the list of options to be set while the file is playing. To address
this problem, the third argument now needs to be set to -1 if the fourth
argument needs to be used.
``loadlist <url> [<flags> [<index>]]``
Load the given playlist file or URL (like ``--playlist``).