From 2d4108fa4cb7cb0ea703e8e86e8a15c26e177eca Mon Sep 17 00:00:00 2001
From: Sven Gothel <sgothel@jausoft.com>
Date: Tue, 15 May 2012 17:49:16 +0200
Subject: Clarify API Doc: GLRunnable and it's GLAutoDrawable::invoke(..)

---
 src/jogl/classes/javax/media/opengl/GLAutoDrawable.java | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

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

diff --git a/src/jogl/classes/javax/media/opengl/GLAutoDrawable.java b/src/jogl/classes/javax/media/opengl/GLAutoDrawable.java
index f0101a90c..c676535c8 100644
--- a/src/jogl/classes/javax/media/opengl/GLAutoDrawable.java
+++ b/src/jogl/classes/javax/media/opengl/GLAutoDrawable.java
@@ -181,22 +181,26 @@ public interface GLAutoDrawable extends GLDrawable {
 
   /** 
    * <p>
-   * Enqueues a one-shot {@link javax.media.opengl.GLRunnable GLRunnable},
-   * which will be executed with the next {@link #display()} call.</p>
+   * Enqueues a one-shot {@link GLRunnable},
+   * which will be executed within the next {@link #display()} call
+   * after all registered {@link GLEventListener}s 
+   * {@link GLEventListener#display(GLAutoDrawable) display(GLAutoDrawable)} 
+   * methods has been called.
+   * </p>
    * <p>
-   * If no {@link javax.media.opengl.GLAnimatorControl GLAnimatorControl} is animating (default),<br>
+   * If no {@link GLAnimatorControl} is animating (default),<br>
    * or if the current thread is the animator thread,<br>
    * a {@link #display()} call is issued after enqueue the <code>GLRunnable</code>.<br>
    * No extra synchronization is performed in case <code>wait</code> is true, since it is executed in the current thread.</p>
    * <p>
-   * If an {@link javax.media.opengl.GLAnimatorControl GLAnimatorControl} is animating,<br>
+   * If an {@link GLAnimatorControl} is animating,<br>
    * no {@link #display()} call is issued, since the animator thread performs it.<br>
    * If <code>wait</code> is true, the implementation waits until the <code>GLRunnable</code> is executed.<br>
    * </p><br>
    *
-   * @see #setAnimator(javax.media.opengl.GLAnimatorControl)
+   * @see #setAnimator(GLAnimatorControl)
    * @see #display()
-   * @see javax.media.opengl.GLRunnable
+   * @see GLRunnable
    */   
   public void invoke(boolean wait, GLRunnable glRunnable);
 
-- 
cgit v1.2.3