docs: inline see_also to sections docs and add missing <variablelist>

This fixes docbook validation for the file.

diff --git a/docs/reference/gtk/tmpl/gtktoolitem.sgml b/docs/reference/gtk/tmpl/gtktoolitem.sgml
index a7a30455b0cd39f320840792766c838fbff71802..348de3fc99dd694340e1f3aa5910107b33565f05 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktoolitem.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolitem.sgml
@@ -12,23 +12,6 @@ GtkToolItem
 <!-- ##### SECTION See_Also ##### -->
 <para>
 
-<varlistentry>
-  <term>#GtkToolbar</term>
-  <listitem><para>The toolbar widget</para></listitem>
-</varlistentry>
-
-<varlistentry>
-  <term>#GtkToolButton</term>
-  <listitem><para>A subclass of #GtkToolItem that displays buttons on
-      the toolbar</para></listitem>
-</varlistentry>
-
-<varlistentry>
-  <term>#GtkSeparatorToolItem</term>
-  <listitem><para>A subclass of #GtkToolItem that separates groups of
-      items on a toolbar</para></listitem>
-</varlistentry>
-
 </para>
 
 <!-- ##### SECTION Stability_Level ##### -->

diff --git a/gtk/gtktoolitem.c b/gtk/gtktoolitem.c
index 9c00b0dab23474be875c08a6478a30f41e0dda4b..7393f7e979ba7c628d083135c3b27553bf23b824 100644 (file)
--- a/gtk/gtktoolitem.c
+++ b/gtk/gtktoolitem.c
@@ -39,6 +39,22 @@
 /**
  * SECTION:gtktoolitem
  * @short_description: The base class of widgets that can be added to GtkToolShell
+ * @see_also: <variablelist>
+ *   <varlistentry>
+ *     <term>#GtkToolbar</term>
+ *     <listitem><para>The toolbar widget</para></listitem>
+ *   </varlistentry>
+ *   <varlistentry>
+ *     <term>#GtkToolButton</term>
+ *     <listitem><para>A subclass of #GtkToolItem that displays buttons on
+ *         the toolbar</para></listitem>
+ *   </varlistentry>
+ *   <varlistentry>
+ *     <term>#GtkSeparatorToolItem</term>
+ *     <listitem><para>A subclass of #GtkToolItem that separates groups of
+ *         items on a toolbar</para></listitem>
+ *   </varlistentry>
+ * </variablelist>
  *
  * #GtkToolItem<!-- -->s are widgets that can appear on a toolbar. To
  * create a toolbar item that contain something else than a button, use