[gtk+] docs: Move documentation to inline comments: GtkToolbar

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

commit 38469882119926241d61dd79e9fec0dde7f8fda9
Author: Javier Jardón <jjardon gnome org>
Date:   Sun Oct 3 00:28:54 2010 +0200

    docs: Move documentation to inline comments: GtkToolbar

 docs/reference/gtk/tmpl/.gitignore      |    1 +
 docs/reference/gtk/tmpl/gtktoolbar.sgml |  305 -------------------------------
 gtk/gtktoolbar.c                        |   23 +++
 3 files changed, 24 insertions(+), 305 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 54e4684..57eac13 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -40,6 +40,7 @@ gtktesting.sgml
 gtktextiter.sgml
 gtktexttagtable.sgml
 gtktoggleaction.sgml
+gtktoolbar.sgml
 gtktoolitem.sgml
 gtktreednd.sgml
 gtktypeutils.sgml
diff --git a/gtk/gtktoolbar.c b/gtk/gtktoolbar.c
index 3a3d7af..7281544 100644
--- a/gtk/gtktoolbar.c
+++ b/gtk/gtktoolbar.c
@@ -59,6 +59,29 @@
 #include "gtkintl.h"
 
 
+/**
+ * SECTION:gtktoolbar
+ * @Short_description: Create bars of buttons and other widgets
+ * @Title: GtkToolbar
+ * @See_also: #GtkToolItem
+ *
+ * A toolbar is created with a call to gtk_toolbar_new().
+ *
+ * A toolbar can contain instances of a subclass of #GtkToolItem. To add
+ * a #GtkToolItem to the a toolbar, use gtk_toolbar_insert(). To remove
+ * an item from the toolbar use gtk_container_remove(). To add a button
+ * to the toolbar, add an instance of #GtkToolButton.
+ *
+ * Toolbar items can be visually grouped by adding instances of
+ * #GtkSeparatorToolItem to the toolbar. If the GtkToolbar child property
+ * "expand" is #TRUE and the property #GtkSeparatorToolItem:draw is set to
+ * #FALSE, the effect is to force all following items to the end of the toolbar.
+ *
+ * Creating a context menu for the toolbar can be done by connecting to
+ * the #GtkToolbar::popup-context-menu signal.
+ */
+
+
 typedef struct _ToolbarContent ToolbarContent;
 
 #define DEFAULT_IPADDING    0