diff --git a/docs/reference/gtk/tmpl/gtkvscale.sgml b/docs/reference/gtk/tmpl/gtkvscale.sgml
deleted file mode 100644
index dcf7b6e4d9..0000000000
--- a/docs/reference/gtk/tmpl/gtkvscale.sgml
+++ /dev/null
@@ -1,51 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkVScale
-
-<!-- ##### SECTION Short_Description ##### -->
-A vertical slider widget for selecting a value from a range
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkVScale widget is used to allow the user to select a value using
-a vertical slider. To create one, use gtk_hscale_new_with_range().
-</para>
-<para>
-The position to show the current value, and the number of decimal places
-shown can be set using the parent #GtkScale class's functions.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkVScale ##### -->
-<para>
-The #GtkVScale-struct struct contains private data only, and
-should be accessed using the functions below.
-</para>
-
-
-<!-- ##### FUNCTION gtk_vscale_new ##### -->
-<para>
-Creates a new #GtkVScale.
-</para>
-
-@adjustment: the #GtkAdjustment which sets the range of the scale.
-@Returns: a new #GtkVScale.
-
-
-<!-- ##### FUNCTION gtk_vscale_new_with_range ##### -->
-<para>
-
-</para>
-
-@min: 
-@max: 
-@step: 
-@Returns: 
-
-
diff --git a/gtk/gtkvscale.c b/gtk/gtkvscale.c
index 20d39bcb3b..a36402b6f9 100644
--- a/gtk/gtkvscale.c
+++ b/gtk/gtkvscale.c
@@ -33,6 +33,17 @@
 #include "gtkorientable.h"
 #include "gtkalias.h"
 
+/**
+ * SECTION:gtkvscale
+ * @Short_description: A vertical slider widget for selecting a value from a range
+ * @Title: GtkVScale
+ *
+ * The #GtkVScale widget is used to allow the user to select a value using
+ * a vertical slider. To create one, use gtk_hscale_new_with_range().
+ *
+ * The position to show the current value, and the number of decimal places
+ * shown can be set using the parent #GtkScale class's functions.
+ */
 
 G_DEFINE_TYPE (GtkVScale, gtk_vscale, GTK_TYPE_SCALE)
 
@@ -50,7 +61,14 @@ gtk_vscale_init (GtkVScale *vscale)
   gtk_orientable_set_orientation (GTK_ORIENTABLE (vscale),
                                   GTK_ORIENTATION_VERTICAL);
 }
-
+/**
+ * gtk_vscale_new:
+ * @adjustment: the #GtkAdjustment which sets the range of the scale.
+ *
+ * Creates a new #GtkVScale.
+ *
+ * Returns: a new #GtkVScale.
+ */
 GtkWidget *
 gtk_vscale_new (GtkAdjustment *adjustment)
 {
diff --git a/gtk/gtkvscale.h b/gtk/gtkvscale.h
index 8409912fa8..cf67920596 100644
--- a/gtk/gtkvscale.h
+++ b/gtk/gtkvscale.h
@@ -49,6 +49,12 @@ G_BEGIN_DECLS
 typedef struct _GtkVScale       GtkVScale;
 typedef struct _GtkVScaleClass  GtkVScaleClass;
 
+/**
+ * GtkVScale:
+ *
+ * The #GtkVScale struct contains private data only, and
+ * should be accessed using the functions below.
+ */
 struct _GtkVScale
 {
   GtkScale scale;