summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorAvi Halachmi (:avih) <avihpit@yahoo.com>2019-12-21 12:13:15 +0200
committerAvi Halachmi (:avih) <avihpit@yahoo.com>2019-12-21 14:57:10 +0200
commit71ddb22b39ec3cce1c39b7f53975e51e94d257d4 (patch)
treea475a493535ffae5e01eaff0707fb8c75fd7f64e /DOCS
parent05fb6f906de25016faff2bdedd1f47f1e4077554 (diff)
downloadmpv-71ddb22b39ec3cce1c39b7f53975e51e94d257d4.tar.bz2
mpv-71ddb22b39ec3cce1c39b7f53975e51e94d257d4.tar.xz
js: read_options: support on_update (match 478a321d)
This is a bit different than the lua code: on script-opts change it simply re-applies the conf-file and script-opts to the options object, and if this results in any changed value at options then on_update is called with the changelist as argument. This allows a value to revert back to the conf-file value if the matching script-opts key had a different value and then got deleted. It also guarantees to call back whenever the options object is modified, which the lua code doesn't do (e.g. if the caller changed a value and the observer changed it back - it won't detect a change).
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/javascript.rst3
1 files changed, 2 insertions, 1 deletions
diff --git a/DOCS/man/javascript.rst b/DOCS/man/javascript.rst
index c0c4dbad8c..8e3e7d6199 100644
--- a/DOCS/man/javascript.rst
+++ b/DOCS/man/javascript.rst
@@ -187,7 +187,8 @@ success, ``fn`` is called always a-sync, ``error`` is empty string on success.
``mp.add_hook(type, priority, fn)``
-``mp.options.read_options(obj [, identifier])`` (types: string/boolean/number)
+``mp.options.read_options(obj [, identifier [, on_update]])`` (types:
+string/boolean/number, ``on_update`` does re-read the config file)
Additional utilities
--------------------