summaryrefslogtreecommitdiff
path: root/specs/XI2proto.txt
AgeCommit message (Collapse)Author
2021-09-15specs: Specify XI 2.4 as releasedPovilas Kanapickas
Signed-off-by: Povilas Kanapickas <povilas@radix.lt>
2021-05-17specs: Fix type of GESTURECLASS num_touches memberPovilas Kanapickas
This was a copy-paste error from TOUCHCLASS. The protocol structs use uint8_t for num_touches. Signed-off-by: Povilas Kanapickas <povilas@radix.lt>
2021-05-17specs: Fix type of TOUCHCLASS num_touches memberPovilas Kanapickas
The actual protocol structs use uint8_t. Signed-off-by: Povilas Kanapickas <povilas@radix.lt>
2021-05-15specs: Specify XI 2.4 as unreleasedPovilas Kanapickas
TODO, while useful for grepping, does not actually mean anything, so completely useless. Signed-off-by: Povilas Kanapickas <povilas@radix.lt>
2021-05-11specs: Add support for gesture events as XI 2.4Povilas Kanapickas
Signed-off-by: Povilas Kanapickas <povilas@radix.lt>
2020-08-18specs: Make links between XI2 enum and event names explicitPovilas Kanapickas
2020-08-18specs: Improve description of detail field in XIPassiveGrabDevicePovilas Kanapickas
2020-08-18specs: Improve description of detail field in DeviceEventPovilas Kanapickas
2020-08-18specs: Fix example of touch event processingPovilas Kanapickas
2020-08-18specs: Use non-hyphenated spelling of nonzeroPovilas Kanapickas
2020-08-18specs: Improve consistency of grammar in a listPovilas Kanapickas
2020-08-18specs: Only key code can be grabbed, not key symbolPovilas Kanapickas
2020-08-18specs: Fix incorrect wording for ignored parameterPovilas Kanapickas
2020-08-18specs: Fix grammar (duplicate word)Povilas Kanapickas
2020-08-08Fix spelling/wording issuesAlan Coopersmith
Found by using: codespell --builtin clear,rare,usage,informal,code,names Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2019-02-17Update URLs for protocol specs to use xorgproto repo nowAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-10-28specs: rename EVENTMASK to EVTYPEMASKPeter Hutterer
EVENTMASK was used twice in the spec, once as the actual bitmask for events, once as the set of deviceid, mask length and mask. The libXi public API uses XIEventMask for the latter data triplet, so leave EVENTMASK, and rename the pure bitmask to EVTYPEMASK. Reported-by: Gabriel Laskar <gabriel@lse.epita.fr> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2014-08-25specs: note the (unused) time field in XIPassiveGrabDevicePeter Hutterer
We don't actually use it either in libXi or in the server, it's a copy/paste error that never got noticed and removed. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2014-01-06specs: note that axis values are non-sparse arraysPeter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2014-01-06specs: clarify SD keyboard focus behaviourPeter Hutterer
The smart thing would be to have the SD's keyboard focus to be identical to the MD's keyboard focus (and a BadDevice returned when trying to set an attached SD's keyboard focus) but alas, the server never implemented this behaviour and we've now shipped 7 versions with separate SD and MD focus. So consider this set in stone. oops. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Jasper St. Pierre <jstpierre@mecheye.net>
2012-12-17specs: removing a device results in a BarrierLeave eventPeter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-12-09Add support for pointer barrier eventsJasper St. Pierre
Signed-off-by: Jasper St. Pierre <jstpierre@mecheye.net> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-11-07specs: XI2: Fix mods in XIPassive(Un)GrabDeviceDaniel Martin
XIPassiveGrabDevice and XIPassiveUngrabDevice are using lists of modifier masks. This one corrects these types. MODIFIERMASK was introduced, because a SETofMODIFIERMASK differs from a SETofKEYMASK: AnyModifier=(1<<15) vs. GrabAnyModifier=(1U<<31). Signed-off-by: Daniel Martin <consume.noise@gmail.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-11-07specs: XI2: Rename AxisClass to ValuatorClassDaniel Martin
ValuatorClass is the XI2 term for AxisClass. Signed-off-by: Daniel Martin <consume.noise@gmail.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-11-07specs: XI2: Fix typosDaniel Martin
Signed-off-by: Daniel Martin <consume.noise@gmail.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-11-02XI2proto: spec formatting fixPeter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-10-29specs: XI2: add titles to requests/events and show them in TOCRan Benita
You often want to quickly jump to the specification of a specific request/event, so add them to the table of contents to allow for that. This also provides the reader with a quick glance at what the protocol looks like. Signed-off-by: Ran Benita <ran234@gmail.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-10-29specs: XI2: make event/request name formatting consistentRan Benita
None of the other have ':' there. Signed-off-by: Ran Benita <ran234@gmail.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-06-14Fix two typos in spec/commentsPeter Hutterer
The ButtonClass provides the number of buttons, not the lentgh of the mask. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-03-02specs: XI 2.2 release date is March 2012Peter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: Remove work in progress warningPeter Hutterer
We're close enough to a release now. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: remove "since" from TouchOwnershipEventPeter Hutterer
It's already in a section "Events introduced in version 2.2" Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: remove TouchOwnership mention from DeviceEventPeter Hutterer
TouchOwnership is described separately below. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: whitespace fix to avoid wrong asciidoc formattingPeter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: fix link to touch ownership sectionPeter Hutterer
Introduced in 535a4377ddb4c2680d54b4cbbb273134bb5f58a3 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: GrabtypeTouchBegin was added in XI 2.2Peter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: formatting fix, move AcceptTouch and RejectTouch onto their own linePeter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: replace † with ²Peter Hutterer
† looks too much like a letter and we can't use * and ** because asciidoc interprets it as lists. Use numbers instead, and replace all current * with ¹. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: XITouchClass doesn't have propertiesPeter Hutterer
Leftover from an earlier version. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: Formatting fixPeter Hutterer
asciidoc requires caption to be on one line but this one here is too long. Split it up instead. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: some wording fixesPeter Hutterer
Button press events are insufficient even on scroll wheels, so don't say they are good enough. Remove duplicate claim of event emulation Don't claim we send touch events "without delay" Touch screens hardly ever "physically move" an object. Hyphenate "implementation-dependent" Remove unnecessary "however" Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-03-02specs: fix typos 'hierachy' → 'hierarchy'Peter Hutterer
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-02-02specs: explain touch behaviour for dependent devicesPeter Hutterer
Dependent devices don't send touch events until the interaction is a true touch interaction (i.e. doesn't just serve to move the pointer). Once that happens, all touchpoints send touch events exclusively. Pointer movement restarts once we're down to one touch that controls the pointer again. For clients listening to touch events in addition to pointer events, this also means that a two-finger tap looks identical to holding one finger down and tapping with a second-finger. Both actions will result in short TouchBegin/TouchEnd sequences for both fingers. The above is the default behaviour we expect from touchpads, the protocol is more generically worded to leave more room for drivers to decide when a touch only controls the pointer and when it doesn't. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-31specs: move touch support details to "Touch device support" sectionPeter Hutterer
Keep the changelog small. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-31specs: remove superfluous "Changes introduced by ..."Peter Hutterer
The line right above says the same thing. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-31specs: move touch mode explanations to where it belongsPeter Hutterer
Rather than have two different explanations to the touch modes, remove it from the "Changes in version 2.2" section and merge the content into the text. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-26specs: replace hard coded number in some "See section" referencesGaetan Nadon
The glossary does not accept <<links>> however. Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-26specs: fix Appendix A titleGaetan Nadon
This section starts a new numbered sequence. Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-26specs: remove older manually typed in section numberGaetan Nadon
These would come out in html as 5.2, 6.3 and 6.4.3.4 Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>
2012-01-26specs: use subsections to group use cases descriptionGaetan Nadon
It makes an entry in the appendix for quick navigation. It looks more readable with subtitles. Signed-off-by: Gaetan Nadon <memsize@videotron.ca> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>