mesa: add some comments about mipmap generation

Trivial.

2 files changed, 9 insertions, 0 deletions

diff --git a/src/mesa/main/dd.h b/src/mesa/main/dd.h
index e96cf3a95dd..0b2b84a65c1 100644
--- a/src/mesa/main/dd.h
+++ b/src/mesa/main/dd.h
@@ -256,6 +256,10 @@ struct dd_function_table {
 
    /**
     * Called by glGenerateMipmap() or when GL_GENERATE_MIPMAP_SGIS is enabled.
+    * Note that if the texture is a cube map, the <target> parameter will
+    * indicate which cube face to generate (GL_POSITIVE/NEGATIVE_X/Y/Z).
+    * texObj->BaseLevel is the level from which to generate the remaining
+    * mipmap levels.
     */
    void (*GenerateMipmap)(struct gl_context *ctx, GLenum target,
                           struct gl_texture_object *texObj);
diff --git a/src/mesa/main/fbobject.c b/src/mesa/main/fbobject.c
index f63ed8cd3db..b5b55fc83d1 100644
--- a/src/mesa/main/fbobject.c
+++ b/src/mesa/main/fbobject.c
@@ -2977,6 +2977,11 @@ invalid_pname_enum:
 }
 
 
+/**
+ * Generate all the mipmap levels below the base level.
+ * Note: this GL function would be more useful if one could specify a
+ * cube face, a set of array slices, etc.
+ */
 void GLAPIENTRY
 _mesa_GenerateMipmap(GLenum target)
 {