[PATCH 5/6] vkd3d-shader/hlsl: Add field-level documentation to function structs.

[Francisco Casas]

From: Francisco Casas

---
 libs/vkd3d-shader/hlsl.h | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/libs/vkd3d-shader/hlsl.h b/libs/vkd3d-shader/hlsl.h
index e14e121c..73fbb4af 100644
--- a/libs/vkd3d-shader/hlsl.h
+++ b/libs/vkd3d-shader/hlsl.h
@@ -383,22 +383,37 @@ struct hlsl_ir_var

struct hlsl_ir_function
 {
+    /* Item entry in hlsl_ctx.functions */
     struct rb_entry entry;
+
     const char *name;
+    /* Container for hlsl_ir_function-decl.entry, containing all the function definitions. Which
+     *   may be more than one (overloading). */
     struct rb_tree overloads;
+
     bool intrinsic;
 };

struct hlsl_ir_function_decl
 {
     struct hlsl_type *return_type;
+    /* Synthetic variable used to store the return value of the function. */
     struct hlsl_ir_var *return_var;
+
     struct vkd3d_shader_location loc;
+    /* Item entry in hlsl_ir_function.overloads. The paremeters' types are used as key. */
     struct rb_entry entry;
+
+    /* Function to which this declaration corresponds. */
     struct hlsl_ir_function *func;
+    /* List containing one variable for each parameter of the function; linked by the
+     *   hlsl_ir_var.param_entry fields. */
     struct list *parameters;
+
     struct hlsl_block body;
     bool has_body;
+    /* Array of attributes (like earlydepthstencil) specified just before the function declaration.
+     * Not to be confused with the function parameters! */
     unsigned int attr_count;
     const struct hlsl_attribute *const *attrs;
 };