From fffbd04d6344e2fa82f744935caf4be8a3b18a73 Mon Sep 17 00:00:00 2001 From: Christian Linhart Date: Mon, 8 Sep 2014 02:29:08 +0200 Subject: [PATCH] xcb-doc: add paramref 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 --- 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 @@ -298,6 +298,23 @@ Expressions the structure containing this expression. The identifier is the value of the "name" attribute on the referenced field. +identifier + + 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. + integer The value element represents a literal integer value in an expression. The -- 2.34.1