I believe that the OpenGL API is poorly documented; Developing products using OpenGL could be greatly improved if the API was documented... I suggest that you use Sun's Java Documentation format... There are a large number of developers who know Java, and it has a documentation standard...
http://java.sun.com/j2se/1.3/docs/api/index.html



