From: Matthias Clasen Date: Sat, 30 Mar 2013 18:09:25 +0000 (-0400) Subject: docs: Add information about serials and timestamps X-Git-Tag: 1.0.90~34 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=3bda215130c245d222471e6430472d02023d0d6f;p=platform%2Fupstream%2Fwayland.git docs: Add information about serials and timestamps Add some information about serials, timestamps and their uses to the Input section in the protocol overview. --- diff --git a/doc/Wayland/en_US/Protocol.xml b/doc/Wayland/en_US/Protocol.xml index 61dc637..d92cf6f 100644 --- a/doc/Wayland/en_US/Protocol.xml +++ b/doc/Wayland/en_US/Protocol.xml @@ -241,6 +241,22 @@ with a pointer grab. + 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. + + + 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. + + See for the protocol description.