docs: replace all <examples> with markdown headings

5 files changed, 13 insertions, 14 deletions

diff --git a/gdk/gdkapplaunchcontext.c b/gdk/gdkapplaunchcontext.c
index 22e517790c..f84367da55 100644
--- a/gdk/gdkapplaunchcontext.c
+++ b/gdk/gdkapplaunchcontext.c
@@ -34,8 +34,9 @@
  * handles launching an application in a graphical context. It provides
  * startup notification and allows to launch applications on a specific
  * screen or workspace.
- * <example>
- * <title>Launching an application</title>
+ *
+ * ## Launching an application
+ *
  * |[<!-- language="C" -->
  * GdkAppLaunchContext *context;
  *
@@ -49,7 +50,6 @@
  *
  * g_object_unref (context);
  * ]|
- * </example>
  */
 
 
diff --git a/gdk/gdkdevicemanager.c b/gdk/gdkdevicemanager.c
index cb2f227d7e..ace175d0e5 100644
--- a/gdk/gdkdevicemanager.c
+++ b/gdk/gdkdevicemanager.c
@@ -77,7 +77,8 @@
  * be controlling each of these virtual devices. Physical devices may also
  * be "floating", which means they are not attached to any virtual device.
  *
- * <example><title>Master and slave devices</title>
+ * ## Master and slave devices
+ *
  * <screen>
  * carlos@sacarino:~$ xinput list
  * ⎡ Virtual core pointer                          id=2    [master pointer  (3)]
@@ -96,7 +97,6 @@
  *     ↳ AT Translated Set 2 keyboard              id=12   [slave  keyboard (3)]
  *     ↳ ThinkPad Extra Buttons                    id=15   [slave  keyboard (3)]
  * </screen>
- * </example>
  *
  * By default, GDK will automatically listen for events coming from all
  * master devices, setting the #GdkDevice for all events coming from input
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index 39f310e7c8..c7cfabdfb4 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -2107,8 +2107,8 @@ static GQueue gdk_error_traps = G_QUEUE_INIT;
  * You can use gdk_x11_display_error_trap_push() to ignore errors
  * on only a single display.
  *
-* <example>
- * <title>Trapping an X error</title>
+ * ## Trapping an X error
+ *
  * |[<!-- language="C" -->
  * gdk_error_trap_push (<!-- -->);
  *
@@ -2120,7 +2120,6 @@ static GQueue gdk_error_traps = G_QUEUE_INIT;
  *    // ... Handle the error here ...
  *  }
  * ]|
- * </example>
  */
 void
 gdk_error_trap_push (void)
diff --git a/gdk/gdkdisplaymanager.c b/gdk/gdkdisplaymanager.c
index 98700373d3..193164a68c 100644
--- a/gdk/gdkdisplaymanager.c
+++ b/gdk/gdkdisplaymanager.c
@@ -85,8 +85,8 @@
  * you are building your application against. At runtime, use type-check
  * macros like GDK_IS_X11_DISPLAY() to find out which backend is in use:
  *
- * <example id="backend-specific">
- * <title>Backend-specific code</title>
+ * ## Backend-specific code ## {#backend-specific}
+ *
  * |[<!-- language="C" -->
  * #ifdef GDK_WINDOWING_X11
  *   if (GDK_IS_X11_DISPLAY (display))
@@ -104,7 +104,6 @@
  * #endif
  *   g_error ("Unsupported GDK backend");
  * ]|
- * </example>
  */
 
 
diff --git a/gdk/gdkpango.c b/gdk/gdkpango.c
index 9b2b8542cd..b1d4eca2c7 100644
--- a/gdk/gdkpango.c
+++ b/gdk/gdkpango.c
@@ -49,8 +49,9 @@
  *
  * Rendering a Pango layout is done most simply with pango_cairo_show_layout();
  * you can also draw pieces of the layout with pango_cairo_show_layout_line().
- * <example id="rotated-example">
- * <title>Draw transformed text with Pango and cairo</title>
+ *
+ * ## Draw transformed text with Pango and cairo ## {#rotated-example}
+ *
  * <!-- Note that this example is basically the same as
  *      demos/gtk-demo/rotated_text.c -->
  * |[<!-- language="C" -->
@@ -117,7 +118,7 @@
  * g_object_unref (layout);
  * g_object_unref (context);
  * ]|
- * </example>
+ *
  * <figure>
  *   <title>Output of <xref linkend="rotated-example"/></title>
  *   <graphic fileref="rotated-text.png" format="PNG"/>