Use markdown for images

diff --git a/gio/gmenumodel.c b/gio/gmenumodel.c
index 6095ca492b3f727787dd0f36fc39ac06ecf8e1b1..61be14c3a6eba654d1cfdd74fb31380864bde05c 100644 (file)
--- a/gio/gmenumodel.c
+++ b/gio/gmenumodel.c
@@ -46,10 +46,9 @@
  * As an example, consider the visible portions of the menu in
  * <xref linkend="menu-example"/>.
  *
- * <figure id="menu-example">
- *   <title>An example menu</title>
- *   <graphic fileref="menu-example.png" format="PNG"></graphic>
- * </figure>
+ * ## An example menu # {#menu-example}
+ *
+ * ![](menu-example.png)
  *
  * There are 8 "menus" visible in the screenshot: one menubar, two
  * submenus and 5 sections:
@@ -68,10 +67,9 @@
  * smaller blocks within the large block represent items in that menu. Some
  * items contain references to other menus.
  *
- * <figure id="menu-model">
- *   <title>A menu model</title>
- *   <graphic fileref="menu-model.png" format="PNG"></graphic>
- * </figure>
+ * ## A menu example # {#menu-model}
+ *
+ * ![](menu-model.png)
  *
  * Notice that the separators visible in <xref linkend="menu-example"/>
  * appear nowhere in <xref linkend="menu-model"/>. This is because

diff --git a/glib/gconvert.c b/glib/gconvert.c
index 62518c0f3f2ef76c990ebe37000a46cc18126a27..32a29bdd2e3284b70a409f94accea7fd808de2e1 100644 (file)
--- a/glib/gconvert.c
+++ b/glib/gconvert.c
@@ -122,10 +122,9 @@
  * these functions are used to convert between UTF-8 and the
  * encoding for file names in the file system.
  *
- * <figure id="file-name-encodings-diagram">
- * <title>Conversion between File Name Encodings</title>
- * <graphic fileref="file-name-encodings.png" format="PNG"/>
- * </figure>
+ * ## Conversion between file name encodings # {#file-name-encodings-diagram)
+ *
+ * ![](file-name-encodings.png)
  *
  * ## Checklist for Application Writers
  *

diff --git a/glib/gmain.c b/glib/gmain.c
index 5606cccbaf7ebdf284f74c7f31cf4942c21bf749..2ed34b9279418ad7564f0c7cd70864d0224d2b91 100644 (file)
--- a/glib/gmain.c
+++ b/glib/gmain.c
@@ -168,11 +168,12 @@
  * g_main_context_prepare(), g_main_context_query(),
  * g_main_context_check() and g_main_context_dispatch().
  *
+ * ## State of a Main Context # {#mainloop-states}
+ *
  * The operation of these functions can best be seen in terms
- * of a state diagram, as shown in <xref linkend="mainloop-states"/>.
- * <figure id="mainloop-states"><title>States of a Main Context</title>
- * <graphic fileref="mainloop-states.gif" format="GIF"></graphic>
- * </figure>
+ * of a state diagram, as shown in this image.
+ *
+ * ![](mainloop-states.gif)
  *
  * On UNIX, the GLib mainloop is incompatible with fork(). Any program
  * using the mainloop must either exec() or exit() from the child

diff --git a/glib/gstrfuncs.c b/glib/gstrfuncs.c
index 5cb22c627b85fe542f303a55b65ffe5a1fb2b6f3..a76449403408a301851dc9ffb62474ac43f3872f 100644 (file)
--- a/glib/gstrfuncs.c
+++ b/glib/gstrfuncs.c
@@ -401,8 +401,8 @@ g_memdup (gconstpointer mem,
  * %NULL it returns %NULL. The returned value should be freed when no longer
  * needed.
  *
- * To copy a number of characters from a UTF-8 encoded string, use
- * g_utf8_strncpy() instead.
+ * To copy a number of characters from a UTF-8 encoded string,
+ * use g_utf8_strncpy() instead.
  *
  * Returns: a newly-allocated buffer containing the first @n bytes
  *     of @str, nul-terminated