Require gtk-doc 1.8

2007-11-25  Matthias Clasen  <mclasen@redhat.com>

        * configure.in: Require gtk-doc 1.8

        * */*.c: Use gtk-doc abbreviations for examples in docs.


svn path=/trunk/; revision=19041

3 files changed, 18 insertions, 19 deletions

diff --git a/gdk/gdk.c b/gdk/gdk.c
index cf14ac4658..a61543ae56 100644
--- a/gdk/gdk.c
+++ b/gdk/gdk.c
@@ -504,18 +504,18 @@ gdk_threads_dispatch_free (gpointer data)
  * running in thread A and accessing @self after it has been finalized
  * in thread B:
  *
- * <informalexample><programlisting>
+ * |[
  * static gboolean
  * idle_callback (gpointer data)
  * {
- *    // gdk_threads_enter(); would be needed for g_idle_add()
+ *    /&ast; gdk_threads_enter(); would be needed for g_idle_add() &ast;/
  *
  *    SomeWidget *self = data;
- *    /<!-- -->* do stuff with self *<!-- -->/
+ *    /&ast; do stuff with self &ast;/
  *
  *    self->idle_id = 0;
  *
- *    // gdk_threads_leave(); would be needed for g_idle_add()
+ *    /&ast; gdk_threads_leave(); would be needed for g_idle_add() &ast;/
  *    return FALSE;
  * }
  *
@@ -523,7 +523,7 @@ gdk_threads_dispatch_free (gpointer data)
  * some_widget_do_stuff_later (SomeWidget *self)
  * {
  *    self->idle_id = gdk_threads_add_idle (idle_callback, self)
- *    // using g_idle_add() here would require thread protection in the callback
+ *    /&ast; using g_idle_add() here would require thread protection in the callback &ast;/
  * }
  *
  * static void
@@ -534,7 +534,7 @@ gdk_threads_dispatch_free (gpointer data)
  *      g_source_remove (self->idle_id);
  *    G_OBJECT_CLASS (parent_class)->finalize (object);
  * }
- * </programlisting></informalexample>
+ * ]|
  *
  * Return value: the ID (greater than 0) of the event source.
  *
@@ -610,12 +610,12 @@ gdk_threads_add_idle (GSourceFunc    function,
  * This variant of g_timeout_add_full() can be thought of a MT-safe version 
  * for GTK+ widgets for the following use case:
  *
- * <informalexample><programlisting>
+ * |[
  * static gboolean timeout_callback (gpointer data)
  * {
  *    SomeWidget *self = data;
  *    
- *    /<!-- -->* do stuff with self *<!-- -->/
+ *    /&ast; do stuff with self &ast;/
  *    
  *    self->timeout_id = 0;
  *    
@@ -629,14 +629,14 @@ gdk_threads_add_idle (GSourceFunc    function,
  *  
  * static void some_widget_finalize (GObject *object)
  * {
- *    SomeWidget *self = SOME_WIDGET(object);
+ *    SomeWidget *self = SOME_WIDGET (object);
  *    
  *    if (self->timeout_id)
  *      g_source_remove (self->timeout_id);
  *    
  *    G_OBJECT_CLASS (parent_class)->finalize (object);
  * }
- * </programlisting></informalexample>
+ * ]|
  *
  * Return value: the ID (greater than 0) of the event source.
  * 
diff --git a/gdk/gdkdisplaymanager.c b/gdk/gdkdisplaymanager.c
index dc98b1a28b..77c5a0578c 100644
--- a/gdk/gdkdisplaymanager.c
+++ b/gdk/gdkdisplaymanager.c
@@ -188,10 +188,8 @@ gdk_display_manager_get_default_display (GdkDisplayManager *display_manager)
  * gdk_display_get_default:
  *
  * Gets the default #GdkDisplay. This is a convenience
- * function for:
- * <programlisting>
- *   gdk_display_manager_get_default_display (gdk_display_manager_get ())
- * </programlisting>
+ * function for
+ * <literal>gdk_display_manager_get_default_display (gdk_display_manager_get ())</literal>.
  * 
  * Returns: a #GdkDisplay, or %NULL if there is no default
  *   display.
diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index 1c58aadc89..f81d5eb363 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -843,14 +843,15 @@ gdk_event_get_axis (GdkEvent   *event,
  * core pointer. Coordinate extraction, processing and requesting more
  * motion events from a %GDK_MOTION_NOTIFY event usually works like this:
  *
- * <informalexample><programlisting>
- * {  // motion_event handler
+ * |[
+ * { 
+ *   /&ast; motion_event handler &ast;/
  *   x = motion_event->x;
  *   y = motion_event->y;
- *   ; // handle (x,y) motion
- *   gdk_event_request_motions (motion_event); // handles is_hint events
+ *   /&ast; handle (x,y) motion &ast;/
+ *   gdk_event_request_motions (motion_event); /&ast; handles is_hint events &ast;/
  * }
- * </programlisting></informalexample>
+ * ]|
  *
  * Since: 2.12
  **/