Mesa (master): mesa: document _mesa_extension_override_* variables

[Emil Velikov]

Module: Mesa
Branch: master
Commit: e964e01fddde2b0d5caed5d9808f43dd99590f26
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=e964e01fddde2b0d5caed5d9808f43dd99590f26

Author: Emil Velikov <emil.velikov at collabora.com>
Date:   Thu Nov 16 14:22:18 2017 +0000

mesa: document _mesa_extension_override_* variables

Currently there are no users of these outside of extensions.c.
Provide some information why they exist and how to use them.

Cc: Jordan Justen <jordan.l.justen at intel.com>
Signed-off-by: Emil Velikov <emil.velikov at collabora.com>
Reviewed-by: Andres Gomez <agomez at igalia.com>

---

 src/mesa/main/extensions.h | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/mesa/main/extensions.h b/src/mesa/main/extensions.h
index 59761bfcdb..159610b6e1 100644
--- a/src/mesa/main/extensions.h
+++ b/src/mesa/main/extensions.h
@@ -106,6 +106,15 @@ _mesa_has_##name_str(const struct gl_context *ctx) \
 #include "extensions_table.h"
 #undef EXT
 
+/* Sometimes the driver wants to query the extension override status before
+ * a context is created. These variables are filled with extension override
+ * information before context creation.
+ *
+ * This can be useful during extension bring-up when an extension is
+ * partially implemented, but cannot yet be advertised as supported.
+ *
+ * Use it with care and keep access read-only.
+ */
 extern struct gl_extensions _mesa_extension_override_enables;
 extern struct gl_extensions _mesa_extension_override_disables;