Document serial param usage in wl_pointer.set_cursor

Serial is supposed to contain the latest wl_pointer.enter value received
by clients but it was not even mentioned in the docs, so add it to avoid
misinterpretations.

Signed-off-by: Nick Diego Yamane <nickdiego@igalia.com>

diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 61e0366..9955d24 100644 (file)
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -1905,6 +1905,10 @@
        wl_surface is no longer used as the cursor. When the use as a
        cursor ends, the current and pending input regions become
        undefined, and the wl_surface is unmapped.
+
+       The serial parameter must match the latest wl_pointer.enter
+       serial number sent to the client. Otherwise the request will be
+       ignored.
       </description>
       <arg name="serial" type="uint" summary="serial number of the enter event"/>
       <arg name="surface" type="object" interface="wl_surface" allow-null="true"