docs: Some detail for PangoGlyphGeometry

1 files changed, 13 insertions, 0 deletions

diff --git a/pango/pango-glyph.h b/pango/pango-glyph.h
index 4dc77fd1..2094fa53 100644
--- a/pango/pango-glyph.h
+++ b/pango/pango-glyph.h
@@ -58,6 +58,19 @@ typedef gint32 PangoGlyphUnit;
  *
  * The `PangoGlyphGeometry` structure contains width and positioning
  * information for a single glyph.
+ *
+ * Note that @width is not guaranteed to be the same as the glyph
+ * extents. Kerning and other positioning applied during shaping will
+ * affect both the @width and the @x_offset for the glyphs in the
+ * glyph string that results from shaping.
+ *
+ * The information in this struct is intended for rendering the glyphs,
+ * as follows:
+ *
+ * 1. Render the current glyph at (x + x_offset, y + y_offset),
+ *    where (x, y) is the current point
+ * 2. Advance the current point to (x + xoffset, y)
+ * 3. Render the next glyph...
  */
 struct _PangoGlyphGeometry
 {