xref: /third_party/openGLES/xml/README.md (revision 5bd8dead)
1# OpenGL XML API Registry
2
3This directory contains the OpenGL, GLX, and WGL XML API registries, in
4gl.xml, glx.xml, and wgl.xml respectively. They are used to reserve
5enumerant ranges for vendors working on new extensions, to register
6extension interfaces when an extension is published, and to generate the
7Khronos-supplied header files in ../api .
8
9The canonical versions are always found in the master branch of the github
10repository at https://github.com/KhronosGroup/OpenGL-Registry
11
12The 'validate' Makefile target uses the 'jing' tool to confirm that each XML
13file is structurally valid and conforms to the registry schema in
14registry.rnc. The schema is described in detail in readme.pdf.
15
16The 'default' Makefile target generates updated headers in ../api/ from the
17XML files.
18
19Note that while there are targets for ../api/{gl.h,glx.h,wgl.h} in
20genglvnd.py and genheaders.py, these targets are not generated by default
21and are experimental. At present, you should use the versions of these
22headers shipped with your OS or IHV SDK.
23