diff --git a/src/hb-ot-layout.cc b/src/hb-ot-layout.cc
index bc0937e6b..cbc694ef9 100644
--- a/src/hb-ot-layout.cc
+++ b/src/hb-ot-layout.cc
@@ -2119,6 +2119,9 @@ hb_ot_layout_get_font_extents (hb_font_t         *font,
  * do not have a line-gap value, and the line-gap is set to zero in
  * that case.
  *
+ * This function is like hb_ot_layout_get_font_extents() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ *
  * Return value: `true` if found script/language-specific font extents.
  *
  * XSince: REPLACEME
@@ -2247,6 +2250,9 @@ hb_ot_layout_get_baseline (hb_font_t                   *font,
  *
  * Fetches a baseline value from the face.
  *
+ * This function is like hb_ot_layout_get_baseline() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ *
  * Return value: `true` if found baseline value in the font.
  *
  * XSince: REPLACEME
@@ -2503,6 +2509,9 @@ hb_ot_layout_get_baseline_with_fallback (hb_font_t                   *font,
  * Fetches a baseline value from the face, and synthesizes
  * it if the font does not have it.
  *
+ * This function is like hb_ot_layout_get_baseline_with_fallback() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ *
  * XSince: REPLACEME
  **/
 void