For those who are interested in helping with the documentation/release
effort for PyOpenGL 3.x, the newly generated reference documentation is
now up, and includes sample-code references for various PyOpenGL-using
Open Source projects. This is still based on OpenGL 1.x documentation,
despite the fact that PyOpenGL should support anything up to OpenGL
3.x. At some point hopefully someone at Khronos group will release at
least the 2.1 DocBook source files and we can regenerate with those.
Check it out here:
http://pyopengl.sourceforge.net/documentation/manual-3.0/index.xhtml
The generation process is now entirely automatic, hopefully we'll get
more PyOpenGL-using projects added so that we can update the set
ofsample-code projects. As mentioned earlier, there's currently no
documentation for extensions. If you want to work on any of those, let
me know, the code to generate the documentation is up on LaunchPad:
bzr branch lp:~mcfletch/pyopengl/directdocs
There's obviously lots to be done with formatting as well if someone has
the time. If someone wants to add deprecation warnings for OpenGL 3.x,
that would be useful too, (e.g. create a text file with the names of the
deprecated functions and annotate the docs with a warning for each
deprecated operation).
Have fun,
Mike
--
________________________________________________
Mike C. Fletcher
Designer, VR Plumber, Coder
http://www.vrplumber.com
http://blog.vrplumber.com
|
