[gtk+] docs: don't use <variablelist>



commit 446095f9ab27268e9e06e2e2920866339b8cc11c
Author: William Jon McCann <william jon mccann gmail com>
Date:   Tue Feb 4 19:40:34 2014 -0500

    docs: don't use <variablelist>

 gtk/deprecated/gtkiconfactory.c |   74 ++++++++++++++++-----------------------
 gtk/deprecated/gtkuimanager.c   |   72 ++++++++++++++++++--------------------
 2 files changed, 64 insertions(+), 82 deletions(-)
---
diff --git a/gtk/deprecated/gtkiconfactory.c b/gtk/deprecated/gtkiconfactory.c
index efb8dd1..dc0f4a6 100644
--- a/gtk/deprecated/gtkiconfactory.c
+++ b/gtk/deprecated/gtkiconfactory.c
@@ -76,50 +76,36 @@
  * multiple &lt;source&gt; 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 edad1b1..429ff35 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


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]