mirrors/wayland
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland.git synced 2025-11-25 06:59:46 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

protocol: clarify wl_seat.name description

Browse source 
Define the expected properties of the seat name.

Signed-off-by: Simon Ser <contact@emersion.fr>
This commit is contained in:
Simon Ser 2021-06-29 12:47:04 +02:00
parent 92038fa394
commit 767765d584
1 changed files with 16 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

19
protocol/wayland.xml
View file

@ -1842,9 +1842,22 @@
<event name="name" since="2"> <event name="name" since="2">
<description summary="unique identifier for this seat"> <description summary="unique identifier for this seat">
In a multiseat configuration this can be used by the client to help In a multi-seat configuration the seat name can be used by clients to
identify which physical devices the seat represents. Based on help identify which physical devices the seat represents.
the seat configuration used by the compositor.
The seat name is a UTF-8 string with no convention defined for its
contents. Each name is unique among all wl_seat globals. The name is
only guaranteed to be unique for the current compositor instance.
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.
The name event is sent after binding to the seat global. This event is
only sent once per seat object, 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
destroyed and re-created later.
</description> </description>
<arg name="name" type="string" summary="seat identifier"/> <arg name="name" type="string" summary="seat identifier"/>
</event> </event>