[gtk+] Move documentation to inline comments: GtkFontSelection

[Javier Jardón <jjardon src gnome org>]

commit 39179e3402f0d16843b5fe1642a0e937615155a9
Author: Javier Jardón <jjardon gnome org>
Date:   Wed Apr 13 22:23:44 2011 +0100

    Move documentation to inline comments: GtkFontSelection

 docs/reference/gtk/tmpl/.gitignore      |    1 +
 docs/reference/gtk/tmpl/gtkfontsel.sgml |  176 -------------------------------
 gtk/gtkfontsel.c                        |   22 ++++
 3 files changed, 23 insertions(+), 176 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 9e0934f..a050d5f 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/gtk/gtkfontsel.c b/gtk/gtkfontsel.c
index a88fbbe..babe7b2 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 */