Clarify docs a little. (#311727, Tristan van Berkom)

2005-08-15  Matthias Clasen  <mclasen@redhat.com>

	* glib/gqueue.c (g_queue_find_custom): Clarify docs
	a little.  (#311727, Tristan van Berkom)

ChangeLog

@@ -1,5 +1,8 @@
 2005-08-15  Matthias Clasen  <mclasen@redhat.com>
 
+	* glib/gqueue.c (g_queue_find_custom): Clarify docs
+	a little.  (#311727, Tristan van Berkom)
+
 	* glib/abicheck.sh, gobject/abicheck.sh: Make the 
 	check work on ia64 too, where some symbols ended up 
 	in yet another section.

ChangeLog.pre-2-10

@@ -1,5 +1,8 @@
 2005-08-15  Matthias Clasen  <mclasen@redhat.com>
 
+	* glib/gqueue.c (g_queue_find_custom): Clarify docs
+	a little.  (#311727, Tristan van Berkom)
+
 	* glib/abicheck.sh, gobject/abicheck.sh: Make the 
 	check work on ia64 too, where some symbols ended up 
 	in yet another section.

ChangeLog.pre-2-12

@@ -1,5 +1,8 @@
 2005-08-15  Matthias Clasen  <mclasen@redhat.com>
 
+	* glib/gqueue.c (g_queue_find_custom): Clarify docs
+	a little.  (#311727, Tristan van Berkom)
+
 	* glib/abicheck.sh, gobject/abicheck.sh: Make the 
 	check work on ia64 too, where some symbols ended up 
 	in yet another section.

ChangeLog.pre-2-8

@@ -1,5 +1,8 @@
 2005-08-15  Matthias Clasen  <mclasen@redhat.com>
 
+	* glib/gqueue.c (g_queue_find_custom): Clarify docs
+	a little.  (#311727, Tristan van Berkom)
+
 	* glib/abicheck.sh, gobject/abicheck.sh: Make the 
 	check work on ia64 too, where some symbols ended up 
 	in yet another section.

docs/reference/ChangeLog

@@ -1,3 +1,9 @@
+2005-08-15  Matthias Clasen  <mclasen@redhat.com>
+
+	* glib/tmpl/linked_lists_single.sgml: 
+	* glib/tmpl/linked_lists_double.sgml: Clarify docs
+	a little.  (#311727, Tristan van Berkom)
+
 2005-08-12  Matthias Clasen  <mclasen@redhat.com>
 
 	* === Released 2.8.0 ===

docs/reference/glib/tmpl/linked_lists_double.sgml

@@ -293,10 +293,11 @@ Sorts a #GList using the given comparison function.
 </para>
 
 @list: a #GList.
-@compare_func: the comparison function used to sort the #GList. This function
+@compare_func: the comparison function used to sort the #GList. 
-is passed 2 elements of the #GList and should return 0 if they are equal,
+This function is passed the data from 2 elements of the #GList and should 
-a negative value if the first element comes before the second, or a positive
+return 0 if they are equal, a negative value if the first element 
-value if the first element comes after the second.
+comes before the second, or a positive value if the first element 
+comes after the second.
 @Returns: the start of the sorted #GList.
 
 
@@ -456,8 +457,8 @@ Finds an element in a #GList, using a supplied function to find the desired
 element.
 It iterates over the list, calling the given function which should return 0
 when the desired element is found.
-The function takes two #gconstpointer arguments, the #GList element's data
+The function takes two #gconstpointer arguments, the #GList element's data as
-and the given user data.
+the first argument and the given user data.
 </para>
 
 @list: a #GList.

docs/reference/glib/tmpl/linked_lists_single.sgml

@@ -284,8 +284,12 @@ Sorts a #GSList using the given comparison function.
 </para>
 
 @list: a #GSList.
-@compare_func: <function>qsort()</function>-style comparison function.
+@compare_func: the comparison function used to sort the #GSList. 
-@Returns: the start of the sorted #GList.
+This function is passed the data from 2 elements of the #GSList and should 
+return 0 if they are equal, a negative value if the first element 
+comes before the second, or a positive value if the first element 
+comes after the second.
+@Returns: the start of the sorted #GSList.
 
 
 <!-- ##### FUNCTION g_slist_sort_with_data ##### -->
@@ -377,8 +381,8 @@ Finds an element in a #GSList, using a supplied function to find the desired
 element.
 It iterates over the list, calling the given function which should return 0
 when the desired element is found.
-The function takes two #gconstpointer arguments, the #GSList element's data
+The function takes two #gconstpointer arguments, the #GSList element's data as
-and the given user data.
+the first argument and the given user data.
 </para>
 
 @list: a #GSList.

glib/gqueue.c

@@ -229,8 +229,8 @@ g_queue_find (GQueue        *queue,
  * Finds an element in a #GQueue, using a supplied function to find the
  * desired element. It iterates over the queue, calling the given function
  * which should return 0 when the desired element is found. The function
- * takes two gconstpointer arguments, the #GQueue element's data and the
+ * takes two gconstpointer arguments, the #GQueue element's data as the
- * given user data.
+ * first argument and the given user data as the second argument.
  * 
  * Return value: The found link, or %NULL if it wasn't found
  *