docs: Remove leftover DocBook tags

We use markdown for the documentation.

clutter/clutter-color.c

@@ -615,10 +615,9 @@ parse_hsla (ClutterColor *color,
  * @color: (out caller-allocates): return location for a #ClutterColor
  * @str: a string specifiying a color
  *
- * Parses a string definition of a color, filling the
+ * Parses a string definition of a color, filling the #ClutterColor.red,
- * <structfield>red</structfield>, <structfield>green</structfield>, 
+ * #ClutterColor.green, #ClutterColor.blue and #ClutterColor.alpha fields 
- * <structfield>blue</structfield> and <structfield>alpha</structfield> 
+ * of @color.
- * channels of @color.
  *
  * The @color is not allocated.
  *

clutter/clutter-main.c

@@ -3480,7 +3480,7 @@ clutter_check_version (guint major,
  * clutter_get_default_text_direction:
  *
  * Retrieves the default direction for the text. The text direction is
- * determined by the locale and/or by the <varname>CLUTTER_TEXT_DIRECTION</varname>
+ * determined by the locale and/or by the `CLUTTER_TEXT_DIRECTION`
  * environment variable.
  *
  * The default text direction can be overridden on a per-actor basis by using

clutter/clutter-paint-node.c

@@ -44,8 +44,8 @@
 /**
  * ClutterPaintNode: (ref-func clutter_paint_node_ref) (unref-func clutter_paint_node_unref) (set-value-func clutter_value_set_paint_node) (get-value-func clutter_value_get_paint_node)
  *
- * The <structname>ClutterPaintNode</structname> structure contains only
+ * The `ClutterPaintNode` structure contains only private data
- * private data and it should be accessed using the provided API.
+ * and it should be accessed using the provided API.
  *
  * Since: 1.10
  */
@@ -53,8 +53,7 @@
 /**
  * ClutterPaintNodeClass:
  *
- * The <structname>ClutterPaintNodeClass</structname> structure contains
+ * The `ClutterPaintNodeClass` structure contains only private data.
- * only private data.
  *
  * Since: 1.10
  */

clutter/clutter-paint-nodes.c

@@ -358,7 +358,7 @@ struct _ClutterPipelineNode
 /**
  * ClutterPipelineNodeClass:
  *
- * The <structname>ClutterPipelineNodeClass</structname> structure is an opaque
+ * The `ClutterPipelineNodeClass` structure is an opaque
  * type whose members cannot be directly accessed.
  *
  * Since: 1.10
@@ -552,7 +552,7 @@ struct _ClutterColorNode
 /**
  * ClutterColorNodeClass:
  *
- * The <structname>ClutterColorNodeClass</structname> structure is an
+ * The `ClutterColorNodeClass` structure is an
  * opaque type whose members cannot be directly accessed.
  *
  * Since: 1.10
@@ -627,7 +627,7 @@ struct _ClutterTextureNode
 /**
  * ClutterTextureNodeClass:
  *
- * The <structname>ClutterTextureNodeClass</structname> structure is an
+ * The `ClutterTextureNodeClass` structure is an
  * opaque type whose members cannot be directly accessed.
  *
  * Since: 1.10
@@ -744,7 +744,7 @@ struct _ClutterTextNode
 /**
  * ClutterTextNodeClass:
  *
- * The <structname>ClutterTextNodeClass</structname> structure is an opaque
+ * The `ClutterTextNodeClass` structure is an opaque
  * type whose contents cannot be directly accessed.
  *
  * Since: 1.10
@@ -948,7 +948,7 @@ struct _ClutterClipNode
 /**
  * ClutterClipNodeClass:
  *
- * The <structname>ClutterClipNodeClass</structname> structure is an opaque
+ * The `ClutterClipNodeClass` structure is an opaque
  * type whose members cannot be directly accessed.
  *
  * Since: 1.10

clutter/clutter-script.c

@@ -130,9 +130,8 @@
  * ]]></programlisting></informalexample>
  *
  * Implicitely defined #ClutterAlpha<!-- -->s and #ClutterTimeline<!-- -->s
- * can omit the <varname>id</varname> member, as well as the
+ * can omit the `id`, as well as the `type` members, but will not be available
- * <varname>type</varname> member, but will not be available using
+ * using clutter_script_get_object() (they can, however, be extracted using the
- * clutter_script_get_object() (they can, however, be extracted using the
  * #ClutterBehaviour and #ClutterAlpha API respectively).
  *
  * Signal handlers can be defined inside a Clutter UI definition file and

clutter/clutter-settings.c

@@ -43,7 +43,7 @@
 /**
  * ClutterSettings:
  *
- * <structname>ClutterSettings</structname> is an opaque structure whose
+ * `ClutterSettings` is an opaque structure whose
  * members cannot be directly accessed.
  *
  * Since: 1.4

clutter/x11/clutter-backend-x11.c

@@ -1402,12 +1402,10 @@ _clutter_backend_x11_get_visual_info (ClutterBackendX11 *backend_x11)
 /**
  * clutter_x11_get_visual_info: (skip)
  *
- * Retrieves the <structname>XVisualInfo</structname> used by the Clutter X11
+ * Retrieves the `XVisualInfo` used by the Clutter X11 backend.
- * backend.
  *
- * Return value: (transfer full): a <structname>XVisualInfo</structname>, or
+ * Return value: (transfer full): a `XVisualInfo`, or `None`.
- *   <varname>None</varname>. The returned value should be freed using XFree()
+ *   The returned value should be freed using `XFree()` when done
- *   when done
  *
  * Since: 1.2
  */