From 27da11aa5a4d7e0ab45b446e5fc70f902d86ed95 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <maclas@gmx.de>
Date: Thu, 17 Jul 2003 23:11:21 +0000
Subject: [PATCH] Add a note about double indirection in
 g_ptr_array_sort[_with_data]().

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                     | 5 +++++
 docs/reference/glib/tmpl/arrays_pointer.sgml | 8 ++++++++
 2 files changed, 13 insertions(+)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 1ca5e4840..e5c06e62d 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -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.
diff --git a/docs/reference/glib/tmpl/arrays_pointer.sgml b/docs/reference/glib/tmpl/arrays_pointer.sgml
index 23fda0353..e609b4405 100644
--- a/docs/reference/glib/tmpl/arrays_pointer.sgml
+++ b/docs/reference/glib/tmpl/arrays_pointer.sgml
@@ -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.