[PATCH weston 08/17] xdg-shell: Further clarify xdg_surface.move semantics
jadahl at gmail.com
Tue Apr 7 02:01:23 PDT 2015
Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
protocol/xdg-shell.xml | 13 +++++++++++--
1 file changed, 11 insertions(+), 2 deletions(-)
diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
index d013803..46775fe 100644
@@ -233,10 +233,19 @@
Start an interactive, user-driven move of the surface.
This request must be used in response to some sort of user action
- like a button press, key press, or touch down event.
+ like a button press, key press, or touch down event. The passed
+ serial is used to determine what type of interactive move (touch,
+ pointer, etc) is.
The server may ignore move requests depending on the state of
- the surface (e.g. fullscreen or maximized).
+ the surface (e.g. fullscreen or maximized), or if the passed serial
+ is no longer valid.
+ If triggered, the surface will loose the focus of the device
+ (wl_pointer, wl_touch, etc) used for the move. It is up to the
+ compositor display any indications, such as updating a pointer cursor,
+ during the move. There is no guarantee that the device focus will
+ return when the move is completed.
<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"/>
More information about the wayland-devel