Version Information

Version Information — Compile-time and run-time version checks.

Synopsis

#define             CAIRO_VERSION
#define             CAIRO_VERSION_MAJOR
#define             CAIRO_VERSION_MINOR
#define             CAIRO_VERSION_MICRO
#define             CAIRO_VERSION_STRING
#define             CAIRO_VERSION_ENCODE                (major, minor, micro)
#define             CAIRO_VERSION_STRINGIZE             (major, minor, micro)
int                 cairo_version                       (void);
const char *        cairo_version_string                (void);

Description

Cairo has a three-part version number scheme. In this scheme, we use even vs. odd numbers to distinguish fixed points in the software vs. in-progress development, (such as from git instead of a tar file, or as a "snapshot" tar file as opposed to a "release" tar file).

 _____ Major. Always 1, until we invent a new scheme.
/  ___ Minor. Even/Odd = Release/Snapshot (tar files) or Branch/Head (git)
| /  _ Micro. Even/Odd = Tar-file/git
| | /
1.0.0

Here are a few examples of versions that one might see.

Releases
--------
1.0.0 - A major release
1.0.2 - A subsequent maintenance release
1.2.0 - Another major release
Snapshots
---------
1.1.2 - A snapshot (working toward the 1.2.0 release)
In-progress development (eg. from git)
--------------------------------------
1.0.1 - Development on a maintenance branch (toward 1.0.2 release)
1.1.1 - Development on head (toward 1.1.2 snapshot and 1.2.0 release)

Compatibility

The API/ABI compatibility guarantees for various versions are as follows. First, let's assume some cairo-using application code that is successfully using the API/ABI "from" one version of cairo. Then let's ask the question whether this same code can be moved "to" the API/ABI of another version of cairo.

Moving from a release to any later version (release, snapshot, development) is always guaranteed to provide compatibility.

Moving from a snapshot to any later version is not guaranteed to provide compatibility, since snapshots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being removed befonk rel=hots may introduce new API that ends up being

			Cairo: A Vector Graphics Library
Top \| Description