[pango/pango2: 52/56] context: more docs

[Matthias Clasen <matthiasc src gnome org>]

commit 3a48614a586727f0197fb46d6ed2bd1d351cad9d
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jun 13 08:43:27 2022 -0400

    context: more docs

 pango/pango-context.c | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)
---
diff --git a/pango/pango-context.c b/pango/pango-context.c
index 66dff58cc..17c7483c0 100644
--- a/pango/pango-context.c
+++ b/pango/pango-context.c
@@ -296,10 +296,14 @@ pango_context_class_init (PangoContextClass *klass)
   /**
    * PangoContext:matrix: (attributes org.gtk.Property.get=pango_context_get_matrix 
org.gtk.Property.set=pango_context_set_matrix)
    *
-   * The transformation matrix that will be applied when rendering
+   * The 'user to device' transformation that will be applied when rendering
    * with this context.
    *
-   * This matrix is also known as the 'ctm'.
+   * This matrix is also known as the current transformation matrix, or 'ctm'.
+   *
+   * The transformation is needed in cases where the font rendering applies
+   * hinting that depends on knowing the position of text with respect to
+   * the pixel grid. If your font rendering does not
    */
   properties[PROP_MATRIX] =
     g_param_spec_boxed ("matrix", NULL, NULL, PANGO_TYPE_MATRIX,
@@ -385,9 +389,15 @@ update_resolved_gravity (PangoContext *context)
  * @matrix: (nullable): a `PangoMatrix`, or %NULL to unset any existing
  * matrix. (No matrix set is the same as setting the identity matrix.)
  *
- * Sets the transformation matrix that will be applied when rendering
+ * Sets the 'user to device' transformation that will be applied when rendering
  * with this context.
  *
+ * This matrix is also known as the current transformation matrix, or 'ctm'.
+ *
+ * The transformation is needed in cases where the font rendering applies
+ * hinting that depends on knowing the position of text with respect to
+ * the pixel grid.
+ *
  * Note that reported metrics are in the user space coordinates before
  * the application of the matrix, not device-space coordinates after the
  * application of the matrix. So, they don't scale with the matrix, though