[gtk+/gtk-3-4] liststore: Make gtk_list_store_reorder() introspectable



commit d53732ad0cc06577b84b7ecadbe3032ee943661f
Author: Martin Pitt <martinpitt gnome org>
Date:   Tue Jun 12 15:41:03 2012 +0200

    liststore: Make gtk_list_store_reorder() introspectable
    
    Mark the new_order argument as zero-terminated array, even though it does not
    need to be zero terminated (it has an implicit length not given by a constant
    or another method argument). It does not hurt if bindings append an extra zero
    to the array as long as it has enough elements, and this makes the method
    introspectable.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=677941

 gtk/gtkliststore.c |    9 +++++----
 1 files changed, 5 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index 2d99d5f..ee07b87 100644
--- a/gtk/gtkliststore.c
+++ b/gtk/gtkliststore.c
@@ -1691,11 +1691,12 @@ gtk_list_store_reorder_func (GSequenceIter *a,
 }
   
 /**
- * gtk_list_store_reorder: (skip)
+ * gtk_list_store_reorder:
  * @store: A #GtkListStore.
- * @new_order: (array): an array of integers mapping the new position of each child
- *      to its old position before the re-ordering,
- *      i.e. @new_order<literal>[newpos] = oldpos</literal>.
+ * @new_order: (array zero-terminated=1): an array of integers mapping the new
+ *      position of each child to its old position before the re-ordering,
+ *      i.e. @new_order<literal>[newpos] = oldpos</literal>. It must have
+ *      exactly as many items as the list store's length.
  *
  * Reorders @store to follow the order indicated by @new_order. Note that
  * this function only works with unsorted stores.



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