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.

diff --git a/ChangeLog b/ChangeLog
index 09d29ea26f48a2a40ef5a05834ca46e8c466a5d5..aebd42aa25ccb2687e88789fbd67866b97fbdcef 100644 (file)
--- 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 09d29ea26f48a2a40ef5a05834ca46e8c466a5d5..aebd42aa25ccb2687e88789fbd67866b97fbdcef 100644 (file)
--- 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 09d29ea26f48a2a40ef5a05834ca46e8c466a5d5..aebd42aa25ccb2687e88789fbd67866b97fbdcef 100644 (file)
--- 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 09d29ea26f48a2a40ef5a05834ca46e8c466a5d5..aebd42aa25ccb2687e88789fbd67866b97fbdcef 100644 (file)
--- 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 09d29ea26f48a2a40ef5a05834ca46e8c466a5d5..aebd42aa25ccb2687e88789fbd67866b97fbdcef 100644 (file)
--- 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 0dcebfda36cc04f2cdfbf3f36efbbda3eabbd722..4941d51be097c04b0b8b49b46316cb027740f00e 100644 (file)
--- 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 678913c335e7b324f74dae1d30702e16bf234462..ece13e22163b3224f40ad8065e237e989a0a9eef 100644 (file)
--- 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 bfc3b81c5be2b6baf2b445119d6d7d403ea47aa0..f26f74ad106bb8a6511a232a3080a38aa918dd91 100644 (file)
--- 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)
 {