From: Martin Pitt <martinpitt@gnome.org>
Date: Tue, 12 Jun 2012 13:41:03 +0000 (+0200)
Subject: liststore: Make gtk_list_store_reorder() introspectable
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~24^2~19758
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=0e37d2a98b10c76a7ccf9b8dc1401a523f3d0173;p=gtk4.git

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
---

diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index 2d99d5f36c..ee07b87811 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.