diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index d60266462e..0d0be57c29 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -12,6 +12,7 @@ gtkradiobutton.sgml
gtkrange.sgml
gtkrecentaction.sgml
gtkrecentchooser.sgml
+gtkrecentchooserdialog.sgml
gtkrecentchoosermenu.sgml
gtkrecentchooserwidget.sgml
gtkscalebutton.sgml
diff --git a/docs/reference/gtk/tmpl/gtkrecentchooserdialog.sgml b/docs/reference/gtk/tmpl/gtkrecentchooserdialog.sgml
deleted file mode 100644
index fd06e2b507..0000000000
--- a/docs/reference/gtk/tmpl/gtkrecentchooserdialog.sgml
+++ /dev/null
@@ -1,96 +0,0 @@
-
-GtkRecentChooserDialog
-
-
-Displays recently used files in a dialog
-
-
-
-#GtkRecentChooserDialog is a dialog box suitable for displaying the recently
-used documents. This widgets works by putting a #GtkRecentChooserWidget inside
-a #GtkDialog. It exposes the #GtkRecentChooserIface interface, so you can use
-all the #GtkRecentChooser functions on the recent chooser dialog as well as
-those for #GtkDialog.
-
-
-
-Note that #GtkRecentChooserDialog does not have any methods of its own.
-Instead, you should use the functions that work on a #GtkRecentChooser.
-
-
-
- Typical usage
-
-
- In the simplest of cases, you can use the following code to use
- a #GtkRecentChooserDialog to select a recently used file:
-
-
-
-GtkWidget *dialog;
-
-dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
- parent_window,
- GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
- GTK_STOCK_OPEN, GTK_RESPONSE_ACCEPT,
- NULL);
-
-if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
- {
- GtkRecentInfo *info;
-
- info = gtk_recent_chooser_get_current_item (GTK_RECENT_CHOOSER (dialog));
- open_file (gtk_recent_info_get_uri (info));
- gtk_recent_info_unref (info);
- }
-
-gtk_widget_destroy (dialog);
-
-
-
-
-Recently used files are supported since GTK+ 2.10.
-
-
-
-
-#GtkRecentChooser, #GtkDialog
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-@title:
-@parent:
-@first_button_text:
-@Varargs:
-@Returns:
-
-
-
-
-
-
-
-@title:
-@parent:
-@manager:
-@first_button_text:
-@Varargs:
-@Returns:
-
-
diff --git a/gtk/gtkrecentchooserdialog.c b/gtk/gtkrecentchooserdialog.c
index 058439af8d..c86910f3fa 100644
--- a/gtk/gtkrecentchooserdialog.c
+++ b/gtk/gtkrecentchooserdialog.c
@@ -29,6 +29,52 @@
#include
+
+/**
+ * SECTION:gtkrecentchooserdialog
+ * @Short_description: Displays recently used files in a dialog
+ * @Title: GtkRecentChooserDialog
+ * @See_also:#GtkRecentChooser, #GtkDialog
+ *
+ * #GtkRecentChooserDialog is a dialog box suitable for displaying the recently
+ * used documents. This widgets works by putting a #GtkRecentChooserWidget inside
+ * a #GtkDialog. It exposes the #GtkRecentChooserIface interface, so you can use
+ * all the #GtkRecentChooser functions on the recent chooser dialog as well as
+ * those for #GtkDialog.
+ *
+ * Note that #GtkRecentChooserDialog does not have any methods of its own.
+ * Instead, you should use the functions that work on a #GtkRecentChooser.
+ *
+ *
+ * Typical usage
+ * In the simplest of cases, you can use the following code to use
+ * a #GtkRecentChooserDialog to select a recently used file:
+ *
+ * GtkWidget *dialog;
+ *
+ * dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
+ * parent_window,
+ * GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
+ * GTK_STOCK_OPEN, GTK_RESPONSE_ACCEPT,
+ * NULL);
+ *
+ * if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
+ * {
+ * GtkRecentInfo *info;
+ *
+ * info = gtk_recent_chooser_get_current_item (GTK_RECENT_CHOOSER (dialog));
+ * open_file (gtk_recent_info_get_uri (info));
+ * gtk_recent_info_unref (info);
+ * }
+ *
+ * gtk_widget_destroy (dialog);
+ *
+ *
+ *
+ * Recently used files are supported since GTK+ 2.10.
+ */
+
+
struct _GtkRecentChooserDialogPrivate
{
GtkRecentManager *manager;