summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2013-03-30 01:11:47 -0400
committerKristian Høgsberg <krh@bitplanet.net>2013-04-01 20:01:25 -0400
commit29ddfdd0dfc6028082a944cc17f41cfc9537aa9b (patch)
tree8224e16e3a747d3b45c5466aff455f2963f28def
parenta4d2b00ae2dc71f864604e1581f4cd599744581a (diff)
docs: Add details about grabs
Mention implicit grabs, (lack of) explicit grabs, and popup windows.
-rw-r--r--doc/Wayland/en_US/Protocol.xml8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/Wayland/en_US/Protocol.xml b/doc/Wayland/en_US/Protocol.xml
index a645409..61dc637 100644
--- a/doc/Wayland/en_US/Protocol.xml
+++ b/doc/Wayland/en_US/Protocol.xml
@@ -233,6 +233,14 @@
in surface local coordinates.
</para>
<para>
+ The compositor maintains an implicit grab when a button is
+ pressed, to ensure that the corresponding button release
+ event gets delivered to the same surface. But there is no way
+ for clients to take an explicit grab. Instead, surfaces can
+ be mapped as 'popup', which combines transient window semantics
+ with a pointer grab.
+ </para>
+ <para>
See <xref linkend="protocol-spec-interface-wl_seat"/> for the
protocol description.
</para>