Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / freetype / 9750fcb0676aae610857a1e40809ad3442addad2 / . / docs / INSTALL.UNIX
blob: 6a5aa316b05c8b23a1e9b6f679151e8ac814d0a5 [file] [log] [blame]
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]1This document contains instructions on how to build the FreeType
2library on Unix systems. This also works for emulations like Cygwin
3or MSys on Win32:
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]4
5
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]6 1. Ensure that you are using GNU Make
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]7 -------------------------------------
8
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]9 The FreeType build system _exclusively_ works with GNU Make. You
10 will not be able to compile the library with the instructions
11 below using any other alternative (including BSD Make).
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]12
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]13 Check that you have GNU make by running the command:
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]14
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]15 make -v
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]16
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]17 This should dump some text that begins with:
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]18
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]19 GNU Make <version number>
20 Copyright (C) <year> Free Software Foundation Inc.
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]21
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]22 Note that version 3.78.1 or higher is *required*, or the build will
23 fail.
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]24
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]25 It's also OK to have GNU Make under another name (e.g. 'gmake')
26 if you use the GNUMAKE trick described below.
27
28 As a special exception, 'makepp' can also be used to build
29 FreeType 2. See the file docs/MAKEPP for details
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]30
31
David Turner9750fcb2007-01-04 23:14:48 +0000[diff] [blame^]32 2. Regenerate the configure script when needed
33 ----------------------------------------------
34
35 This only applies if you're building a CVS snapshot or checkout,
36 *not* if you grabbed the sources of an official release.
37
38 you need to invoke the "autogen.sh" script in the top-level
39 directory in order to re-generate the configure script for your
40 platform. Normally, this simply means typing:
41
42 sh autogen.sh <your configure options>
43
44 in case of problems, you may need to install or upgrade Automake,
45 Autoconf or Libtool. See README.CVS in the top-level directory for
46 the gory details.
47
48
49 3. Build and install the library
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]50 --------------------------------
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]51
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]52 The following should work on all Unix systems where the `make'
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]53 command invokes GNU Make:
54
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]55 ./configure [options]
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]56 make
57 make install (as root)
58
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]59 The default installation path is `/usr/local'. It can be changed
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]60 with the `--prefix=<path>' option. Example:
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]61
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]62 ./configure --prefix=/usr
63
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]64 When using a different command to invoke GNU Make, use the GNUMAKE
65 variable. For example, if `gmake' is the command to use on your
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]66 system, do something like:
67
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]68 GNUMAKE=gmake ./configure [options]
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]69 gmake
70 gmake install (as root)
71
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]72 If this still doesn't work, there must be a problem with your
73 system (e.g., you are using a very old version of GNU Make).
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]74
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]75 It is possible to compile FreeType in a different directory.
76 Assuming the FreeType source files in directory `/src/freetype' a
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]77 compilation in directory `foo' works as follows:
78
79 cd foo
80 /src/freetype/configure [options]
81 make
82 make install
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]83
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]84----------------------------------------------------------------------
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]85
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]86Copyright 2003, 2004, 2005, 2006 by
Werner Lemberg56c368c2005-06-04 23:00:25 +0000[diff] [blame]87David Turner, Robert Wilhelm, and Werner Lemberg.
88
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]89This file is part of the FreeType project, and may only be used,
90modified, and distributed under the terms of the FreeType project
91license, LICENSE.TXT. By continuing to use, modify, or distribute
92this file you indicate that you have read the license and understand
93and accept it fully.
Werner Lemberg56c368c2005-06-04 23:00:25 +0000[diff] [blame]94
95
Werner Lemberg82a07e92006-10-12 06:20:44 +0000[diff] [blame]96--- end of INSTALL.UNIX ---