summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/lua.rst6
1 files changed, 5 insertions, 1 deletions
diff --git a/DOCS/man/lua.rst b/DOCS/man/lua.rst
index 7be8960915..d3034f1113 100644
--- a/DOCS/man/lua.rst
+++ b/DOCS/man/lua.rst
@@ -344,12 +344,16 @@ The ``mp`` module is preloaded, although it can be loaded manually with
exact behavior depends on timing and other things.)
In some cases the function is not called even if the property changes.
- Whether this can happen depends on the property.
+ This depends on the property, and it's a valid feature request to ask for
+ better update handling of a specific property.
If the ``type`` is ``none`` or ``nil``, sporadic property change events are
possible. This means the change function ``fn`` can be called even if the
property doesn't actually change.
+ You always get an initial change notification. This is meant to initialize
+ the user's state to the current value of the property.
+
``mp.unobserve_property(fn)``
Undo ``mp.observe_property(..., fn)``. This removes all property handlers
that are equal to the ``fn`` parameter. This uses normal Lua ``==``