summaryrefslogtreecommitdiff
path: root/specs
AgeCommit message (Collapse)Author
2014-01-22spec: give footnotes ids for more stable linksAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Convert Data Types section to have a section per type, with tablesAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Finish replacing nroff .sp macros with <para> breaksAlan Coopersmith
Mostly just removes the <!-- .sp --> comments where they had already been autoconverted. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: markup data type names with <type>Alan Coopersmith
Automated replacement, followed by manual correction to <structfield> when names refer to fields in given types/structs. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Use <superscript> for exponentsAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Convert a bunch of AccessContext references from <function> to </type>Alan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Use tables for contents of Requests, Events & ErrorsAlan Coopersmith
Much more consistent layout than previous mix of blockquotes & literallayouts Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Use <personname> markup in AcknowledgementsAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: make links from encoding section to definitionsAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Convert Errors chapter to have a section per requestAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Convert Events chapter to have a section per requestAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Convert Requests chapter to have a section per requestAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Use <errorname> instead of <function> for error namesAlan Coopersmith
Also markup some uses of errornames that were previously missed. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: fix boundaries of <function> tagsAlan Coopersmith
Conversion from nroff .BR "function" "otherstuff" style markup got confused in a few places. Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: add autogenerated indexAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Convert .IN comments to indexterm tagsAlan Coopersmith
Performed with: perl -i -p -e 's{\<\!-- \.IN "([^"]+)" "" "\@DEF\@" --\>}{<indexterm significance="preferred"><primary>$1</primary></indexterm>}' specs/fsproto.xml perl -i -p -e 's{\<\!-- \.IN "([^"]+)" "([^"]+)" "\@DEF\@" --\>}{ <indexterm significance="preferred"><primary>$1</primary><secondary>$2</secondary></indexterm>}' specs/fsproto.xml Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: convert list of license models from itemizedlist to variablelistAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: add <acronym> markupAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: remove some extra quotes from nroff conversionAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: Use <figure> markup for figure labelsAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: add links to references to other sectionsAlan Coopersmith
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
2014-01-22spec: change ids for encoding sections from *_2 to Encoding::*Alan Coopersmith
Easier for cross-reference linking, matches what x11proto uses Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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>