From 17a06d4871a3dc23b698bfa15586d02b98a71c32 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Alejandro=20Pi=C3=B1eiro?= Date: Mon, 12 May 2014 15:00:06 +0200 Subject: [PATCH] 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 --- atk/atkutil.c | 7 +++++++ 1 file changed, 7 insertions(+) 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 -- 2.7.4