From fbb57d301dd41318ef58a2f5cd3a3415b889a432 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Wed, 13 Apr 2011 20:37:21 +0100
Subject: [PATCH] Move documentation to inline comments: GtkToggleToolButton

---
 docs/reference/gtk/tmpl/.gitignore            |   1 +
 .../gtk/tmpl/gtktoggletoolbutton.sgml         | 105 ------------------
 gtk/gtktoggletoolbutton.c                     |  15 +++
 3 files changed, 16 insertions(+), 105 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index ae6f64520c..409c0e8bd5 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -103,6 +103,7 @@ gtktexttag.sgml
 gtktexttagtable.sgml
 gtktextview.sgml
 gtktoggleaction.sgml
+gtktoggletoolbutton.sgml
 gtktoolbar.sgml
 gtktoolitem.sgml
 gtktooltip.sgml
diff --git a/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml b/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
deleted file mode 100644
index 738e4b9291..0000000000
--- a/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
+++ /dev/null
@@ -1,105 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkToggleToolButton
-
-<!-- ##### SECTION Short_Description ##### -->
-A GtkToolItem containing a toggle button
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-  A #GtkToggleToolButton is a #GtkToolItem that contains a toggle
-  button.
-</para>
-
-<para>
-  Use gtk_toggle_tool_button_new() to create a new
-  #GtkToggleToolButton. Use gtk_toggle_tool_button_new_from_stock() to
-  create a new #GtkToggleToolButton containing a stock item.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-
-<para>
-  <variablelist>
-    <varlistentry>
-      <term>#GtkToolbar</term>
-      <listitem><para>The toolbar widget</para></listitem>
-      <term>#GtkToolButton</term>
-      <listitem>
-        <para>
-          The parent class of #GtkToggleToolButton. The properties
-          "label_widget", "label", "icon_widget", and "stock_id" on
-          #GtkToolButton determine the label and icon used on
-          #GtkToggleToolButton<!-- -->s.
-        </para>
-      </listitem>
-      <term>#GtkSeparatorToolItem</term>
-      <listitem>
-        <para>A subclass of #GtkToolItem that separates groups of
-          items on a toolbar.
-        </para>
-      </listitem>
-    </varlistentry>
-  </variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkToggleToolButton ##### -->
-<para>
-  The #GtkToggleToolButton struct contains only private data and
-  should only be accessed through the functions described below.
-</para>
-
-
-<!-- ##### SIGNAL GtkToggleToolButton::toggled ##### -->
-<para>
-
-</para>
-
-@toggletoolbutton: the object which received the signal.
-
-<!-- ##### ARG GtkToggleToolButton:active ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_new_from_stock ##### -->
-<para>
-
-</para>
-
-@stock_id: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_set_active ##### -->
-<para>
-
-</para>
-
-@button: 
-@is_active: 
-
-
-<!-- ##### FUNCTION gtk_toggle_tool_button_get_active ##### -->
-<para>
-
-</para>
-
-@button: 
-@Returns: 
-
-
diff --git a/gtk/gtktoggletoolbutton.c b/gtk/gtktoggletoolbutton.c
index e6cea93c93..9207ca6341 100644
--- a/gtk/gtktoggletoolbutton.c
+++ b/gtk/gtktoggletoolbutton.c
@@ -32,6 +32,21 @@
 #include "gtkprivate.h"
 
 
+/**
+ * SECTION:gtktoggletoolbutton
+ * @Short_description: A GtkToolItem containing a toggle button
+ * @Title: GtkToggleToolButton
+ * @See_also: #GtkToolbar, #GtkToolButton, #GtkSeparatorToolItem
+ *
+ * A #GtkToggleToolButton is a #GtkToolItem that contains a toggle
+ * button.
+ *
+ * Use gtk_toggle_tool_button_new() to create a new
+ * #GtkToggleToolButton. Use gtk_toggle_tool_button_new_from_stock() to
+ * create a new #GtkToggleToolButton containing a stock item.
+ */
+
+
 #define MENU_ID "gtk-toggle-tool-button-menu-id"
 
 enum {