[Mesa-dev] Does Mesa have a policy for OpenGL token naming?

Ian Romanick idr at freedesktop.org
Mon Jun 25 22:07:48 UTC 2018

On 06/25/2018 12:41 PM, Nicholas Miell wrote:
> When extensions get promoted into OpenGL itself, they keep the same
> token names minus the _EXT or whatever postfix, which means grepping for
> the tokens in the OpenGL specification will find the implementation in
> the Mesa source even if it still uses the original token names from the
> extension.
> Unfortunately, the OpenGL spec also gratuitously renames tokens on
> occasion, which means e.g. the OpenGL 4.6 compatability spec discussion
> of what used to be the EXT_fog_coord extension uses a completely
> different set of token names than what's found in the Mesa source.
> OpenGL 1.5 renames several tokens, 2.0 does one, 3.0 does a few, 3.2
> does one, 4.1 does one, 4.2 has a Changed Tokens section that is empty,
> 4.3 does one, and 4.4 fixes the 4.2 Changed Tokens section to list a few
> but does none for itself. The 4.2 changes are particularly weird because
> they introduce new renamed tokens for some contexts but also retain the
> old tokens for other contexts.
> Does Mesa have a policy of which version of the tokens should be used in
> the source?

Generally new code should be written to use the "current" spelling of
the name.  For the most part, we don't go back an rename things when
they change, but I do have a patch somewhere that removes the suffixes
from all the GL_EXT_framebuffer_object tokens...

Part of the reason we don't do mass renames is that it makes cherry
picking patches back to stable releases more annoying.  The renames
won't get cherry picked back, so any patches that come after a rename
may have extra conflicts.

> _______________________________________________
> mesa-dev mailing list
> mesa-dev at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev

More information about the mesa-dev mailing list