| // Copyright 2017-2021 The Khronos Group Inc. | |
| // SPDX-License-Identifier: CC-BY-4.0 | |
| # OpenGL XML API Registry | |
| This directory contains the OpenGL, GLX, and WGL XML API registries, in | |
| gl.xml, glx.xml, and wgl.xml respectively. They are used to reserve | |
| enumerant ranges for vendors working on new extensions, to register | |
| extension interfaces when an extension is published, and to generate the | |
| Khronos-supplied header files in ../api . | |
| The canonical versions are always found in the master branch of the github | |
| repository at https://github.com/KhronosGroup/OpenGL-Registry | |
| The 'validate' Makefile target uses the 'jing' tool to confirm that each XML | |
| file is structurally valid and conforms to the registry schema in | |
| registry.rnc. The schema is described in detail in readme.pdf. | |
| The 'default' Makefile target generates updated headers in ../api/ from the | |
| XML files. | |
| Note that while there are targets for ../api/{gl.h,glx.h,wgl.h} in | |
| genglvnd.py and genheaders.py, these targets are not generated by default | |
| and are experimental. At present, you should use the versions of these | |
| headers shipped with your OS or IHV SDK. |