Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / freetype / 71dd68731057d79a2e58775cd93e09b67fb0ee24 / . / docs / INSTALL
blob: 585c4dbea2eb278f7bf0748e1fa5b2456ab6d067 [file] [log] [blame]
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]1
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]2There are several ways to build the FreeType library, depending on
3your system and the level of customization you need. Here is a short
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]4overview of the documentation available:
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]5
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]6
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]7I. Normal installation and upgrades
8===================================
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]9
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]10 1. Native TrueType Hinting
11
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]12 Native TrueType hinting is disabled by default[1]. If you really
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]13 need it, read the file `TRUETYPE' for information.
14
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]15
Werner Lemberg4ea0a7f2007-01-05 09:03:31 +0000[diff] [blame]16 2. Unix Systems (including Mac OS X, Cygwin, and MSys on Windows)
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]17
Werner Lemberg82a07e92006-10-12 06:20:44 +0000[diff] [blame]18 Please read *both* `UPGRADE.UNIX' and `INSTALL.UNIX' to install or
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]19 upgrade FreeType 2 on a Unix system. Note that you *need* GNU
20 Make for automatic compilation, since other make tools won't work
21 (this includes BSD Make).
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]22
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]23
24 3. On VMS with the `mms' build tool
Werner Lemberg9b774e22007-01-16 06:11:27 +0000[diff] [blame]25
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]26 See `INSTALL.VMS' for installation instructions on this platform.
27
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]28
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]29 4. Other systems using GNU Make
Werner Lemberg9b774e22007-01-16 06:11:27 +0000[diff] [blame]30
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]31 On non-Unix platforms, it is possible to build the library using
32 GNU Make utility. Note that *NO OTHER MAKE TOOL WILL WORK*[2]!
33 This methods supports several compilers on Windows, OS/2, and
34 BeOS, including MinGW, Visual C++, Borland C++, and more.
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]35
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]36 Instructions are provided in the file `INSTALL.GNU'.
David Turnerc3c7e7f2000-03-13 14:19:31 +0000[diff] [blame]37
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]38
39 5. With an IDE Project File (e.g., for Visual Studio or CodeWarrior)
Werner Lemberg9b774e22007-01-16 06:11:27 +0000[diff] [blame]40
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]41 We provide a small number of `project files' for various IDEs to
42 automatically build the library as well. Note that these files
43 are not supported and only sporadically maintained by FreeType
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]44 developers, so don't expect them to work in each release.
Werner Lemberg9b774e22007-01-16 06:11:27 +0000[diff] [blame]45
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]46 To find them, have a look at the content of the `builds/<system>'
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]47 directory, where <system> stands for your OS or environment.
Werner Lemberg3975e2e2002-01-09 21:01:18 +0000[diff] [blame]48
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]49
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]50 6. From you own IDE, or own Makefiles
Werner Lemberg9b774e22007-01-16 06:11:27 +0000[diff] [blame]51
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]52 If you want to create your own project file, follow the
53 instructions given in the `INSTALL.ANY' document of this
54 directory.
David Turner7da48242001-12-11 13:14:41 +0000[diff] [blame]55
56
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]57II. Custom builds of the library
58================================
David Turner7da48242001-12-11 13:14:41 +0000[diff] [blame]59
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]60 Customizing the compilation of FreeType is easy, and allows you to
61 select only the components of the font engine that you really need.
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]62 For more details read the file `CUSTOMIZE'.
David Turner7da48242001-12-11 13:14:41 +0000[diff] [blame]63
64
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]65----------------------------------------------------------------------
David Turner7da48242001-12-11 13:14:41 +0000[diff] [blame]66
David Turner66cbc202003-03-20 07:04:40 +0000[diff] [blame]67[1] More details on: http://www.freetype.org/patents.html
Werner Lemberg5a2fdc02000-12-14 22:57:17 +0000[diff] [blame]68
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]69[2] make++, a make tool written in Perl, has sufficient support of GNU
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]70 make extensions to build FreeType. See
71
72 http://makepp.sourceforge.net
73
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]74 for more information; you need version 1.19 or newer, and you must
Werner Lemberga7235262005-08-30 00:22:46 +0000[diff] [blame]75 pass option `--norc-substitution'.
David Turner7da48242001-12-11 13:14:41 +0000[diff] [blame]76
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]77----------------------------------------------------------------------
Werner Lemberg56c368c2005-06-04 23:00:25 +0000[diff] [blame]78
Werner Lemberg4ea0a7f2007-01-05 09:03:31 +0000[diff] [blame]79Copyright 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 by
Werner Lemberg56c368c2005-06-04 23:00:25 +0000[diff] [blame]80David Turner, Robert Wilhelm, and Werner Lemberg.
81
Werner Lemberg59939242006-01-31 20:17:42 +0000[diff] [blame]82This file is part of the FreeType project, and may only be used,
83modified, and distributed under the terms of the FreeType project
84license, LICENSE.TXT. By continuing to use, modify, or distribute
85this file you indicate that you have read the license and understand
86and accept it fully.
Werner Lemberg56c368c2005-06-04 23:00:25 +0000[diff] [blame]87
88
Werner Lemberga16c4a72003-04-21 13:30:27 +0000[diff] [blame]89--- end of INSTALL ---