summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEmmanuele Bassi <ebassi@gnome.org>2018-06-26 17:03:18 +0100
committerEmmanuele Bassi <ebassi@gnome.org>2019-06-14 16:36:43 +0100
commit1baed9664d86f8975271e85c2bfdff08d694d4b2 (patch)
tree000f698323eec187b6ec5fbea3d7679998004ab2
parent9ce60b20828d2df9723fbee9edc5fb8a01c25f3a (diff)
downloadatk-1baed9664d86f8975271e85c2bfdff08d694d4b2.tar.gz
Add missing documentation for AtkObject functions
The deprecated functions for connecting and removing a handler for property notification are missing a description, and use the wrong syntax for the deprecation notice.
-rw-r--r--atk/atkobject.c16
1 files changed, 9 insertions, 7 deletions
diff --git a/atk/atkobject.c b/atk/atkobject.c
index 110bf2e..63986dd 100644
--- a/atk/atkobject.c
+++ b/atk/atkobject.c
@@ -1171,12 +1171,14 @@ atk_object_set_role (AtkObject *accessible,
* @accessible: an #AtkObject
* @handler: a function to be called when a property changes its value
*
- * Deprecated: Since 2.12. Connect directly to property-change or
- * notify signals.
+ * Calls @handler on property changes.
*
* Returns: a #guint which is the handler id used in
- * atk_object_remove_property_change_handler()
- **/
+ * atk_object_remove_property_change_handler()
+ *
+ * Deprecated: 2.12: Connect directly to #AtkObject::property-change or
+ * the relevant #GObject::notify signal for each desired property.
+ */
guint
atk_object_connect_property_change_handler (AtkObject *accessible,
AtkPropertyChangeHandler *handler)
@@ -1198,10 +1200,10 @@ atk_object_connect_property_change_handler (AtkObject *accessible,
* @accessible: an #AtkObject
* @handler_id: a guint which identifies the handler to be removed.
*
- * Deprecated: Since 2.12.
- *
* Removes a property change handler.
- **/
+ *
+ * Deprecated: 2.12: See atk_object_connect_property_change_handler()
+ */
void
atk_object_remove_property_change_handler (AtkObject *accessible,
guint handler_id)