From 15d1d8bb3b3c408002aaac19566b5d1f23a04aa0 Mon Sep 17 00:00:00 2001
From: Steven Harms <sharms@ubuntu.com>
Date: Wed, 3 Mar 2010 18:35:45 -0500
Subject: [PATCH] Move documentation to inline comments: GtkVSeparator

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=611662
---
 docs/reference/gtk/tmpl/gtkvseparator.sgml | 41 ----------------------
 gtk/gtkvseparator.c                        | 18 ++++++++++
 gtk/gtkvseparator.h                        |  6 ++++
 3 files changed, 24 insertions(+), 41 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkvseparator.sgml

diff --git a/docs/reference/gtk/tmpl/gtkvseparator.sgml b/docs/reference/gtk/tmpl/gtkvseparator.sgml
deleted file mode 100644
index 02ce8b15ff..0000000000
--- a/docs/reference/gtk/tmpl/gtkvseparator.sgml
+++ /dev/null
@@ -1,41 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkVSeparator
-
-<!-- ##### SECTION Short_Description ##### -->
-A vertical separator
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkVSeparator widget is a vertical separator, used to group the
-widgets within a window. It displays a vertical line with a shadow to
-make it appear sunken into the interface.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<variablelist>
-<varlistentry>
-<term>#GtkHSeparator</term>
-<listitem><para>a horizontal separator.</para></listitem>
-</varlistentry>
-</variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkVSeparator ##### -->
-<para>
-The #GtkVSeparator-struct struct contains private data only, and
-should be accessed using the functions below.
-</para>
-
-
-<!-- ##### FUNCTION gtk_vseparator_new ##### -->
-<para>
-Creates a new #GtkVSeparator.
-</para>
-
-@Returns: a new #GtkVSeparator.
-
-
diff --git a/gtk/gtkvseparator.c b/gtk/gtkvseparator.c
index 855c1688ce..77c3f59856 100644
--- a/gtk/gtkvseparator.c
+++ b/gtk/gtkvseparator.c
@@ -30,6 +30,17 @@
 #include "gtkvseparator.h"
 #include "gtkalias.h"
 
+/**
+ * SECTION:gtkvseparator
+ * @Short_description: A vertical separator
+ * @Title: GtkVSeparator
+ * @See_also: #GtkHSeparator
+ *
+ * The #GtkVSeparator widget is a vertical separator, used to group the
+ * widgets within a window. It displays a vertical line with a shadow to
+ * make it appear sunken into the interface.
+ */
+
 G_DEFINE_TYPE (GtkVSeparator, gtk_vseparator, GTK_TYPE_SEPARATOR)
 
 static void
@@ -44,6 +55,13 @@ gtk_vseparator_init (GtkVSeparator *vseparator)
                                   GTK_ORIENTATION_VERTICAL);
 }
 
+/**
+ * gtk_vseparator_new:
+ *
+ * Creates a new #GtkVSeparator.
+ *
+ * Returns: a new #GtkVSeparator.
+ */
 GtkWidget *
 gtk_vseparator_new (void)
 {
diff --git a/gtk/gtkvseparator.h b/gtk/gtkvseparator.h
index ee97ee0690..a82ebfe10a 100644
--- a/gtk/gtkvseparator.h
+++ b/gtk/gtkvseparator.h
@@ -49,6 +49,12 @@ G_BEGIN_DECLS
 typedef struct _GtkVSeparator       GtkVSeparator;
 typedef struct _GtkVSeparatorClass  GtkVSeparatorClass;
 
+/**
+ * GtkVSeparator:
+ *
+ * The #GtkVSeparator struct contains private data only, and
+ * should be accessed using the functions below.
+ */
 struct _GtkVSeparator
 {
   GtkSeparator separator;