From 0780eef7b111d963717d6891a232182e84bbf4d9 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Fri, 17 Oct 2025 20:29:20 +0530 Subject: [PATCH] Fix #9125 --- docs/keyboard-protocol.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/keyboard-protocol.rst b/docs/keyboard-protocol.rst index 015dd05cb..4acf01480 100644 --- a/docs/keyboard-protocol.rst +++ b/docs/keyboard-protocol.rst @@ -468,7 +468,10 @@ These keys are encoded using three schemes:: In the above, if there are no modifiers, the modifier parameter is omitted. The modifier value is encoded as described in the :ref:`modifiers` section, -above. When the second form is used, the number is always ``1`` and must be +above, except that lock keys (such as :kbd:`Num lock` and :kbd:`Caps lock`) +are not encoded as the legacy mode has no encoding for them. + +When the second form is used, the number is always ``1`` and must be omitted if the modifiers field is also absent. The third form becomes the second form when modifiers are present (``SS3 is the bytes 0x1b 0x4f``).