Add documentation of schema change from !343
diff --git a/xml/readme.pdf b/xml/readme.pdf index df2c7e0..2e0b5ca 100644 --- a/xml/readme.pdf +++ b/xml/readme.pdf Binary files differ
diff --git a/xml/readme.tex b/xml/readme.tex index 60e5002..36a24f5 100644 --- a/xml/readme.tex +++ b/xml/readme.tex
@@ -24,7 +24,7 @@ \title{The Khronos XML API Registry} \author{Jon Leech} -\date{Last updated 2017-01-20} +\date{Last updated 2020-01-11} \maketitle \begin{abstract} @@ -382,6 +382,12 @@ for \code{unsigned} 32- and 64-bit integer values, respectively. Separated from the \attr{value} field since this eases parsing and sorting of values, and is rarely used. +\item \attr{group} - group name, an arbitrary string for grouping a set of + enums together within a broader namespace. + \par {\bf Note:} the \tag{group} tag (see section~\ref{tag:group}) + serves the same purpose, but is deprecated in favor of this attribute. + Eventually all \tag{group} tags will be removed from the XML + registries. \item \attr{alias} - name of another enumerant this is an alias of, used where token names have been changed as a result of profile changes or for consistency purposes. An enumerant alias is simply a @@ -942,6 +948,8 @@ \label{changelog} \begin{itemize} +\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. \item 2014-06-16 - Add \tag{vendor} attribute to \tag{unused} tags. \item 2013-09-17 - Add \tag{comment} attribute to \tag{command} tags