Clean up readme.tex and regenerate PDF. Fix XML typo from #428 and
regenerate headers for a new QCOM extension.
diff --git a/api/GL/glext.h b/api/GL/glext.h
index 20b7ae2..f6499a5 100644
--- a/api/GL/glext.h
+++ b/api/GL/glext.h
@@ -32,7 +32,7 @@
#define GLAPI extern
#endif
-#define GL_GLEXT_VERSION 20200929
+#define GL_GLEXT_VERSION 20201027
#include <KHR/khrplatform.h>
diff --git a/api/GLES/gl.h b/api/GLES/gl.h
index 55daa6a..e598367 100644
--- a/api/GLES/gl.h
+++ b/api/GLES/gl.h
@@ -17,7 +17,7 @@
#include <GLES/glplatform.h>
-/* Generated on date 20200814 */
+/* Generated on date 20201027 */
/* Generated C header for:
* API: gles1
diff --git a/api/GLES/glext.h b/api/GLES/glext.h
index 9d53d9a..037af10 100644
--- a/api/GLES/glext.h
+++ b/api/GLES/glext.h
@@ -19,7 +19,7 @@
#define GL_APIENTRYP GL_APIENTRY*
#endif
-/* Generated on date 20200814 */
+/* Generated on date 20201027 */
/* Generated C header for:
* API: gles1
diff --git a/api/GLES2/gl2.h b/api/GLES2/gl2.h
index fcb8084..ef3fe7c 100644
--- a/api/GLES2/gl2.h
+++ b/api/GLES2/gl2.h
@@ -25,7 +25,7 @@
#define GL_GLES_PROTOTYPES 1
#endif
-/* Generated on date 20200929 */
+/* Generated on date 20201027 */
/* Generated C header for:
* API: gles2
diff --git a/api/GLES2/gl2ext.h b/api/GLES2/gl2ext.h
index 49c4460..7c0b043 100644
--- a/api/GLES2/gl2ext.h
+++ b/api/GLES2/gl2ext.h
@@ -19,7 +19,7 @@
#define GL_APIENTRYP GL_APIENTRY*
#endif
-/* Generated on date 20200814 */
+/* Generated on date 20201027 */
/* Generated C header for:
* API: gles2
@@ -3862,6 +3862,11 @@
#endif
#endif /* GL_QCOM_texture_foveated */
+#ifndef GL_QCOM_texture_foveated2
+#define GL_QCOM_texture_foveated2 1
+#define GL_TEXTURE_FOVEATED_CUTOFF_DENSITY_QCOM 0x96A0
+#endif /* GL_QCOM_texture_foveated2 */
+
#ifndef GL_QCOM_texture_foveated_subsampled_layout
#define GL_QCOM_texture_foveated_subsampled_layout 1
#define GL_FOVEATION_SUBSAMPLED_LAYOUT_METHOD_BIT_QCOM 0x00000004
diff --git a/api/GLES3/gl3.h b/api/GLES3/gl3.h
index 86728ff..7ad72f9 100644
--- a/api/GLES3/gl3.h
+++ b/api/GLES3/gl3.h
@@ -25,7 +25,7 @@
#define GL_GLES_PROTOTYPES 1
#endif
-/* Generated on date 20200929 */
+/* Generated on date 20201027 */
/* Generated C header for:
* API: gles2
diff --git a/xml/gl.xml b/xml/gl.xml
index 5288ba1..760bb45 100644
--- a/xml/gl.xml
+++ b/xml/gl.xml
@@ -13210,7 +13210,6 @@
</command>
<command>
<proto group="SyncStatus"><ptype>GLenum</ptype> <name>glClientWaitSyncAPPLE</name></proto>
- <param><ptype>GLsync</ptype> <name>sync</name></param>
<param class="sync" group="sync"><ptype>GLsync</ptype> <name>sync</name></param>
<param group="SyncObjectMask"><ptype>GLbitfield</ptype> <name>flags</name></param>
<param><ptype>GLuint64</ptype> <name>timeout</name></param>
diff --git a/xml/readme.pdf b/xml/readme.pdf
index 2e0b5ca..17cb822 100644
--- a/xml/readme.pdf
+++ b/xml/readme.pdf
Binary files differ
diff --git a/xml/readme.tex b/xml/readme.tex
index 2ced81f..e6e4eb3 100644
--- a/xml/readme.tex
+++ b/xml/readme.tex
@@ -2,7 +2,7 @@
% Various packages of possible use. {index} creates problems for some reason.
% \usepackage{index}
-\def\specpdftitle{The Khronos XML API Registry}
+\def\specpdftitle{The Khronos OpenGL API Registry Schema}
\usepackage[pdftex,bookmarksnumbered=true,linktocpage,plainpages=false,pdftitle={\specpdftitle},colorlinks=true]{hyperref}
\usepackage{amsmath,enumerate,epsfig,framed,mdframed,multicol,longtable,times,url}
\usepackage[normalem]{ulem}
@@ -22,14 +22,14 @@
\begin{document}
-\title{The Khronos XML API Registry}
+\title{The Khronos OpenGL API Registry Schema}
\author{Jon Leech}
-\date{Last updated 2020-01-11}
+\date{Last updated 2020-10-27}
\maketitle
\begin{abstract}
-This document describes the Khronos XML API Registry schema, and provides
+This document describes the Khronos OpenGL API Registry XML schema, and provides
some additional information about using the registry and scripts to generate
C header files. The underlying XML files and scripts, as well as headers
generated from the current authoritative copy of the XML files, can be
@@ -52,6 +52,9 @@
requests on github, although the XML schema itself is mature and unlikely to
change at this point.
+Other APIs defined by Khronos, such as Vulkan and OpenXR, use a similar XML
+schema originally based on the OpenGL schema to describe those APIs.
+
Some groups outside Khronos have their own XML based API descriptions,
often used for additional purposes such as library code generators or
extension loaders, and it may be desirable to construct XSLT or other
@@ -539,9 +542,11 @@
string expression with poorly defined syntax, usually representing
a length that is computed as a combination of other command
parameter values, and possibly current GL state as well.
-\item \attr{class} - an arbitrary string, defining type of object name (object handle).
- Handles with different types are not compatible. So handle created as
- \attr{class=buffer} can not be passed to \attr{class=shader}.
+\item \attr{class} - an arbitrary string defining the type of object handles
+ passed in this parameter. Handles with different types are not
+ compatible; for example, handles created with
+ \attr{class}{\tt="buffer"} can not be passed to a parameter with
+ \attr{class}{\tt="shader"}.
\end{itemize}
If the group name is defined, it may be interpreted as described in
@@ -818,18 +823,16 @@
canonicalization of the XML or sorting of \tag{command} and
\tag{extension} tags by name. Changes to the schema will be described in
the change log of this document (see section~\ref{changelog}). Changes
-to the \code{.xml} files will be described in Subversion revision
-history.
+to the \code{.xml} files will be described in Github revision history.
\subsection{Feature Enhancements to the Registry}
\label{general:enhancements}
-There are lots of tools and additional tags that would make the XML
-format more expressive and the tools more capable. Khronos is open to
-hosting additional processing scripts for other purposes. We're hoping
-to be much more responsive to bugs filed in the Khronos public bugzilla
-now that there's a more modern and maintainable framework to build on.
+There are lots of tools and additional tags that would make the XML format
+more expressive and the tools more capable. Khronos is open to hosting
+additional processing scripts for other purposes related to the definition
+of the API and bindings to it.
A partial wishlist follows:
@@ -951,6 +954,10 @@
\label{changelog}
\begin{itemize}
+\item 2020-10-27 - Add \attr{class} attribute to \tag{param} tags (github
+ pull request 428), update document title and make minor tweaks to
+ reflect this not being the only Khronos XML API schema in use, and
+ having migrated from Subversion to Github.
\item 2020-01-11 - Add \attr{group} attribute to \tag{enum} tags, and
deprecate \tag{group} tags (github issue 335).
\item 2017-01-20 - Update for the move to the new github repository.
