pangocairo: Tweak docs

Convert link syntax, and summaries.

1 files changed, 21 insertions, 7 deletions

diff --git a/pango/pangocairo-render.c b/pango/pangocairo-render.c
index 47beb100..9e3cfab8 100644
--- a/pango/pangocairo-render.c
+++ b/pango/pangocairo-render.c
@@ -1045,6 +1045,7 @@ _pango_cairo_do_error_underline (cairo_t *cr,
  * @glyphs: a `PangoGlyphString`
  *
  * Draws the glyphs in @glyphs in the specified cairo context.
+ *
  * The origin of the glyphs (the left edge of the baseline) will
  * be drawn at the current point of the cairo context.
  *
@@ -1069,6 +1070,7 @@ pango_cairo_show_glyph_string (cairo_t          *cr,
  * @glyph_item: a `PangoGlyphItem`
  *
  * Draws the glyphs in @glyph_item in the specified cairo context,
+ *
  * embedding the text associated with the glyphs in the output if the
  * output format supports it (PDF for example), otherwise it acts
  * similar to [func@show_glyph_string].
@@ -1099,6 +1101,7 @@ pango_cairo_show_glyph_item (cairo_t          *cr,
  * @line: a `PangoLayoutLine`
  *
  * Draws a `PangoLayoutLine` in the specified cairo context.
+ *
  * The origin of the glyphs (the left edge of the line) will
  * be drawn at the current point of the cairo context.
  *
@@ -1120,6 +1123,7 @@ pango_cairo_show_layout_line (cairo_t          *cr,
  * @layout: a Pango layout
  *
  * Draws a `PangoLayout` in the specified cairo context.
+ *
  * The top-left corner of the `PangoLayout` will be drawn
  * at the current point of the cairo context.
  *
@@ -1145,9 +1149,11 @@ pango_cairo_show_layout (cairo_t     *cr,
  *
  * Draw a squiggly line in the specified cairo context that approximately
  * covers the given rectangle in the style of an underline used to indicate a
- * spelling error. (The width of the underline is rounded to an integer
+ * spelling error.
+ *
+ * The width of the underline is rounded to an integer
  * number of up/down segments and the resulting rectangle is centered in the
- * original rectangle)
+ * original rectangle.
  *
  * Since: 1.14
  */
@@ -1171,7 +1177,9 @@ pango_cairo_show_error_underline (cairo_t *cr,
  * @glyphs: a `PangoGlyphString`
  *
  * Adds the glyphs in @glyphs to the current path in the specified
- * cairo context. The origin of the glyphs (the left edge of the baseline)
+ * cairo context.
+ *
+ * The origin of the glyphs (the left edge of the baseline)
  * will be at the current point of the cairo context.
  *
  * Since: 1.10
@@ -1193,7 +1201,9 @@ pango_cairo_glyph_string_path (cairo_t          *cr,
  * @line: a `PangoLayoutLine`
  *
  * Adds the text in `PangoLayoutLine` to the current path in the
- * specified cairo context. The origin of the glyphs (the left edge
+ * specified cairo context.
+ *
+ * The origin of the glyphs (the left edge
  * of the line) will be at the current point of the cairo context.
  *
  * Since: 1.10
@@ -1214,7 +1224,9 @@ pango_cairo_layout_line_path (cairo_t          *cr,
  * @layout: a Pango layout
  *
  * Adds the text in a `PangoLayout` to the current path in the
- * specified cairo context. The top-left corner of the `PangoLayout`
+ * specified cairo context.
+ *
+ * The top-left corner of the `PangoLayout`
  * will be at the current point of the cairo context.
  *
  * Since: 1.10
@@ -1239,9 +1251,11 @@ pango_cairo_layout_path (cairo_t     *cr,
  *
  * Add a squiggly line to the current path in the specified cairo context that
  * approximately covers the given rectangle in the style of an underline used
- * to indicate a spelling error. (The width of the underline is rounded to an
+ * to indicate a spelling error.
+ *
+ * The width of the underline is rounded to an
  * integer number of up/down segments and the resulting rectangle is centered
- * in the original rectangle)
+ * in the original rectangle.
  *
  * Since: 1.14
  */