summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stone <daniel@fooishbar.org>2011-05-03 17:21:34 +0100
committerDaniel Stone <daniel@fooishbar.org>2011-05-03 17:21:44 +0100
commitf17598c1beeadbc648588d192d2e7eb616019e2d (patch)
treea6eb6c7ce2c2bec230abdf50cb72ac18899278be
parent2d5294cb0b9dc641e0f8ef1ff5f2a1a1803a57ee (diff)
Mostly typographical
Signed-off-by: Daniel Stone <daniel@fooishbar.org>
-rw-r--r--specs/XI2proto.txt23
1 files changed, 12 insertions, 11 deletions
diff --git a/specs/XI2proto.txt b/specs/XI2proto.txt
index bc23855..6bfbf98 100644
--- a/specs/XI2proto.txt
+++ b/specs/XI2proto.txt
@@ -249,28 +249,30 @@ types <<events-deviceevent,TouchBegin>>, <<events-deviceevent,TouchUpdate>>, and
generates TouchBegin and TouchEnd events, and may also generate TouchUpdate
events. Clients must select for all three of these events simultaneously.
-When a touch starts, clients are sent a <<events-deviceevent,TouchBegin>> event
+When a touch starts, clients are sent a <<events-deviceevent,TouchBegin event>>
detailing the position used to focus the event for delivery, as well as the
initial properties of the touchpoint. Note that the logical state of the
device (as seen through the input protocol) may lag the physical state if event
-processing is affected by grabs. The event timestamp of touch events always
-represents the time the event occurred.
+processing is affected by grabs. Multiple touchpoints may be active on the
+same device at any time, potentially owned by and/or delivered to a different
+set of clients.
Whenever the touch position or any other property of the touchpoint changes,
-a <<events-deviceevent,TouchUpdate>> event is sent to the client with the
-updated information (usually new touch co-ordinates).
+a <<events-deviceevent,TouchUpdate event>> is sent to all clients listening
+to events for that touchpoint with the updated information (usually new touch
+co-ordinates).
When the touch has physically ended, or a client will otherwise not receive
-any more events for a given touchpoint, a <<events-deviceevent,TouchEnd>> event
-will be sent.
+any more events for a given touchpoint, a <<events-deviceevent,TouchEnd event>>
+will be sent to that client.
Passive touch grabs are similar to standard input event grabs in that they
take precedence over event selections and are searched from the root window
to the child window (as opposed to selections, which start their search at the
child window and continue up to the root window). When a touch grab activates,
the client whose grab activates becomes the “owner” of this touch sequence.
-See <<requests-passivegrabdevice,XIPassiveGrabDevice>> for more information on
-passive grab activation.
+See the <<requests-passivegrabdevice,XIPassiveGrabDevice request>>
+documentation for more information on passive grab activation.
Once a grabbing client becomes the owner of a touch, it must either “accept” or
"reject" the touch sequence using the
@@ -345,7 +347,6 @@ touch sequence ceases on the device, even if the current owner of the
sequence accepts the sequence.
-
**************************************************************************
[red yellow-background]*FIXME*
@@ -449,7 +450,7 @@ Pointer emulation for direct touch devices
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Touch sequences from direct touch devices may emulation pointer events. Only
-one touch sequence from a device may emulate pointer events at a time. Which
+one touch sequence from a device may emulate pointer events at a time; which
touch sequence emulates pointer events is implementation dependent.
**************************************************************************