protocol: clients should not emulate key-press events on enter

The previous change introducing the logical state caused some confusion.
Clarify that most application should not use the list of pressed keys.

Signed-off-by: Julian Orth <ju.orth@gmail.com>
This commit is contained in:
Julian Orth 2024-09-06 13:28:07 +02:00 committed by Simon Ser
parent 6c4a695045
commit 7c6259e9ad

View file

@ -2479,6 +2479,9 @@
the surface argument and the keys currently logically down to the keys the surface argument and the keys currently logically down to the keys
in the keys argument. The compositor must not send this event if the in the keys argument. The compositor must not send this event if the
wl_keyboard already had an active surface immediately before this event. wl_keyboard already had an active surface immediately before this event.
Clients should not use the list of pressed keys to emulate key-press
events. The order of keys in the list is unspecified.
</description> </description>
<arg name="serial" type="uint" summary="serial number of the enter event"/> <arg name="serial" type="uint" summary="serial number of the enter event"/>
<arg name="surface" type="object" interface="wl_surface" summary="surface gaining keyboard focus"/> <arg name="surface" type="object" interface="wl_surface" summary="surface gaining keyboard focus"/>