From ebda721f4ef4cbb4c8479552eac43b3e45bd00d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Mon, 11 Apr 2011 03:09:38 +0100
Subject: [PATCH] Move documentation to inline comments: GtkFileChooserWidget

---
 docs/reference/gtk/tmpl/.gitignore            |  1 +
 .../gtk/tmpl/gtkfilechooserwidget.sgml        | 57 -------------------
 gtk/gtkfilechooserwidget.c                    | 19 +++++++
 3 files changed, 20 insertions(+), 57 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 69350ee8d9..91c807ffa6 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/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml b/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
deleted file mode 100644
index 434d70967d..0000000000
--- a/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
+++ /dev/null
@@ -1,57 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkFileChooserWidget
-
-<!-- ##### SECTION Short_Description ##### -->
-File chooser widget that can be embedded in other widgets
-
-<!-- ##### SECTION Long_Description ##### -->
-    <para>
-      #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.
-    </para>
-
-    <para>
-      Note that #GtkFileChooserWidget does not have any methods of its
-      own.  Instead, you should use the functions that work on a
-      #GtkFileChooser.
-    </para>
-
-<!-- ##### SECTION See_Also ##### -->
-    <para>
-      #GtkFileChooser, #GtkFileChooserDialog
-    </para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkFileChooserWidget ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### FUNCTION gtk_file_chooser_widget_new ##### -->
-<para>
-
-</para>
-
-@action: 
-@Returns: 
-
-
-
-
-<!--
-Local variables:
-mode: sgml
-sgml-parent-document: ("../gtk-docs.sgml" "book" "refentry")
-End:
--->
-
-
diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c
index 567f77f152..7969bff200 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);