1 Add comments to clarify behavior if handler has already been added

* atk/atkcomponent.c (atk_component_add_focus_handler):1
Add comments to clarify behavior if handler has already been added

* docs/tmpl/atktext.sgml:
Update for change of caret_changed to text_caret_moved

diff --git a/ChangeLog b/ChangeLog
index 202257b..07386f4 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2002-01-07  Padraig O'Briain  <padraig.obriain@sun.com>
+
+       * atk/atkcomponent.c (atk_component_add_focus_handler):1
+       Add comments to clarify behavior if handler has already been added
+
+       * docs/tmpl/atktext.sgml:
+       Update for change of caret_changed to text_caret_moved
+
 2002-01-05  Hans Breuer  <hans@breuer.org>
 
        * atk/makefile.msc : generate atk-enum-types.[hc]

diff --git a/atk/atkcomponent.c b/atk/atkcomponent.c
index 0ec321d..f47dc8e 100755 (executable)
--- a/atk/atkcomponent.c
+++ b/atk/atkcomponent.c
@@ -65,9 +65,11 @@ atk_component_get_type ()
  * @handler: The #AtkFocusHandler to be attached to @component
  *
  * Add the specified handler to the set of functions to be called 
- * when this object receives focus events (in or out).
+ * when this object receives focus events (in or out). If the handler is
+ * already added it is not added again
  *
- * Returns:
+ * Returns: a handler id which can be used in atk_component_remove_focus_handler
+ * or zero if the handler was already added.
  **/
 guint
 atk_component_add_focus_handler (AtkComponent    *component,

diff --git a/docs/tmpl/atktext.sgml b/docs/tmpl/atktext.sgml
index 89fdfd7..2d14994 100644 (file)
--- a/docs/tmpl/atktext.sgml
+++ b/docs/tmpl/atktext.sgml
@@ -44,7 +44,7 @@ AtkText
 @set_selection: 
 @set_caret_offset: 
 @text_changed: 
-@caret_changed: 
+@text_caret_moved: 
 @text_selection_changed: 
 
 <!-- ##### ENUM AtkTextBoundary ##### -->