1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/modules/freetype2/docs/INSTALL.UNIX Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,115 @@
1.4 +This document contains instructions on how to build the FreeType
1.5 +library on Unix systems. This also works for emulations like Cygwin
1.6 +or MSys on Win32:
1.7 +
1.8 +
1.9 + 1. Ensure that you are using GNU Make
1.10 + -------------------------------------
1.11 +
1.12 + The FreeType build system _exclusively_ works with GNU Make. You
1.13 + will not be able to compile the library with the instructions
1.14 + below using any other alternative (including BSD Make).
1.15 +
1.16 + Check that you have GNU make by running the command:
1.17 +
1.18 + make -v
1.19 +
1.20 + This should dump some text that begins with:
1.21 +
1.22 + GNU Make <version number>
1.23 + Copyright (C) <year> Free Software Foundation Inc.
1.24 +
1.25 + Note that version 3.80 or higher is *required* or the build will
1.26 + fail.
1.27 +
1.28 + It is also fine to have GNU Make under another name (e.g. 'gmake')
1.29 + if you use the MAKE variable as described below.
1.30 +
1.31 + As a special exception, 'makepp' can also be used to build
1.32 + FreeType 2. See the file docs/MAKEPP for details.
1.33 +
1.34 +
1.35 + 2. Regenerate the configure script if needed
1.36 + --------------------------------------------
1.37 +
1.38 + This only applies if you are building a git snapshot or checkout,
1.39 + *not* if you grabbed the sources of an official release.
1.40 +
1.41 + You need to invoke the `autogen.sh' script in the top-level
1.42 + directory in order to create the `configure' script for your
1.43 + platform. Normally, this simply means typing:
1.44 +
1.45 + sh autogen.sh
1.46 +
1.47 + In case of problems, you may need to install or upgrade Automake,
1.48 + Autoconf or Libtool. See README.git in the top-level directory
1.49 + for more information.
1.50 +
1.51 +
1.52 + 3. Build and install the library
1.53 + --------------------------------
1.54 +
1.55 + The following should work on all Unix systems where the `make'
1.56 + command invokes GNU Make:
1.57 +
1.58 + ./configure [options]
1.59 + make
1.60 + make install (as root)
1.61 +
1.62 + The default installation path is `/usr/local'. It can be changed
1.63 + with the `--prefix=<path>' option. Example:
1.64 +
1.65 + ./configure --prefix=/usr
1.66 +
1.67 + When using a different command to invoke GNU Make, use the MAKE
1.68 + variable. For example, if `gmake' is the command to use on your
1.69 + system, do something like:
1.70 +
1.71 + MAKE=gmake ./configure [options]
1.72 + gmake
1.73 + gmake install (as root)
1.74 +
1.75 + If this still doesn't work, there must be a problem with your
1.76 + system (e.g., you are using a very old version of GNU Make).
1.77 +
1.78 + It is possible to compile FreeType in a different directory.
1.79 + Assuming the FreeType source files in directory `/src/freetype' a
1.80 + compilation in directory `foo' works as follows:
1.81 +
1.82 + cd foo
1.83 + /src/freetype/configure [options]
1.84 + make
1.85 + make install
1.86 +
1.87 +
1.88 + 3.1 Interdependency with HarfBuzz
1.89 + .................................
1.90 +
1.91 + Note that there is a chicken-and-egg problem currently since the
1.92 + HarfBuzz library (used by the auto-hinter to improve support of
1.93 + OpenType fonts) depends on FreeType, which can be solved as
1.94 + follows in case HarfBuzz is not yet installed on your system.
1.95 +
1.96 + 1. Call FreeType's `configure' script with option
1.97 + `--without-harfbuzz', then compile and install FreeType.
1.98 +
1.99 + 2. Compile and install HarfBuzz.
1.100 +
1.101 + 3. Call FreeType's `configure' script without option
1.102 + `--without-harfbuzz' (after executing `make distclean'), then
1.103 + compile and install FreeType again.
1.104 +
1.105 +
1.106 +----------------------------------------------------------------------
1.107 +
1.108 +Copyright 2003-2007, 2013, 2014 by
1.109 +David Turner, Robert Wilhelm, and Werner Lemberg.
1.110 +
1.111 +This file is part of the FreeType project, and may only be used,
1.112 +modified, and distributed under the terms of the FreeType project
1.113 +license, LICENSE.TXT. By continuing to use, modify, or distribute
1.114 +this file you indicate that you have read the license and understand
1.115 +and accept it fully.
1.116 +
1.117 +
1.118 +--- end of INSTALL.UNIX ---
