From 7ee963c26001cc2854b935ec3597a0fb4a51b33d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Fri, 15 Apr 2011 17:26:46 +0100
Subject: [PATCH] Move documentation to inline comments: GtkRadioToolButton

---
 docs/reference/gtk/tmpl/.gitignore            |   1 +
 .../gtk/tmpl/gtkradiotoolbutton.sgml          | 131 ------------------
 gtk/gtkradiotoolbutton.c                      |  20 +++
 3 files changed, 21 insertions(+), 131 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 84d3c3644d..8bc887a70a 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -86,6 +86,7 @@ gtkprintoperation.sgml
 gtkprogressbar.sgml
 gtkradioaction.sgml
 gtkradiobutton.sgml
+gtkradiotoolbutton.sgml
 gtkrange.sgml
 gtkrecentaction.sgml
 gtkrecentchooser.sgml
diff --git a/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml b/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml
deleted file mode 100644
index 61876786e7..0000000000
--- a/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml
+++ /dev/null
@@ -1,131 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkRadioToolButton
-
-<!-- ##### SECTION Short_Description ##### -->
-A toolbar item that contains a radio button
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-A #GtkRadioToolButton is a #GtkToolItem that contains a radio button,
-that is, a button that is part of a group of toggle buttons where only
-one button can be active at a time.
-</para>
-
-<para>
-Use gtk_radio_tool_button_new() to create a new
-#GtkRadioToolButton. use gtk_radio_tool_button_new_from_widget() to
-create a new #GtkRadioToolButton that is part of the same group as an
-existing #GtkRadioToolButton. Use
-gtk_radio_tool_button_new_from_stock() or
-gtk_radio_tool_button_new_from_widget_with_stock() to create a new
-#GtkRAdioToolButton containing a stock item.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-<variablelist>
-
-<varlistentry>
-<term>#GtkToolbar</term>
-<listitem><para>The toolbar widget</para></listitem>
-</varlistentry>
-
-<varlistentry>
-  <term>#GtkToolButton</term>
-  <listitem><para>
-      An ancestor class of GtkRadioToolButton. The properties
-      "label_widget", "label", "icon_widget", and "stock_id" on
-      #GtkToolButton determine the label and icon used on a
-      #GtkRadioToolButton.
-  </para></listitem>
-</varlistentry>
-
-<varlistentry>
-  <term>#GtkSeparatorToolItem</term>
-  <listitem>
-    <para>A subclass of #GtkToolItem that separates groups of
-      items on a toolbar. It is usually a good idea to put a separator
-      before and after a group of #GtkRadioToolButtons on a #GtkToolbar.
-    </para>
-  </listitem>
-</varlistentry>
-
-</variablelist>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkRadioToolButton ##### -->
-<para>
-  The #GtkRadioToolButton contains only private data and should only
-  be accessed through the functions described below.
-</para>
-
-
-<!-- ##### ARG GtkRadioToolButton:group ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_radio_tool_button_new ##### -->
-<para>
-
-</para>
-
-@group: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_radio_tool_button_new_from_stock ##### -->
-<para>
-
-</para>
-
-@group: 
-@stock_id: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_radio_tool_button_new_from_widget ##### -->
-<para>
-
-</para>
-
-@group: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_radio_tool_button_new_with_stock_from_widget ##### -->
-<para>
-
-</para>
-
-@group: 
-@stock_id: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_radio_tool_button_get_group ##### -->
-<para>
-
-</para>
-
-@button: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_radio_tool_button_set_group ##### -->
-<para>
-
-</para>
-
-@button: 
-@group: 
-
-
diff --git a/gtk/gtkradiotoolbutton.c b/gtk/gtkradiotoolbutton.c
index 6ca58532eb..56f45e3dd8 100644
--- a/gtk/gtkradiotoolbutton.c
+++ b/gtk/gtkradiotoolbutton.c
@@ -27,6 +27,26 @@
 #include "gtkprivate.h"
 
 
+/**
+ * SECTION:gtkradiotoolbutton
+ * @Short_description: A toolbar item that contains a radio button
+ * @Title: GtkRadioToolButton
+ * @See_also: #GtkToolbar, #GtkToolButton
+ *
+ * A #GtkRadioToolButton is a #GtkToolItem that contains a radio button,
+ * that is, a button that is part of a group of toggle buttons where only
+ * one button can be active at a time.
+ *
+ * Use gtk_radio_tool_button_new() to create a new
+ * #GtkRadioToolButton. Use gtk_radio_tool_button_new_from_widget() to
+ * create a new #GtkRadioToolButton that is part of the same group as an
+ * existing #GtkRadioToolButton. Use
+ * gtk_radio_tool_button_new_from_stock() or
+ * gtk_radio_tool_button_new_with_stock_from_widget() create a new
+ * #GtkRadioToolButton containing a stock item.
+ */
+
+
 enum {
   PROP_0,
   PROP_GROUP