thirdparty/freetype-2.3.12/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.0.9 or 2.1.3.
  17
  18   * The libtool (and Unix) specific version number, like 9.2.3.  This is
  19     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.3.2'.
  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.   Unfortunately, this one  wasn't available or
  43 working correctly before the 2.1.3 official release.
  44
  45
  46 2. History
  47 ----------
  48
  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:
  52
  53
  54     release    libtool      so
  55   -------------------------------
  56      2.3.12     10.0.4    6.4.0
  57      2.3.11     9.22.3    6.3.22
  58      2.3.10     9.21.3    6.3.21
  59      2.3.9      9.20.3    6.3.20
  60      2.3.8      9.19.3    6.3.19
  61      2.3.7      9.18.3    6.3.18
  62      2.3.6      9.17.3    6.3.17
  63      2.3.5      9.16.3    6.3.16
  64      2.3.4      9.15.3    6.3.15
  65      2.3.3      9.14.3    6.3.14
  66      2.3.2      9.13.3    6.3.13
  67      2.3.1      9.12.3    6.3.12
  68      2.3.0      9.11.3    6.3.11
  69      2.2.1      9.10.3    6.3.10
  70      2.2.0      9.9.3     6.3.9
  71      2.1.10     9.8.3     6.3.8
  72      2.1.9      9.7.3     6.3.7
  73      2.1.8      9.6.3     6.3.6
  74      2.1.7      9.5.3     6.3.5
  75      2.1.6      9.5.3     6.3.5
  76      2.1.5      9.4.3     6.3.4
  77      2.1.4      9.3.3     6.3.3
  78      2.1.3      9.2.3     6.3.2
  79      2.1.2      9.1.3     6.3.1
  80      2.1.1      9.0.3         ?
  81      2.1.0      8.0.2         ?
  82      2.0.9      9.0.3         ?
  83      2.0.8      8.0.2         ?
  84      2.0.4      7.0.1         ?
  85      2.0.1      6.1.0         ?
  86
  87 The libtool numbers are a bit inconsistent due to the library's history:
  88
  89   - 2.1.0 was created as a development branch from 2.0.8 (hence the same
  90     libtool numbers).
  91
  92   - 2.0.9  was  a  bug-fix  release  of  the  `stable'  branch,  and  we
  93     incorrectly increased its libtool number.
  94
  95   - 2.1.4 was a development version, however it was stable  enough to be
  96     the basis of the 2.2.0 release.
  97
  98
  99 3. Autoconf Code Fragment
 100 -------------------------
 101
 102 Lars Clausen contributed the following autoconf fragment to detect which
 103 version of  FreeType is  installed on  a system.  This  one tests  for a
 104 version that  is at least 2.0.9;  you should change it  to check against
 105 other release numbers.
 106
 107
 108   AC_MSG_CHECKING([whether FreeType version is 2.0.9 or higher])
 109   old_CPPFLAGS="$CPPFLAGS"
 110   CPPFLAGS=`freetype-config --cflags`
 111   AC_TRY_CPP([
 112
 113 #include <ft2build.h>
 114 #include FT_FREETYPE_H
 115 #if (FREETYPE_MAJOR*1000 + FREETYPE_MINOR)*1000 + FREETYPE_PATCH < 2000009
 116 #error Freetype version too low.
 117 #endif
 118   ],
 119   [AC_MSG_RESULT(yes)
 120    FREETYPE_LIBS=`freetype-config --libs`
 121    AC_SUBST(FREETYPE_LIBS)
 122    AC_DEFINE(HAVE_FREETYPE,1,[Define if you have the FreeType2 library])
 123    CPPFLAGS="$old_CPPFLAGS"],
 124   [AC_MSG_ERROR([Need FreeType library version 2.0.9 or higher])])
 125
 126 ------------------------------------------------------------------------
 127
 128 Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 by
 129 David Turner, Robert Wilhelm, and Werner Lemberg.
 130
 131 This  file is  part  of the  FreeType  project, and  may  only be  used,
 132 modified,  and  distributed under  the  terms  of  the FreeType  project
 133 license, LICENSE.TXT.  By continuing  to use, modify, or distribute this
 134 file  you indicate that  you have  read the  license and  understand and
 135 accept it fully.
 136
 137
 138 --- end of VERSION.DLL ---