docs: Tweak renderer docs

Add summaries, convert markup, etc.

1 files changed, 7 insertions, 4 deletions

diff --git a/pango/pango-renderer.h b/pango/pango-renderer.h
index 89107fd1..98c4cfb0 100644
--- a/pango/pango-renderer.h
+++ b/pango/pango-renderer.h
@@ -65,12 +65,15 @@ typedef enum
  *    the Renderer; may be %NULL, which should be treated the
  *    same as the identity matrix.
  *
- * #PangoRenderer is a base class for objects that are used to
- * render Pango objects such as #PangoGlyphString and
- * #PangoLayout.
+ * `PangoRenderer` is a base class for objects that can render text
+ * provided as `PangoGlyphString` or `PangoLayout`.
+ *
+ * By subclassing `PangoRenderer` and overriding operations such as
+ * @draw_glyphs and @draw_rectangle, renderers for particular font
+ * backends and destinations can be created.
  *
  * Since: 1.8
- **/
+ */
 struct _PangoRenderer
 {
   /*< private >*/