From 85923d15a395579642d01bf87d4923fbe871c303 Mon Sep 17 00:00:00 2001
From: Robert Shearman <robertshearman@gmail.com>
Date: Mon, 2 Jun 2008 09:02:16 +0100
Subject: [PATCH] widl: Document the use of statement types and the statement
 union.

---
 tools/widl/widltypes.h | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/tools/widl/widltypes.h b/tools/widl/widltypes.h
index 20a9d7180e6..116d3717b8c 100644
--- a/tools/widl/widltypes.h
+++ b/tools/widl/widltypes.h
@@ -208,15 +208,15 @@ enum storage_class
 
 enum statement_type
 {
-    STMT_LIBRARY,
-    STMT_DECLARATION,
-    STMT_TYPE,
-    STMT_TYPEREF,
-    STMT_MODULE,
-    STMT_TYPEDEF,
-    STMT_IMPORT,
-    STMT_IMPORTLIB,
-    STMT_CPPQUOTE
+    STMT_LIBRARY,     /* library definition */
+    STMT_DECLARATION, /* declaration of a variable, possibly initialised */
+    STMT_TYPE,        /* type definition without using typedef */
+    STMT_TYPEREF,     /* type reference without declaring a variable */
+    STMT_MODULE,      /* module definition */
+    STMT_TYPEDEF,     /* type definition */
+    STMT_IMPORT,      /* import an IDL file */
+    STMT_IMPORTLIB,   /* import a type library */
+    STMT_CPPQUOTE     /* add a line to the generated C header file */
 };
 
 struct _loc_info_t
@@ -410,11 +410,18 @@ struct _statement_t {
     enum statement_type type;
     union
     {
-        ifref_t iface;
+    /* case STMT_TYPEREF: */
+    /* case STMT_TYPE: */
         type_t *type;
+    /* case STMT_IMPORT: */
+    /* case STMT_IMPORTLIB: */
+    /* case STMT_CPPQUOTE: */
         const char *str;
+    /* case STMT_DECLARATION: */
         var_t *var;
+    /* case STMT_LIBRARY: */
         typelib_t *lib;
+    /* case STMT_TYPEDEF: */
         type_list_t *type_list;
     } u;
 };
-- 
2.11.4.GIT