From c53440b808ecf8ea066479c004cac4cdbb1e989d Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Wed, 30 Oct 2013 01:57:34 +0100
Subject: Bug 776 GLContext Sharing: GLSharedContextSetter API Doc: Add
 'glFinish()' to lifecycle considerations ; GearsES2: Add glFinish() after
 init().

---
 src/jogl/classes/javax/media/opengl/GLSharedContextSetter.java | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'src/jogl/classes/javax/media/opengl')

diff --git a/src/jogl/classes/javax/media/opengl/GLSharedContextSetter.java b/src/jogl/classes/javax/media/opengl/GLSharedContextSetter.java
index fd48d12bf..873e4cd9f 100644
--- a/src/jogl/classes/javax/media/opengl/GLSharedContextSetter.java
+++ b/src/jogl/classes/javax/media/opengl/GLSharedContextSetter.java
@@ -41,6 +41,11 @@ package javax.media.opengl;
  * </p>
  * <h5><a name="lifecycle">Lifecycle Considerations</a></h5>
  * <p>
+ * After shared objects are created on the <i>master</i>, the OpenGL pipeline
+ * might need to be synchronized w/ the <i>slaves</i>, e.g. via {@link GL#glFinish()}.
+ * At least this has been experienced w/ OSX 10.9.
+ * </p>
+ * <p>
  * Be aware that the <i>master</i> {@link GLContext} and related resources
  * <i>shall not</i> be destroyed before it's <i>slave</i> {@link GLContext} instances <i>while they are using them</i>.<br>
  * Otherwise the OpenGL driver implementation may crash w/ SIGSEGV, since using already destroyed resources,
-- 
cgit v1.2.3