diff --git a/clutter/cogl/cogl/cogl-shader.h b/clutter/cogl/cogl/cogl-shader.h
index 9eec9bb40..2bb082d35 100644
--- a/clutter/cogl/cogl/cogl-shader.h
+++ b/clutter/cogl/cogl/cogl-shader.h
@@ -265,22 +265,22 @@ void            cogl_program_uniform_1i       (int              uniform_no,
  * @uniform_no: the uniform to set.
  * @size: Size of float vector.
  * @count: Size of array of uniforms.
- * @value: the new value of the uniform.
+ * @value: (array length=count): the new value of the uniform.
  *
  * Changes the value of a float vector uniform, or uniform array in the
- * currently used (see #cogl_program_use) shader program.
+ * currently used (see cogl_program_use()) shader program.
  */
-void            cogl_program_uniform_float    (int               uniform_no,
-                                               int               size,
-                                               int               count,
-                                               const GLfloat    *value);
+void            cogl_program_uniform_float    (int            uniform_no,
+                                               int            size,
+                                               int            count,
+                                               const GLfloat *value);
 
 /**
  * cogl_program_uniform_int:
  * @uniform_no: the uniform to set.
  * @size: Size of int vector.
  * @count: Size of array of uniforms.
- * @value: the new value of the uniform.
+ * @value: (array length=count): the new value of the uniform.
  *
  * Changes the value of a int vector uniform, or uniform array in the
  * currently used (see cogl_program_use()) shader program.
@@ -296,7 +296,7 @@ void            cogl_program_uniform_int      (int           uniform_no,
  * @size: Size of matrix.
  * @count: Size of array of uniforms.
  * @transpose: Whether to transpose the matrix when setting the uniform.
- * @value: the new value of the uniform.
+ * @value: (array length=count): the new value of the uniform.
  *
  * Changes the value of a matrix uniform, or uniform array in the
  * currently used (see cogl_program_use()) shader program. The @size