Updated spec based on comments from rexguo on javagaming.org forums

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

1 files changed, 6 insertions, 4 deletions

diff --git a/src/classes/javax/media/opengl/GLDrawable.java b/src/classes/javax/media/opengl/GLDrawable.java
index 5b54bd369..a1780bd2a 100644
--- a/src/classes/javax/media/opengl/GLDrawable.java
+++ b/src/classes/javax/media/opengl/GLDrawable.java
@@ -70,10 +70,12 @@ package javax.media.opengl;
 public interface GLDrawable {
   /**
    * Creates a new context for drawing to this drawable that will
-   * share display lists with the given GLContext.
+   * optionally share display lists and other server-side OpenGL
+   * objects with the specified GLContext.
    *
    * The GLContext <code>share</code> need not be associated with this
-   * GLDrawable.
+   * GLDrawable and may be null if sharing of display lists and other
+   * objects is not desired.
    */
   public GLContext createContext(GLContext shareWith);
 
@@ -112,7 +114,7 @@ public interface GLDrawable {
 
   /** Swaps the front and back buffers of this drawable. For {@link
       GLAutoDrawable} implementations, when automatic buffer swapping
-      is enabled (as is the default), it is not necessary to call this
-      method and doing so may have undefined results. */
+      is enabled (as is the default), this method is called
+      automatically and should not be called by the end user. */
   public void swapBuffers() throws GLException;
 }