docs: Use Markdown instead of Docbook

The example code is not correctly escaped, and gtk-doc has become
slightly more strict. This is a good chance to port this bit of the API
reference to Markdown, and avoid all issues in a future without inlined
XML.

1 files changed, 9 insertions, 9 deletions

diff --git a/pango/pangocairo-render.c b/pango/pangocairo-render.c
index 7670ca13..b39b8156 100644
--- a/pango/pangocairo-render.c
+++ b/pango/pangocairo-render.c
@@ -52,9 +52,9 @@
  * functions in Pango report results in integer Pango units. To get
  * to the floating point units used in Cairo divide by %PANGO_SCALE.
  *
- * <example id="rotated-example">
- * <title>Using Pango with Cairo</title>
- *  <programlisting>
+ * ## Using Pango with Cairo ## {#rotated-example}
+ *
+ * |[<!-- language="C" -->
  * #include <math.h>
  * #include <pango/pangocairo.h>
  *
@@ -145,12 +145,12 @@
  *
  *   return 0;
  * }
- * </programlisting>
- * </example>
- * <figure id="rotated-example-output">
- *   <title>Output of <xref linkend="rotated-example"/></title>
- *   <graphic fileref="rotated-text.png" format="PNG"/>
- * </figure>
+ * ]|
+ *
+ * Once you build and run the example code above, you should see the
+ * following result:
+ *
+ * ![Output of rotated-example](rotated-text.png)
  */
 #include "config.h"