[Mesa-dev] [PATCH] mesa/extensions: Document the extensions table

[Nanley Chery]

From: Nanley Chery <nanley.g.chery at intel.com>

Help developers understand the table's organization.

Suggested-by: Jason Ekstrand <jason at jlekstrand.net>
Signed-off-by: Nanley Chery <nanley.g.chery at intel.com>
---
 src/mesa/main/extensions_table.h | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/mesa/main/extensions_table.h b/src/mesa/main/extensions_table.h
index d12fd9f..66c9a78 100644
--- a/src/mesa/main/extensions_table.h
+++ b/src/mesa/main/extensions_table.h
@@ -1,8 +1,25 @@
+/*
+ * This table contains information about extensions (see column descriptions). It is used to determine if an
+ * extension can be advertised to a client application.
+ *
+ * Using any of the following tokens in an API's column enables the extension for all versions of the API.
+ * Tokens representing the API are used instead of 'Y' to enable quick determination of the column's API.
+ */
 #define GLL 0
 #define GLC 0
 #define ES1 0
 #define ES2 0
+
+/*
+ * If a specific version is required within an API, it should be specified using a 2-digit number, e.g., 31, 33, 45.
+ * See EXT_shader_integer_mix for example.
+ *
+ * Using the following token in an API's column disables the extension for all versions of the API.
+ */
 #define  x ~0
+
+/*                                                                                     API ver required:
+ *  Name string                             , Driver enable flag                     , GLL, GLC, ES1, ES2, Year */
 EXT(ARB_ES2_compatibility                   , ARB_ES2_compatibility                  , GLL, GLC,  x ,  x , 2009)
 EXT(ARB_ES3_compatibility                   , ARB_ES3_compatibility                  , GLL, GLC,  x ,  x , 2012)
 EXT(ARB_arrays_of_arrays                    , ARB_arrays_of_arrays                   , GLL, GLC,  x ,  x , 2012)
-- 
2.6.2