1 2There are several ways to build the FreeType library, depending on 3your system and the level of customization you need. Here is a short 4overview of the documentation available: 5 6 7I. Normal installation and upgrades 8=================================== 9 10 1. Unix Systems (including Mac OS X, Cygwin, and MSys on Windows) 11 12 Please read `INSTALL.UNIX' to install or upgrade FreeType 2 on a 13 Unix system. Note that you *need* GNU Make for automatic 14 compilation, since other make tools won't work (this includes BSD 15 Make). 16 17 GNU Make VERSION 3.81 OR NEWER IS NEEDED! 18 19 [For `cmake' see below.] 20 21 22 2. On VMS with the `mms' build tool 23 24 See `INSTALL.VMS' for installation instructions on this platform. 25 26 27 3. Other systems using GNU Make 28 29 On non-Unix platforms, it is possible to build the library using 30 GNU Make utility. Note that *NO OTHER MAKE TOOL WILL WORK*[1]! 31 This methods supports several compilers on Windows, OS/2, and 32 BeOS, including MinGW, Visual C++, Borland C++, and more. 33 34 Instructions are provided in the file `INSTALL.GNU'. 35 36 37 4. With an IDE Project File (e.g., for Visual Studio or CodeWarrior) 38 39 We provide a small number of `project files' for various IDEs to 40 automatically build the library as well. Note that these files 41 are not supported and only sporadically maintained by FreeType 42 developers, so don't expect them to work in each release. 43 44 To find them, have a look at the content of the `builds/<system>' 45 directory, where <system> stands for your OS or environment. 46 47 48 5. Using cmake 49 50 See the top-level `CMakeLists.txt' file for more information. 51 52 53 6. From you own IDE, or own Makefiles 54 55 If you want to create your own project file, follow the 56 instructions given in the `INSTALL.ANY' document of this 57 directory. 58 59 60II. Custom builds of the library 61================================ 62 63 Customizing the compilation of FreeType is easy, and allows you to 64 select only the components of the font engine that you really need. 65 For more details read the file `CUSTOMIZE'. 66 67 68---------------------------------------------------------------------- 69 70[1] make++, a make tool written in Perl, has sufficient support of GNU 71 make extensions to build FreeType. See 72 73 https://makepp.sourceforge.net 74 75 for more information; you need version 2.0 or newer, and you must 76 pass option `--norc-substitution'. 77 78---------------------------------------------------------------------- 79 80Copyright (C) 2000-2020 by 81David Turner, Robert Wilhelm, and Werner Lemberg. 82 83This file is part of the FreeType project, and may only be used, 84modified, and distributed under the terms of the FreeType project 85license, LICENSE.TXT. By continuing to use, modify, or distribute 86this file you indicate that you have read the license and understand 87and accept it fully. 88 89 90--- end of INSTALL --- 91