Added note on limitations of OpenGL context sharing to spec overview

and pointed to it from GLDrawableFactory, GLDrawable, GLCanvas and
GLJPanel


git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@611 232f8b59-042b-4e1e-8c03-345bb8c30851

1 files changed, 14 insertions, 0 deletions

diff --git a/make/spec-overview.html b/make/spec-overview.html
index c8c45142a..a187e2c51 100644
--- a/make/spec-overview.html
+++ b/make/spec-overview.html
@@ -199,6 +199,20 @@ which a separate thread attempts to alter the contents of the argument during
 the time interval following validation but preceding passage of the argument 
 to the underlying native engine.<br>
    
+<h3><a name="SHARING">Sharing of Server-Side OpenGL Objects between GLContexts</a></h3>
+
+Sharing of server-side OpenGL objects such as textures and display
+lists among OpenGL contexts is supported in this specification.
+However, the specification does not guarantee that a request to share
+objects between two contexts will succeed. Certain OpenGL
+implementations restrict sharing in certain ways. Applications should
+assume that sharing is a request more than an assertion.
+Implementations of this specification should, but are not required to,
+provide timely notification of a failure of a request to share objects
+between two GLContexts, perhaps in the form of a GLException. The
+situation in which sharing is most likely to work on all platforms is
+between two GLContexts associated with the same GLDrawable.
+
 <h3>Criteria Used for Inclusion of APIs into the Java Bindings</h3>
    
 <h4>OpenGL API Inclusion Criteria</h4>