summaryrefslogtreecommitdiff
path: root/protocol
diff options
context:
space:
mode:
authorJonas Ådahl <jadahl@gmail.com>2015-03-18 20:29:10 +0800
committerJonas Ådahl <jadahl@gmail.com>2015-06-26 17:23:12 +0800
commitb317beb5e69b1cbea5b0bf550df46b6eb7b64afa (patch)
tree40afe4312ff2875a42a9a4e9af8a04dbc0438710 /protocol
parentaa9536a992c5a676c4b223c29866c9da7a63b53c (diff)
downloadweston-b317beb5e69b1cbea5b0bf550df46b6eb7b64afa.tar.gz
xdg-shell: Further clarify xdg_surface.move semantics
Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Acked-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
Diffstat (limited to 'protocol')
-rw-r--r--protocol/xdg-shell.xml13
1 files changed, 11 insertions, 2 deletions
diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
index 6479301c..4eeac92d 100644
--- a/protocol/xdg-shell.xml
+++ b/protocol/xdg-shell.xml
@@ -246,10 +246,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 the type of interactive move (touch,
+ pointer, etc).
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 lose the focus of the device
+ (wl_pointer, wl_touch, etc) used for the move. It is up to the
+ compositor to visually indicate that the move is taking place, such as
+ updating a pointer cursor, during the move. There is no guarantee
+ that the device focus will return when the move is completed.
</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"/>