summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst6
-rw-r--r--DOCS/man/input.rst5
2 files changed, 7 insertions, 4 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 2290c6c6b1..5b1ab8602f 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -54,8 +54,10 @@ Interface changes
Using the "playlist-play-index" command is recommended instead.
- add "playlist-play-index" command
- add playlist-current-pos, playlist-playing-pos properties
- - Lua end-file events do not set the "error" field anymore, use "file_error"
- instead.
+ - Lua end-file events set the "error" field; this is deprecated; use the
+ "file_error" instead for this specific event. Scripts relying on the
+ "error" field for end-file will silently break at some point in the
+ future.
- deprecate encoding mode (lack of maintainer)
--- mpv 0.32.0 ---
- change behavior when using legacy option syntax with options that start
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 7a4c5dcdc2..bcc7c0100d 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -1350,8 +1350,9 @@ This list uses the event name field value, and the C API symbol in brackets:
``file_error``
Set to mpv error string describing the approximate reason why playback
failed. Unset if no error known. (In Lua scripting, this value was set
- on the ``error`` field directly before mpv 0.33.0. Now the ``error``
- field always indicates success, i.e. is not set.)
+ on the ``error`` field directly. This is deprecated since mpv 0.33.0.
+ In the future, this ``error`` field will be unset for this specific
+ event.)
``file-loaded`` (``MPV_EVENT_FILE_LOADED``)
Happens after a file was loaded and begins playback.