summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2009-08-05 16:00:44 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2009-08-05 16:01:13 +1000
commit42a718457d183aab42778fbb127fafbae6b3e6d8 (patch)
tree36a951d205981062fa42be3c8413e744c68180c0
parent1a5f4fd2fa3ac7cfa1671d5cf0975ff365294f29 (diff)
man: point out temporary detachment of slave devices.
Affects XIGrabDevice, XIGrabButton/Key and XIGrabEnter/GrabFocusIN Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
-rw-r--r--man/XIGrabButton.txt7
-rw-r--r--man/XIGrabDevice.txt9
-rw-r--r--man/XIGrabEnter.txt7
3 files changed, 21 insertions, 2 deletions
diff --git a/man/XIGrabButton.txt b/man/XIGrabButton.txt
index d9e3297..70a3505 100644
--- a/man/XIGrabButton.txt
+++ b/man/XIGrabButton.txt
@@ -125,6 +125,13 @@ DESCRIPTION
released (independent of the logical state of the modifier
keys).
+ If the device is an attached slave device, the device is
+ automatically detached from the master device when the grab
+ activates and reattached to the same master device when the
+ grab deactivates. If the master device is removed while the
+ device is floating as a result of a grab, the device remains
+ floating once the grab deactivates.
+
Note that the logical state of a device (as seen by client
applications) may lag the physical state if device event
processing is frozen.
diff --git a/man/XIGrabDevice.txt b/man/XIGrabDevice.txt
index 6194ed9..bd749b7 100644
--- a/man/XIGrabDevice.txt
+++ b/man/XIGrabDevice.txt
@@ -58,8 +58,13 @@ DESCRIPTION
XIGrabDevice actively grabs control of the device. Further
device events are reported only to the grabbing client.
XIGrabDevice overrides any active device grab by this client.
- if deviceid is an attached slave device, the device is set
- floating until the client calls XIUngrabDevice.
+
+ If the device is an attached slave device, the device is
+ automatically detached from the master device and reattached to
+ the same master device when client ungrabs the device. If the
+ master device is removed while the device is floating as a
+ result of a grab, the device remains floating once the grab
+ deactivates.
If owner_events is False, all generated device events are
reported with respect to grab_window if selected. If
diff --git a/man/XIGrabEnter.txt b/man/XIGrabEnter.txt
index 513afcc..005a72b 100644
--- a/man/XIGrabEnter.txt
+++ b/man/XIGrabEnter.txt
@@ -108,6 +108,13 @@ DESCRIPTION
different window (independent of the logical state of the
modifier keys).
+ If the device is an attached slave device, the device is
+ automatically detached from the master device when the grab
+ activates and reattached to the same master device when the
+ grab deactivates. If the master device is removed while the
+ device is floating as a result of a grab, the device remains
+ floating once the grab deactivates.
+
Note that the logical state of a device (as seen by client
applications) may lag the physical state if device event
processing is frozen.