From 6b828113a89b39888cde6ff89b1ae0f39a0cb4ee Mon Sep 17 00:00:00 2001
From: hooke007 <41094733+hooke007@users.noreply.github.com>
Date: Thu, 29 Jul 2021 03:08:24 +0800
Subject: [PATCH] DOCS/input.rst: key names: add shift modifier note

Fixes #9060
---
 DOCS/man/input.rst | 6 ++++++
 1 file changed, 6 insertions(+)

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.