[gtk+] Move documentation to inline comments: GtkSeparatorToolItem

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

commit 98e773d93def3e9c24ae040d256f81ba16491ce8
Author: Javier Jardón <jjardon gnome org>
Date:   Sun May 16 02:31:45 2010 +0200

    Move documentation to inline comments: GtkSeparatorToolItem

 docs/reference/gtk/tmpl/.gitignore                |    1 +
 docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml |   81 ---------------------
 gtk/gtkseparatortoolitem.c                        |   20 +++++
 3 files changed, 21 insertions(+), 81 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index c870daa..0dc5174 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -13,6 +13,7 @@ gtkrecentchooserwidget.sgml
 gtkscalebutton.sgml
 gtkseparator.sgml
 gtkseparatormenuitem.sgml
+gtkseparatortoolitem.sgml
 gtkstyle.sgml
 gtktesting.sgml
 gtktextiter.sgml
diff --git a/gtk/gtkseparatortoolitem.c b/gtk/gtkseparatortoolitem.c
index 4aa4b15..2a35efe 100644
--- a/gtk/gtkseparatortoolitem.c
+++ b/gtk/gtkseparatortoolitem.c
@@ -27,6 +27,26 @@
 #include "gtkprivate.h"
 #include "gtkalias.h"
 
+
+/**
+ * SECTION:gtkseparatortoolitem
+ * @Short_description: A toolbar item that separates groups of other
+ *   toolbar items
+ * @Title: GtkSeparatorToolItem
+ * @See_also: #GtkToolbar, #GtkRadioToolButton
+ *
+ * A #GtkSeparatorItem is a #GtkToolItem that separates groups of other
+ * #GtkToolItems. Depending on the theme, a #GtkSeparatorToolItem will
+ * often look like a vertical line on horizontally docked toolbars.
+ *
+ * If the #GtkToolbar child property "expand" is %TRUE and the property
+ * #GtkSeparatorToolItem:draw is %FALSE, a #GtkSeparatorToolItem will act as
+ * a "spring" that forces other items to the ends of the toolbar.
+ *
+ * Use gtk_separator_tool_item_new() to create a new #GtkSeparatorToolItem.
+ */
+
+
 #define MENU_ID "gtk-separator-tool-item-menu-id"
 
 enum {