summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorhooke007 <41094733+hooke007@users.noreply.github.com>2021-07-29 03:08:24 +0800
committerAvi Halachmi (:avih) <avihpit@yahoo.com>2021-07-30 11:08:19 +0300
commit6b828113a89b39888cde6ff89b1ae0f39a0cb4ee (patch)
treef955292bd3b69016b80f8096cd4b5bd24ac9ad4f
parent8b1930fbd69d5d911f38918cdd5c6936b8941b0e (diff)
downloadmpv-6b828113a89b39888cde6ff89b1ae0f39a0cb4ee.tar.bz2
mpv-6b828113a89b39888cde6ff89b1ae0f39a0cb4ee.tar.xz
DOCS/input.rst: key names: add shift modifier note
Fixes #9060
-rw-r--r--DOCS/man/input.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index d890471de2..75841dba99 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -97,6 +97,12 @@ All key names can be combined with the modifiers ``Shift``, ``Ctrl``, ``Alt``,
``Meta``. They must be prefixed to the actual key name, where each modifier
is followed by a ``+`` (for example ``ctrl+q``).
+The ``Shift`` modifier requires some attention. For instance ``Shift+2`` should
+usually be specified as key-name ``@`` at ``input.conf``, and similarly the
+combination ``Alt+Shift+2`` is usually ``Alt+@``, etc. Special key names like
+``Shift+LEFT`` work as expected. If in doubt - use ``--input-test`` to check
+how a key/combination is seen by mpv.
+
Symbolic key names and modifier names are case-insensitive. Unicode key names
are case-sensitive because input bindings typically respect the shift key.