From ba22b91e31cfd3be2ea882bccce47a3fc2f6350e Mon Sep 17 00:00:00 2001
From: Steven Harms <sharms@ubuntu.com>
Date: Wed, 3 Mar 2010 18:21:56 -0500
Subject: [PATCH] Move documentation to inline comments: GtkVScrollbar

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=611658
---
 docs/reference/gtk/tmpl/gtkvscrollbar.sgml | 40 ----------------------
 gtk/gtkvscrollbar.c                        | 14 ++++++++
 gtk/gtkvscrollbar.h                        |  6 ++++
 3 files changed, 20 insertions(+), 40 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkvscrollbar.sgml

diff --git a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml b/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
deleted file mode 100644
index 84efad5e6b..0000000000
--- a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
+++ /dev/null
@@ -1,40 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkVScrollbar
-
-<!-- ##### SECTION Short_Description ##### -->
-A vertical scrollbar
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkVScrollbar widget is a widget arranged vertically creating a
-scrollbar. See #GtkScrollbar for details on
-scrollbars. #GtkAdjustment pointers may be added to handle the
-adjustment of the scrollbar or it may be left %NULL in which case one
-will be created for you. See #GtkScrollbar for a description of what the
-fields in an adjustment represent for a scrollbar.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-#GtkScrollbar, #GtkScrolledWindow
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkVScrollbar ##### -->
-<para>
-The #GtkVScrollbar struct contains private data and should be accessed
-using the functions below.
-</para>
-
-
-<!-- ##### FUNCTION gtk_vscrollbar_new ##### -->
-<para>
-
-</para>
-
-@adjustment: 
-@Returns: 
-
-
diff --git a/gtk/gtkvscrollbar.c b/gtk/gtkvscrollbar.c
index 3287e09263..8e87c885ee 100644
--- a/gtk/gtkvscrollbar.c
+++ b/gtk/gtkvscrollbar.c
@@ -32,6 +32,20 @@
 #include "gtkintl.h"
 #include "gtkalias.h"
 
+/**
+ * SECTION:gtkvscrollbar
+ * @Short_description: A vertical scrollbar
+ * @Title: GtkVScrollbar
+ * @See_also:#GtkScrollbar, #GtkScrolledWindow
+ *
+ * The #GtkVScrollbar widget is a widget arranged vertically creating a
+ * scrollbar. See #GtkScrollbar for details on
+ * scrollbars. #GtkAdjustment pointers may be added to handle the
+ * adjustment of the scrollbar or it may be left %NULL in which case one
+ * will be created for you. See #GtkScrollbar for a description of what the
+ * fields in an adjustment represent for a scrollbar.
+ */
+
 G_DEFINE_TYPE (GtkVScrollbar, gtk_vscrollbar, GTK_TYPE_SCROLLBAR)
 
 static void
diff --git a/gtk/gtkvscrollbar.h b/gtk/gtkvscrollbar.h
index 2a8e85e8a0..2cd2ec971c 100644
--- a/gtk/gtkvscrollbar.h
+++ b/gtk/gtkvscrollbar.h
@@ -49,6 +49,12 @@ G_BEGIN_DECLS
 typedef struct _GtkVScrollbar       GtkVScrollbar;
 typedef struct _GtkVScrollbarClass  GtkVScrollbarClass;
 
+/**
+ * GtkVScrollbar:
+ *
+ * The #GtkVScrollbar struct contains private data and should be accessed
+ * using the functions below.
+ */
 struct _GtkVScrollbar
 {
   GtkScrollbar scrollbar;