lua: restore recent end-file event, and deprecate it

Lua changed behavior for this specific event. I considered the change
minor enough that it would not need to go through deprecation, but
someone hit it immediately and ask on the -dev channel.

It's probably better to restore the behavior. But mark it as deprecated,
since it's problematic (mismatch with the C API). Unfortunately, no
automatic warning is possible. (Or maybe it is, by playing sophisticated
Lua tricks such as setting a metatable and overriding indexing, but
let's not.)

1 files changed, 3 insertions, 2 deletions

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.