From 4a3f7e3b42d02734cf86ee725f99dd41ad783f0f Mon Sep 17 00:00:00 2001
From: Damon Chaplin <damon@helixcode.com>
Date: Mon, 21 Feb 2000 21:08:17 +0000
Subject: [PATCH] updated the g_source_remove_by_XXX() descriptions to note
 that only the

2000-02-21  Damon Chaplin  <damon@helixcode.com>

        * tmpl/main.sgml: updated the g_source_remove_by_XXX() descriptions
        to note that only the first source found is removed.
---
 docs/reference/ChangeLog           |  5 +++++
 docs/reference/glib/glib/ChangeLog |  5 +++++
 docs/reference/glib/tmpl/main.sgml | 31 +++++++++++++++++++++---------
 3 files changed, 32 insertions(+), 9 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 455fcba2..fe546374 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2000-02-21  Damon Chaplin  <damon@helixcode.com>
+
+	* tmpl/main.sgml: updated the g_source_remove_by_XXX() descriptions
+	to note that only the first source found is removed.
+
 2000-01-25  Damon Chaplin  <damon@karuna.freeserve.co.uk>
 
 	* tmpl/misc_utils.sgml: g_bit_nth_lsf/msf docs from 
diff --git a/docs/reference/glib/glib/ChangeLog b/docs/reference/glib/glib/ChangeLog
index 455fcba2..fe546374 100644
--- a/docs/reference/glib/glib/ChangeLog
+++ b/docs/reference/glib/glib/ChangeLog
@@ -1,3 +1,8 @@
+2000-02-21  Damon Chaplin  <damon@helixcode.com>
+
+	* tmpl/main.sgml: updated the g_source_remove_by_XXX() descriptions
+	to note that only the first source found is removed.
+
 2000-01-25  Damon Chaplin  <damon@karuna.freeserve.co.uk>
 
 	* tmpl/misc_utils.sgml: g_bit_nth_lsf/msf docs from 
diff --git a/docs/reference/glib/tmpl/main.sgml b/docs/reference/glib/tmpl/main.sgml
index 9795fa41..e97e91a5 100644
--- a/docs/reference/glib/tmpl/main.sgml
+++ b/docs/reference/glib/tmpl/main.sgml
@@ -362,10 +362,10 @@ or -1 if an error occurred.
 
 <!-- ##### FUNCTION g_source_add ##### -->
 <para>
-Adds a source to the main loop.
+Adds an event source to the main loop.
 </para>
 
-@priority: the priority of the function. See #G_PRIORITY_DEFAULT,
+@priority: the priority of the event source. See #G_PRIORITY_DEFAULT,
 #G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH, #G_PRIORITY_HIGH_IDLE, and
 #G_PRIORITY_LOW.
 @can_recurse: if it is safe to call the source functions recursively.
@@ -463,35 +463,48 @@ g_timeout_add() and g_timeout_add_full().
 </para>
 
 @tag: the id of the event source to remove.
-@Returns: TRUE if the source was found.
+@Returns: TRUE if the source was found and removed.
 
 
 <!-- ##### FUNCTION g_source_remove_by_funcs_user_data ##### -->
 <para>
-Removes the event source with the given #GSourceFuncs and user data.
+Removes the first event source found with the given #GSourceFuncs and user
+data.
+</para>
+<para>
+Event sources are sorted with the highest priority first. Sources with equal
+priority are stored in the order in which they were added.
 </para>
 
 @funcs: the #GSourceFuncs of the source to remove.
 @user_data: the user data of the source to remove.
-@Returns: TRUE if the source was found.
+@Returns: TRUE if an event source was found and removed.
 
 
 <!-- ##### FUNCTION g_source_remove_by_source_data ##### -->
 <para>
-Removes the event source with the given source data.
+Removes the first event source found with the given source data.
+</para>
+<para>
+Event sources are sorted with the highest priority first. Sources with equal
+priority are stored in the order in which they were added.
 </para>
 
 @source_data: the source data, which contains information specific to the
 type of source.
-@Returns: TRUE if the source was found.
+@Returns: TRUE if an event source was found and removed.
 
 
 <!-- ##### FUNCTION g_source_remove_by_user_data ##### -->
 <para>
-Removes the event source with the given user data.
+Removes the first event source found with the given user data.
+</para>
+<para>
+Event sources are sorted with the highest priority first. Sources with equal
+priority are stored in the order in which they were added.
 </para>
 
 @user_data: the user data of the source to remove.
-@Returns: TRUE if the source was found.
+@Returns: TRUE if an event source was found and removed.
 
 
-- 
2.34.1