docs/VERSION.DLL

   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.
   5
   6 This file tries  to explain why and to document  ways to properly detect
   7 FreeType on Unix.
   8
   9
  10 1. Version and Release numbers
  11 ------------------------------
  12
  13 For each new  public release of FreeType 2, there  are generally *three*
  14 distinct `version' numbers to consider:
  15
  16   * The official FreeType 2 release number, like 2.3.1 or 2.4.10.
  17
  18   * The libtool (and  Unix) specific version number,  like 13.0.7.  This
  19     is what `freetype-config --version' returns.
  20
  21   * The platform-specific  shared object  number, used for  example when
  22     the library is installed as `/usr/lib/libfreetype.so.6.7.1'.
  23
  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
  27 for simple tests.
  28
  29 The libtool-specific  number does  not equal the  release number  but is
  30 tied to it.
  31
  32 The release number is available  at *compile* time through the following
  33 macros defined in FT_FREETYPE_H:
  34
  35   - FREETYPE_MAJOR: major release number
  36   - FREETYPE_MINOR: minor release number
  37   - FREETYPE_PATCH: patch release number
  38
  39 See below for a small autoconf fragment.
  40
  41 The  release  number   is  also  available  at   *runtime*  through  the
  42 `FT_Library_Version' API.
  43
  44
  45 2. History
  46 ----------
  47
  48 The  following   table  gives,  for   all  releases  since   2.3.0,  the
  49 corresponding libtool number, as well  as the shared object number found
  50 on _most_ systems, but not all of them:
  51
  52
  53     release     libtool     so
  54   -------------------------------
  55      2.5.5      17.4.11   6.11.4
  56      2.5.4      17.3.11   6.11.3
  57      2.5.3      17.2.11   6.11.2
  58      2.5.2      17.1.11   6.11.1
  59      2.5.1      17.0.11   6.11.0
  60      2.5.0      16.2.10   6.10.2
  61      2.4.12     16.1.10   6.10.1
  62      2.4.11     16.0.10   6.10.0
  63      2.4.10     15.0.9    6.9.0
  64      2.4.9      14.1.8    6.8.1
  65      2.4.8      14.0.8    6.8.0
  66      2.4.7      13.2.7    6.7.2
  67      2.4.6      13.1.7    6.7.1
  68      2.4.5      13.0.7    6.7.0
  69      2.4.4      12.2.6    6.6.2
  70      2.4.3      12.1.6    6.6.1
  71      2.4.2      12.0.6    6.6.0
  72      2.4.1      11.1.5    6.5.1
  73      2.4.0      11.0.5    6.5.0
  74      2.3.12     10.0.4    6.4.0
  75      2.3.11     9.22.3    6.3.22
  76      2.3.10     9.21.3    6.3.21
  77      2.3.9      9.20.3    6.3.20
  78      2.3.8      9.19.3    6.3.19
  79      2.3.7      9.18.3    6.3.18
  80      2.3.6      9.17.3    6.3.17
  81      2.3.5      9.16.3    6.3.16
  82      2.3.4      9.15.3    6.3.15
  83      2.3.3      9.14.3    6.3.14
  84      2.3.2      9.13.3    6.3.13
  85      2.3.1      9.12.3    6.3.12
  86      2.3.0      9.11.3    6.3.11
  87
  88
  89 3. Autoconf Code Fragment
  90 -------------------------
  91
  92 Lars Clausen contributed the following autoconf fragment to detect which
  93 version of  FreeType is  installed on  a system.  This  one tests  for a
  94 version that  is at least 2.0.9;  you should change it  to check against
  95 other release numbers.
  96
  97
  98   AC_MSG_CHECKING([whether FreeType version is 2.0.9 or higher])
  99   old_CPPFLAGS="$CPPFLAGS"
 100   CPPFLAGS=`freetype-config --cflags`
 101   AC_TRY_CPP([
 102
 103 #include <ft2build.h>
 104 #include FT_FREETYPE_H
 105 #if (FREETYPE_MAJOR*1000 + FREETYPE_MINOR)*1000 + FREETYPE_PATCH < 2000009
 106 #error Freetype version too low.
 107 #endif
 108   ],
 109   [AC_MSG_RESULT(yes)
 110    FREETYPE_LIBS=`freetype-config --libs`
 111    AC_SUBST(FREETYPE_LIBS)
 112    AC_DEFINE(HAVE_FREETYPE,1,[Define if you have the FreeType2 library])
 113    CPPFLAGS="$old_CPPFLAGS"],
 114   [AC_MSG_ERROR([Need FreeType library version 2.0.9 or higher])])
 115
 116 ------------------------------------------------------------------------
 117
 118 Copyright 2002-2014 by
 119 David Turner, Robert Wilhelm, and Werner Lemberg.
 120
 121 This  file is  part  of the  FreeType  project, and  may  only be  used,
 122 modified,  and  distributed under  the  terms  of  the FreeType  project
 123 license, LICENSE.TXT.  By continuing  to use, modify, or distribute this
 124 file  you indicate that  you have  read the  license and  understand and
 125 accept it fully.
 126
 127
 128 --- end of VERSION.DLL ---