[gtk+] Move documentation to inline comments: GtkFileChooserWidget

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

commit ebda721f4ef4cbb4c8479552eac43b3e45bd00d9
Author: Javier Jardón <jjardon gnome org>
Date:   Mon Apr 11 03:09:38 2011 +0100

    Move documentation to inline comments: GtkFileChooserWidget

 docs/reference/gtk/tmpl/.gitignore                |    1 +
 docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml |   57 ---------------------
 gtk/gtkfilechooserwidget.c                        |   19 +++++++
 3 files changed, 20 insertions(+), 57 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 69350ee..91c807f 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -31,6 +31,7 @@ gtkeventbox.sgml
 gtkexpander.sgml
 gtkfeatures.sgml
 gtkfixed.sgml
+gtkfilechooserwidget.sgml
 gtkfilefilter.sgml
 gtkfontbutton.sgml
 gtkhbox.sgml
diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c
index 567f77f..7969bff 100644
--- a/gtk/gtkfilechooserwidget.c
+++ b/gtk/gtkfilechooserwidget.c
@@ -28,6 +28,25 @@
 #include "gtkfilechooserembed.h"
 #include "gtkintl.h"
 
+
+/**
+ * SECTION:gtkfilechooserwidget
+ * @Short_description: File chooser widget that can be embedded in other widgets
+ * @Title: GtkFileChooserWidget
+ * @See_also: #GtkFileChooser, #GtkFileChooserDialog
+ *
+ * #GtkFileChooserWidget is a widget suitable for selecting files.
+ * It is the main building block of a #GtkFileChooserDialog.  Most
+ * applications will only need to use the latter; you can use
+ * #GtkFileChooserWidget as part of a larger window if you have
+ * special needs.
+ *
+ * Note that #GtkFileChooserWidget does not have any methods of its
+ * own.  Instead, you should use the functions that work on a
+ * #GtkFileChooser.
+ */
+
+
 #define GTK_FILE_CHOOSER_WIDGET_GET_PRIVATE(o)  (GTK_FILE_CHOOSER_WIDGET (o)->priv)
 
 static void gtk_file_chooser_widget_finalize     (GObject                   *object);