| Current File : //usr/include/atk-1.0/atk/atkversion.h |
/* ATK - Accessibility Toolkit
*
* Copyright (C) 2012 Igalia, S.L.
* Copyright (C) 2014 Chun-wei Fan
*
* Author: Alejandro Piñeiro Iglesias <apinheiro@igalia.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#if defined(ATK_DISABLE_SINGLE_INCLUDES) && !defined (__ATK_H_INSIDE__) && !defined (ATK_COMPILATION)
#error "Only <atk/atk.h> can be included directly."
#endif
#ifndef __ATK_VERSION_H__
#define __ATK_VERSION_H__
#include <glib.h>
/**
* ATK_MAJOR_VERSION:
*
* Like atk_get_major_version(), but from the headers used at
* application compile time, rather than from the library linked
* against at application run time.
*
* Since: 2.7.4
*/
#define ATK_MAJOR_VERSION (2)
/**
* ATK_MINOR_VERSION:
*
* Like atk_get_minor_version(), but from the headers used at
* application compile time, rather than from the library linked
* against at application run time.
*
* Since: 2.7.4
*/
#define ATK_MINOR_VERSION (28)
/**
* ATK_MICRO_VERSION:
*
* Like atk_get_micro_version(), but from the headers used at
* application compile time, rather than from the library linked
* against at application run time.
*
* Since: 2.7.4
*/
#define ATK_MICRO_VERSION (1)
/**
* ATK_BINARY_AGE:
*
* Like atk_get_binary_age(), but from the headers used at
* application compile time, rather than from the library linked
* against at application run time.
*
* Since: 2.7.4
*/
#define ATK_BINARY_AGE (22811)
/**
* ATK_INTERFACE_AGE:
*
* Like atk_get_interface_age(), but from the headers used at
* application compile time, rather than from the library linked
* against at application run time.
*
* Since: 2.7.4
*/
#define ATK_INTERFACE_AGE (1)
/**
* ATK_CHECK_VERSION:
* @major: major version (e.g. 1 for version 1.2.5)
* @minor: minor version (e.g. 2 for version 1.2.5)
* @micro: micro version (e.g. 5 for version 1.2.5)
*
* Returns %TRUE if the version of the ATK header files is the same as
* or newer than the passed-in version.
*
* Since: 2.7.4
*/
#define ATK_CHECK_VERSION(major,minor,micro) \
(ATK_MAJOR_VERSION > (major) || \
(ATK_MAJOR_VERSION == (major) && ATK_MINOR_VERSION > (minor)) || \
(ATK_MAJOR_VERSION == (major) && ATK_MINOR_VERSION == (minor) && \
ATK_MICRO_VERSION >= (micro)))
#ifndef _ATK_EXTERN
#define _ATK_EXTERN extern
#endif
/**
* ATK_VERSION_2_2:
*
* A macro that evaluates to the 2.2 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_2 (G_ENCODE_VERSION (2, 2))
/**
* ATK_VERSION_2_4:
*
* A macro that evaluates to the 2.4 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_4 (G_ENCODE_VERSION (2, 4))
/**
* ATK_VERSION_2_6:
*
* A macro that evaluates to the 2.6 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_6 (G_ENCODE_VERSION (2, 6))
/**
* ATK_VERSION_2_8:
*
* A macro that evaluates to the 2.8 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_8 (G_ENCODE_VERSION (2, 8))
/**
* ATK_VERSION_2_10:
*
* A macro that evaluates to the 2.10 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_10 (G_ENCODE_VERSION (2, 10))
/**
* ATK_VERSION_2_12:
*
* A macro that evaluates to the 2.12 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_12 (G_ENCODE_VERSION (2, 12))
/**
* ATK_VERSION_2_14:
*
* A macro that evaluates to the 2.14 version of ATK, in a format
* that can be used by the C pre-processor.
*
* Since: 2.14
*/
#define ATK_VERSION_2_14 (G_ENCODE_VERSION (2, 14))
/* evaluates to the current stable version; for development cycles,
* this means the next stable target
*/
#if (ATK_MINOR_VERSION % 2)
#define ATK_VERSION_CUR_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION + 1))
#else
#define ATK_VERSION_CUR_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION))
#endif
/* evaluates to the previous stable version */
#if (ATK_MINOR_VERSION % 2)
#define ATK_VERSION_PREV_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION - 1))
#else
#define ATK_VERSION_PREV_STABLE (G_ENCODE_VERSION (ATK_MAJOR_VERSION, ATK_MINOR_VERSION - 2))
#endif
/**
* ATK_VERSION_MIN_REQUIRED:
*
* A macro that should be defined by the user prior to including
* the atk/atk.h header.
* The definition should be one of the predefined ATK version
* macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
*
* This macro defines the earliest version of ATK that the package is
* required to be able to compile against.
*
* If the compiler is configured to warn about the use of deprecated
* functions, then using functions that were deprecated in version
* %ATK_VERSION_MIN_REQUIRED or earlier will cause warnings (but
* using functions deprecated in later releases will not).
*
* Since: 2.14
*/
/* If the package sets ATK_VERSION_MIN_REQUIRED to some future
* ATK_VERSION_X_Y value that we don't know about, it will compare as
* 0 in preprocessor tests.
*/
#ifndef ATK_VERSION_MIN_REQUIRED
# define ATK_VERSION_MIN_REQUIRED (ATK_VERSION_CUR_STABLE)
#elif ATK_VERSION_MIN_REQUIRED == 0
# undef ATK_VERSION_MIN_REQUIRED
# define ATK_VERSION_MIN_REQUIRED (ATK_VERSION_CUR_STABLE + 2)
#endif
/**
* ATK_VERSION_MAX_ALLOWED:
*
* A macro that should be defined by the user prior to including
* the atk/atk.h header.
* The definition should be one of the predefined ATK version
* macros: %ATK_VERSION_2_12, %ATK_VERSION_2_14,...
*
* This macro defines the latest version of the ATK API that the
* package is allowed to make use of.
*
* If the compiler is configured to warn about the use of deprecated
* functions, then using functions added after version
* %ATK_VERSION_MAX_ALLOWED will cause warnings.
*
* Unless you are using ATK_CHECK_VERSION() or the like to compile
* different code depending on the ATK version, then this should be
* set to the same value as %ATK_VERSION_MIN_REQUIRED.
*
* Since: 2.14
*/
#if !defined (ATK_VERSION_MAX_ALLOWED) || (ATK_VERSION_MAX_ALLOWED == 0)
# undef ATK_VERSION_MAX_ALLOWED
# define ATK_VERSION_MAX_ALLOWED (ATK_VERSION_CUR_STABLE)
#endif
/* sanity checks */
#if ATK_VERSION_MIN_REQUIRED > ATK_VERSION_CUR_STABLE
#error "ATK_VERSION_MIN_REQUIRED must be <= ATK_VERSION_CUR_STABLE"
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_MIN_REQUIRED
#error "ATK_VERSION_MAX_ALLOWED must be >= ATK_VERSION_MIN_REQUIRED"
#endif
#if ATK_VERSION_MIN_REQUIRED < ATK_VERSION_2_2
#error "ATK_VERSION_MIN_REQUIRED must be >= ATK_VERSION_2_2"
#endif
/* these macros are used to mark deprecated functions, and thus have to be
* exposed in a public header.
*
* do *not* use them in other libraries depending on Atk: use G_DEPRECATED
* and G_DEPRECATED_FOR, or use your own wrappers around them.
*/
#ifdef ATK_DISABLE_DEPRECATION_WARNINGS
#define ATK_DEPRECATED _ATK_EXTERN
#define ATK_DEPRECATED_FOR(f) _ATK_EXTERN
#define ATK_UNAVAILABLE(maj,min) _ATK_EXTERN
#else
#define ATK_DEPRECATED G_DEPRECATED _ATK_EXTERN
#define ATK_DEPRECATED_FOR(f) G_DEPRECATED_FOR(f) _ATK_EXTERN
#define ATK_UNAVAILABLE(maj,min) G_UNAVAILABLE(maj,min) _ATK_EXTERN
#endif
#define ATK_AVAILABLE_IN_ALL _ATK_EXTERN
/* XXX: Every new stable minor release should add a set of macros here */
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_2
# define ATK_DEPRECATED_IN_2_2 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_2_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_2 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_2_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_2
# define ATK_AVAILABLE_IN_2_2 ATK_UNAVAILABLE(2, 2)
#else
# define ATK_AVAILABLE_IN_2_2 _ATK_EXTERN
#endif
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_4
# define ATK_DEPRECATED_IN_2_4 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_4_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_4 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_4_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_4
# define ATK_AVAILABLE_IN_2_4 ATK_UNAVAILABLE(2, 4)
#else
# define ATK_AVAILABLE_IN_2_4 _ATK_EXTERN
#endif
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_6
# define ATK_DEPRECATED_IN_2_6 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_6_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_6 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_6_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_6
# define ATK_AVAILABLE_IN_2_6 ATK_UNAVAILABLE(2, 6)
#else
# define ATK_AVAILABLE_IN_2_6 _ATK_EXTERN
#endif
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_8
# define ATK_DEPRECATED_IN_2_8 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_8_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_8 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_8_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_8
# define ATK_AVAILABLE_IN_2_8 ATK_UNAVAILABLE(2, 8)
#else
# define ATK_AVAILABLE_IN_2_8 _ATK_EXTERN
#endif
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_10
# define ATK_DEPRECATED_IN_2_10 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_10_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_10 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_10_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_10
# define ATK_AVAILABLE_IN_2_10 ATK_UNAVAILABLE(2, 10)
#else
# define ATK_AVAILABLE_IN_2_10 _ATK_EXTERN
#endif
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_12
# define ATK_DEPRECATED_IN_2_12 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_12_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_12 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_12_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_12
# define ATK_AVAILABLE_IN_2_12 ATK_UNAVAILABLE(2, 12)
#else
# define ATK_AVAILABLE_IN_2_12 _ATK_EXTERN
#endif
#if ATK_VERSION_MIN_REQUIRED >= ATK_VERSION_2_14
# define ATK_DEPRECATED_IN_2_14 ATK_DEPRECATED
# define ATK_DEPRECATED_IN_2_14_FOR(f) ATK_DEPRECATED_FOR(f)
#else
# define ATK_DEPRECATED_IN_2_14 _ATK_EXTERN
# define ATK_DEPRECATED_IN_2_14_FOR(f) _ATK_EXTERN
#endif
#if ATK_VERSION_MAX_ALLOWED < ATK_VERSION_2_14
# define ATK_AVAILABLE_IN_2_14 ATK_UNAVAILABLE(2, 14)
#else
# define ATK_AVAILABLE_IN_2_14 _ATK_EXTERN
#endif
ATK_AVAILABLE_IN_2_8
guint atk_get_major_version (void) G_GNUC_CONST;
ATK_AVAILABLE_IN_2_8
guint atk_get_minor_version (void) G_GNUC_CONST;
ATK_AVAILABLE_IN_2_8
guint atk_get_micro_version (void) G_GNUC_CONST;
ATK_AVAILABLE_IN_2_8
guint atk_get_binary_age (void) G_GNUC_CONST;
ATK_AVAILABLE_IN_2_8
guint atk_get_interface_age (void) G_GNUC_CONST;
#define atk_major_version atk_get_major_version ()
#define atk_minor_version atk_get_minor_version ()
#define atk_micro_version atk_get_micro_version ()
#define atk_binary_age atk_get_binary_age ()
#define atk_interface_age atk_get_interface_age ()
#endif /* __ATK_VERSION_H__ */