diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 9e0934f7b9..a050d5f9ae 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -43,6 +43,7 @@ gtkfilechooserdialog.sgml
 gtkfilechooserwidget.sgml
 gtkfilefilter.sgml
 gtkfontbutton.sgml
+gtkfontsel.sgml
 gtkframe.sgml
 gtkhbbox.sgml
 gtkhbox.sgml
diff --git a/docs/reference/gtk/tmpl/gtkfontsel.sgml b/docs/reference/gtk/tmpl/gtkfontsel.sgml
deleted file mode 100644
index f97de24d4e..0000000000
--- a/docs/reference/gtk/tmpl/gtkfontsel.sgml
+++ /dev/null
@@ -1,176 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkFontSelection
-
-<!-- ##### SECTION Short_Description ##### -->
-A widget for selecting fonts
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkFontSelection widget lists the available fonts, styles and sizes,
-allowing the user to select a font.
-It is used in the #GtkFontSelectionDialog widget to provide a dialog box for
-selecting fonts.
-</para>
-<para>
-To set the font which is initially selected, use
-gtk_font_selection_set_font_name().
-</para>
-<para>
-To get the selected font use gtk_font_selection_get_font_name().
-</para>
-<para>
-To change the text which is shown in the preview area, use
-gtk_font_selection_set_preview_text().
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<variablelist>
-
-<varlistentry>
-<term>#GtkFontSelectionDialog</term>
-<listitem><para>a dialog box which uses #GtkFontSelection.</para></listitem>
-</varlistentry>
-
-</variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkFontSelection ##### -->
-<para>
-The #GtkFontSelection struct contains private data only, and should
-only be accessed using the functions below.
-</para>
-
-
-<!-- ##### ARG GtkFontSelection:font-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontSelection:preview-text ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_font_selection_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_font_name ##### -->
-<para>
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_set_font_name ##### -->
-<para>
-</para>
-
-@fontsel: 
-@fontname: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_preview_text ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_set_preview_text ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@text: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_face ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_face_list ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_family ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_size ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_family_list ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_preview_entry ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_size_entry ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_font_selection_get_size_list ##### -->
-<para>
-
-</para>
-
-@fontsel: 
-@Returns: 
-
-
diff --git a/gtk/gtkfontsel.c b/gtk/gtkfontsel.c
index a88fbbea0f..babe7b236b 100644
--- a/gtk/gtkfontsel.c
+++ b/gtk/gtkfontsel.c
@@ -58,6 +58,28 @@
 #include "gtkbuildable.h"
 #include "gtkprivate.h"
 
+
+/**
+ * SECTION:gtkfontsel
+ * @Short_description: A widget for selecting fonts
+ * @Title: GtkFontSelection
+ * @See_also: #GtkFontSelectionDialog
+ *
+ * The #GtkFontSelection widget lists the available fonts, styles and sizes,
+ * allowing the user to select a font.
+ * It is used in the #GtkFontSelectionDialog widget to provide a dialog box for
+ * selecting fonts.
+ *
+ * To set the font which is initially selected, use
+ * gtk_font_selection_set_font_name().
+ *
+ * To get the selected font use gtk_font_selection_get_font_name().
+ *
+ * To change the text which is shown in the preview area, use
+ * gtk_font_selection_set_preview_text().
+ */
+
+
 struct _GtkFontSelectionPrivate
 {
   GtkWidget *font_entry;        /* Used _get_family_entry() for consistency, -mr */