Francisco Casas : vkd3d-shader/hlsl: Add field-level documentation to struct hlsl_struct_field.

[Alexandre Julliard]

Module: vkd3d
Branch: master
Commit: 0a2732428c0df1419f88e747d6180cdeb118575c
URL:    https://gitlab.winehq.org/wine/vkd3d/-/commit/0a2732428c0df1419f88e747d6180c...

Author: Francisco Casas <fcasas(a)codeweavers.com>
Date:   Mon Nov 14 14:25:24 2022 -0300

vkd3d-shader/hlsl: Add field-level documentation to struct hlsl_struct_field.

---

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

diff --git a/libs/vkd3d-shader/hlsl.h b/libs/vkd3d-shader/hlsl.h
index d672de0b..d0a345aa 100644
--- a/libs/vkd3d-shader/hlsl.h
+++ b/libs/vkd3d-shader/hlsl.h
@@ -191,15 +191,22 @@ struct hlsl_semantic
     uint32_t index;
 };
 
+/* A field within a struct type declaration, used in hlsl_type.e.fields. */
 struct hlsl_struct_field
 {
     struct vkd3d_shader_location loc;
     struct hlsl_type *type;
     const char *name;
     struct hlsl_semantic semantic;
+
+    /* Bitfield for storing modifiers that are not in HLSL_TYPE_MODIFIERS_MASK (these are stored in
+     *   type->modifiers instead) and that also are specific to the field and not the whole variable.
+     *   In particular, interpolation modifiers. */
     unsigned int storage_modifiers;
+    /* Offset of the field within the type it belongs to, in numeric register components. */
     unsigned int reg_offset;
 
+    /* Offset where the fields's name starts in the output bytecode, in bytes. */
     size_t name_bytecode_offset;
 };