mirrors/wayland
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland.git synced 2025-10-29 05:40:16 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

protocol: Clarify sending of wl_seat.capabilities

Browse source 
It wasn't explicitly stated that wl_seat.capabilities should also
be sent on bind. Everyone did because it was obviously sensible.

This also clarifies that static seat name should be sent before
announcing capabilities so clients can associate these devices with the
right seat name.

Signed-off-by: David Edmundson <davidedmundson@kde.org>
This commit is contained in:
David Edmundson 2024-09-26 12:15:37 +01:00 • committed by Simon Ser
parent 66fc3f007d
commit 3214f858e2
1 changed files with 7 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

13
protocol/wayland.xml
View file

@ -1913,9 +1913,10 @@
<event name="capabilities"> <event name="capabilities">
<description summary="seat capabilities changed"> <description summary="seat capabilities changed">
This is emitted whenever a seat gains or loses the pointer, This is sent on binding to the seat global or whenever a seat gains
keyboard or touch capabilities. The argument is a capability or loses the pointer, keyboard or touch capabilities.
enum containing the complete set of capabilities this seat has. The argument is a capability enum containing the complete set of
capabilities this seat has.
When the pointer capability is added, a client may create a When the pointer capability is added, a client may create a
wl_pointer object using the wl_seat.get_pointer request. This object wl_pointer object using the wl_seat.get_pointer request. This object
@ -1997,9 +1998,9 @@
The same seat names are used for all clients. Thus, the name can be The same seat names are used for all clients. Thus, the name can be
shared across processes to refer to a specific wl_seat global. shared across processes to refer to a specific wl_seat global.
The name event is sent after binding to the seat global. This event is The name event is sent after binding to the seat global, and should be sent
only sent once per seat object, and the name does not change over the before announcing capabilities. This event only sent once per seat object,
lifetime of the wl_seat global. and the name does not change over the lifetime of the wl_seat global.
Compositors may re-use the same seat name if the wl_seat global is Compositors may re-use the same seat name if the wl_seat global is
destroyed and re-created later. destroyed and re-created later.