[gtk/ebassi/gidocgen: 214/478] fontchooserdialog: Convert docs

[Emmanuele Bassi <ebassi src gnome org>]

commit 1f21ff714616699524fc2719d5e9ddf5df6ad551
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Feb 26 16:11:15 2021 -0500

    fontchooserdialog: Convert docs

 gtk/gtkfontchooserdialog.c | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)
---
diff --git a/gtk/gtkfontchooserdialog.c b/gtk/gtkfontchooserdialog.c
index 5c38db7fa8..3d360cf2ec 100644
--- a/gtk/gtkfontchooserdialog.c
+++ b/gtk/gtkfontchooserdialog.c
@@ -56,17 +56,20 @@ struct _GtkFontChooserDialogClass
 };
 
 /**
- * SECTION:gtkfontchooserdialog
- * @Short_description: A dialog for selecting fonts
- * @Title: GtkFontChooserDialog
- * @See_also: #GtkFontChooser, #GtkDialog
+ * GtkFontChooserDialog:
  *
- * The #GtkFontChooserDialog widget is a dialog for selecting a font.
- * It implements the #GtkFontChooser interface.
+ * The `GtkFontChooserDialog` widget is a dialog for selecting a font.
+ *
+ * ![An example GtkFontChooserDialog](fontchooser.png)
+ *
+ * `GtkFontChooserDialog` implements the [iface@Gtk.FontChooser] interface
+ * and does not provide much API of its own.
+ *
+ * To create a `GtkFontChooserDialog`, use [ctor Gtk FontChooserDialog new].
  *
  * # GtkFontChooserDialog as GtkBuildable
  *
- * The GtkFontChooserDialog implementation of the #GtkBuildable
+ * The `GtkFontChooserDialog` implementation of the `GtkBuildable`
  * interface exposes the buttons with the names “select_button”
  * and “cancel_button”.
  */
@@ -281,9 +284,9 @@ gtk_font_chooser_dialog_init (GtkFontChooserDialog *dialog)
  * @title: (allow-none): Title of the dialog, or %NULL
  * @parent: (allow-none): Transient parent of the dialog, or %NULL
  *
- * Creates a new #GtkFontChooserDialog.
+ * Creates a new `GtkFontChooserDialog`.
  *
- * Returns: a new #GtkFontChooserDialog
+ * Returns: a new `GtkFontChooserDialog`
  */
 GtkWidget*
 gtk_font_chooser_dialog_new (const char *title,