diff --git a/cogl/cogl-snippet.h b/cogl/cogl-snippet.h
index e1b30ef8b..6baba62b8 100644
--- a/cogl/cogl-snippet.h
+++ b/cogl/cogl-snippet.h
@@ -173,17 +173,17 @@ COGL_BEGIN_DECLS
* attribute vec4
* cogl_tex_coord_in
*
- * The texture coordinate for the first texture unit. This is
- * equivalent to #gl_MultiTexCoord0.
+ * The texture coordinate for layer 0. This is an alternative name
+ * for #cogl_tex_coord0_in.
*
*
*
* attribute vec4
* cogl_tex_coord0_in
*
- * The texture coordinate for the first texture unit. This is
- * equivalent to #gl_MultiTexCoord0. There is also
- * #cogl_tex_coord1_in and so on.
+ * The texture coordinate for the layer 0. This is equivalent to
+ * #gl_MultiTexCoord0. There will also be #cogl_tex_coord1_in and
+ * so on if more layers are added to the pipeline.
*
*
*
@@ -227,10 +227,13 @@ COGL_BEGIN_DECLS
*
*
* varying vec4
- * cogl_tex_coord_out[]
+ * cogl_tex_coord0_out
*
- * An array of calculated texture coordinates for a vertex. This is
- * equivalent to #gl_TexCoord.
+ * The calculated texture coordinate for layer 0 of the pipeline.
+ * This is equivalent to #gl_TexCoord[0]. There will also be
+ * #cogl_tex_coord1_out and so on if more layers are added to the
+ * pipeline. In the fragment shader, this varying is called
+ * #cogl_tex_coord0_in.
*
*
*
@@ -246,10 +249,11 @@ COGL_BEGIN_DECLS
*
*
* varying vec4
- * cogl_tex_coord_in[]
+ * cogl_tex_coord0_in
*
- * An array of calculated texture coordinates for a vertex. This is
- * equivalent to #gl_TexCoord.
+ * The texture coordinate for layer 0. This is equivalent to
+ * #gl_TexCoord[0]. There will also be #cogl_tex_coord1_in and so
+ * on if more layers are added to the pipeline.
*
*
*