diff --git a/src/hb-ot-color.h b/src/hb-ot-color.h
index 89935143e..1cc04d4f3 100644
--- a/src/hb-ot-color.h
+++ b/src/hb-ot-color.h
@@ -94,7 +94,9 @@ HB_EXTERN hb_bool_t
 hb_ot_color_has_layers (hb_face_t *face);
 
 /**
- * hb_ot_color_layer_t: Pairs of glyph and color index.
+ * hb_ot_color_layer_t:
+ *
+ * Pairs of glyph and color index.
  *
  * Since: REPLACEME
  **/
diff --git a/src/hb-ot-name.cc b/src/hb-ot-name.cc
index 2bf2ae58b..e8aa3d8e7 100644
--- a/src/hb-ot-name.cc
+++ b/src/hb-ot-name.cc
@@ -52,13 +52,13 @@ _get_name (hb_face_t *face)
 /**
  * hb_ot_name_list_names:
  * @face: font face.
- * @num_entries: (out) number of returned entries.
+ * @num_entries: (out): number of returned entries.
  *
  * Enumerates all available name IDs and language combinations. Returned
  * array is owned by the @face and should not be modified.  It can be
  * used as long as @face is alive.
  *
- * Returns: (out) (transfer none) (array length=num_entries) Array of available name entries.
+ * Returns: (out) (transfer none) (array length=num_entries): Array of available name entries.
  * Since: 2.1.0
  **/
 const hb_ot_name_entry_t *