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
[https://cvs.khronos.org/svn/repos/ogl/trunk/ecosystem/public/sdk/docs/man4/](https://cvs.khronos.org/svn/repos/ogl/trunk/ecosystem/public/sdk/docs/man4/)
If you have the Subversion command-line client installed, you should be able to check out the man pages into the directory ‘man4’ by executing the command
svn co --username anonymous --password anonymous [https://cvs.khronos.org/svn/repos/ogl/trunk/ecosystem/public/sdk/docs/man4/](https://cvs.khronos.org/svn/repos/ogl/trunk/ecosystem/public/sdk/docs/man4/) man4
Under ‘man4’ you’ll find the OpenGL 4.2 man pages, both the Docbook XML source in this directory and generated XHTML+MathML in xhtml/ , and some supporting build and XSL infrastructure.
There are several other directories parallel to man4/ which may also be of interest:
- man3 - OpenGL 3.x API man pages
- man - OpenGL 2.1 API man pages
- manglsl - OpenGL Shading Language man pages
- mancommon - common infrastructure used by all the other man* directories
These can be checked out from Subversion using a similar ‘svn co’ command but replacing man4 with the corresponding directory name.
There are two files in the OpenGL.org Wiki containing additional documentation:
http://www.opengl.org/wiki/Getting_started/XML_Toolchain_and_Man_Pages
- Description of the tools used to build the man pages; how to install and make use of them if you want to build them yourself; and how to report problems.
http://www.opengl.org/wiki/Getting_started/Viewing_XHTML_and_MathML
- Some notes on viewing XHTML+MathML documents in different browsers.
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.