diff --git a/gtk/deprecated/gtkiconfactory.c b/gtk/deprecated/gtkiconfactory.c
index efb8dd1512..dc0f4a674d 100644
--- a/gtk/deprecated/gtkiconfactory.c
+++ b/gtk/deprecated/gtkiconfactory.c
@@ -76,50 +76,36 @@
* multiple <source> elements.
* The following attributes are allowed:
*
- *
- *
- * stock-id
- *
- * The stock id of the source, a string.
- * This attribute is mandatory
- *
- *
- *
- * filename
- *
- * The filename of the source, a string.
- * This attribute is optional
- *
- *
- *
- * icon-name
- *
- * The icon name for the source, a string.
- * This attribute is optional.
- *
- *
- *
- * size
- *
- * Size of the icon, a #GtkIconSize enum value.
- * This attribute is optional.
- *
- *
- *
- * direction
- *
- * Direction of the source, a #GtkTextDirection enum value.
- * This attribute is optional.
- *
- *
- *
- * state
- *
- * State of the source, a #GtkStateType enum value.
- * This attribute is optional.
- *
- *
- *
+ * - stock-id
+ *
+ * The stock id of the source, a string. This attribute is
+ * mandatory
+ *
+ * - filename
+ *
+ * The filename of the source, a string. This attribute is
+ * optional
+ *
+ * - icon-name
+ *
+ * The icon name for the source, a string. This attribute is
+ * optional.
+ *
+ * - size
+ *
+ * Size of the icon, a #GtkIconSize enum value. This attribute is
+ * optional.
+ *
+ * - direction
+ *
+ * Direction of the source, a #GtkTextDirection enum value. This
+ * attribute is optional.
+ *
+ * - state
+ *
+ * State of the source, a #GtkStateType enum value. This
+ * attribute is optional.
+ *
*
* ## A #GtkIconFactory UI definition fragment. ##
*
diff --git a/gtk/deprecated/gtkuimanager.c b/gtk/deprecated/gtkuimanager.c
index edad1b1bae..429ff350f2 100644
--- a/gtk/deprecated/gtkuimanager.c
+++ b/gtk/deprecated/gtkuimanager.c
@@ -155,44 +155,40 @@
* parents. The correspondence of XML elements to widgets should be
* almost obvious:
*
- *
- *
- * menubar
- * a #GtkMenuBar
- *
- *
- * toolbar
- * a #GtkToolbar
- *
- *
- * popup
- * a toplevel #GtkMenu
- *
- *
- * menu
- * a #GtkMenu attached to a menuitem
- *
- *
- * menuitem
- * a #GtkMenuItem subclass, the exact type depends on the
- * action
- *
- *
- * toolitem
- * a #GtkToolItem subclass, the exact type depends on the
- * action. Note that toolitem elements may contain a menu element, but only
- * if their associated action specifies a #GtkMenuToolButton as proxy.
- *
- *
- * separator
- * a #GtkSeparatorMenuItem or
- * #GtkSeparatorToolItem
- *
- *
- * accelerator
- * a keyboard accelerator
- *
- *
+ * - menubar
+ *
+ * a #GtkMenuBar
+ *
+ * - toolbar
+ *
+ * a #GtkToolbar
+ *
+ * - popup
+ *
+ * a toplevel #GtkMenu
+ *
+ * - menu
+ *
+ * a #GtkMenu attached to a menuitem
+ *
+ * - menuitem
+ *
+ * a #GtkMenuItem subclass, the exact type depends on the action
+ *
+ * - toolitem
+ *
+ * a #GtkToolItem subclass, the exact type depends on the
+ * action. Note that toolitem elements may contain a menu element,
+ * but only if their associated action specifies a
+ * #GtkMenuToolButton as proxy.
+ *
+ * - separator
+ *
+ * a #GtkSeparatorMenuItem or #GtkSeparatorToolItem
+ *
+ * - accelerator
+ *
+ * a keyboard accelerator
*
* The "position" attribute determines where a constructed widget is positioned
* wrt. to its siblings in the partially constructed tree. If it is