From: Federico Mena Quintero Date: Thu, 23 Oct 2003 23:02:38 +0000 (+0000) Subject: Fixed docs. (gtk_file_chooser_remove_filter): Likewise. X-Git-Url: http://pileus.org/git/?a=commitdiff_plain;h=e475c2684d01ff5fd7ce1c97a5cf944c233f7931;p=~andy%2Fgtk Fixed docs. (gtk_file_chooser_remove_filter): Likewise. 2003-10-23 Federico Mena Quintero * 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 09d29ea26..aebd42aa2 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2003-10-23 Federico Mena Quintero + + * 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 * 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 + + * 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 * 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 + + * 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 * 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 + + * 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 * 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 + + * 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 * 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) {