[pango/line-breaker: 15/33] layout-line: Add docs

[Matthias Clasen <matthiasc src gnome org>]

commit 55097b869512e3805e785c8c8a8bed74654acb42
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jan 24 14:42:26 2022 -0500

    layout-line: Add docs

 pango/pango-layout-line.c | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
---
diff --git a/pango/pango-layout-line.c b/pango/pango-layout-line.c
index eb9f79c8..6d69067f 100644
--- a/pango/pango-layout-line.c
+++ b/pango/pango-layout-line.c
@@ -11,6 +11,25 @@
 #include <math.h>
 #include <hb-ot.h>
 
+/**
+ * PangoLayoutLine:
+ *
+ * A `PangoLayoutLine` represents one of the lines resulting from laying
+ * out a paragraph via `PangoLayout` or `PangoLineBreaker`.
+ *
+ * A line consists of a number of runs (i.e. ranges of text with uniform
+ * script, font and attributes that are shaped as a unit). Runs are
+ * represented as [struct@Pango.LayoutRun] objects.
+ *
+ * A `PangoLayoutLine` always has its origin at the leftmost point  of its
+ * baseline. To position lines in an entire paragraph of text (i.e. in layout
+ * coordinates), the `PangoLines` object stores X and Y coordinates to
+ * offset each line to.
+ *
+ * The most convenient way to access the visual extents and components
+ * of a `PangoLayoutLine` is via a [struct@Pango.LayoutIter] iterator.
+ */
+
 /* {{{ LineData */
 
 void