Merge branch 'button_position' into 'main'

protocol: add wl_pointer.warp event

See merge request wayland/wayland!340

protocol/wayland.xml

@@ -2130,8 +2130,9 @@
       <description summary="pointer button event">
 	Mouse button click and release notifications.
 
-	The location of the click is given by the last motion or
+	The location of the click is given by the last motion, warp or
 	enter event.
+
 	The time argument is a timestamp with millisecond
 	granularity, with an undefined base.
 
@@ -2431,6 +2432,27 @@
       <arg name="direction" type="uint" enum="axis_relative_direction"
 	  summary="physical direction relative to axis motion"/>
     </event>
+
+    <!-- Version 10 additions -->
+
+    <event name="warp" since="10">
+      <description summary="pointer warp event">
+	Notification of pointer location change within a surface.
+	This location change is not due to events on the input device,
+	but because either the surface under the pointer was moved and
+	thus the relative position of the pointer changed, or because
+	the compositor changed the pointer position in response to
+	an event like pointer confinement being exited. The arguments
+	surface_x and surface_y are the location relative to the
+	focused surface.
+
+	This event must not occur in the same wl_pointer.frame as a
+	wl_pointer.enter or wl_pointer.motion event.
+
+      </description>
+      <arg name="surface_x" type="fixed" summary="surface-local x coordinate"/>
+      <arg name="surface_y" type="fixed" summary="surface-local y coordinate"/>
+    </event>
   </interface>
 
   <interface name="wl_keyboard" version="10">