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

manpage: clarify writes to playlist-pos 

I don't know what should happen when the same value is written to the
property. It seems that it would be more natural if it were ignored
(since that's also what is done with options now), but you could argue
the other way around as well. In any case, changing it silently could
leads to user scripts etc. breaking, so don't change it now.

Instead, add blabla to the manpage to put the responsibility on the
user, so when we suddenly change it one day, we can blame any breakages
on someone else.

See: #7501
This commit is contained in:
wm4 2020-03-05 11:01:07 +01:00
parent 3b8b7cb9d4
commit e7de0e718c
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
DOCS/man/input.rst
View File

@ -2233,8 +2233,14 @@ Property list
is returned instead.
``playlist-pos`` (RW)
Current position on playlist. The first entry is on position 0. Writing
to the property will restart playback at the written entry.
Current position on playlist. The first entry is on position 0. Writing to
this property may start playback at the new position.
What happens if you write the same value back to the property is
implementation dependent. Currently, writing the same value will restart
playback from the beginning. It is possible (but not necessarily planned)
that in the future, write access if the same value is written will be
ignored.
``playlist-pos-1`` (RW)
Same as ``playlist-pos``, but 1-based.