[gtk+] Move documentation to inline comments: GtkMenuToolButton

[Javier Jardón <jjardon src gnome org>]

commit b398f96bede8c8fa7f92ce4d8429ca8a1bce3e88
Author: Javier Jardón <jjardon gnome org>
Date:   Fri Apr 15 00:08:33 2011 +0100

    Move documentation to inline comments: GtkMenuToolButton

 docs/reference/gtk/tmpl/.gitignore             |    1 +
 docs/reference/gtk/tmpl/gtkmenutoolbutton.sgml |  136 ------------------------
 gtk/gtkmenutoolbutton.c                        |   36 ++++++
 3 files changed, 37 insertions(+), 136 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index c21db50..65aa493 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -69,6 +69,7 @@ gtkmain.sgml
 gtkmenu.sgml
 gtkmenubar.sgml
 gtkmenushell.sgml
+gtkmenutoolbutton.sgml
 gtkmessagedialog.sgml
 gtkmisc.sgml
 gtknotebook.sgml
diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c
index e63d795..a042737 100644
--- a/gtk/gtkmenutoolbutton.c
+++ b/gtk/gtkmenutoolbutton.c
@@ -36,6 +36,42 @@
 #include "gtkintl.h"
 
 
+/**
+ * SECTION:gtkmenutoolbutton
+ * @Short_description: A GtkToolItem containing a button with an additional dropdown menu
+ * @Title: GtkMenuToolButton
+ * @See_also: #GtkToolbar, #GtkToolButton
+ *
+ * A #GtkMenuToolButton is a #GtkToolItem that contains a button and
+ * a small additional button with an arrow. When clicked, the arrow
+ * button pops up a dropdown menu.
+ *
+ * Use gtk_menu_tool_button_new() to create a new
+ * #GtkMenuToolButton. Use gtk_menu_tool_button_new_from_stock() to
+ * create a new #GtkMenuToolButton containing a stock item.
+ *
+ * <refsect2 id="GtkMenuToolButton-BUILDER-UI">
+ * <title>GtkMenuToolButton as GtkBuildable</title>
+ * <para>
+ * The GtkMenuToolButton implementation of the GtkBuildable interface
+ * supports adding a menu by specifying "menu" as the "type"
+ * attribute of a &lt;child&gt; element.
+ *
+ * <example>
+ * <title>A UI definition fragment with menus</title>
+ * <programlisting><![CDATA[
+ * <object class="GtkMenuToolButton">
+ *   <child type="menu">
+ *     <object class="GtkMenu"/>
+ *   </child>
+ * </object>
+ * ]]></programlisting>
+ * </example>
+ * </para>
+ * </refsect2>
+ */
+
+
 struct _GtkMenuToolButtonPrivate
 {
   GtkWidget *button;