docs: don't use <variablelist>

2 files changed, 64 insertions, 82 deletions

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:
  *
- * <variablelist>
- * <varlistentry>
- * <term>stock-id</term>
- * <listitem><para>
- * The stock id of the source, a string.
- * This attribute is mandatory
- * </para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>filename</term>
- * <listitem><para>
- * The filename of the source, a string.
- * This attribute is optional
- * </para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>icon-name</term>
- * <listitem><para>
- * The icon name for the source, a string.
- * This attribute is optional.
- * </para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>size</term>
- * <listitem><para>
- * Size of the icon, a #GtkIconSize enum value.
- * This attribute is optional.
- * </para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>direction</term>
- * <listitem><para>
- * Direction of the source, a #GtkTextDirection enum value.
- * This attribute is optional.
- * </para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>state</term>
- * <listitem><para>
- * State of the source, a #GtkStateType enum value.
- * This attribute is optional.
- * </para></listitem>
- * </varlistentry>
- * </variablelist>
+ * - 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:
  *
- * <variablelist>
- * <varlistentry>
- * <term>menubar</term>
- * <listitem><para>a #GtkMenuBar</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>toolbar</term>
- * <listitem><para>a #GtkToolbar</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>popup</term>
- * <listitem><para>a toplevel #GtkMenu</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>menu</term>
- * <listitem><para>a #GtkMenu attached to a menuitem</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>menuitem</term>
- * <listitem><para>a #GtkMenuItem subclass, the exact type depends on the
- * action</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>toolitem</term>
- * <listitem><para>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.</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>separator</term>
- * <listitem><para>a #GtkSeparatorMenuItem or
- * #GtkSeparatorToolItem</para></listitem>
- * </varlistentry>
- * <varlistentry>
- * <term>accelerator</term>
- * <listitem><para>a keyboard accelerator</para></listitem>
- * </varlistentry>
- * </variablelist>
+ * - 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