summaryrefslogtreecommitdiff
path: root/specs
AgeCommit message (Collapse)Author
2014-01-22spec: fixup markup/formatting of the naming syntax sectionAlan Coopersmith
Use <replaceable> <literal> <optional> etc. tags instead of &lt;&gt; "" and [] pairs. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: markup introduction of new terms with <firstterm>Alan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: convert from article with sections to book with chaptersAlan Coopersmith
Matches most other X.Org specs, and restores our chapter numbering in output Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: fixup bibliography entries (correct authors, link to references)Alan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: add olinks to X11 protocol & XLFD specsAlan Coopersmith
Also use <citetitle> to markup titles of other specs/docs. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Replace ASCII => & -> arrows with Unicode ▶ & ◀Alan Coopersmith
Matches formatting used in core X11 & current extension specs This spec previously used => for server to client replies, like the other specs, but also had -> for client responses to server data, so the opposing direction arrows should make this distinction clearer. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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>
2013-09-05Fix length of padding in server replyAlan Coopersmith
Length of "20" with unspecified contents was accidentally split into a length of "2" and contents of "0" in the docbook conversion. Verified against old spec in http://www.x.org/docs/Xext/bigreq.pdf Reported-by: shoop_da_whoop on #xorg-devel IRC Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> Reviewed-by: Jasper St. Pierre <jstpierre@mecheye.net>
2013-08-01specs: Change XkbSA_DfltBtnAbsolute to 4Daniel Martin
Adopt the value from XKB.h: #define XkbSA_DfltBtnAbsolute (1L << 2) Found-by: Ran Benita <ran234@gmail.com> Signed-off-by: Daniel Martin <consume.noise@gmail.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.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-21x11proto: add permille, ezh, and EZH to keysymdef.hMarko Myllynen
This patch adds the following mnemonic symbols: XK_permille for U+2030 PER MILLE SIGN XK_EZH for U+01B7 LATIN CAPITAL LETTER EZH XK_ezh for U+0292 LATIN SMALL LETTER EZH These are the last mnemonic symbols missing from the Finnish keyboard layout. The characters are part of the Finnish standard, ezh is used in Sami and permille sign is used commonly in Finland, probably in other countries as well. https://bugs.freedesktop.org/show_bug.cgi?id=19687 Signed-off-by: Marko Myllynen <myllynen@redhat.com> Reviewed-by: Matt Dew <marcoz@osource.org> Signed-off-by: James Cloos <cloos@jhcloos.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>
2012-01-26specs: Edit titles for section 3 and 4Gaetan Nadon
In the htlm version, the section number appeared to be 3.2.1 and 4.2.2 because of the generated section number. A section title should not begin with a number. 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-16informaltable cleanupMatt Dew
On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, IE, 1* -> 1.0* cleans up these build errors: WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
2012-01-16informaltable cleanupMatt Dew
On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, IE, 1* -> 1.0* cleans up these build errors: WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
2012-01-15informaltable cleanupMatt Dew
On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, IE, 1* -> 1.0* cleans up these build errors: WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
2012-01-14informaltable cleanupMatt Dew
On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
2012-01-14informaltable cleanupMatt Dew
On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, IE, 1* -> 1.0* cleans up these build errors: WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
2012-01-13informaltable cleanupMatt Dew
On certain tables, add top and bottom borders to table header and a bottom border to the table. This matches what those tables in the old pdfs looked like. the <?dbfo keep-together='always'> prevents tables from splitting across pages. Useful for tiny tables. Converting the colwidth to a floating point, IE, 1* -> 1.0* cleans up these build errors: WARNING: table-layout="fixed" and column-width unspecified => falling back to proportional-column-width(1) Signed-off-by: Matt Dew <marcoz@osource.org>
2012-01-03Set a flag on the pointer-emulating touch eventPeter Hutterer
Toolkits need to know which touch event emulated a pointer event and which ones do not. To quote Carlos Garnacho: GTK+ does client-side windows by default (GdkWindows without a backing X window), for this to work the toplevel window in the client needs to select for more events that it wouldn't normally select for in order to cater for the event masks in such child "windows". This means that ideally GTK+ should set the touch events mask in the toplevel, and then find out whether the "window" would receive pointer or touch events for the sequence emulating the pointer, and perform the emulation itself. Reported-by: Carlos Garnacho <carlosg@gnome.org> Reviewed-by: Chase Douglas <chase.douglas@canonical.com> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2012-01-03specs: purge leftover TouchAccepted notePeter Hutterer
This flag does not exist anymore. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Chase Douglas <chase.douglas@canonical.com>