Texture: Clarifiy API doc of getTextureObject(GL)

1 files changed, 6 insertions, 1 deletions

diff --git a/src/jogl/classes/com/jogamp/opengl/util/texture/Texture.java b/src/jogl/classes/com/jogamp/opengl/util/texture/Texture.java
index 15dd19ea9..6e66e3d03 100644
--- a/src/jogl/classes/com/jogamp/opengl/util/texture/Texture.java
+++ b/src/jogl/classes/com/jogamp/opengl/util/texture/Texture.java
@@ -833,9 +833,14 @@ public class Texture {
     }
 
     /**
-     * Returns the underlying OpenGL texture object for this texture.
+     * Returns the underlying OpenGL texture object for this texture
+     * and generates it if not done yet.
+     * <p>
      * Most applications will not need to access this, since it is
      * handled automatically by the bind(GL) and destroy(GL) APIs.
+     * </p>
+     * @param gl required to be valid and current in case the texture object has not been generated yet,
+     *           otherwise it may be <code>null</code>.
      */
     public int getTextureObject(GL gl) {
         validateTexID(gl, false);