diff --git a/src/hb-paint.cc b/src/hb-paint.cc
index 6e20a6024..24ac7131c 100644
--- a/src/hb-paint.cc
+++ b/src/hb-paint.cc
@@ -392,7 +392,7 @@ hb_paint_funcs_is_immutable (hb_paint_funcs_t *funcs)
  * may be out of order. It is the callers responsibility to ensure that
  * color stops are sorted by their offset before they are used.
  *
- * Return value: the total number of color stops in @cl
+ * Return value: the total number of color stops in @color_line
  *
  * Since: REPLACEME
  */
@@ -415,6 +415,8 @@ hb_color_line_get_color_stops (hb_color_line_t *color_line,
  *
  * Fetches the extend mode of the color line object.
  *
+ * Return value: the extend mode of @color_line
+ *
  * Since: REPLACEME
  */
 hb_paint_extend_t
diff --git a/src/hb-paint.h b/src/hb-paint.h
index 7bd88124d..e57e26b7c 100644
--- a/src/hb-paint.h
+++ b/src/hb-paint.h
@@ -326,6 +326,22 @@ typedef enum {
 
 typedef struct hb_color_line_t hb_color_line_t;
 
+/**
+ * hb_color_line_get_color_stops_func_t:
+ * @color_line: a #hb_color_line_t object
+ * @color_line_data: the data accompanying @color_line
+ * @start: the index of the first color stop to return
+ * @count: (inout) (optional): Input = the maximum number of feature tags to return;
+ *     Output = the actual number of feature tags returned (may be zero)
+ * @color_stops: (out) (array length=count) (optional): Array of #hb_color_stop_t to populate
+ * @user_data: the data accompanying this method
+ *
+ * A virtual method for the #hb_color_line_t to fetch color stops.
+ *
+ * Return value: the total number of color stops in @color_line
+ *
+ * Since: REPLACEME
+ */
 typedef unsigned int (*hb_color_line_get_color_stops_func_t) (hb_color_line_t *color_line,
 							      void *color_line_data,
 							      unsigned int start,
@@ -333,6 +349,18 @@ typedef unsigned int (*hb_color_line_get_color_stops_func_t) (hb_color_line_t *c
 							      hb_color_stop_t *color_stops,
 							      void *user_data);
 
+/**
+ * hb_color_line_get_extend_func_t:
+ * @color_line: a #hb_color_line_t object
+ * @color_line_data: the data accompanying @color_line
+ * @user_data: the data accompanying this method
+ *
+ * A virtual method for the @hb_color_line_t to fetches the extend mode.
+ *
+ * Return value: the extend mode of @color_line
+ *
+ * Since: REPLACEME
+ */
 typedef hb_paint_extend_t (*hb_color_line_get_extend_func_t) (hb_color_line_t *color_line,
 							      void *color_line_data,
 							      void *user_data);