nir: Improve the comment on num_inputs and friends
authorJason Ekstrand <jason@jlekstrand.net>
Mon, 31 Aug 2020 18:06:04 +0000 (13:06 -0500)
committerMarge Bot <eric+marge@anholt.net>
Tue, 1 Sep 2020 17:30:51 +0000 (17:30 +0000)
This doesn't fix the problem that no one knows what any of these mean
half the time but it at least makes them better documented to hopefully
make people's expectations more accurate.

Reviewed-by: Boris Brezillon <boris.brezillon@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/6524>

src/compiler/nir/nir.h

index 6195a66..e6edb72 100644 (file)
@@ -3322,8 +3322,9 @@ typedef struct nir_shader {
    struct exec_list functions; /** < list of nir_function */
 
    /**
-    * the highest index a load_input_*, load_uniform_*, etc. intrinsic can
-    * access plus one
+    * The size of the variable space for load_input_*, load_uniform_*, etc.
+    * intrinsics.  This is in back-end specific units which is likely one of
+    * bytes, dwords, or vec4s depending on context and back-end.
     */
    unsigned num_inputs, num_uniforms, num_outputs;