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