Version information

Version information — Checking the telepathy-glib version

Synopsis

#include <telepathy-glib/telepathy-glib.h>

#define             TP_MAJOR_VERSION
#define             TP_MINOR_VERSION
#define             TP_MICRO_VERSION
#define             TP_VERSION_0_16
#define             TP_VERSION_0_18
#define             TP_VERSION_0_20
#define             TP_VERSION_0_22
#define             TP_VERSION_0_24
#define             TP_VERSION_MIN_REQUIRED
#define             TP_VERSION_MAX_ALLOWED

Description

Since 0.19.0, telepathy-glib provides version information similar to that used in GLib.

Typical usage from configure.ac is similar to GLib's:

1
2
3
4
AC_DEFINE([TP_VERSION_MIN_REQUIRED], [TP_VERSION_0_18],
  [Ignore deprecations newer than this branch])
AC_DEFINE([TP_VERSION_MAX_ALLOWED], [TP_VERSION_0_20],
  [Prevent use of APIs newer than this branch])

or you can define the macros directly on the compiler command line if required:

1
2
3
4
cc -o foo foo.c \
    -DTP_VERSION_MIN_REQUIRED=TP_VERSION_0_18 \
    -DTP_VERSION_MAX_ALLOWED=TP_VERSION_0_20 \
    ${TP_CFLAGS} ${TP_LIBS}

This functionality was added in telepathy-glib 0.19.0, but it is safe to define the TP_VERSION_MIN_REQUIRED and TP_VERSION_MAX_ALLOWED macros even for older versions of telepathy-glib, as long as you do not try to expand them.

Details

TP_MAJOR_VERSION

#define TP_MAJOR_VERSION 0

The major version of telepathy-glib (e.g. the 0 in 0.18.1) at the time your code was compiled.


TP_MINOR_VERSION

#define TP_MINOR_VERSION 24

The minor version of telepathy-glib (e.g. the 18 in 0.18.1) at the time your code was compiled.

Odd minor versions indicate a development branch; even minor versions indicate a stable branch.


TP_MICRO_VERSION

#define TP_MICRO_VERSION 1

The micro version of telepathy-glib (e.g. the 1 in 0.18.1) at the time your code was compiled.

Within a stable branch (even minor version), micro versions fix bugs but do not add features.

Within a development branch (odd minor version), micro versions can fix bugs and/or add features.


TP_VERSION_0_16

#define TP_VERSION_0_16 (_TP_ENCODE_VERSION (0, 16))

A constant representing the telepathy-glib 0.16 stable branch, and the 0.15 development branch that led to it.


TP_VERSION_0_18

#define TP_VERSION_0_18 (_TP_ENCODE_VERSION (0, 18))

A constant representing the telepathy-glib 0.18 stable branch, and the 0.17 development branch that led to it.


TP_VERSION_0_20

#define TP_VERSION_0_20 (_TP_ENCODE_VERSION (0, 20))

A constant representing the telepathy-glib 0.20 stable branch, and the 0.19 development branch that led to it.


TP_VERSION_0_22

#define TP_VERSION_0_22 (_TP_ENCODE_VERSION (0, 22))

A constant representing the telepathy-glib 0.22 stable branch, and the 0.21 development branch that led to it.


TP_VERSION_0_24

#define TP_VERSION_0_24 (_TP_ENCODE_VERSION (0, 24))

A constant representing the telepathy-glib 0.24 stable branch, and the 0.23 development branch that led to it.


TP_VERSION_MIN_REQUIRED

# define TP_VERSION_MIN_REQUIRED (_TP_VERSION_CUR_STABLE)

A version-number constant like TP_VERSION_0_18.

This may be defined to a value like TP_VERSION_0_18 by users of telepathy-glib, to set the minimum version they wish to require. Warnings will be issued for functions deprecated in or before that version.

If not defined, the default value is the previous stable branch.


TP_VERSION_MAX_ALLOWED

# define TP_VERSION_MAX_ALLOWED (_TP_VERSION_CUR_STABLE)

A version-number constant like TP_VERSION_0_18.

This may be defined to a value like TP_VERSION_0_18 by users of telepathy-glib, to set the maximum version they wish to depend on. Warnings will be issued for functions deprecated in or before that version.

If not defined, the default value in stable branches is that stable branch, and the default value in development branches is the next stable branch.