Add a note about double indirection in g_ptr_array_sort[_with_data]().
authorMatthias Clasen <maclas@gmx.de>
Thu, 17 Jul 2003 23:11:21 +0000 (23:11 +0000)
committerMatthias Clasen <matthiasc@src.gnome.org>
Thu, 17 Jul 2003 23:11:21 +0000 (23:11 +0000)
2003-07-18  Matthias Clasen  <maclas@gmx.de>

* glib/tmpl/arrays_pointer.sgml: Add a note about double indirection in
g_ptr_array_sort[_with_data]().  (#113697, Owen Taylor)

docs/reference/ChangeLog
docs/reference/glib/tmpl/arrays_pointer.sgml

index 1ca5e4840ddeb5c79336ee063454cc5f54952342..e5c06e62d8a5eff3321441bb490d6d5ad39c4357 100644 (file)
@@ -1,3 +1,8 @@
+2003-07-18  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/arrays_pointer.sgml: Add a note about double indirection in 
+       g_ptr_array_sort[_with_data]().  (#113697, Owen Taylor)
+
 2003-07-12  Matthias Clasen  <maclas@gmx.de>
 
        * glib/tmpl/string_utils.sgml: Add a paragraph about string precision, add links to it.
index 23fda0353ee514387c8f14141be8ed93111af298..e609b44053e5702d5d2f64c2b1f6cf5920129b02 100644 (file)
@@ -161,6 +161,10 @@ Sorts the array, using @compare_func which should be a <function>qsort()</functi
 function (returns -1 for first arg is less than second arg, 0 for equal, 1 if
 first arg is greater than second arg).
 </para>
+<note><para>
+The comparison function for g_ptr_array_sort() doesn't take the pointers from the array as arguments, 
+it takes pointers to the pointers in the array.
+</para></note>
 
 @array: a #GPtrArray.
 @compare_func: comparison function.
@@ -170,6 +174,10 @@ first arg is greater than second arg).
 <para>
 Like g_ptr_array_sort(), but the comparison function has a user data argument.
 </para>
+<note><para>
+The comparison function for g_ptr_array_sort_with_data() doesn't take the pointers from the array as arguments, 
+it takes pointers to the pointers in the array.
+</para></note>
 
 @array: a #GPtrArray.
 @compare_func: comparison function.