Add a header for versioning macros

This header is used for:
-Indicating what stable versions an API is introduced at and after 1.30.0.
-Indicating what APIs are deprecated, and which stable release series
 they are deprecated if the deprecation is done after 1.30.0.  This replaces
 the use of G_DEPRECATED* in Pango.
-Use in a later commit to be used to export symbols directly via compiler
 directives instead of doing so over .def files, for compilers that do not
 support exporting via regex expressions.

2 files changed, 652 insertions, 24 deletions

diff --git a/pango/Makefile.am b/pango/Makefile.am
index eca0d8b2..b239170b 100644
--- a/pango/Makefile.am
+++ b/pango/Makefile.am
@@ -97,30 +97,31 @@ libpango_1_0_la_SOURCES =			\
 	shape.c					\
 	pango-enum-types.c
 
-pango_headers =		   \
-	pango.h		   \
-	pango-attributes.h \
-	pango-bidi-type.h  \
-	pango-break.h	   \
-	pango-context.h	   \
-	pango-coverage.h   \
-	pango-engine.h	   \
-	pango-font.h       \
-	pango-fontmap.h	   \
-	pango-fontset.h    \
-	pango-glyph.h	   \
-	pango-glyph-item.h \
-	pango-gravity.h    \
-	pango-item.h	   \
-	pango-language.h   \
-	pango-layout.h	   \
-	pango-matrix.h     \
-	pango-modules.h	   \
-	pango-renderer.h   \
-	pango-script.h	   \
-	pango-tabs.h	   \
-	pango-types.h	   \
-	pango-utils.h
+pango_headers =		\
+	pango.h			\
+	pango-attributes.h	\
+	pango-bidi-type.h	\
+	pango-break.h		\
+	pango-context.h		\
+	pango-coverage.h	\
+	pango-engine.h		\
+	pango-font.h		\
+	pango-fontmap.h		\
+	pango-fontset.h		\
+	pango-glyph.h		\
+	pango-glyph-item.h	\
+	pango-gravity.h		\
+	pango-item.h		\
+	pango-language.h	\
+	pango-layout.h		\
+	pango-matrix.h		\
+	pango-modules.h		\
+	pango-renderer.h	\
+	pango-script.h		\
+	pango-tabs.h		\
+	pango-types.h		\
+	pango-utils.h		\
+	pango-version-macros.h
 
 pangoinclude_HEADERS =	   \
 	$(pango_headers)   \
diff --git a/pango/pango-version-macros.h b/pango/pango-version-macros.h
new file mode 100644
index 00000000..827dd739
--- /dev/null
+++ b/pango/pango-version-macros.h
@@ -0,0 +1,627 @@
+/* Pango - Internationalized text layout and rendering library
+ * Copyright (C) 2016  Chun-wei Fan
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser 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
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __PANGO_VERSION_H__
+#define __PANGO_VERSION_H__
+
+#include <pango/pango-features.h>
+
+#include <glib.h>
+
+#ifndef _PANGO_EXTERN
+#define _PANGO_EXTERN extern
+#endif
+
+#define PANGO_AVAILABLE_IN_ALL                   _PANGO_EXTERN
+
+/* XXX: Every new stable minor release bump should add a macro here */
+
+/**
+ * PANGO_VERSION_1_2:
+ *
+ * A macro that evaluates to the 1.2 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_2        (G_ENCODE_VERSION (1, 2))
+
+/**
+ * PANGO_VERSION_1_4:
+ *
+ * A macro that evaluates to the 1.4 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_4        (G_ENCODE_VERSION (1, 4))
+
+/**
+ * PANGO_VERSION_1_6:
+ *
+ * A macro that evaluates to the 1.6 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_6        (G_ENCODE_VERSION (1, 6))
+
+/**
+ * PANGO_VERSION_1_8:
+ *
+ * A macro that evaluates to the 1.8 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_8        (G_ENCODE_VERSION (1, 8))
+
+/**
+ * PANGO_VERSION_1_10:
+ *
+ * A macro that evaluates to the 1.10 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_10       (G_ENCODE_VERSION (1, 10))
+
+/**
+ * PANGO_VERSION_1_12:
+ *
+ * A macro that evaluates to the 1.12 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_12       (G_ENCODE_VERSION (1, 12))
+
+/**
+ * PANGO_VERSION_1_14:
+ *
+ * A macro that evaluates to the 1.14 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_14       (G_ENCODE_VERSION (1, 14))
+
+/**
+ * PANGO_VERSION_1_16:
+ *
+ * A macro that evaluates to the 1.16 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_16       (G_ENCODE_VERSION (1, 16))
+
+/**
+ * PANGO_VERSION_1_18:
+ *
+ * A macro that evaluates to the 1.18 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_18       (G_ENCODE_VERSION (1, 18))
+
+/**
+ * PANGO_VERSION_1_20:
+ *
+ * A macro that evaluates to the 1.20 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_20       (G_ENCODE_VERSION (1, 20))
+
+/**
+ * PANGO_VERSION_1_22:
+ *
+ * A macro that evaluates to the 1.22 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_22       (G_ENCODE_VERSION (1, 22))
+
+/**
+ * PANGO_VERSION_1_24:
+ *
+ * A macro that evaluates to the 1.24 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_24       (G_ENCODE_VERSION (1, 24))
+
+/**
+ * PANGO_VERSION_1_26:
+ *
+ * A macro that evaluates to the 1.26 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_26       (G_ENCODE_VERSION (1, 26))
+
+/**
+ * PANGO_VERSION_1_28:
+ *
+ * A macro that evaluates to the 1.28 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_28       (G_ENCODE_VERSION (1, 28))
+
+/**
+ * PANGO_VERSION_1_30:
+ *
+ * A macro that evaluates to the 1.30 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_30       (G_ENCODE_VERSION (1, 30))
+
+/**
+ * PANGO_VERSION_1_32:
+ *
+ * A macro that evaluates to the 1.32 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_32       (G_ENCODE_VERSION (1, 32))
+
+/**
+ * PANGO_VERSION_1_34:
+ *
+ * A macro that evaluates to the 1.34 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_34       (G_ENCODE_VERSION (1, 34))
+
+/**
+ * PANGO_VERSION_1_36:
+ *
+ * A macro that evaluates to the 1.36 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_36       (G_ENCODE_VERSION (1, 36))
+
+/**
+ * PANGO_VERSION_1_38:
+ *
+ * A macro that evaluates to the 1.38 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_38       (G_ENCODE_VERSION (1, 38))
+
+/**
+ * PANGO_VERSION_1_40:
+ *
+ * A macro that evaluates to the 1.40 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_40       (G_ENCODE_VERSION (1, 40))
+
+/**
+ * PANGO_VERSION_1_42:
+ *
+ * A macro that evaluates to the 2.38 version of Pango, in a format
+ * that can be used by the C pre-processor.
+ *
+ * Since: 1.42
+ */
+#define PANGO_VERSION_1_42       (G_ENCODE_VERSION (1, 42))
+
+/* evaluates to the current stable version; for development cycles,
+ * this means the next stable target
+ */
+#if (PANGO_VERSION_MINOR % 2)
+#define PANGO_VERSION_CUR_STABLE         (G_ENCODE_VERSION (PANGO_VERSION_MAJOR, PANGO_VERSION_MINOR + 1))
+#else
+#define PANGO_VERSION_CUR_STABLE         (G_ENCODE_VERSION (PANGO_VERSION_MAJOR, PANGO_VERSION_MINOR))
+#endif
+
+/* evaluates to the previous stable version */
+#if (PANGO_VERSION_MINOR % 2)
+#define PANGO_VERSION_PREV_STABLE        (G_ENCODE_VERSION (PANGO_VERSION_MAJOR, PANGO_VERSION_MINOR - 1))
+#else
+#define PANGO_VERSION_PREV_STABLE        (G_ENCODE_VERSION (PANGO_VERSION_MAJOR, PANGO_VERSION_MINOR - 2))
+#endif
+
+/**
+ * PANGO_VERSION_MIN_REQUIRED:
+ *
+ * A macro that should be defined by the user prior to including
+ * the pango.h header.
+ * The definition should be one of the predefined Pango version
+ * macros: %PANGO_VERSION_1_2, %PANGO_VERSION_1_4,...
+ *
+ * This macro defines the earliest version of Pango 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
+ * %PANGO_VERSION_MIN_REQUIRED or earlier will cause warnings (but
+ * using functions deprecated in later releases will not).
+ *
+ * Since: 1.42
+ */
+/* If the package sets PANGO_VERSION_MIN_REQUIRED to some future
+ * PANGO_VERSION_X_Y value that we don't know about, it will compare as
+ * 0 in preprocessor tests.
+ */
+#ifndef PANGO_VERSION_MIN_REQUIRED
+# define PANGO_VERSION_MIN_REQUIRED      (PANGO_VERSION_CUR_STABLE)
+#elif PANGO_VERSION_MIN_REQUIRED == 0
+# undef  PANGO_VERSION_MIN_REQUIRED
+# define PANGO_VERSION_MIN_REQUIRED      (PANGO_VERSION_CUR_STABLE + 2)
+#endif
+
+/**
+ * PANGO_VERSION_MAX_ALLOWED:
+ *
+ * A macro that should be defined by the user prior to including
+ * the glib.h header.
+ * The definition should be one of the predefined Pango version
+ * macros: %PANGO_VERSION_1_2, %PANGO_VERSION_1_4,...
+ *
+ * This macro defines the latest version of the Pango 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
+ * %PANGO_VERSION_MAX_ALLOWED will cause warnings.
+ *
+ * Unless you are using PANGO_CHECK_VERSION() or the like to compile
+ * different code depending on the Pango version, then this should be
+ * set to the same value as %PANGO_VERSION_MIN_REQUIRED.
+ *
+ * Since: 1.42
+ */
+#if !defined (PANGO_VERSION_MAX_ALLOWED) || (PANGO_VERSION_MAX_ALLOWED == 0)
+# undef PANGO_VERSION_MAX_ALLOWED
+# define PANGO_VERSION_MAX_ALLOWED      (PANGO_VERSION_CUR_STABLE)
+#endif
+
+/* sanity checks */
+#if PANGO_VERSION_MIN_REQUIRED > PANGO_VERSION_CUR_STABLE
+#error "PANGO_VERSION_MIN_REQUIRED must be <= PANGO_VERSION_CUR_STABLE"
+#endif
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_MIN_REQUIRED
+#error "PANGO_VERSION_MAX_ALLOWED must be >= PANGO_VERSION_MIN_REQUIRED"
+#endif
+#if PANGO_VERSION_MIN_REQUIRED < PANGO_VERSION_1_2
+#error "PANGO_VERSION_MIN_REQUIRED must be >= PANGO_VERSION_1_2"
+#endif
+
+/* These macros are used to mark deprecated functions in Pango headers,
+ * and thus have to be exposed in installed headers.
+ */
+#define PANGO_DEPRECATED                         G_DEPRECATED _PANGO_EXTERN
+#define PANGO_DEPRECATED_FOR(f)                  G_DEPRECATED_FOR(f) _PANGO_EXTERN
+
+/* XXX: Every new stable minor release should add a set of macros here */
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_2
+# define PANGO_DEPRECATED_IN_1_2                 G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_2_FOR(f)          G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_2                 _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_2_FOR(f)          _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_2
+# define PANGO_AVAILABLE_IN_1_2                  PANGO_UNAVAILABLE(1, 2)
+#else
+# define PANGO_AVAILABLE_IN_1_2                  _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_4
+# define PANGO_DEPRECATED_IN_1_4                 G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_4_FOR(f)          G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_4                 _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_4_FOR(f)          _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_4
+# define PANGO_AVAILABLE_IN_1_4                  PANGO_UNAVAILABLE(1, 4)
+#else
+# define PANGO_AVAILABLE_IN_1_4                  _PANGO_EXTERN
+#endif
+
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_6
+# define PANGO_DEPRECATED_IN_1_6                 G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_6_FOR(f)          G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_6                 _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_6_FOR(f)          _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_6
+# define PANGO_AVAILABLE_IN_1_6                  PANGO_UNAVAILABLE(1, 6)
+#else
+# define PANGO_AVAILABLE_IN_1_6                  _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_8
+# define PANGO_DEPRECATED_IN_1_8                 G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_8_FOR(f)          G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_8                 _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_8_FOR(f)          _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_8
+# define PANGO_AVAILABLE_IN_1_8                  PANGO_UNAVAILABLE(1, 8)
+#else
+# define PANGO_AVAILABLE_IN_1_8                  _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_10
+# define PANGO_DEPRECATED_IN_1_10                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_10_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_10                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_10_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_10
+# define PANGO_AVAILABLE_IN_1_10                 PANGO_UNAVAILABLE(1, 10)
+#else
+# define PANGO_AVAILABLE_IN_1_10                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_12
+# define PANGO_AVAILABLE_IN_1_12                 PANGO_UNAVAILABLE(1, 12)
+#else
+# define PANGO_AVAILABLE_IN_1_12                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_12
+# define PANGO_DEPRECATED_IN_1_12                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_12_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_12                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_12_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_14
+# define PANGO_AVAILABLE_IN_1_14                 PANGO_UNAVAILABLE(1, 14)
+#else
+# define PANGO_AVAILABLE_IN_1_14                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_14
+# define PANGO_DEPRECATED_IN_1_14                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_14_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_14                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_14_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_16
+# define PANGO_AVAILABLE_IN_1_16                 PANGO_UNAVAILABLE(1, 16)
+#else
+# define PANGO_AVAILABLE_IN_1_16                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_16
+# define PANGO_DEPRECATED_IN_1_16                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_16_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_16                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_16_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_18
+# define PANGO_DEPRECATED_IN_1_18                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_18_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_18                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_18_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_18
+# define PANGO_AVAILABLE_IN_1_18                 PANGO_UNAVAILABLE(1, 18)
+#else
+# define PANGO_AVAILABLE_IN_1_18                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_20
+# define PANGO_DEPRECATED_IN_1_20                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_20_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_20                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_20_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_20
+# define PANGO_AVAILABLE_IN_1_20                 PANGO_UNAVAILABLE(1, 20)
+#else
+# define PANGO_AVAILABLE_IN_1_20                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_22
+# define PANGO_DEPRECATED_IN_1_22                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_22_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_22                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_22_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_22
+# define PANGO_AVAILABLE_IN_1_22                 PANGO_UNAVAILABLE(1, 22)
+#else
+# define PANGO_AVAILABLE_IN_1_22                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_24
+# define PANGO_DEPRECATED_IN_1_24                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_24_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_24                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_24_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_24
+# define PANGO_AVAILABLE_IN_1_24                 PANGO_UNAVAILABLE(1, 24)
+#else
+# define PANGO_AVAILABLE_IN_1_24                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_26
+# define PANGO_DEPRECATED_IN_1_26                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_26_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_26                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_26_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_26
+# define PANGO_AVAILABLE_IN_1_26                 PANGO_UNAVAILABLE(1, 26)
+#else
+# define PANGO_AVAILABLE_IN_1_26                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_28
+# define PANGO_DEPRECATED_IN_1_28                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_28_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_28                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_28_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_28
+# define PANGO_AVAILABLE_IN_1_28                 PANGO_UNAVAILABLE(1, 28)
+#else
+# define PANGO_AVAILABLE_IN_1_28                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_30
+# define PANGO_DEPRECATED_IN_1_30                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_30_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_30                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_30_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_30
+# define PANGO_AVAILABLE_IN_1_30                 PANGO_UNAVAILABLE(1, 30)
+#else
+# define PANGO_AVAILABLE_IN_1_30                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_32
+# define PANGO_DEPRECATED_IN_1_32                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_32_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_32                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_32_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_32
+# define PANGO_AVAILABLE_IN_1_32                 PANGO_UNAVAILABLE(1, 32)
+#else
+# define PANGO_AVAILABLE_IN_1_32                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_34
+# define PANGO_DEPRECATED_IN_1_34                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_34_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_34                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_34_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_34
+# define PANGO_AVAILABLE_IN_1_34                 PANGO_UNAVAILABLE(1, 34)
+#else
+# define PANGO_AVAILABLE_IN_1_34                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_36
+# define PANGO_DEPRECATED_IN_1_36                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_36_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_36                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_36_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_36
+# define PANGO_AVAILABLE_IN_1_36                 PANGO_UNAVAILABLE(1, 36)
+#else
+# define PANGO_AVAILABLE_IN_1_36                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_38
+# define PANGO_DEPRECATED_IN_1_38                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_38_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_38                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_38_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_38
+# define PANGO_AVAILABLE_IN_1_38                 PANGO_UNAVAILABLE(1, 38)
+#else
+# define PANGO_AVAILABLE_IN_1_38                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_40
+# define PANGO_DEPRECATED_IN_1_40                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_40_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_40                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_40_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_40
+# define PANGO_AVAILABLE_IN_1_40                 PANGO_UNAVAILABLE(1, 40)
+#else
+# define PANGO_AVAILABLE_IN_1_40                 _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MIN_REQUIRED >= PANGO_VERSION_1_42
+# define PANGO_DEPRECATED_IN_1_42                G_DEPRECATED _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_42_FOR(f)         G_DEPRECATED_FOR(f) _PANGO_EXTERN
+#else
+# define PANGO_DEPRECATED_IN_1_42                _PANGO_EXTERN
+# define PANGO_DEPRECATED_IN_1_42_FOR(f)         _PANGO_EXTERN
+#endif
+
+#if PANGO_VERSION_MAX_ALLOWED < PANGO_VERSION_1_42
+# define PANGO_AVAILABLE_IN_1_42                 PANGO_UNAVAILABLE(1, 42)
+#else
+# define PANGO_AVAILABLE_IN_1_42                 _PANGO_EXTERN
+#endif
+
+#endif /* __PANGO_VERSION_H__ */