summaryrefslogtreecommitdiff
path: root/doc/xml-xcb.txt
AgeCommit message (Collapse)AuthorFilesLines
2021-09-02Add element to specify expression that defines length of a structPovilas Kanapickas1-2/+19
Currently the layout of a struct is used to compute its size. This works fine in case of structs of fixed size. However this introduces forwards-compatibility problems in cases when the struct has multiple variants and the exact variant is specified by the value of some field (e.g. in the case of <switch> elements). Future revisions of protocols may introduce new layout variants, in which case the old code does not know the size of the struct variant and can't parse the incoming byte stream. Instead of relying on knowledge about the layout of data structures we should instead use the length field for length information. This way when old client libxcb communicates with newer server it can at least ignore unknown struct variants.
2017-03-11add support for eventstructChristian Linhart1-0/+29
eventstruct is a new xml element that allows to use events as part of requests. This is, e.g., needed by the SendExtensionEvent request of the XINPUT extension. Signed-off-by: Christian Linhart <chris@demorecorder.com>
2016-01-27optionally enforce serialization of padsChristian Linhart1-1/+8
From now on, due to a patch in libxcb, pads will not be serialized anymore. This is to maintain ABI-compatibility when adding explicit align pads. However, some align pads were already be serialized in prior official versions of libxcb. Therefore we need a method to enforce serialization, so we can maintainn ABI compatibility with that legacy. Signed-off-by: Christian Linhart <chris@demorecorder.com>
2015-05-30xml-xcb.txt: remove description of the "localfield" elementRan Benita1-7/+0
It was removed in: http://cgit.freedesktop.org/xcb/proto/commit/?id=854d08c8242e8fbe7b5a000b75ec6845419806c4 Signed-off-by: Ran Benita <ran234@gmail.com> Reviewed-by: Peter Harris <pharris@opentext.com> Reviewed-by: Christian Linhart <chris@demorecorder.com>
2015-05-30xml-xcb.txt: mention that case/bitcase can have a nameRan Benita1-2/+2
Signed-off-by: Ran Benita <ran234@gmail.com> Reviewed-by: Christian Linhart <chris@demorecorder.com>
2014-11-03xcb-doc: add paramrefChristian Linhart1-0/+17
The first paragraph of the description is loosely based on a description proposed by Ran Benita. Message-ID: <1410136150-30254-3-git-send-email-chris@demorecorder.com> Patch-Thread-Subject: [Xcb] parametrized structs implemented Patch-Set: ParametrizedStruct Patch-Number: proto 3/5 Patch-Version: V1 Signed-off-by: Christian Linhart <chris@DemoRecorder.com>
2014-11-03doc: new expr element listelement-refChristian Linhart1-0/+5
Message-ID: <1409845742-38797-3-git-send-email-chris@demorecorder.com> Patch-Thread-Subject: [Xcb] support popcount of a list and associated xml changes Patch-Set: PopcountList Patch-Number: proto 3/8 Patch-Version: V1 Signed-off-by: Christian Linhart <chris@DemoRecorder.com>
2014-11-03xml-doc: add sumof with nested expressionChristian Linhart1-0/+11
Signed-off-by: Christian Linhart <chris@demorecorder.com> Reviewed-by: Ran Benita <ran234@gmail.com> Message-ID: <545627D5.4010008@DemoRecorder.com> Patch-Thread-Subject: [Xcb] [PATCHSET] ListInputDevices revision 2 Patch-Set: ListInputDevices Patch-Number: proto 2/8 Patch-Version: V1
2014-08-25xml-xcb spec: describe switch-caseChristian Linhart1-8/+30
V2: patch revised according to suggestion from Peter Harris: * add the restriction that <enumref> inside <bitcase> can only refer to an enum's <bit> members, and <enumref> inside <case> can only refer to an enum's <value> members. Reviewed-by: Peter Harris <pharris@opentext.com> Reviewed-by: Ran Benita <ran234@gmail.com>
2014-08-25Add "altmask" attribute, like "altenum" for masksRan Benita1-2/+3
"altmask" means the field is principally a bitmask of bits from the enum, but in some cases can obtain other values (e.g. "out-of-band" data in a free bit). Several fields in xinput will benefit from this extra metadata. Suggested-by: Peter Harris <pharris@opentext.com> Signed-off-by: Ran Benita <ran234@gmail.com> Signed-off-by: Peter Harris <pharris@opentext.com>
2014-07-20Add <fd> to xml-xcb.txtRan Benita1-0/+8
Signed-off-by: Ran Benita <ran234@gmail.com> Reviewed-by: Daniel Martin <consume.noise@gmail.com>
2013-07-12Add support for X Generic Extension eventsDaniel Martin1-1/+7
With these patches, we are able to mark an XGE event as such and generate the correct header for it. XGE events can be found in the X Input Extension v2++. Signed-off-by: Daniel Martin <consume.noise@gmail.com> Reviewed-by: Keith Packard <keithp@keithp.com> Signed-off-by: Peter Harris <pharris@opentext.com>
2013-04-16Allow multiple <enumref> in a <bitcase>Peter Harris1-4/+9
Signed-off-by: Peter Harris <pharris@opentext.com>
2012-03-26xproto: add doc tags, xcbgen: handle doc tagsMichael Stapelberg1-0/+35
Signed-off-by: Julien Danjou <julien@danjou.info>
2010-02-08Add description of new protocol elementsPeter Harris1-1/+29
These new elements will be used to support XKEYBOARD (and potentially other troublesome extensions in the future). Thanks to Mariusz Ceier <mceier@gmail.com> for starting this work, and to Google's Summer of Code for sponsoring the initial work. Signed-off-by: Peter Harris <pharris@opentext.com>
2009-02-19Document enum, altenum, and maskPeter Harris1-0/+6
Signed-off-by: Peter Harris <pharris@opentext.com>
2009-02-05Remove obsolete references to XSLTPeter Harris1-36/+8
Signed-off-by: Peter Harris <pharris@opentext.com>
2006-06-15Remove arbitrary division between xcb_types and xproto by mergingJosh Triplett1-10/+10
xcb_types.xml into xproto.xml.
2006-03-20Update xml-xcb.txt to include new <bit> expression.Ian Osgood1-3/+8
2006-03-05Change event copy to error copy.Jeremy Kolb1-1/+1
2006-02-18Remove xcl and CVSROOT.Josh Triplett1-0/+275