docs: Replace lots of vestigial xml markup

We want to use pure markdown, since docbook
is going away as the intermediate format.

1 files changed, 10 insertions, 11 deletions

diff --git a/pango/pangocairo-render.c b/pango/pangocairo-render.c
index 614a3a44..75a7a0f7 100644
--- a/pango/pangocairo-render.c
+++ b/pango/pangocairo-render.c
@@ -24,7 +24,7 @@
  * @short_description:Font handling and rendering with Cairo
  * @title:Cairo Fonts and Rendering
  *
- * The <ulink url="http://cairographics.org">Cairo library</ulink> is a
+ * The Cairo library is a
  * vector graphics library with a powerful rendering model. It has such
  * features as anti-aliased primitives, alpha-compositing, and
  * gradients. Multiple backends for Cairo are available, to allow
@@ -69,11 +69,10 @@
  *   PangoFontDescription *desc;
  *   int i;
  *
- *   /&ast; Center coordinates on the middle of the region we are drawing
- *    &ast;/
+ *   // Center coordinates on the middle of the region we are drawing
  *   cairo_translate (cr, RADIUS, RADIUS);
  *
- *   /&ast; Create a PangoLayout, set the font and text &ast;/
+ *   // Create a PangoLayout, set the font and text
  *   layout = pango_cairo_create_layout (cr);
  *
  *   pango_layout_set_text (layout, "Text", -1);
@@ -81,8 +80,8 @@
  *   pango_layout_set_font_description (layout, desc);
  *   pango_font_description_free (desc);
  *
- *   /&ast; Draw the layout N_WORDS times in a circle &ast;/
- *   for (i = 0; i &lt; N_WORDS; i++)
+ *   // Draw the layout N_WORDS times in a circle
+ *   for (i = 0; i < N_WORDS; i++)
  *     {
  *       int width, height;
  *       double angle = (360. * i) / N_WORDS;
@@ -90,23 +89,23 @@
  *
  *       cairo_save (cr);
  *
- *       /&ast; Gradient from red at angle == 60 to blue at angle == 240 &ast;/
+ *       // Gradient from red at angle == 60 to blue at angle == 240
  *       red   = (1 + cos ((angle - 60) * G_PI / 180.)) / 2;
  *       cairo_set_source_rgb (cr, red, 0, 1.0 - red);
  *
  *       cairo_rotate (cr, angle * G_PI / 180.);
  *
- *       /&ast; Inform Pango to re-layout the text with the new transformation &ast;/
+ *       // Inform Pango to re-layout the text with the new transformation
  *       pango_cairo_update_layout (cr, layout);
  *
- *       pango_layout_get_size (layout, &amp;width, &amp;height);
+ *       pango_layout_get_size (layout, &width, &height);
  *       cairo_move_to (cr, - ((double)width / PANGO_SCALE) / 2, - RADIUS);
  *       pango_cairo_show_layout (cr, layout);
  *
  *       cairo_restore (cr);
  *     }
  *
- *   /&ast; free the layout object &ast;/
+ *   // free the layout object
  *   g_object_unref (layout);
  * }
  *
@@ -1210,7 +1209,7 @@ pango_cairo_show_glyph_string (cairo_t          *cr,
  * be drawn at the current point of the cairo context.
  *
  * Note that @text is the start of the text for layout, which is then
- * indexed by <literal>@glyph_item->item->offset</literal>.
+ * indexed by `glyph_item->item->offset`.
  *
  * Since: 1.22
  **/