From f5fd46aa3d905a7c69c12fa35c48d8c3b64f0cf2 Mon Sep 17 00:00:00 2001
From: Behdad Esfahbod <behdad@behdad.org>
Date: Mon, 26 Dec 2022 16:18:27 -0700
Subject: [PATCH] [cairo] Docs

---
 src/hb-cairo.cc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/hb-cairo.cc b/src/hb-cairo.cc
index 163f59ed0..5e2f47159 100644
--- a/src/hb-cairo.cc
+++ b/src/hb-cairo.cc
@@ -677,7 +677,9 @@ hb_cairo_scaled_font_get_font (cairo_scaled_font_t *scaled_font)
  * If the cairo-face was created using the alternative constructor
  * hb_cairo_font_face_create_for_font(), you are on your own
  * computing the correct scale-factor to pass to
- * hb_cairo_glyphs_from_buffer().
+ * hb_cairo_glyphs_from_buffer(), but it is generally the x_scale
+ * of the #hb_font_t divided by the xx factor of the scaled-font's
+ * scale-matrix.
  *
  * Since: REPLACEME
  */