[gtk/matthiasc/for-master] filechooser: Correct an annotation



commit 429e0bfaec27f22a49be810df1fa29a12062b7d1
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Apr 27 00:35:47 2020 -0400

    filechooser: Correct an annotation
    
    Clarify that gtk_file_chooser_add_filter is only taking
    ownership of a floating reference, which translates to
    "transfer none", not "transfer full".
    
    Fixes: #2016

 gtk/gtkfilechooser.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 549c56279b..58709d9e67 100644
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -647,14 +647,14 @@ gtk_file_chooser_remove_shortcut_folder (GtkFileChooser  *chooser,
 /**
  * gtk_file_chooser_add_filter:
  * @chooser: a #GtkFileChooser
- * @filter: (transfer full): a #GtkFileFilter
+ * @filter: (transfer none): a #GtkFileFilter
  * 
  * Adds @filter to the list of filters that the user can select between.
  * When a filter is selected, only files that are passed by that
  * filter are displayed. 
  * 
- * Note that the @chooser takes ownership of the filter, so you have to 
- * ref and sink it if you want to keep a reference.
+ * Note that the @chooser takes ownership of the filter if it is floating,
+ * so you have to ref and sink it if you want to keep a reference.
  **/
 void
 gtk_file_chooser_add_filter (GtkFileChooser *chooser,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]