Bug 776 GLContext Sharing: Add note about driver stability (destruction order) ; Fix unit tests (Shared Gears, wait for created context and destruction order)

- Add note about driver stability (destruction order)
  - See GLSharedContextSetter: Don't destroy master context before slaves!

- Fix spec-overview.html#SHARED links, add link to GLSharedContextSetter in SHARED subsection.

- Fix unit tests (Shared Gears, wait for created context and destruction order)
  - The GearsObject sharing was completly bogus!
    It simply used the _same_ GLArrayDataServer instance for sharing,
    but it should use a _copy_ of the shared GLArrayDataServer while
    only preserving the VBO object!
    Fixed, while adding required methods to GLArrayDataServer.

  - Waiting for the created GLContext of a GLAutoDrawable required us
    to pass the latter _and_ check whether it's GLContext exists and is natively created.

  - Accomodated the destruction order - see above!

1 files changed, 5 insertions, 0 deletions

diff --git a/make/doc/jogl/spec-overview.html b/make/doc/jogl/spec-overview.html
index 952e8f8e0..1a63fb7dd 100644
--- a/make/doc/jogl/spec-overview.html
+++ b/make/doc/jogl/spec-overview.html
@@ -332,6 +332,11 @@ to the underlying native engine.</p>
 Sharing of server-side OpenGL objects such as buffer objects, e.g. VBOs, 
 and textures among OpenGL contexts is supported in this specification.
 
+<p>
+See {@link javax.media.opengl.GLSharedContextSetter GLSharedContextSetter} interface
+for details.
+</p>
+
 <h3>Criteria Used for Inclusion of APIs into the Java Bindings</h3>
    
 <h4><a name="GLAPIInclusionCriteria">OpenGL API Inclusion Criteria</a></h4>