some new comments
diff --git a/src/mesa/swrast/s_texstore.c b/src/mesa/swrast/s_texstore.c
index a9da77e..e9f4fae 100644
--- a/src/mesa/swrast/s_texstore.c
+++ b/src/mesa/swrast/s_texstore.c
@@ -304,8 +304,13 @@
}
-/*
+/**
* Fallback for Driver.CopyTexImage2D().
+ *
+ * We implement CopyTexImage by reading the image from the framebuffer
+ * then passing it to the ctx->Driver.TexImage2D() function.
+ *
+ * Device drivers should try to implement direct framebuffer->texture copies.
*/
void
_swrast_copy_teximage2d( GLcontext *ctx, GLenum target, GLint level,
@@ -441,8 +446,11 @@
}
-/*
+/**
* Fallback for Driver.CopyTexSubImage2D().
+ *
+ * Read the image from the framebuffer then hand it
+ * off to ctx->Driver.TexSubImage2D().
*/
void
_swrast_copy_texsubimage2d( GLcontext *ctx,