diff --git a/src/hb-font.h b/src/hb-font.h
index 070d173e3..1e36796da 100644
--- a/src/hb-font.h
+++ b/src/hb-font.h
@@ -798,6 +798,10 @@ hb_font_funcs_set_glyph_shape_func (hb_font_funcs_t *ffuncs,
  * @func: (closure user_data) (destroy destroy) (scope notified):
  * @user_data:
  * @destroy: (nullable):
+ *
+ * Sets the implementation function for #hb_font_get_glyph_paint_func_t.
+ *
+ * Since: REPLACEME
  */
 HB_EXTERN void
 hb_font_funcs_set_glyph_paint_func (hb_font_funcs_t *ffuncs,
diff --git a/src/hb-paint.cc b/src/hb-paint.cc
index 793a27e1f..a37483eee 100644
--- a/src/hb-paint.cc
+++ b/src/hb-paint.cc
@@ -421,7 +421,7 @@ hb_paint_push_clip_glyph (hb_paint_funcs_t *funcs, void *paint_data,
 }
 
 /**
- * hb_paint_push_clip_rect:
+ * hb_paint_push_clip_rectangle:
  * @funcs: paint functions
  * @paint_data: associated data passed by the caller
  * @xmin: min X for the rectangle