[Mesa-dev] [PATCH] mesa: document _mesa_extension_override_* variables

[Andres Gomez]

This is:

Reviewed-by: Andres Gomez <agomez at igalia.com>

On Thu, 2017-11-16 at 14:22 +0000, Emil Velikov wrote:
> From: Emil Velikov <emil.velikov at collabora.com>
> 
> 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>
> ---
>  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;
>  
-- 
Br,

Andres