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

docs: Add information about serials and timestamps

Browse source 
Add some information about serials, timestamps and their uses
to the Input section in the protocol overview.
This commit is contained in:
Matthias Clasen 2013-03-30 14:09:25 -04:00 • committed by Kristian Høgsberg
parent c110fbcb75
commit 3bda215130
1 changed files with 16 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/Wayland/en_US/Protocol.xml
View file

@ -240,6 +240,22 @@
be mapped as 'popup', which combines transient window semantics be mapped as 'popup', which combines transient window semantics
with a pointer grab. with a pointer grab.
</para> </para>
<para>
To avoid race conditions, input events that are likely to
trigger further requests (such as button presses, key events,
pointer motions) carry serial numbers, and requests such as
wl_surface.set_popup require that the serial number of the
triggering event is specified. The server maintains a
monotonically increasing counter for these serial numbers.
</para>
<para>
Input events also carry timestamps with millisecond granularity.
Their base is undefined, so they can't be compared against
system time (as obtained with clock_gettime or gettimeofday).
They can be compared with each other though, and for instance
be used to identify sequences of button presses as double
or triple clicks.
</para>
<para> <para>
See <xref linkend="protocol-spec-interface-wl_seat"/> for the See <xref linkend="protocol-spec-interface-wl_seat"/> for the
protocol description. protocol description.