From 107d1d330dab8054d01b16355099d3869d7bea99 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Wed, 11 Jun 2008 16:27:22 +0000
Subject: [PATCH] fix some docs

svn path=/trunk/; revision=7004
---
 docs/reference/ChangeLog                 |  8 ++++++++
 docs/reference/gobject/tmpl/signals.sgml | 12 ++++++------
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 7a90bde3f..465d982d5 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,11 @@
+2008-06-11  Matthias Clasen  <mclasen@redhat.com>
+
+	Bug 528172 – gtk_signal_handlers_unblock_* functions return value
+	amount of matched signals, not amount of actually unblocked.
+
+	* gobject/tmpl/signals.sgml: Fix documentation of return value
+	of functions that operate on matched signal handlers.
+
 2008-06-11  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 528717 – Misprint in the description of the parameter 
diff --git a/docs/reference/gobject/tmpl/signals.sgml b/docs/reference/gobject/tmpl/signals.sgml
index 76f36d82b..bea34f42e 100644
--- a/docs/reference/gobject/tmpl/signals.sgml
+++ b/docs/reference/gobject/tmpl/signals.sgml
@@ -676,7 +676,7 @@ otherwise.
 @closure: The closure the handlers will invoke.
 @func: The C closure callback of the handlers (useless for non-C closures).
 @data: The closure data of the handlers' closures.
-@Returns: The amount of handlers that got blocked.
+@Returns: The number of handlers that matched.
 
 
 <!-- ##### FUNCTION g_signal_handlers_unblock_matched ##### -->
@@ -699,7 +699,7 @@ not currently blocked.
 @closure: The closure the handlers will invoke.
 @func: The C closure callback of the handlers (useless for non-C closures).
 @data: The closure data of the handlers' closures.
-@Returns: The amount of handlers that got unblocked.
+@Returns: The number of handlers that matched.
 
 
 <!-- ##### FUNCTION g_signal_handlers_disconnect_matched ##### -->
@@ -721,7 +721,7 @@ handlers otherwise.
 @closure: The closure the handlers will invoke.
 @func: The C closure callback of the handlers (useless for non-C closures).
 @data: The closure data of the handlers' closures.
-@Returns: The amount of handlers that got disconnected.
+@Returns: The number of handlers that matched.
 
 
 <!-- ##### FUNCTION g_signal_handler_is_connected ##### -->
@@ -742,7 +742,7 @@ Blocks all handlers on an instance that match @func and @data.
 @instance: The instance to block handlers from.
 @func: The C closure callback of the handlers (useless for non-C closures).
 @data: The closure data of the handlers' closures.
-@Returns: The number of handlers that got blocked.
+@Returns: The number of handlers that matched.
 
 
 <!-- ##### MACRO g_signal_handlers_unblock_by_func ##### -->
@@ -753,7 +753,7 @@ Unblocks all handlers on an instance that match @func and @data.
 @instance: The instance to unblock handlers from.
 @func: The C closure callback of the handlers (useless for non-C closures).
 @data: The closure data of the handlers' closures.
-@Returns: The number of handlers that got unblocked.
+@Returns: The number of handlers that matched.
 
 
 <!-- ##### MACRO g_signal_handlers_disconnect_by_func ##### -->
@@ -764,7 +764,7 @@ Disconnects all handlers on an instance that match @func and @data.
 @instance: The instance to remove handlers from.
 @func: The C closure callback of the handlers (useless for non-C closures).
 @data: The closure data of the handlers' closures.
-@Returns: The number of handlers that got disconnected.
+@Returns: The number of handlers that matched.
 
 
 <!-- ##### FUNCTION g_signal_has_handler_pending ##### -->