doc: adding further explanation on atk_add_global_event_listener

Clarifying that the atk types should be already registered
before calling this method.

https://bugzilla.gnome.org/show_bug.cgi?id=729922

1 files changed, 7 insertions, 0 deletions

diff --git a/atk/atkutil.c b/atk/atkutil.c
index e9726e7..bc4c0a6 100755
--- a/atk/atkutil.c
+++ b/atk/atkutil.c
@@ -377,6 +377,13 @@ atk_util_real_remove_global_event_listener (guint remove_listener)
  * Toolkit implementor note: this method is not intended to be used by
  * ATK implementors but by ATK consumers.
  *
+ * ATK consumers note: as this method adds a listener for a given ATK
+ * type, that type should be already registered on the GType system
+ * before calling this method. A simple way to do that is creating an
+ * instance of #AtkNoOpObject. This class implements all ATK
+ * interfaces, so creating the instance will register all ATK types as
+ * a collateral effect.
+ *
  * Returns: added event listener id, or 0 on failure.
  **/
 guint