path: root/DOCS
diff options
authorwm4 <wm4@nowhere>2018-01-24 03:20:15 +0100
committerKevin Mitchell <>2018-01-25 20:18:32 -0800
commit0d359879c9edfaefe8f4d500802781e32f2c8d9a (patch)
treeb412fe69f8e0723ef11be2b9018e2e43768312f0 /DOCS
parent9e64b9382265fb688fecda15b28ad6c41b587cd6 (diff)
command: add a change-list command
Requested. See manpage additions. The main reason why this goes through the trouble to keep the action/operation parameter separate is so that we don't expose some option parser implementation details to the command (although that is a relatively weak reason), and also to make it more different from the "set" command, which can't support this type of option as it goes through the property layer. Fixes #5435.
Diffstat (limited to 'DOCS')
2 files changed, 20 insertions, 0 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 1a9c07e19d..188858d86d 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -732,6 +732,23 @@ Input Commands that are Possibly Subject to Change
``load-script "<path>"``
Load a script, similar to the ``--script`` option.
+``change-list "<option>" "<operation>" "<value>"``
+ This command changes list options as described in `List Options`_. The
+ ``<option>`` parameter is the normal option name, while ``<operation>`` is
+ the suffix or action used on the option.
+ Some operations take no value, but the command still requires the value
+ parameter. In these cases, the value must be an empty string.
+ .. admonition:: Example
+ ``change-list glsl-shaders append file.glsl``
+ Add a filename to the ``glsl-shaders`` list. The command line
+ equivalent is ``--glsl-shaders-append=file.glsl`` or alternatively
+ ``--glsl-shader=file.glsl``.
Undocumented commands: ``tv-last-channel`` (TV/DVB only),
``ao-reload`` (experimental/internal).
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index d7564c3b57..1919485069 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -448,6 +448,9 @@ aliases for the proper option with ``-append`` action. For example,
Some options only support a subset of the above.
+Options of this type can be changed at runtime using the ``change-list``
+command, which takes the suffix as separate operation parameter.
Playing DVDs