diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index c992c535db..3f60574825 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -31,6 +31,7 @@ gtkfeatures.sgml
 gtkfixed.sgml
 gtkfilefilter.sgml
 gtkhbox.sgml
+gtkhpaned.sgml
 gtkiconview.sgml
 gtkimagemenuitem.sgml
 gtkimcontextsimple.sgml
diff --git a/docs/reference/gtk/tmpl/gtkhpaned.sgml b/docs/reference/gtk/tmpl/gtkhpaned.sgml
deleted file mode 100644
index 25fd0333b5..0000000000
--- a/docs/reference/gtk/tmpl/gtkhpaned.sgml
+++ /dev/null
@@ -1,39 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkHPaned
-
-<!-- ##### SECTION Short_Description ##### -->
-A container with two panes arranged horizontally
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The HPaned widget is a container widget with two
-children arranged horizontally. 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 ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkHPaned ##### -->
-<para>
-</para>
-
-
-<!-- ##### FUNCTION gtk_hpaned_new ##### -->
-<para>
-Create a new #GtkHPaned
-</para>
-
-@void: 
-@Returns: the new #GtkHPaned
-
-
diff --git a/gtk/gtkhpaned.c b/gtk/gtkhpaned.c
index 86742f564c..e0b864c63e 100644
--- a/gtk/gtkhpaned.c
+++ b/gtk/gtkhpaned.c
@@ -30,6 +30,18 @@
 #include "gtkorientable.h"
 
 
+/**
+ * SECTION:gtkhpaned
+ * @Short_description: A container with two panes arranged horizontally
+ * @Title: GtkHPaned
+ *
+ * The HPaned widget is a container widget with two
+ * children arranged horizontally. The division between
+ * the two panes is adjustable by the user by dragging
+ * a handle. See #GtkPaned for details.
+ */
+
+
 G_DEFINE_TYPE (GtkHPaned, gtk_hpaned, GTK_TYPE_PANED)
 
 static void
@@ -44,6 +56,13 @@ gtk_hpaned_init (GtkHPaned *hpaned)
                                   GTK_ORIENTATION_HORIZONTAL);
 }
 
+/**
+ * gtk_hpaned_new:
+ *
+ * Create a new #GtkHPaned
+ *
+ * Returns: the new #GtkHPaned
+ */
 GtkWidget *
 gtk_hpaned_new (void)
 {