Fixed docs. (gtk_file_chooser_remove_filter): Likewise.

2003-10-23  Federico Mena Quintero  <federico@ximian.com>

	* gtk/gtkfilechooser.c (gtk_file_chooser_get_preview_uri): Fixed docs.
	(gtk_file_chooser_remove_filter): Likewise.
	(gtk_file_chooser_select_all): Added docs.
	(gtk_file_chooser_unselect_all): Likewise.

	* gtk/gtkfilechooserdialog.c (gtk_file_chooser_dialog_new): Added docs.

	* gtk/gtkfilechooserwidget.c (gtk_file_chooser_widget_new): Added docs.

8 files changed, 94 insertions, 4 deletions

diff --git a/ChangeLog b/ChangeLog
index 09d29ea26..aebd42aa2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2003-10-23  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/gtkfilechooser.c (gtk_file_chooser_get_preview_uri): Fixed docs.
+	(gtk_file_chooser_remove_filter): Likewise.
+	(gtk_file_chooser_select_all): Added docs.
+	(gtk_file_chooser_unselect_all): Likewise.
+
+	* gtk/gtkfilechooserdialog.c (gtk_file_chooser_dialog_new): Added docs.
+
+	* gtk/gtkfilechooserwidget.c (gtk_file_chooser_widget_new): Added docs.
+
 Thu Oct 23 23:22:15 2003  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkfilefilter.c: 
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 09d29ea26..aebd42aa2 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,14 @@
+2003-10-23  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/gtkfilechooser.c (gtk_file_chooser_get_preview_uri): Fixed docs.
+	(gtk_file_chooser_remove_filter): Likewise.
+	(gtk_file_chooser_select_all): Added docs.
+	(gtk_file_chooser_unselect_all): Likewise.
+
+	* gtk/gtkfilechooserdialog.c (gtk_file_chooser_dialog_new): Added docs.
+
+	* gtk/gtkfilechooserwidget.c (gtk_file_chooser_widget_new): Added docs.
+
 Thu Oct 23 23:22:15 2003  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkfilefilter.c: 
diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index 09d29ea26..aebd42aa2 100644
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,14 @@
+2003-10-23  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/gtkfilechooser.c (gtk_file_chooser_get_preview_uri): Fixed docs.
+	(gtk_file_chooser_remove_filter): Likewise.
+	(gtk_file_chooser_select_all): Added docs.
+	(gtk_file_chooser_unselect_all): Likewise.
+
+	* gtk/gtkfilechooserdialog.c (gtk_file_chooser_dialog_new): Added docs.
+
+	* gtk/gtkfilechooserwidget.c (gtk_file_chooser_widget_new): Added docs.
+
 Thu Oct 23 23:22:15 2003  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkfilefilter.c: 
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 09d29ea26..aebd42aa2 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,14 @@
+2003-10-23  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/gtkfilechooser.c (gtk_file_chooser_get_preview_uri): Fixed docs.
+	(gtk_file_chooser_remove_filter): Likewise.
+	(gtk_file_chooser_select_all): Added docs.
+	(gtk_file_chooser_unselect_all): Likewise.
+
+	* gtk/gtkfilechooserdialog.c (gtk_file_chooser_dialog_new): Added docs.
+
+	* gtk/gtkfilechooserwidget.c (gtk_file_chooser_widget_new): Added docs.
+
 Thu Oct 23 23:22:15 2003  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkfilefilter.c: 
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 09d29ea26..aebd42aa2 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,14 @@
+2003-10-23  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/gtkfilechooser.c (gtk_file_chooser_get_preview_uri): Fixed docs.
+	(gtk_file_chooser_remove_filter): Likewise.
+	(gtk_file_chooser_select_all): Added docs.
+	(gtk_file_chooser_unselect_all): Likewise.
+
+	* gtk/gtkfilechooserdialog.c (gtk_file_chooser_dialog_new): Added docs.
+
+	* gtk/gtkfilechooserwidget.c (gtk_file_chooser_widget_new): Added docs.
+
 Thu Oct 23 23:22:15 2003  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkfilefilter.c: 
diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 0dcebfda3..4941d51be 100644
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -744,6 +744,12 @@ gtk_file_chooser_unselect_uri (GtkFileChooser *chooser,
     }
 }
 
+/**
+ * gtk_file_chooser_select_all:
+ * @chooser: a #GtkFileChooser
+ * 
+ * Selects all the files in the current folder of a file chooser.
+ **/
 void
 gtk_file_chooser_select_all (GtkFileChooser *chooser)
 {
@@ -752,6 +758,12 @@ gtk_file_chooser_select_all (GtkFileChooser *chooser)
   GTK_FILE_CHOOSER_GET_IFACE (chooser)->select_all (chooser);
 }
 
+/**
+ * gtk_file_chooser_unselect_all:
+ * @chooser: a #GtkFileChooser
+ * 
+ * Unselects all the files in the current folder of a file chooser.
+ **/
 void
 gtk_file_chooser_unselect_all (GtkFileChooser *chooser)
 {
@@ -1204,14 +1216,14 @@ gtk_file_chooser_get_preview_filename (GtkFileChooser *chooser)
 }
 
 /**
- * gtk_file_chooser_get_preview_filename:
+ * gtk_file_chooser_get_preview_uri:
  * @chooser: a #GtkFileChooser
  * 
  * Gets the URI that should be previewed in a custom preview
  * widget. See gtk_file_chooser_set_preview_widget().
  * 
- * Return value: the URI for the file to preview, or %NULL if no file
- *  is selected. Free with g_free().
+ * Return value: the URI for the file to preview, or %NULL if no file is
+ * selected. Free with g_free().
  *
  * Since: 2.4
  **/
@@ -1304,7 +1316,7 @@ gtk_file_chooser_add_filter (GtkFileChooser *chooser,
 }
 
 /**
- * gtk_file_chooser_add_filter:
+ * gtk_file_chooser_remove_filter:
  * @chooser: a #GtkFileChooser
  * @filter: a #GtkFileFilter
  * 
diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c
index 678913c33..ece13e221 100644
--- a/gtk/gtkfilechooserdialog.c
+++ b/gtk/gtkfilechooserdialog.c
@@ -199,6 +199,19 @@ gtk_file_chooser_dialog_get_property (GObject         *object,
   g_object_get_property (G_OBJECT (priv->widget), pspec->name, value);
 }
 
+/**
+ * gtk_file_chooser_dialog_new:
+ * @title: Title of the dialog, or %NULL
+ * @parent: Transient parent of the dialog, or %NULL
+ * @action: Open or save mode for the dialog
+ * @first_button_text: stock ID or text to go in the first button, or %NULL
+ * @Varargs: response ID for the first button, then additional (button, id) pairs, ending with %NULL
+ * 
+ * Creates a new #GtkFileChooserDialog.  This function is analogous to
+ * gtk_dialog_new_with_buttons().
+ * 
+ * Return value: a new #GtkFileChooserDialog
+ **/
 GtkWidget *
 gtk_file_chooser_dialog_new (const gchar         *title,
 			     GtkWindow           *parent,
diff --git a/gtk/gtkfilechooserwidget.c b/gtk/gtkfilechooserwidget.c
index bfc3b81c5..f26f74ad1 100644
--- a/gtk/gtkfilechooserwidget.c
+++ b/gtk/gtkfilechooserwidget.c
@@ -195,6 +195,16 @@ gtk_file_chooser_widget_get_property (GObject         *object,
   g_object_get_property (G_OBJECT (priv->impl), pspec->name, value);
 }
 
+/**
+ * gtk_file_chooser_widget_new:
+ * @action: Open or save mode for the widget
+ * 
+ * Creates a new #GtkFileChooserWidget.  This is a file chooser widget that can
+ * be embedded in custom windows, and it is the same widget that is used by
+ * #GtkFileChooserDialog.
+ * 
+ * Return value: a new #GtkFileChooserWidget
+ **/
 GtkWidget *
 gtk_file_chooser_widget_new (GtkFileChooserAction action)
 {