[atk] Annotate the Public Symbols in Public Headers



commit ca5ea1bd3f923565f21d2efb32ada4cbb923f941
Author: Chun-wei Fan <fanchunwei src gnome org>
Date:   Thu Apr 24 18:46:31 2014 +0800

    Annotate the Public Symbols in Public Headers
    
    This includes atk/atkversion.h in all the public headers, either directly
    or via atk/atkobject.h, and annotates the public symbols in the headers,
    which all lead to _ATK_EXTERN via one of ATK_AVAILABLE_IN_ALL,
    ATK_AVAILABLE_IN_X_Y, ATK_DEPRECATED, ATK_DEPRECATED_FOR,
    ATK_DEPRECATED_IN_X_Y or ATK_DEPRECATED_IN_X_Y_FOR, depending on which
    stable release series the API was introduced or deprecated.
    
    _ATK_EXTERN which can then be defined in a way during the build, so that
    these symbols can be exported automatically using compiler directives.
    
    Also use _ATK_EXTERN for ATK_VAR in atk/atkmisc.h during the build so that
    variables can also be properly exported.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=728031

 atk/atkaction.h            |    9 ++++++++-
 atk/atkcomponent.h         |   20 ++++++++++++++++----
 atk/atkdocument.h          |   12 +++++++++---
 atk/atkeditabletext.h      |    8 ++++++++
 atk/atkgobjectaccessible.h |    3 +++
 atk/atkhyperlink.h         |   10 +++++++++-
 atk/atkhyperlinkimpl.h     |    2 ++
 atk/atkhypertext.h         |    4 ++++
 atk/atkimage.h             |    6 ++++++
 atk/atkmisc.h              |   13 ++++++++-----
 atk/atknoopobject.h        |    4 ++++
 atk/atknoopobjectfactory.h |    2 ++
 atk/atkobject.h            |   42 +++++++++++++++++++++++++++++++++++-------
 atk/atkobjectfactory.h     |    5 +++++
 atk/atkplug.h              |    5 +++++
 atk/atkrange.h             |    8 ++++++++
 atk/atkregistry.h          |    5 +++++
 atk/atkrelation.h          |   10 ++++++++++
 atk/atkrelationset.h       |   10 ++++++++++
 atk/atkselection.h         |    8 ++++++++
 atk/atksocket.h            |    6 ++++++
 atk/atkstate.h             |    4 ++++
 atk/atkstateset.h          |   12 ++++++++++++
 atk/atkstreamablecontent.h |    7 ++++++-
 atk/atktable.h             |   33 ++++++++++++++++++++++++++++++---
 atk/atktablecell.h         |    8 ++++++++
 atk/atktext.h              |   31 ++++++++++++++++++++++++++++---
 atk/atkutil.h              |   19 +++++++++++++++----
 atk/atkvalue.h             |   18 +++++++++++++-----
 atk/atkwindow.h            |    1 +
 30 files changed, 288 insertions(+), 37 deletions(-)
---
diff --git a/atk/atkaction.h b/atk/atkaction.h
index 6991ab5..3712806 100755
--- a/atk/atkaction.h
+++ b/atk/atkaction.h
@@ -68,6 +68,7 @@ struct _AtkActionIface
                                                gint              i);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_action_get_type (void);
 
 /*
@@ -81,21 +82,27 @@ GType atk_action_get_type (void);
  * provided in a support library
  */
 
+ATK_AVAILABLE_IN_ALL
 gboolean   atk_action_do_action                (AtkAction         *action,
                                             gint              i);
+ATK_AVAILABLE_IN_ALL
 gint   atk_action_get_n_actions            (AtkAction *action);
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_action_get_description  (AtkAction         *action,
                                                    gint              i);
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_action_get_name         (AtkAction         *action,
                                                    gint              i);
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_action_get_keybinding   (AtkAction         *action,
                                                    gint              i);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_action_set_description  (AtkAction         *action,
                                                    gint              i,
                                                    const gchar       *desc);
 
 /* NEW in ATK 1.1: */
-
+ATK_AVAILABLE_IN_ALL
 const gchar* atk_action_get_localized_name (AtkAction       *action,
                                                     gint            i);
 
diff --git a/atk/atkcomponent.h b/atk/atkcomponent.h
index 541de53..9a057ef 100755
--- a/atk/atkcomponent.h
+++ b/atk/atkcomponent.h
@@ -83,6 +83,7 @@ struct _AtkRectangle
   gint height;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_rectangle_get_type (void);
 
 #define ATK_TYPE_RECTANGLE (atk_rectangle_get_type ())
@@ -158,54 +159,65 @@ struct _AtkComponentIface
   gdouble                  (* get_alpha)        (AtkComponent   *component);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_component_get_type (void);
 
 /* convenience functions */
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_10
 guint                atk_component_add_focus_handler      (AtkComponent    *component,
                                                            AtkFocusHandler handler);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_component_contains               (AtkComponent    *component,
                                                             gint            x,
                                                             gint            y,
                                                             AtkCoordType    coord_type);
+ATK_AVAILABLE_IN_ALL
 AtkObject*            atk_component_ref_accessible_at_point(AtkComponent    *component,
                                                             gint            x,
                                                             gint            y,
                                                             AtkCoordType    coord_type);
+ATK_AVAILABLE_IN_ALL
 void                  atk_component_get_extents            (AtkComponent    *component,
                                                             gint            *x,
                                                             gint            *y,
                                                             gint            *width,
                                                             gint            *height,
                                                             AtkCoordType    coord_type);
-G_DEPRECATED_FOR(atk_component_get_extents)
+ATK_DEPRECATED_IN_2_12_FOR(atk_component_get_extents)
 void                  atk_component_get_position           (AtkComponent    *component,
                                                             gint            *x,
                                                             gint            *y,
                                                             AtkCoordType    coord_type);
-G_DEPRECATED_FOR(atk_component_get_extents)
+ATK_DEPRECATED_IN_2_12_FOR(atk_component_get_extents)
 void                  atk_component_get_size               (AtkComponent    *component,
                                                             gint            *width,
                                                             gint            *height);
+ATK_AVAILABLE_IN_ALL
 AtkLayer              atk_component_get_layer              (AtkComponent    *component);
+ATK_AVAILABLE_IN_ALL
 gint                  atk_component_get_mdi_zorder         (AtkComponent    *component);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_component_grab_focus             (AtkComponent    *component);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_10
 void                  atk_component_remove_focus_handler   (AtkComponent    *component,
                                                             guint           handler_id);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_component_set_extents            (AtkComponent    *component,
                                                             gint            x,
                                                             gint            y,
                                                             gint            width,
                                                             gint            height,
                                                             AtkCoordType    coord_type);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_component_set_position           (AtkComponent    *component,
                                                             gint            x,
                                                             gint            y,
                                                             AtkCoordType    coord_type);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_component_set_size               (AtkComponent    *component,
                                                             gint            width,
                                                             gint            height);
+ATK_AVAILABLE_IN_ALL
 gdouble               atk_component_get_alpha              (AtkComponent    *component);
 
 G_END_DECLS
diff --git a/atk/atkdocument.h b/atk/atkdocument.h
index bc6d458..aa38d3e 100755
--- a/atk/atkdocument.h
+++ b/atk/atkdocument.h
@@ -82,24 +82,30 @@ struct _AtkDocumentIface
   gint                  ( *get_page_count) (AtkDocument *document);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType  atk_document_get_type             (void);
 
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 const gchar*          atk_document_get_document_type (AtkDocument   *document);
 
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 gpointer atk_document_get_document (AtkDocument   *document);
 
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_8_FOR(atk_object_get_object_locale)
 const gchar*          atk_document_get_locale (AtkDocument *document);
 
+ATK_AVAILABLE_IN_ALL
 AtkAttributeSet*      atk_document_get_attributes (AtkDocument *document);
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_document_get_attribute_value (AtkDocument *document,
                                                         const gchar *attribute_name);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_document_set_attribute_value (AtkDocument *document,
                                                         const gchar *attribute_name,
                                                         const gchar *attribute_value);
+ATK_AVAILABLE_IN_2_12
 gint                  atk_document_get_current_page_number (AtkDocument *document);
+ATK_AVAILABLE_IN_2_12
 gint                  atk_document_get_page_count      (AtkDocument *document);
 
 G_END_DECLS
diff --git a/atk/atkeditabletext.h b/atk/atkeditabletext.h
index 0849595..f78f267 100755
--- a/atk/atkeditabletext.h
+++ b/atk/atkeditabletext.h
@@ -71,28 +71,36 @@ struct _AtkEditableTextIface
   void   (* paste_text)           (AtkEditableText  *text,
                                    gint             position);
 };
+ATK_AVAILABLE_IN_ALL
 GType atk_editable_text_get_type (void);
 
 
+ATK_AVAILABLE_IN_ALL
 gboolean atk_editable_text_set_run_attributes (AtkEditableText          *text,
                                                AtkAttributeSet  *attrib_set,
                                                gint                    start_offset,
                                               gint             end_offset);
+ATK_AVAILABLE_IN_ALL
 void atk_editable_text_set_text_contents    (AtkEditableText  *text,
                                              const gchar      *string);
+ATK_AVAILABLE_IN_ALL
 void atk_editable_text_insert_text          (AtkEditableText  *text,
                                              const gchar      *string,
                                              gint             length,
                                              gint             *position);
+ATK_AVAILABLE_IN_ALL
 void atk_editable_text_copy_text            (AtkEditableText  *text,
                                              gint             start_pos,
                                              gint             end_pos);
+ATK_AVAILABLE_IN_ALL
 void atk_editable_text_cut_text             (AtkEditableText  *text,
                                              gint             start_pos,
                                              gint             end_pos);
+ATK_AVAILABLE_IN_ALL
 void atk_editable_text_delete_text          (AtkEditableText  *text,
                                              gint             start_pos,
                                              gint             end_pos);
+ATK_AVAILABLE_IN_ALL
 void atk_editable_text_paste_text           (AtkEditableText  *text,
                                              gint             position);
 
diff --git a/atk/atkgobjectaccessible.h b/atk/atkgobjectaccessible.h
index 2901291..f843370 100644
--- a/atk/atkgobjectaccessible.h
+++ b/atk/atkgobjectaccessible.h
@@ -47,6 +47,7 @@ struct _AtkGObjectAccessible
   AtkObject parent;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_gobject_accessible_get_type (void);
 
 struct _AtkGObjectAccessibleClass
@@ -57,7 +58,9 @@ struct _AtkGObjectAccessibleClass
   AtkFunction pad2;
 };
 
+ATK_AVAILABLE_IN_ALL
 AtkObject *atk_gobject_accessible_for_object      (GObject           *obj);
+ATK_AVAILABLE_IN_ALL
 GObject   *atk_gobject_accessible_get_object      (AtkGObjectAccessible *obj);
 
 G_END_DECLS
diff --git a/atk/atkhyperlink.h b/atk/atkhyperlink.h
index c1bd0bf..6e8dc74 100755
--- a/atk/atkhyperlink.h
+++ b/atk/atkhyperlink.h
@@ -80,25 +80,33 @@ struct _AtkHyperlinkClass
   AtkFunction      pad1;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType            atk_hyperlink_get_type             (void);
 
+ATK_AVAILABLE_IN_ALL
 gchar*           atk_hyperlink_get_uri              (AtkHyperlink     *link_,
                                                      gint             i);
 
+ATK_AVAILABLE_IN_ALL
 AtkObject*       atk_hyperlink_get_object           (AtkHyperlink     *link_,
                                                      gint             i);
 
+ATK_AVAILABLE_IN_ALL
 gint             atk_hyperlink_get_end_index        (AtkHyperlink     *link_);
 
+ATK_AVAILABLE_IN_ALL
 gint             atk_hyperlink_get_start_index      (AtkHyperlink     *link_);
 
+ATK_AVAILABLE_IN_ALL
 gboolean         atk_hyperlink_is_valid             (AtkHyperlink     *link_);
 
+ATK_AVAILABLE_IN_ALL
 gboolean         atk_hyperlink_is_inline             (AtkHyperlink     *link_);
 
+ATK_AVAILABLE_IN_ALL
 gint            atk_hyperlink_get_n_anchors        (AtkHyperlink     *link_);
 
-G_DEPRECATED
+ATK_DEPRECATED
 gboolean         atk_hyperlink_is_selected_link     (AtkHyperlink     *link_);
 
 G_END_DECLS
diff --git a/atk/atkhyperlinkimpl.h b/atk/atkhyperlinkimpl.h
index e8e033a..65568b5 100644
--- a/atk/atkhyperlinkimpl.h
+++ b/atk/atkhyperlinkimpl.h
@@ -57,8 +57,10 @@ struct _AtkHyperlinkImplIface
   AtkHyperlink*  (* get_hyperlink) (AtkHyperlinkImpl *impl);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType            atk_hyperlink_impl_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 AtkHyperlink    *atk_hyperlink_impl_get_hyperlink (AtkHyperlinkImpl *impl);
 
 G_END_DECLS
diff --git a/atk/atkhypertext.h b/atk/atkhypertext.h
index 6dc2a27..6a97215 100755
--- a/atk/atkhypertext.h
+++ b/atk/atkhypertext.h
@@ -61,11 +61,15 @@ struct _AtkHypertextIface
   void         (* link_selected)            (AtkHypertext       *hypertext,
                                              gint               link_index);
 };
+ATK_AVAILABLE_IN_ALL
 GType atk_hypertext_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 AtkHyperlink* atk_hypertext_get_link       (AtkHypertext *hypertext,
                                             gint          link_index);
+ATK_AVAILABLE_IN_ALL
 gint          atk_hypertext_get_n_links    (AtkHypertext *hypertext);
+ATK_AVAILABLE_IN_ALL
 gint          atk_hypertext_get_link_index (AtkHypertext *hypertext,
                                             gint          char_index);
 
diff --git a/atk/atkimage.h b/atk/atkimage.h
index 9977e52..4905cd1 100755
--- a/atk/atkimage.h
+++ b/atk/atkimage.h
@@ -62,21 +62,27 @@ struct _AtkImageIface
   const gchar*          ( *get_image_locale)      (AtkImage              *image);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType  atk_image_get_type             (void);
 
+ATK_AVAILABLE_IN_ALL
 const gchar* atk_image_get_image_description (AtkImage   *image);
 
+ATK_AVAILABLE_IN_ALL
 void     atk_image_get_image_size        (AtkImage           *image,
                                           gint               *width,
                                           gint               *height);
 
+ATK_AVAILABLE_IN_ALL
 gboolean atk_image_set_image_description (AtkImage           *image,
                                           const gchar       *description);
+ATK_AVAILABLE_IN_ALL
 void     atk_image_get_image_position    (AtkImage          *image,
                                           gint               *x,
                                          gint               *y,
                                          AtkCoordType       coord_type);
 
+ATK_AVAILABLE_IN_ALL
 const gchar* atk_image_get_image_locale (AtkImage   *image);
 
 G_END_DECLS
diff --git a/atk/atkmisc.h b/atk/atkmisc.h
index 269e4d2..e898e35 100755
--- a/atk/atkmisc.h
+++ b/atk/atkmisc.h
@@ -25,6 +25,7 @@
 #define __ATK_MISC_H__
 
 #include <glib-object.h>
+#include <atk/atkversion.h>
 
 /* We prefix variable declarations so they can
  * properly get exported in Windows DLLs.
@@ -36,7 +37,7 @@
 #    else /* !ATK_STATIC_COMPILATION */
 #      ifdef ATK_COMPILATION
 #        ifdef DLL_EXPORT
-#          define ATK_VAR __declspec(dllexport)
+#          define ATK_VAR _ATK_EXTERN
 #        else /* !DLL_EXPORT */
 #          define ATK_VAR extern
 #        endif /* !DLL_EXPORT */
@@ -45,7 +46,7 @@
 #      endif /* !ATK_COMPILATION */
 #    endif /* !ATK_STATIC_COMPILATION */
 #  else /* !G_PLATFORM_WIN32 */
-#    define ATK_VAR extern
+#    define ATK_VAR _ATK_EXTERN
 #  endif /* !G_PLATFORM_WIN32 */
 #endif /* ATK_VAR */
 
@@ -95,13 +96,15 @@ struct _AtkMiscClass
    void   (* threads_leave)                     (AtkMisc *misc);
    gpointer vfuncs[32]; /* future bincompat */
 };
+
+ATK_DEPRECATED_IN_2_12
 GType atk_misc_get_type (void);
 
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 void     atk_misc_threads_enter  (AtkMisc *misc);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 void     atk_misc_threads_leave  (AtkMisc *misc);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 const AtkMisc *atk_misc_get_instance (void);
 
 G_END_DECLS
diff --git a/atk/atknoopobject.h b/atk/atknoopobject.h
index 261571c..9c02a19 100644
--- a/atk/atknoopobject.h
+++ b/atk/atknoopobject.h
@@ -21,6 +21,8 @@
 #error "Only <atk/atk.h> can be included directly."
 #endif
 
+#include <atk/atkversion.h>
+
 #ifndef __ATK_NO_OP_OBJECT_H__
 #define __ATK_NO_OP_OBJECT_H__
 
@@ -41,6 +43,7 @@ struct _AtkNoOpObject
   AtkObject     parent;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_no_op_object_get_type (void);
 
 struct _AtkNoOpObjectClass
@@ -48,6 +51,7 @@ struct _AtkNoOpObjectClass
   AtkObjectClass parent_class;
 };
 
+ATK_AVAILABLE_IN_ALL
 AtkObject *atk_no_op_object_new (GObject  *obj);
 
 G_END_DECLS
diff --git a/atk/atknoopobjectfactory.h b/atk/atknoopobjectfactory.h
index b216d6c..953e8fe 100755
--- a/atk/atknoopobjectfactory.h
+++ b/atk/atknoopobjectfactory.h
@@ -48,8 +48,10 @@ struct _AtkNoOpObjectFactoryClass
   AtkObjectFactoryClass parent_class;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_no_op_object_factory_get_type(void);
 
+ATK_AVAILABLE_IN_ALL
 AtkObjectFactory *atk_no_op_object_factory_new(void);
 
 G_END_DECLS
diff --git a/atk/atkobject.h b/atk/atkobject.h
index 712d68c..93b7c84 100755
--- a/atk/atkobject.h
+++ b/atk/atkobject.h
@@ -25,6 +25,8 @@
 #define __ATK_OBJECT_H__
 
 #include <glib-object.h>
+
+#include <atk/atkversion.h>
 #include <atk/atkstate.h>
 #include <atk/atkrelationtype.h>
 
@@ -638,6 +640,7 @@ void                      (* initialize)                         (AtkObject
   AtkFunction             pad1;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType            atk_object_get_type   (void);
 
 /**
@@ -653,69 +656,94 @@ struct _AtkImplementorIface
 
   AtkObject*   (*ref_accessible) (AtkImplementor *implementor);
 };
-GType atk_implementor_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
+GType atk_implementor_get_type (void);
+ATK_AVAILABLE_IN_ALL
 AtkObject*              atk_implementor_ref_accessible            (AtkImplementor *implementor);
 
 /*
  * Properties directly supported by AtkObject
  */
 
+ATK_AVAILABLE_IN_ALL
 const gchar*            atk_object_get_name                       (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 const gchar*            atk_object_get_description                (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 AtkObject*              atk_object_get_parent                     (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 AtkObject*              atk_object_peek_parent                    (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 gint                    atk_object_get_n_accessible_children      (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 AtkObject*              atk_object_ref_accessible_child           (AtkObject *accessible,
                                                                    gint        i);
+ATK_AVAILABLE_IN_ALL
 AtkRelationSet*         atk_object_ref_relation_set               (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 AtkRole                 atk_object_get_role                       (AtkObject *accessible);
 
-G_DEPRECATED_FOR(atk_component_get_layer)
+ATK_DEPRECATED_FOR(atk_component_get_layer)
 AtkLayer                atk_object_get_layer                      (AtkObject *accessible);
-G_DEPRECATED_FOR(atk_component_get_mdi_zorder)
+ATK_DEPRECATED_FOR(atk_component_get_mdi_zorder)
 gint                    atk_object_get_mdi_zorder                 (AtkObject *accessible);
 
+ATK_AVAILABLE_IN_ALL
 AtkAttributeSet*        atk_object_get_attributes                 (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 AtkStateSet*            atk_object_ref_state_set                  (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 gint                    atk_object_get_index_in_parent            (AtkObject *accessible);
+ATK_AVAILABLE_IN_ALL
 void                    atk_object_set_name                       (AtkObject *accessible,
                                                                    const gchar *name);
+ATK_AVAILABLE_IN_ALL
 void                    atk_object_set_description                (AtkObject *accessible,
                                                                    const gchar *description);
+ATK_AVAILABLE_IN_ALL
 void                    atk_object_set_parent                     (AtkObject *accessible,
                                                                    AtkObject *parent);
+ATK_AVAILABLE_IN_ALL
 void                    atk_object_set_role                       (AtkObject *accessible,
                                                                    AtkRole   role);
 
 
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 guint                atk_object_connect_property_change_handler  (AtkObject                      *accessible,
                                                                   AtkPropertyChangeHandler       *handler);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 void                 atk_object_remove_property_change_handler   (AtkObject                      *accessible,
                                                                   guint                          handler_id);
 
+ATK_AVAILABLE_IN_ALL
 void                 atk_object_notify_state_change              (AtkObject                      *accessible,
                                                                   AtkState                       state,
                                                                   gboolean                       value);
+ATK_AVAILABLE_IN_ALL
 void                 atk_object_initialize                       (AtkObject                     *accessible,
                                                                   gpointer                      data);
-                                    
+
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_role_get_name      (AtkRole         role);
+ATK_AVAILABLE_IN_ALL
 AtkRole               atk_role_for_name      (const gchar     *name);
 
 
 /* NEW in 1.1: convenience API */
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_object_add_relationship              (AtkObject      *object,
                                                                AtkRelationType relationship,
                                                                AtkObject      *target);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_object_remove_relationship           (AtkObject      *object,
                                                                AtkRelationType relationship,
                                                                AtkObject      *target);
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_role_get_localized_name              (AtkRole     role);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 AtkRole               atk_role_register                        (const gchar *name);
+ATK_AVAILABLE_IN_2_8
 const gchar*          atk_object_get_object_locale             (AtkObject   *accessible);
 
 G_END_DECLS
diff --git a/atk/atkobjectfactory.h b/atk/atkobjectfactory.h
index ff7e254..4c9cb10 100755
--- a/atk/atkobjectfactory.h
+++ b/atk/atkobjectfactory.h
@@ -56,10 +56,15 @@ struct _AtkObjectFactoryClass
   AtkFunction pad2;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_object_factory_get_type(void);
 
+
+ATK_AVAILABLE_IN_ALL
 AtkObject* atk_object_factory_create_accessible (AtkObjectFactory *factory, GObject *obj);
+ATK_AVAILABLE_IN_ALL
 void       atk_object_factory_invalidate (AtkObjectFactory *factory);
+ATK_AVAILABLE_IN_ALL
 GType      atk_object_factory_get_accessible_type (AtkObjectFactory *factory);
 
 G_END_DECLS
diff --git a/atk/atkplug.h b/atk/atkplug.h
index 7d6efd4..1e6813f 100644
--- a/atk/atkplug.h
+++ b/atk/atkplug.h
@@ -24,6 +24,8 @@
 #ifndef __ATK_PLUG_H__
 #define __ATK_PLUG_H__
 
+#include <atk/atkversion.h>
+
 G_BEGIN_DECLS
 
 #define ATK_TYPE_PLUG               (atk_plug_get_type ())
@@ -41,6 +43,7 @@ struct _AtkPlug
   AtkObject parent;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_plug_get_type (void);
 
 struct _AtkPlugClass
@@ -53,7 +56,9 @@ struct _AtkPlugClass
   gchar* (* get_object_id) (AtkPlug* obj);
 };
 
+ATK_AVAILABLE_IN_ALL
 AtkObject*    atk_plug_new     (void);
+ATK_AVAILABLE_IN_ALL
 gchar*        atk_plug_get_id  (AtkPlug* plug);
 
 G_END_DECLS
diff --git a/atk/atkrange.h b/atk/atkrange.h
index 12e22d9..0dd585c 100644
--- a/atk/atkrange.h
+++ b/atk/atkrange.h
@@ -26,6 +26,7 @@
 #define __ATK_RANGE_H__
 
 #include <glib-object.h>
+#include <atk/atkversion.h>
 
 G_BEGIN_DECLS
 
@@ -34,14 +35,21 @@ G_BEGIN_DECLS
 typedef struct _AtkRange AtkRange;
 
 /* AtkRange methods */
+ATK_AVAILABLE_IN_2_12
 GType atk_range_get_type (void);
 
+ATK_AVAILABLE_IN_2_12
 AtkRange*    atk_range_copy (AtkRange *src);
+ATK_AVAILABLE_IN_2_12
 void         atk_range_free (AtkRange *range);
 
+ATK_AVAILABLE_IN_2_12
 gdouble      atk_range_get_lower_limit  (AtkRange    *range);
+ATK_AVAILABLE_IN_2_12
 gdouble      atk_range_get_upper_limit  (AtkRange    *range);
+ATK_AVAILABLE_IN_2_12
 const gchar* atk_range_get_description  (AtkRange    *range);
+ATK_AVAILABLE_IN_2_12
 AtkRange*    atk_range_new              (gdouble      lower_limit,
                                          gdouble      upper_limit,
                                          const gchar *description);
diff --git a/atk/atkregistry.h b/atk/atkregistry.h
index eb16403..2490940 100644
--- a/atk/atkregistry.h
+++ b/atk/atkregistry.h
@@ -52,15 +52,20 @@ typedef struct _AtkRegistry             AtkRegistry;
 typedef struct _AtkRegistryClass        AtkRegistryClass;
 
 
+ATK_AVAILABLE_IN_ALL
 GType             atk_registry_get_type         (void);
+ATK_AVAILABLE_IN_ALL
 void              atk_registry_set_factory_type (AtkRegistry *registry,
                                                  GType type,
                                                  GType factory_type);
+ATK_AVAILABLE_IN_ALL
 GType             atk_registry_get_factory_type (AtkRegistry *registry,
                                                 GType type);
+ATK_AVAILABLE_IN_ALL
 AtkObjectFactory* atk_registry_get_factory      (AtkRegistry *registry,
                                                  GType type);
 
+ATK_AVAILABLE_IN_ALL
 AtkRegistry*      atk_get_default_registry      (void);
 
 G_END_DECLS
diff --git a/atk/atkrelation.h b/atk/atkrelation.h
index 5cccaee..0c958fa 100755
--- a/atk/atkrelation.h
+++ b/atk/atkrelation.h
@@ -28,6 +28,7 @@ G_BEGIN_DECLS
 
 #include <glib-object.h>
 #include <atk/atkrelationtype.h>
+#include <atk/atkversion.h>
 
 /*
  * An AtkRelation describes a relation between the object and one or more 
@@ -58,29 +59,38 @@ struct _AtkRelationClass
   GObjectClass parent;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_relation_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 AtkRelationType       atk_relation_type_register      (const gchar     *name);
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_relation_type_get_name      (AtkRelationType type);
+ATK_AVAILABLE_IN_ALL
 AtkRelationType       atk_relation_type_for_name      (const gchar     *name);
 
 /*
  * Create a new relation for the specified key and the specified list
  * of targets.
  */
+ATK_AVAILABLE_IN_ALL
 AtkRelation*          atk_relation_new                (AtkObject       **targets,
                                                        gint            n_targets,
                                                        AtkRelationType relationship);
 /*
  * Returns the type of a relation.
  */
+ATK_AVAILABLE_IN_ALL
 AtkRelationType       atk_relation_get_relation_type  (AtkRelation     *relation);
 /*
  * Returns the target list of a relation.
  */
+ATK_AVAILABLE_IN_ALL
 GPtrArray*            atk_relation_get_target         (AtkRelation     *relation);
+ATK_AVAILABLE_IN_ALL
 void                  atk_relation_add_target         (AtkRelation     *relation,
                                                        AtkObject       *target);
+ATK_AVAILABLE_IN_ALL
 gboolean              atk_relation_remove_target      (AtkRelation     *relation,
                                                        AtkObject       *target);
 
diff --git a/atk/atkrelationset.h b/atk/atkrelationset.h
index 2d97bf1..ed286b4 100755
--- a/atk/atkrelationset.h
+++ b/atk/atkrelationset.h
@@ -55,23 +55,33 @@ struct _AtkRelationSetClass
   AtkFunction pad2;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_relation_set_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 AtkRelationSet* atk_relation_set_new                  (void);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_relation_set_contains             (AtkRelationSet  *set,
                                                        AtkRelationType relationship);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_relation_set_contains_target      (AtkRelationSet  *set,
                                                        AtkRelationType relationship,
                                                        AtkObject       *target);
+ATK_AVAILABLE_IN_ALL
 void            atk_relation_set_remove               (AtkRelationSet  *set,
                                                        AtkRelation     *relation);
+ATK_AVAILABLE_IN_ALL
 void            atk_relation_set_add                  (AtkRelationSet  *set,
                                                        AtkRelation     *relation);
+ATK_AVAILABLE_IN_ALL
 gint            atk_relation_set_get_n_relations      (AtkRelationSet  *set);
+ATK_AVAILABLE_IN_ALL
 AtkRelation*    atk_relation_set_get_relation         (AtkRelationSet  *set,
                                                        gint            i);
+ATK_AVAILABLE_IN_ALL
 AtkRelation*    atk_relation_set_get_relation_by_type (AtkRelationSet  *set,
                                                        AtkRelationType relationship);
+ATK_AVAILABLE_IN_ALL
 void            atk_relation_set_add_relation_by_type (AtkRelationSet  *set,
                                                        AtkRelationType relationship,
                                                        AtkObject       *target);
diff --git a/atk/atkselection.h b/atk/atkselection.h
index 715b97a..0d51cf2 100755
--- a/atk/atkselection.h
+++ b/atk/atkselection.h
@@ -67,24 +67,32 @@ struct _AtkSelectionIface
   void         (*selection_changed)     (AtkSelection   *selection);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_selection_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 gboolean     atk_selection_add_selection        (AtkSelection   *selection,
                                                  gint           i);
 
+ATK_AVAILABLE_IN_ALL
 gboolean     atk_selection_clear_selection      (AtkSelection   *selection);
 
+ATK_AVAILABLE_IN_ALL
 AtkObject*   atk_selection_ref_selection        (AtkSelection   *selection,
                                                  gint           i);
 
+ATK_AVAILABLE_IN_ALL
 gint         atk_selection_get_selection_count  (AtkSelection   *selection);
 
+ATK_AVAILABLE_IN_ALL
 gboolean     atk_selection_is_child_selected    (AtkSelection   *selection,
                                                  gint           i);
 
+ATK_AVAILABLE_IN_ALL
 gboolean     atk_selection_remove_selection     (AtkSelection   *selection,
                                                  gint           i);
 
+ATK_AVAILABLE_IN_ALL
 gboolean     atk_selection_select_all_selection (AtkSelection   *selection);
 
 G_END_DECLS
diff --git a/atk/atksocket.h b/atk/atksocket.h
index 813d4f3..600559b 100644
--- a/atk/atksocket.h
+++ b/atk/atksocket.h
@@ -24,6 +24,8 @@
 #ifndef __ATK_SOCKET_H__
 #define __ATK_SOCKET_H__
 
+#include <atk/atkversion.h>
+
 G_BEGIN_DECLS
 
 #define ATK_TYPE_SOCKET               (atk_socket_get_type ())
@@ -44,6 +46,7 @@ struct _AtkSocket
   gchar* embedded_plug_id;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_socket_get_type (void);
 
 struct _AtkSocketClass
@@ -56,8 +59,11 @@ struct _AtkSocketClass
   void (* embed) (AtkSocket *obj, gchar* plug_id);
 };
 
+ATK_AVAILABLE_IN_ALL
 AtkObject*    atk_socket_new           (void);
+ATK_AVAILABLE_IN_ALL
 void          atk_socket_embed         (AtkSocket* obj, gchar* plug_id);
+ATK_AVAILABLE_IN_ALL
 gboolean      atk_socket_is_occupied   (AtkSocket* obj);
 
 G_END_DECLS
diff --git a/atk/atkstate.h b/atk/atkstate.h
index 66228db..a6967ef 100755
--- a/atk/atkstate.h
+++ b/atk/atkstate.h
@@ -25,6 +25,7 @@
 #define __ATK_STATE_H__
 
 #include <glib-object.h>
+#include <atk/atkversion.h>
 
 G_BEGIN_DECLS
 
@@ -176,9 +177,12 @@ typedef enum
 
 typedef guint64      AtkState;
 
+ATK_AVAILABLE_IN_ALL
 AtkStateType atk_state_type_register            (const gchar *name);
 
+ATK_AVAILABLE_IN_ALL
 const gchar*          atk_state_type_get_name   (AtkStateType type);
+ATK_AVAILABLE_IN_ALL
 AtkStateType          atk_state_type_for_name   (const gchar  *name);
 
 G_END_DECLS
diff --git a/atk/atkstateset.h b/atk/atkstateset.h
index b592eb5..e67679e 100755
--- a/atk/atkstateset.h
+++ b/atk/atkstateset.h
@@ -51,27 +51,39 @@ struct _AtkStateSetClass
   GObjectClass parent;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_state_set_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 AtkStateSet*    atk_state_set_new               (void);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_state_set_is_empty          (AtkStateSet  *set);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_state_set_add_state         (AtkStateSet  *set,
                                                  AtkStateType type);
+ATK_AVAILABLE_IN_ALL
 void            atk_state_set_add_states        (AtkStateSet  *set,
                                                  AtkStateType *types,
                                                  gint         n_types);
+ATK_AVAILABLE_IN_ALL
 void            atk_state_set_clear_states      (AtkStateSet  *set);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_state_set_contains_state    (AtkStateSet  *set,
                                                  AtkStateType type);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_state_set_contains_states   (AtkStateSet  *set,
                                                  AtkStateType *types,
                                                  gint         n_types);
+ATK_AVAILABLE_IN_ALL
 gboolean        atk_state_set_remove_state      (AtkStateSet  *set,
                                                  AtkStateType type);
+ATK_AVAILABLE_IN_ALL
 AtkStateSet*    atk_state_set_and_sets          (AtkStateSet  *set,
                                                  AtkStateSet  *compare_set);
+ATK_AVAILABLE_IN_ALL
 AtkStateSet*    atk_state_set_or_sets           (AtkStateSet  *set,
                                                  AtkStateSet  *compare_set);
+ATK_AVAILABLE_IN_ALL
 AtkStateSet*    atk_state_set_xor_sets          (AtkStateSet  *set,
                                                  AtkStateSet  *compare_set);
 
diff --git a/atk/atkstreamablecontent.h b/atk/atkstreamablecontent.h
index 54d832b..91d09c1 100755
--- a/atk/atkstreamablecontent.h
+++ b/atk/atkstreamablecontent.h
@@ -88,15 +88,20 @@ struct _AtkStreamableContentIface
   AtkFunction               pad2;
   AtkFunction               pad3;
 };
+ATK_AVAILABLE_IN_ALL
 GType                  atk_streamable_content_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 gint                   atk_streamable_content_get_n_mime_types (AtkStreamableContent     *streamable);
-                                                       
+
+ATK_AVAILABLE_IN_ALL
 const gchar*           atk_streamable_content_get_mime_type    (AtkStreamableContent     *streamable,
                                                                 gint                     i);
+ATK_AVAILABLE_IN_ALL
 GIOChannel*             atk_streamable_content_get_stream       (AtkStreamableContent     *streamable,
                                                                  const gchar              *mime_type);
 
+ATK_AVAILABLE_IN_ALL
 const gchar*           atk_streamable_content_get_uri          (AtkStreamableContent     *streamable,
                                                                 const gchar              *mime_type);
 
diff --git a/atk/atktable.h b/atk/atktable.h
index 8aace1f..388f1b8 100755
--- a/atk/atktable.h
+++ b/atk/atktable.h
@@ -128,75 +128,102 @@ struct _AtkTableIface
   void              (* model_changed)            (AtkTable      *table);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_table_get_type (void);
 
+ATK_AVAILABLE_IN_ALL
 AtkObject*        atk_table_ref_at               (AtkTable         *table,
                                                   gint             row,
                                                   gint             column);
-G_DEPRECATED_FOR(atk_table_ref_at)
+ATK_DEPRECATED_IN_2_12_FOR(atk_table_ref_at)
 gint              atk_table_get_index_at         (AtkTable         *table,
                                                   gint             row,
                                                   gint             column);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 gint              atk_table_get_column_at_index  (AtkTable         *table,
                                                   gint             index_);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_12
 gint              atk_table_get_row_at_index     (AtkTable         *table,
                                                   gint             index_);
+ATK_AVAILABLE_IN_ALL
 gint              atk_table_get_n_columns        (AtkTable         *table);
+ATK_AVAILABLE_IN_ALL
 gint              atk_table_get_n_rows           (AtkTable         *table);
+ATK_AVAILABLE_IN_ALL
 gint              atk_table_get_column_extent_at (AtkTable         *table,
                                                   gint             row,
                                                   gint             column);
+ATK_AVAILABLE_IN_ALL
 gint              atk_table_get_row_extent_at    (AtkTable         *table,
                                                   gint             row,
                                                   gint             column);
+ATK_AVAILABLE_IN_ALL
 AtkObject*
                   atk_table_get_caption          (AtkTable         *table);
+ATK_AVAILABLE_IN_ALL
 const gchar*      atk_table_get_column_description
                                                  (AtkTable         *table,
                                                   gint             column);
+ATK_AVAILABLE_IN_ALL
 AtkObject*        atk_table_get_column_header    (AtkTable         *table,
                                                  gint             column);
+ATK_AVAILABLE_IN_ALL
 const gchar*      atk_table_get_row_description  (AtkTable         *table,
                                                   gint             row);
+ATK_AVAILABLE_IN_ALL
 AtkObject*        atk_table_get_row_header       (AtkTable         *table,
                                                  gint             row);
+ATK_AVAILABLE_IN_ALL
 AtkObject*        atk_table_get_summary          (AtkTable         *table);
+ATK_AVAILABLE_IN_ALL
 void              atk_table_set_caption          (AtkTable         *table,
                                                   AtkObject        *caption);
+ATK_AVAILABLE_IN_ALL
 void              atk_table_set_column_description 
                                                  (AtkTable         *table,
                                                   gint             column,
                                                   const gchar      *description);
+ATK_AVAILABLE_IN_ALL
 void              atk_table_set_column_header    (AtkTable         *table,
                                                   gint             column,
                                                   AtkObject        *header);
+ATK_AVAILABLE_IN_ALL
 void              atk_table_set_row_description  (AtkTable         *table,
                                                   gint             row,
                                                   const gchar      *description);
+ATK_AVAILABLE_IN_ALL
 void              atk_table_set_row_header       (AtkTable         *table,
                                                   gint             row,
                                                   AtkObject        *header);
+ATK_AVAILABLE_IN_ALL
 void              atk_table_set_summary          (AtkTable         *table,
                                                   AtkObject        *accessible);
+ATK_AVAILABLE_IN_ALL
 gint              atk_table_get_selected_columns (AtkTable         *table,
                                                   gint             **selected);
+ATK_AVAILABLE_IN_ALL
 gint              atk_table_get_selected_rows    (AtkTable         *table,
                                                   gint             **selected);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_is_column_selected   (AtkTable         *table,
                                                   gint             column);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_is_row_selected      (AtkTable         *table,
                                                   gint             row);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_is_selected          (AtkTable         *table,
                                                   gint             row,
                                                   gint             column);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_add_row_selection    (AtkTable         *table,
                                                   gint             row);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_remove_row_selection (AtkTable         *table,
                                                   gint             row);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_add_column_selection (AtkTable         *table,
                                                   gint             column);
+ATK_AVAILABLE_IN_ALL
 gboolean          atk_table_remove_column_selection  
                                                  (AtkTable         *table,
                                                   gint             column);
diff --git a/atk/atktablecell.h b/atk/atktablecell.h
index b168451..0e70d69 100755
--- a/atk/atktablecell.h
+++ b/atk/atktablecell.h
@@ -75,20 +75,28 @@ struct _AtkTableCellIface
   AtkObject *   (*get_table)               (AtkTableCell *cell);
 };
 
+ATK_AVAILABLE_IN_2_12
 GType atk_table_cell_get_type (void);
 
+ATK_AVAILABLE_IN_2_12
 gint        atk_table_cell_get_column_span         (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
 GPtrArray * atk_table_cell_get_column_header_cells (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
 gboolean    atk_table_cell_get_position            (AtkTableCell *cell,
                                                     gint         *row,
                                                     gint         *column);
+ATK_AVAILABLE_IN_2_12
 gint        atk_table_cell_get_row_span            (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
 GPtrArray * atk_table_cell_get_row_header_cells    (AtkTableCell *cell);
+ATK_AVAILABLE_IN_2_12
 gboolean    atk_table_cell_get_row_column_span     (AtkTableCell *cell,
                                                     gint         *row,
                                                     gint         *column,
                                                     gint         *row_span,
                                                     gint         *column_span);
+ATK_AVAILABLE_IN_2_12
 AtkObject * atk_table_cell_get_table               (AtkTableCell *cell);
 
 G_END_DECLS
diff --git a/atk/atktext.h b/atk/atktext.h
index 2808fc6..cd94130 100755
--- a/atk/atktext.h
+++ b/atk/atktext.h
@@ -97,6 +97,7 @@ typedef enum
   ATK_TEXT_ATTR_LAST_DEFINED
 } AtkTextAttribute;
 
+ATK_AVAILABLE_IN_ALL
 AtkTextAttribute         atk_text_attribute_register   (const gchar *name);
 
 
@@ -208,6 +209,7 @@ struct _AtkTextRange {
   gchar* content;
 };
 
+ATK_AVAILABLE_IN_ALL
 GType atk_text_range_get_type (void);
 
 /**
@@ -333,6 +335,7 @@ struct _AtkTextIface
                                                    gint               *end_offset);
 };
 
+ATK_AVAILABLE_IN_ALL
 GType            atk_text_get_type (void);
 
 
@@ -343,35 +346,40 @@ GType            atk_text_get_type (void);
  *                         editable text only)
  */
 
+ATK_AVAILABLE_IN_ALL
 gchar*        atk_text_get_text                           (AtkText          *text,
                                                            gint             start_offset,
                                                            gint             end_offset);
+ATK_AVAILABLE_IN_ALL
 gunichar      atk_text_get_character_at_offset            (AtkText          *text,
                                                            gint             offset);
-G_DEPRECATED_FOR(atk_text_get_string_at_offset)
+ATK_DEPRECATED_IN_2_10_FOR(atk_text_get_string_at_offset)
 gchar*        atk_text_get_text_after_offset              (AtkText          *text,
                                                            gint             offset,
                                                            AtkTextBoundary  boundary_type,
                                                           gint             *start_offset,
                                                           gint             *end_offset);
-G_DEPRECATED_FOR(atk_text_get_string_at_offset)
+ATK_DEPRECATED_IN_2_10_FOR(atk_text_get_string_at_offset)
 gchar*        atk_text_get_text_at_offset                 (AtkText          *text,
                                                            gint             offset,
                                                            AtkTextBoundary  boundary_type,
                                                           gint             *start_offset,
                                                           gint             *end_offset);
-G_DEPRECATED_FOR(atk_text_get_string_at_offset)
+ATK_DEPRECATED_IN_2_10_FOR(atk_text_get_string_at_offset)
 gchar*        atk_text_get_text_before_offset             (AtkText          *text,
                                                            gint             offset,
                                                            AtkTextBoundary  boundary_type,
                                                           gint             *start_offset,
                                                           gint             *end_offset);
+ATK_AVAILABLE_IN_2_10
 gchar*        atk_text_get_string_at_offset               (AtkText            *text,
                                                            gint               offset,
                                                            AtkTextGranularity granularity,
                                                            gint               *start_offset,
                                                            gint               *end_offset);
+ATK_AVAILABLE_IN_ALL
 gint          atk_text_get_caret_offset                   (AtkText          *text);
+ATK_AVAILABLE_IN_ALL
 void          atk_text_get_character_extents              (AtkText          *text,
                                                            gint             offset,
                                                            gint             *x,
@@ -379,47 +387,64 @@ void          atk_text_get_character_extents              (AtkText          *tex
                                                            gint             *width,
                                                            gint             *height,
                                                            AtkCoordType            coords);
+ATK_AVAILABLE_IN_ALL
 AtkAttributeSet* atk_text_get_run_attributes              (AtkText         *text,
                                                           gint             offset,
                                                           gint             *start_offset,
                                                           gint             *end_offset);
+ATK_AVAILABLE_IN_ALL
 AtkAttributeSet* atk_text_get_default_attributes          (AtkText         *text);
+ATK_AVAILABLE_IN_ALL
 gint          atk_text_get_character_count                (AtkText          *text);
+ATK_AVAILABLE_IN_ALL
 gint          atk_text_get_offset_at_point                (AtkText          *text,
                                                            gint             x,
                                                            gint             y,
                                                            AtkCoordType            coords);
+ATK_AVAILABLE_IN_ALL
 gint          atk_text_get_n_selections                          (AtkText          *text);
+ATK_AVAILABLE_IN_ALL
 gchar*        atk_text_get_selection                     (AtkText          *text,
                                                           gint             selection_num,
                                                           gint             *start_offset,
                                                           gint             *end_offset);
+ATK_AVAILABLE_IN_ALL
 gboolean      atk_text_add_selection                      (AtkText          *text,
                                                           gint             start_offset,
                                                           gint             end_offset);
+ATK_AVAILABLE_IN_ALL
 gboolean      atk_text_remove_selection                   (AtkText          *text,
                                                           gint             selection_num);
+ATK_AVAILABLE_IN_ALL
 gboolean      atk_text_set_selection                      (AtkText          *text,
                                                           gint             selection_num,
                                                           gint             start_offset,
                                                           gint             end_offset);
+ATK_AVAILABLE_IN_ALL
 gboolean      atk_text_set_caret_offset                   (AtkText          *text,
                                                            gint             offset);
+ATK_AVAILABLE_IN_ALL
 void          atk_text_get_range_extents                  (AtkText          *text,
 
                                                            gint             start_offset,
                                                            gint             end_offset,
                                                            AtkCoordType     coord_type,
                                                            AtkTextRectangle *rect);
+ATK_AVAILABLE_IN_ALL
 AtkTextRange**  atk_text_get_bounded_ranges               (AtkText          *text,
                                                            AtkTextRectangle *rect,
                                                            AtkCoordType     coord_type,
                                                            AtkTextClipType  x_clip_type,
                                                            AtkTextClipType  y_clip_type);
+ATK_AVAILABLE_IN_ALL
 void          atk_text_free_ranges                        (AtkTextRange     **ranges);
+ATK_AVAILABLE_IN_ALL
 void         atk_attribute_set_free                      (AtkAttributeSet  *attrib_set);
+ATK_AVAILABLE_IN_ALL
 const gchar*  atk_text_attribute_get_name                 (AtkTextAttribute attr);
+ATK_AVAILABLE_IN_ALL
 AtkTextAttribute       atk_text_attribute_for_name        (const gchar      *name);
+ATK_AVAILABLE_IN_ALL
 const gchar*  atk_text_attribute_get_value                (AtkTextAttribute attr,
                                                            gint             index_);
 
diff --git a/atk/atkutil.h b/atk/atkutil.h
index 0b0c402..79180e2 100755
--- a/atk/atkutil.h
+++ b/atk/atkutil.h
@@ -170,6 +170,7 @@ struct _AtkUtilClass
    const gchar* (* get_toolkit_name)             (void);
    const gchar* (* get_toolkit_version)          (void);
 };
+ATK_AVAILABLE_IN_ALL
 GType atk_util_get_type (void);
 
 /**
@@ -186,25 +187,34 @@ typedef enum {
   ATK_XY_WINDOW
 }AtkCoordType;
 
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_10
 guint    atk_add_focus_tracker     (AtkEventListener      focus_tracker);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_10
 void     atk_remove_focus_tracker  (guint                tracker_id);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_10
 void     atk_focus_tracker_init    (AtkEventListenerInit  init);
-G_DEPRECATED
+ATK_DEPRECATED_IN_2_10
 void     atk_focus_tracker_notify  (AtkObject            *object);
+ATK_AVAILABLE_IN_ALL
 guint  atk_add_global_event_listener (GSignalEmissionHook listener,
                                       const gchar        *event_type);
+ATK_AVAILABLE_IN_ALL
 void   atk_remove_global_event_listener (guint listener_id);
+ATK_AVAILABLE_IN_ALL
 guint  atk_add_key_event_listener (AtkKeySnoopFunc listener, gpointer data);
+ATK_AVAILABLE_IN_ALL
 void   atk_remove_key_event_listener (guint listener_id);
 
+ATK_AVAILABLE_IN_ALL
 AtkObject* atk_get_root(void);
+ATK_AVAILABLE_IN_ALL
 AtkObject* atk_get_focus_object (void);
 
+ATK_AVAILABLE_IN_ALL
 const gchar *atk_get_toolkit_name (void);
+ATK_AVAILABLE_IN_ALL
 const gchar *atk_get_toolkit_version (void);
+ATK_AVAILABLE_IN_ALL
 const gchar *atk_get_version (void);
 
 /* --- GType boilerplate --- */
@@ -305,6 +315,7 @@ static void     type_name##_class_intern_init (gpointer klass) \
   type_name##_class_init ((TypeName##Class*) klass); \
 } \
 \
+ATK_AVAILABLE_IN_ALL \
 GType \
 type_name##_get_type (void) \
 { \
diff --git a/atk/atkvalue.h b/atk/atkvalue.h
index 54919d9..bafbed4 100755
--- a/atk/atkvalue.h
+++ b/atk/atkvalue.h
@@ -119,35 +119,43 @@ struct _AtkValueIface
 
 };
 
+ATK_AVAILABLE_IN_ALL
 GType            atk_value_get_type (void);
 
-G_DEPRECATED_FOR(atk_value_get_value_and_text)
+ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_value_and_text)
 void      atk_value_get_current_value (AtkValue     *obj,
                                        GValue       *value);
 
-G_DEPRECATED_FOR(atk_value_get_range)
+ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_range)
 void     atk_value_get_maximum_value  (AtkValue     *obj,
                                        GValue       *value);
-G_DEPRECATED_FOR(atk_value_get_range)
+ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_range)
 void     atk_value_get_minimum_value  (AtkValue     *obj,
                                        GValue       *value);
-G_DEPRECATED_FOR(atk_value_set_value)
+ATK_DEPRECATED_IN_2_12_FOR(atk_value_set_value)
 gboolean atk_value_set_current_value  (AtkValue     *obj,
                                        const GValue *value);
-G_DEPRECATED_FOR(atk_value_get_increment)
+ATK_DEPRECATED_IN_2_12_FOR(atk_value_get_increment)
 void     atk_value_get_minimum_increment  (AtkValue     *obj,
                                           GValue       *value);
 
+ATK_AVAILABLE_IN_2_12
 void      atk_value_get_value_and_text (AtkValue *obj,
                                         gdouble *value,
                                         gchar  **text);
+ATK_AVAILABLE_IN_2_12
 AtkRange* atk_value_get_range          (AtkValue *obj);
+ATK_AVAILABLE_IN_2_12
 gdouble   atk_value_get_increment      (AtkValue *obj);
+ATK_AVAILABLE_IN_2_12
 GSList*   atk_value_get_sub_ranges     (AtkValue *obj);
+ATK_AVAILABLE_IN_2_12
 void      atk_value_set_value          (AtkValue     *obj,
                                         const gdouble new_value);
 /* AtkValueType methods */
+ATK_AVAILABLE_IN_ALL
 const gchar* atk_value_type_get_name           (AtkValueType value_type);
+ATK_AVAILABLE_IN_ALL
 const gchar* atk_value_type_get_localized_name (AtkValueType value_type);
 
 G_END_DECLS
diff --git a/atk/atkwindow.h b/atk/atkwindow.h
index dfc38ba..a9a5b4b 100644
--- a/atk/atkwindow.h
+++ b/atk/atkwindow.h
@@ -46,6 +46,7 @@ struct _AtkWindowIface
   GTypeInterface parent;
 };
 
+ATK_AVAILABLE_IN_2_2
 GType atk_window_get_type (void);
 G_END_DECLS
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]