summaryrefslogtreecommitdiff
path: root/protocol
diff options
context:
space:
mode:
authorSimon Ser <contact@emersion.fr>2020-02-03 15:45:58 +0100
committerSimon Ser <contact@emersion.fr>2020-06-16 11:35:14 +0200
commit1dfd2169dad8c7a39506b52afbedd42b7a1d9dbe (patch)
treedac258b7de5f25e6c3627976522c9e31e8a7c1d8 /protocol
parent57b7c7d9463f391a1cae6fa049b2f98a3de3d09e (diff)
downloadwayland-1dfd2169dad8c7a39506b52afbedd42b7a1d9dbe.tar.gz
protocol: disambiguate key codes in wl_keyboard.key
Explain that wl_keyboard.key yields platform-specific key codes. Some compositors use Linux key codes (defined in the linux/input-event-codes.h header file, e.g. KEY_ESC), however clients should not assume that this is always the case. The only reliable way for clients to interpret key codes is to feed them into a keyboard mapping. Signed-off-by: Simon Ser <contact@emersion.fr>
Diffstat (limited to 'protocol')
-rw-r--r--protocol/wayland.xml3
1 files changed, 3 insertions, 0 deletions
diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 9784680..d087e25 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -2240,6 +2240,9 @@
The time argument is a timestamp with millisecond
granularity, with an undefined base.
+ The key is a platform-specific key code that can be interpreted
+ by feeding it to the keyboard mapping (see the keymap event).
+
If this event produces a change in modifiers, then the resulting
wl_keyboard.modifiers event must be sent after this event.
</description>