Fixes after @whot review

Signed-off-by: Pierre Le Marre <dev@wismill.eu>
This commit is contained in:
Pierre Le Marre 2025-12-11 09:01:33 +01:00
parent d0e65f78b3
commit a05fb244e1
No known key found for this signature in database
GPG key ID: 3BFB00E5C59E818E

View file

@ -2518,9 +2518,11 @@
the recipient, as MAP_SHARED may fail. the recipient, as MAP_SHARED may fail.
From version 11 onwards, multiple wl_keyboard.keymap events may be sent From version 11 onwards, multiple wl_keyboard.keymap events may be sent
within the same frame, each one with a different keymap format. Clients within a single frame, each representing the same keymap in a distinct
should select at most one of these events. Clients are advised to select keymap format. Clients must select and process at most one of these
the format with most supported features. keymaps, ideally the one offering the greatest feature coverage, while
immediately closing the file descriptors corresponding to unused
keymaps. Keymap events sent in a later frame replace the active keymap.
</description> </description>
<arg name="format" type="uint" enum="keymap_format" summary="keymap format"/> <arg name="format" type="uint" enum="keymap_format" summary="keymap format"/>
<arg name="fd" type="fd" summary="keymap file descriptor"/> <arg name="fd" type="fd" summary="keymap file descriptor"/>
@ -2542,6 +2544,9 @@
Clients should not use the list of pressed keys to emulate key-press Clients should not use the list of pressed keys to emulate key-press
events. The order of keys in the list is unspecified. events. The order of keys in the list is unspecified.
From version 11 onwards this event is part of a wl_keyboard.frame
logical event group. See wl_keyboard.frame for details.
</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"/>
@ -2560,6 +2565,9 @@
defaults. The compositor must not send this event if the active surface defaults. The compositor must not send this event if the active surface
of the wl_keyboard was not equal to the surface argument immediately of the wl_keyboard was not equal to the surface argument immediately
before this event. before this event.
From version 11 onwards this event is part of a wl_keyboard.frame
logical event group. See wl_keyboard.frame for details.
</description> </description>
<arg name="serial" type="uint" summary="serial number of the leave event"/> <arg name="serial" type="uint" summary="serial number of the leave event"/>
<arg name="surface" type="object" interface="wl_surface" summary="surface that lost keyboard focus"/> <arg name="surface" type="object" interface="wl_surface" summary="surface that lost keyboard focus"/>
@ -2607,6 +2615,9 @@
key state when a wl_keyboard.repeat_info event with a rate argument of key state when a wl_keyboard.repeat_info event with a rate argument of
0 has been received. This allows the compositor to take over the 0 has been received. This allows the compositor to take over the
responsibility of key repetition. responsibility of key repetition.
From version 11 onwards this event is part of a wl_keyboard.frame
logical event group. See wl_keyboard.frame for details.
</description> </description>
<arg name="serial" type="uint" summary="serial number of the key event"/> <arg name="serial" type="uint" summary="serial number of the key event"/>
<arg name="time" type="uint" summary="timestamp with millisecond granularity"/> <arg name="time" type="uint" summary="timestamp with millisecond granularity"/>
@ -2629,6 +2640,9 @@
In the wl_keyboard logical state, this event updates the modifiers and In the wl_keyboard logical state, this event updates the modifiers and
group. group.
From version 11 onwards this event is part of a wl_keyboard.frame
logical event group. See wl_keyboard.frame for details.
</description> </description>
<arg name="serial" type="uint" summary="serial number of the modifiers event"/> <arg name="serial" type="uint" summary="serial number of the modifiers event"/>
<arg name="mods_depressed" type="uint" summary="depressed modifiers"/> <arg name="mods_depressed" type="uint" summary="depressed modifiers"/>
@ -2659,6 +2673,9 @@
This event can be sent later on as well with a new value if necessary, This event can be sent later on as well with a new value if necessary,
so clients should continue listening for the event past the creation so clients should continue listening for the event past the creation
of wl_keyboard. of wl_keyboard.
From version 11 onwards this event is part of a wl_keyboard.frame
logical event group. See wl_keyboard.frame for details.
</description> </description>
<arg name="rate" type="int" <arg name="rate" type="int"
summary="the rate of repeating keys in characters per second"/> summary="the rate of repeating keys in characters per second"/>
@ -2677,8 +2694,8 @@
All wl_keyboard events before a wl_keyboard.frame event belong All wl_keyboard events before a wl_keyboard.frame event belong
logically together. For example, multiple wl_keyboard.keymap event may logically together. For example, multiple wl_keyboard.keymap event may
be sent — each one with a different format — and finally a be sent — each one with a different format — and finally a
wl_keyboard.frame event. The client may use this information to select wl_keyboard.frame event. See the wl_keyboard.keymap event for more
the keymap format that fits best. details.
A wl_keyboard.frame event is sent for every logical event group, A wl_keyboard.frame event is sent for every logical event group,
even if the group only contains a single wl_keyboard event. even if the group only contains a single wl_keyboard event.