From 75ffa7983ae05a6b9f3bdeeb80b83a587b4d310c Mon Sep 17 00:00:00 2001
From: Steven Harms <sharms@ubuntu.com>
Date: Wed, 3 Mar 2010 19:51:16 -0500
Subject: [PATCH] [docs] Move documentation to inline comments: GtkVPaned
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=611634

Signed-off-by: Javier Jardón <jjardon@gnome.org>
---
 docs/reference/gtk/tmpl/gtkvpaned.sgml | 35 --------------------------
 gtk/gtkvpaned.c                        | 18 +++++++++++++
 2 files changed, 18 insertions(+), 35 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkvpaned.sgml

diff --git a/docs/reference/gtk/tmpl/gtkvpaned.sgml b/docs/reference/gtk/tmpl/gtkvpaned.sgml
deleted file mode 100644
index b894b6dfe9..0000000000
--- a/docs/reference/gtk/tmpl/gtkvpaned.sgml
+++ /dev/null
@@ -1,35 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkVPaned
-
-<!-- ##### SECTION Short_Description ##### -->
-A container with two panes arranged vertically
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The VPaned widget is a container widget with two
-children arranged vertically. The division between
-the two panes is adjustable by the user by dragging
-a handle. See #GtkPaned for details.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkVPaned ##### -->
-<para>
-</para>
-
-
-<!-- ##### FUNCTION gtk_vpaned_new ##### -->
-<para>
-Create a new #GtkVPaned
-</para>
-
-@Returns: the new #GtkVPaned
-
-
diff --git a/gtk/gtkvpaned.c b/gtk/gtkvpaned.c
index 42bba68ede..7b9e38f16a 100644
--- a/gtk/gtkvpaned.c
+++ b/gtk/gtkvpaned.c
@@ -30,6 +30,17 @@
 #include "gtkvpaned.h"
 #include "gtkalias.h"
 
+/**
+ * SECTION:gtkvpaned
+ * @Short_description: A container with two panes arranged vertically
+ * @Title: GtkVPaned
+ *
+ * The VPaned widget is a container widget with two
+ * children arranged vertically. The division between
+ * the two panes is adjustable by the user by dragging
+ * a handle. See #GtkPaned for details.
+ */
+
 G_DEFINE_TYPE (GtkVPaned, gtk_vpaned, GTK_TYPE_PANED)
 
 static void
@@ -44,6 +55,13 @@ gtk_vpaned_init (GtkVPaned *vpaned)
                                   GTK_ORIENTATION_VERTICAL);
 }
 
+/**
+ * gtk_vpaned_new:
+ *
+ * Create a new #GtkVPaned
+ *
+ * Returns: the new #GtkVPaned
+ */
 GtkWidget *
 gtk_vpaned_new (void)
 {