role: deprecate atk_role_register

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

2 files changed, 5 insertions, 0 deletions

diff --git a/atk/atkobject.c b/atk/atkobject.c
index 72cfbdd..0136c7a 100755
--- a/atk/atkobject.c
+++ b/atk/atkobject.c
@@ -899,6 +899,10 @@ atk_object_ref_relation_set (AtkObject *accessible)
  * Registers the role specified by @name. @name must be a meaningful
  * name. So it should not be empty, or consisting on whitespaces.
  *
+ * Deprecated: Since 2.12. If your application/toolkit doesn't find a
+ * suitable role for a specific object defined at #AtkRole, please
+ * submit a bug in order to add a new role to the specification.
+ *
  * Returns: an #AtkRole for the new role if added
  * properly. ATK_ROLE_INVALID in case of error.
  **/
diff --git a/atk/atkobject.h b/atk/atkobject.h
index a4ac38e..781c317 100755
--- a/atk/atkobject.h
+++ b/atk/atkobject.h
@@ -721,6 +721,7 @@ gboolean              atk_object_remove_relationship           (AtkObject      *
 								AtkRelationType relationship,
 								AtkObject      *target);
 const gchar*          atk_role_get_localized_name              (AtkRole     role);
+G_DEPRECATED
 AtkRole               atk_role_register                        (const gchar *name);
 const gchar*          atk_object_get_object_locale             (AtkObject   *accessible);