X-Git-Url: http://git.demorecorder.com/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fxml-xcb.txt;h=3c6a155194188c6e8e88f1fd70c9000673f8852d;hb=70e270182fd523a6ea2270d8cf9ad21960dd0f74;hp=5d34754425fb1aa73606655f54d806675130f0dc;hpb=505dd632bbbd9a55c2bd334d0c06abc175445327;p=free-sw%2Fxcb%2Fproto
diff --git a/doc/xml-xcb.txt b/doc/xml-xcb.txt
index 5d34754..3c6a155 100644
--- a/doc/xml-xcb.txt
+++ b/doc/xml-xcb.txt
@@ -178,6 +178,12 @@ separated by a single colon. For example, to refer to the PIXMAP type defined
in glx rather than the one defined in xproto, use type="glx:PIXMAP" rather
than type="PIXMAP".
+Note: Most of the below may optionally contain an enum, altenum, or mask
+attribute, which follows the above rules for "type". "enum" is an exhaustive
+enum; the value is restricted to one of the constants named in the enum.
+"altenum" may be one of the values contained in the enum, but it need not be.
+"mask" refers to an enum to be used as a bitmask.
+
This element declares some padding in a data structure. The bytes
@@ -219,8 +225,17 @@ than type="PIXMAP".
defining the set of values included, and a list containing these values.
value-mask-type gives the type of the bitmask; this must be CARD16 or
CARD32. value-mask-name gives the field name of the bitmask, and
- value-list-name gives the field name of the list of values.
+ value-list-name gives the field name of the list of values. Please use
+ instead for new protocol definitions.
+
+ switch expression
+ bitcase expression, fields
+ This element represents conditional inclusion of fields. It can be viewed
+ as sequence of multiple ifs: if ( switch expression & bitcase expression )
+ is equal to bitcase expression, bitcase fields are included in structure.
+ It can be used only as the last field of structure. New protocol definitions
+ should prefer to use this instead of .
Expressions
-----------
@@ -250,3 +265,22 @@ Expressions
The bit element represents a literal bitmask value in an expression.
The integer must be in the range 0..31, expanding to (1<enum item identifier
+
+ This element represents a reference to item of enum.
+
+expression
+
+ This element represents a unary operator, with the op attribute specifying
+ which operator. The only supported operation so far is ~, and its semantic
+ is identical to the corresponding operator in C.
+
+
+
+ This element represents a sumation of the elements of the referenced list.
+
+expression
+
+ This element represents the number of bits set in the expression.
+