[Xcb] [PATCH proto 3/5] xcb-doc: add paramref

Christian Linhart chris at demorecorder.com
Sun Sep 7 17:29:08 PDT 2014

The first paragraph of the description is loosely based on
a description proposed by Ran Benita.
 doc/xml-xcb.txt | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/xml-xcb.txt b/doc/xml-xcb.txt
index 01f7678..f8129ea 100644
--- a/doc/xml-xcb.txt
+++ b/doc/xml-xcb.txt
@@ -294,14 +294,31 @@ Expressions
   The fieldref element represents a reference to the value of another field in
   the structure containing this expression.  The identifier is the value of
   the "name" attribute on the referenced field.
+<paramref type="type">identifier</paramref>
+  A paramref is similar to a fieldref, but it refers to the value of
+  a field in the context which refers to the struct which contains the paramref.
+  So, it refers to a field outside of the structure where it is defined.
+  This has the following consequences:
+  * The generator cannot deduce its type.
+    So, it is mandatory to specify its type.
+  * The identifier-name must not be used as a field in the structure
+    which contaons the paramref.
+  For an example, see struct "DeviceTimeCoord" and request/reply
+  "GetDeviceMotionEvents" in xinput.xml, where paramref "num_axes"
+  in struct DeviceTimeCoord refers to field "num_axes" in
+  the DeviceTimeCoord reply.
   The value element represents a literal integer value in an expression.  The
   integer may be expressed in decimal or hexadecimal.

More information about the Xcb mailing list