1
Due to our use of `libtool' to generate and install the FreeType 2
2
libraries on Unix systems, as well as other historical events, it is
3
generally very difficult to know precisely which release of the font
4
engine is installed on a given system.
6
This file tries to explain why and to document ways to properly detect
10
1. Version and Release numbers
11
------------------------------
13
For each new public release of FreeType 2, there are generally *three*
14
distinct `version' numbers to consider:
16
* The official FreeType 2 release number, like 2.0.9 or 2.1.3.
18
* The libtool (and Unix) specific version number, like 9.2.3. This is
19
what `freetype-config --version' returns.
21
* The platform-specific shared object number, used for example when
22
the library is installed as `/usr/lib/libfreetype.so.6.3.2'.
24
The platform-specific number is, unsurprisingly, platform-specific and
25
varies with the operating system you are using (several variants of
26
Linux, FreeBSD, Solaris, etc.). You should thus _never_ use it, even
29
The libtool-specific number does not equal the release number but is
32
The release number is available at *compile* time through the following
33
macros defined in FT_FREETYPE_H:
35
- FREETYPE_MAJOR: major release number
36
- FREETYPE_MINOR: minor release number
37
- FREETYPE_PATCH: patch release number
39
See below for a small autoconf fragment.
41
The release number is also available at *runtime* through the
42
`FT_Library_Version' API. Unfortunately, this one wasn't available or
43
working correctly before the 2.1.3 official release.
49
The following table gives, for each official release, the corresponding
50
libtool number, as well as the shared object number found on _most_
51
systems, but not all of them:
55
-------------------------------
92
The libtool numbers are a bit inconsistent due to the library's history:
94
- 2.1.0 was created as a development branch from 2.0.8 (hence the same
97
- 2.0.9 was a bug-fix release of the `stable' branch, and we
98
incorrectly increased its libtool number.
100
- 2.1.4 was a development version, however it was stable enough to be
101
the basis of the 2.2.0 release.
104
3. Autoconf Code Fragment
105
-------------------------
107
Lars Clausen contributed the following autoconf fragment to detect which
108
version of FreeType is installed on a system. This one tests for a
109
version that is at least 2.0.9; you should change it to check against
110
other release numbers.
113
AC_MSG_CHECKING([whether FreeType version is 2.0.9 or higher])
114
old_CPPFLAGS="$CPPFLAGS"
115
CPPFLAGS=`freetype-config --cflags`
118
#include <ft2build.h>
119
#include FT_FREETYPE_H
120
#if (FREETYPE_MAJOR*1000 + FREETYPE_MINOR)*1000 + FREETYPE_PATCH < 2000009
121
#error Freetype version too low.
125
FREETYPE_LIBS=`freetype-config --libs`
126
AC_SUBST(FREETYPE_LIBS)
127
AC_DEFINE(HAVE_FREETYPE,1,[Define if you have the FreeType2 library])
128
CPPFLAGS="$old_CPPFLAGS"],
129
[AC_MSG_ERROR([Need FreeType library version 2.0.9 or higher])])
131
------------------------------------------------------------------------
133
Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 by
134
David Turner, Robert Wilhelm, and Werner Lemberg.
136
This file is part of the FreeType project, and may only be used,
137
modified, and distributed under the terms of the FreeType project
138
license, LICENSE.TXT. By continuing to use, modify, or distribute this
139
file you indicate that you have read the license and understand and
143
--- end of VERSION.DLL ---