summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKevin Mitchell <kevmitch@gmail.com>2017-12-05 22:07:20 -0800
committeravih <avih@users.noreply.github.com>2017-12-06 09:05:57 +0200
commitf23c21ef17fd3f456f406f24ec4f6c2abfd1d0d2 (patch)
treed070704b0dede33d2768dc97e0847c32c0756508
parent0433162f7f9590b3b9001fdb0aa3d8e207561363 (diff)
downloadmpv-f23c21ef17fd3f456f406f24ec4f6c2abfd1d0d2.tar.bz2
mpv-f23c21ef17fd3f456f406f24ec4f6c2abfd1d0d2.tar.xz
manpage: add note about properties not immediately showing up
fixes #5134
-rw-r--r--DOCS/man/lua.rst5
1 files changed, 4 insertions, 1 deletions
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