From e964e01fddde2b0d5caed5d9808f43dd99590f26 Mon Sep 17 00:00:00 2001 From: Emil Velikov Date: Thu, 16 Nov 2017 14:22:18 +0000 Subject: [PATCH] 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 Signed-off-by: Emil Velikov Reviewed-by: Andres Gomez --- 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 59761bfcdb4..159610b6e12 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;