From f23c21ef17fd3f456f406f24ec4f6c2abfd1d0d2 Mon Sep 17 00:00:00 2001 From: Kevin Mitchell Date: Tue, 5 Dec 2017 22:07:20 -0800 Subject: manpage: add note about properties not immediately showing up fixes #5134 --- DOCS/man/lua.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/DOCS/man/lua.rst b/DOCS/man/lua.rst index cfd622b078..831981db06 100644 --- a/DOCS/man/lua.rst +++ b/DOCS/man/lua.rst @@ -39,7 +39,10 @@ option. Some scripts are loaded internally (like ``--osc``). Each script runs in its own thread. Your script is first run "as is", and once that is done, the event loop is entered. This event loop will dispatch events received by mpv and call your own event handlers which you have registered with ``mp.register_event``, or -timers added with ``mp.add_timeout`` or similar. +timers added with ``mp.add_timeout`` or similar. Note that since the +script starts execution concurrently with player initialization, some properties +may not be populated with meaningful values until the relevant subsystems have +initialized. When the player quits, all scripts will be asked to terminate. This happens via a ``shutdown`` event, which by default will make the event loop return. If your -- cgit v1.2.3