From 63fcb26c9b771f6ab492dad896a4da911fb0427e Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sat, 17 Dec 2022 22:41:34 -0500
Subject: [PATCH] Add some more docs

---
 src/hb-ot-color.cc | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/hb-ot-color.cc b/src/hb-ot-color.cc
index 696ca3e17..621d36555 100644
--- a/src/hb-ot-color.cc
+++ b/src/hb-ot-color.cc
@@ -190,7 +190,15 @@ hb_ot_color_palette_get_colors (hb_face_t     *face,
  * hb_ot_color_has_layers:
  * @face: #hb_face_t to work upon
  *
- * Tests whether a face includes any `COLR` color layers.
+ * Tests whether a face includes a `COLR` table.
+ *
+ * Note that the `COLR` table may contain layers
+ * or (for v1) more complicated paint graphs, so
+ * it is not guaranteed that hb_ot_color_get_layers()
+ * will return information for each color glyph,
+ * even if this function returns `true`. See
+ * hb_font_paint_glyph() for an API that will work
+ * in either case.
  *
  * Return value: `true` if data found, `false` otherwise
  *