[PATCH weston] xdg-shell: define further the behavior of input devices around xdg_popup

[Carlos Garnacho]

This consolidates the behavior that compositors must implement when
xdg_popups cause input to be redirected into the popup surface.

Signed-off-by: Carlos Garnacho <carlosg at gnome.org>
---
 protocol/xdg-shell.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
index 44a3a12..4ae872c 100644
--- a/protocol/xdg-shell.xml
+++ b/protocol/xdg-shell.xml
@@ -252,6 +252,9 @@
 
 	The server may ignore move requests depending on the state of
 	the surface (e.g. fullscreen or maximized).
+
+	This request will trigger the emission of seat.release_input
+	events on all interacted surfaces, including this one.
       </description>
       <arg name="seat" type="object" interface="wl_seat" summary="the wl_seat of the user event"/>
       <arg name="serial" type="uint" summary="the serial of the user event"/>
@@ -284,6 +287,9 @@
 
 	The server may ignore resize requests depending on the state of
 	the surface (e.g. fullscreen or maximized).
+
+	This request will trigger the emission of seat.release_input
+	events on all interacted surfaces, including this one.
       </description>
       <arg name="seat" type="object" interface="wl_seat" summary="the wl_seat of the user event"/>
       <arg name="serial" type="uint" summary="the serial of the user event"/>
@@ -556,6 +562,12 @@
 
       For a surface to be mapped by the compositor the client must have
       committed both the xdg_popup state and a buffer.
+
+      When the xdg_popup state is committed, events from all input
+      capabilities will be immediately redirected to the xdg_popup or be
+      eligible for xdg_popup deactivation. The compositor must emit
+      seat.release_input events on all surfaces being currently
+      interacted with.
     </description>
 
     <request name="destroy" type="destructor">
-- 
2.4.2