1. Where is the documentation located? I pulled what is in CVS but there isn't really much there. The userguide.html is just a one page overview. The two demo programs also don't give you too many clues as to how it is to be used.
Now come on, you know Sun is infamous for not writing a lot of documentation
Heck you could find more documentation about the FullScreen API in weblogs than Sun's own website.
On a more serious note, I think that documentation will somewhat fall to the community. I've been writing a document that will help people get going with JOGL. Seems I'm becoming quite the Tech Writer of late.
2. What exactly should we be doing in the init method? In the gear demo they are drawing geometry, in other places I have seen what looks like frame setup stuff (projection matrix, clearing background). But I have also see the GL and GLU handles being fetched from the drawable interface.
While you can draw stuff in init, according to the code in GLCanvas and Animator you really should be doing any drawing in your GLEventListener's display,reshape, and displayChanged methods.
3. Where is the documentation for GL and GLU? In particular I would like to see the options for passing geometry to the interface (NIO Buffers, Arrays, etc). I have plenty of docs on the opengl interface in general, what I need is the specifics (preferablly javadoc) for the JOGL interface to those methods. For example LWJGL 0.6 uses system addresses against direct NIO buffers for passing in buffers, which is extremely fast.
You'll have to generate the javadocs unless you download the source. When it builds it generates the docs in a directory javadoc_public.
4. What drove the decision to force AWT to underly the canvas implementations? Is it possible to somehow abstract from that so we can have a third drawable (heavyweight componant, lightweight componant, OS level window).
Can't answer that one, but GLCanvas is HW component, GLJCanvas is lightweight component and there is no OS level window - that's just wrong IMHO
5. How have you found the performance of gathering mouse events through the AWT event mechanism? I have found that in general WLToolkit under windows just sucks the life out applications, which is why the polling mechanism of LWJGL is attractive to many people.
6. How stable is the current release of JOGL right now under Lunix, Windows and MacOS?
I can confirm its stability on WIndowsXP, and OSX Panther. No issues whatsoever.