[Xcb] [PATCH libxcb 8/9] function _c_helper_fieldaccess_expr: improve description

[Christian Linhart]

Signed-off-by: Christian Linhart <chris at demorecorder.com>
---
 src/c_client.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/src/c_client.py b/src/c_client.py
index aaaac0a..4fedf45 100644
--- a/src/c_client.py
+++ b/src/c_client.py
@@ -558,16 +558,25 @@ def _c_field_is_member_of_case_or_bitcase(field):
         return False
 
 # end of Functions for querying field properties
 
 def _c_helper_fieldaccess_expr(prefix, field=None):
     """
     turn prefix, which is a list of tuples (name, separator, Type obj) into a string
-    representing a valid name in C (based on the context)
-    if field is not None, append the field name as well
+    representing a valid field-access-expression in C (based on the context)
+    if field is not None, append access to the field as well.
+
+    "separator" is one of the C-operators "." or "->".
+
+    A field access expression can consist of the following components:
+    * struct/union member access from a value with the "."-operator
+    * struct/union member access from a pointer with "->"-operator
+    * function-call of an accessor function:
+      This is used when a xcb-field is not contained in a struct.
+      This can, e.g., happen for fields after var-sized fields, etc.
     """
     prefix_str = ''
     last_sep =''
     for name, sep, obj in prefix:
         prefix_str += last_sep + name
         if '' == sep:
             sep = '->'
-- 
2.0.1