summaryrefslogtreecommitdiffstats
path: root/DOCS/man/input.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-10-15 22:39:33 +0200
committerwm4 <wm4@nowhere>2014-10-15 22:39:33 +0200
commitbc0ed904811b4e4a0fc3d6129ba92e2c786cbabf (patch)
tree158d3e662b4d1f2c6031d80b1b037ffa4f04f6da /DOCS/man/input.rst
parent312531c08c2376257a43bd40e4ace08c2893da4d (diff)
downloadmpv-bc0ed904811b4e4a0fc3d6129ba92e2c786cbabf.tar.bz2
mpv-bc0ed904811b4e4a0fc3d6129ba92e2c786cbabf.tar.xz
command: allow setting per-file options at runtime
The intended use-case is for doing this at load time, after the load command was issued. (See following commit.)
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r--DOCS/man/input.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 269783c45b..3ae48bc125 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -1361,6 +1361,16 @@ Property list
require reloading the file for changes to take effect. If there is an
equivalent property, prefer setting the property instead.
+``file-local-options/<name>``
+ Similar to ``options/<name>``, but when setting an option through this
+ property, the option is reset to its old value once the current file has
+ stopped playing. Trying to write an option while no file is playing (or
+ is being loaded) results in an error.
+
+ (Note that if an option is marked as file-local, even ``options/`` will
+ access the local value, and the ``old`` value, which will be restored on
+ end of playback, can not be read or written until end of playback.)
+
``property-list``
Return the list of top-level properties.