I wasn't so much trying to suggest adding the entire OpenGL manual into the javadoc, just some 1 or 2 sentence descriptions of each method/member variable. It would be much more handy to have a quick reference in the javadoc or in Eclipse, instead of having to hunt through the OpenGL books. I don't see this task becoming too daunting, just some work that can be done over a span of time. Like I said, I wouldn't mind taking it upon myself to do some of this work.
Conversely, if you want me to drop the subject, just tell me and I'll go home with my tail between my legs :wink: