Man pages source available in Khronos Subversion

Khronos has released the OpenGL man page XML sources. This was done mostly at the request of people wishing to adapt the man pages to other output formats or language bindings.

You will need to have a reasonable understanding of Subversion, Docbook, XML, XSLT, Linux package management (if using Linux), and other components of the toolchain used to generate the man pages, before you're likely to have much success with them. A great deal of Docbook, XML, and XSL infrastructure may need to be installed on your system
first.

The directory tree containing the current (OpenGL 4.x) API man pages is available for anonymous, read-only checkout in Khronos' Subversion server, at

Please read both the Wiki pages above completely and try doing what they suggest before asking for help. If you're only having setup problems (as opposed to finding actual bugs in the man pages), you should probably post in this thread where other people may be having the same problems.

Re: Man pages source available in Khronos Subversion

Re: Man pages source available in Khronos Subversion

This is pretty interesting. However, there is something odd in the files.

"<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
"http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">" is prefaced at the beginning of all of your files. That's all well and good, but the DOCTYPE's first parameter is the root element of this particular document. And virtually none of them start with the element "book". While the document is still well-formed by the rules of XML, it means that the document is considered invalid by a strict XML DTD validator.

Re: Man pages source available in Khronos Subversion

My hunch is that it would be as easy or easier to just generate new content in documentation format as it would be to reformat existing specifications. Plus there may be some benefit in rewording some of the spec language, to make it more easily digestible by those new to OpenGL.

Updated SGI FreeB license

SGI has updated their FreeB license, which applies to many of the man pages Khronos distributes. Version 2.0 of FreeB is just an X11/MIT-style license.

This doesn't have any substantive effect on the man pages - and they don't even need to be changed to take advantage of it, since they incorporate the FreeB license by reference - but it does make it more convenient for people with a strong FSF/Debian-style Free Software stance to modify and/or distribute those man pages.