DOCS/input.rst: clarify --no-input-default-keybindings docs

This commit describes more accurately what currently gets disabled
by this option - specifically also keys from mp.add_key_binding.

It's not necessarily the best behavior because libmpv clients might
want to disable mpv's own builtin keybindings while still allowing
scripts to define keys which `input.conf' can override.

In the future we might exclude mp.add_key_binding from this option,
but for now at least document this option accurately.

Fixes #8809
This commit is contained in:
Avi Halachmi (:avih) 2021-05-04 17:16:39 +03:00
parent f6f9b1e8db
commit 8edfe70b83
1 changed files with 4 additions and 1 deletions

View File

@ -3782,7 +3782,10 @@ Input
configuration directory (usually ``~/.config/mpv/input.conf``). configuration directory (usually ``~/.config/mpv/input.conf``).
``--no-input-default-bindings`` ``--no-input-default-bindings``
Disable mpv default (built-in) key bindings. Disable mpv default (built-in) key bindings. Currently this includes all
key bindings which ``input.conf`` can override, like those added by scripts
using ``mp.add_key_binding`` (but not ``mp.add_forced_key_binding``).
This might change in the future to exclude ``mp.add_key_binding``.
``--input-cmdlist`` ``--input-cmdlist``
Prints all commands that can be bound to keys. Prints all commands that can be bound to keys.