michael@0: 
michael@0: There are  several ways  to build the  FreeType library,  depending on
michael@0: your system and the level of  customization you need.  Here is a short
michael@0: overview of the documentation available:
michael@0: 
michael@0: 
michael@0: I. Normal installation and upgrades
michael@0: ===================================
michael@0: 
michael@0:   1. Unix Systems (including Mac OS X, Cygwin, and MSys on Windows)
michael@0: 
michael@0:     Please read `INSTALL.UNIX' to install or upgrade FreeType  2 on  a
michael@0:     Unix system.   Note  that  you  *need*  GNU  Make   for  automatic
michael@0:     compilation,  since other make tools won't work (this includes BSD
michael@0:     Make).
michael@0: 
michael@0:     GNU Make VERSION 3.80 OR NEWER IS NEEDED!
michael@0: 
michael@0: 
michael@0:   2. On VMS with the `mms' build tool
michael@0: 
michael@0:     See `INSTALL.VMS' for installation instructions on this platform.
michael@0: 
michael@0: 
michael@0:   3. Other systems using GNU Make
michael@0: 
michael@0:     On non-Unix platforms,  it is possible to build  the library using
michael@0:     GNU Make  utility.  Note that  *NO OTHER MAKE TOOL  WILL WORK*[1]!
michael@0:     This  methods supports  several  compilers on  Windows, OS/2,  and
michael@0:     BeOS, including MinGW, Visual C++, Borland C++, and more.
michael@0: 
michael@0:     Instructions are provided in the file `INSTALL.GNU'.
michael@0: 
michael@0: 
michael@0:   4. With an IDE Project File (e.g., for Visual Studio or CodeWarrior)
michael@0: 
michael@0:     We provide a  small number of `project files'  for various IDEs to
michael@0:     automatically build  the library as  well.  Note that  these files
michael@0:     are  not supported  and only  sporadically maintained  by FreeType
michael@0:     developers, so don't expect them to work in each release.
michael@0: 
michael@0:     To find them, have a  look at the content of the `builds/<system>'
michael@0:     directory, where <system> stands for your OS or environment.
michael@0: 
michael@0: 
michael@0:   5. Using cmake
michael@0: 
michael@0:     See the top-level `CMakeLists.txt' file for more information.
michael@0: 
michael@0: 
michael@0:   6. From you own IDE, or own Makefiles
michael@0: 
michael@0:     If  you  want  to  create   your  own  project  file,  follow  the
michael@0:     instructions   given  in  the   `INSTALL.ANY'  document   of  this
michael@0:     directory.
michael@0: 
michael@0: 
michael@0: II. Custom builds of the library
michael@0: ================================
michael@0: 
michael@0:   Customizing the compilation  of FreeType is easy, and  allows you to
michael@0:   select only the components of  the font engine that you really need.
michael@0:   For more details read the file `CUSTOMIZE'.
michael@0: 
michael@0: 
michael@0: ----------------------------------------------------------------------
michael@0: 
michael@0: [1] make++, a make tool written in Perl, has sufficient support of GNU
michael@0:     make extensions to build FreeType.  See
michael@0: 
michael@0:       http://makepp.sourceforge.net
michael@0: 
michael@0:     for more information; you need version 1.19 or newer, and you must
michael@0:     pass option `--norc-substitution'.
michael@0: 
michael@0: ----------------------------------------------------------------------
michael@0: 
michael@0: Copyright   2000-2008, 2010-2011, 2013
michael@0: by David Turner, Robert Wilhelm, and Werner Lemberg.
michael@0: 
michael@0: This  file is  part of  the FreeType  project, and  may only  be used,
michael@0: modified,  and distributed  under the  terms of  the  FreeType project
michael@0: license,  LICENSE.TXT.  By  continuing to  use, modify,  or distribute
michael@0: this file you  indicate that you have read  the license and understand
michael@0: and accept it fully.
michael@0: 
michael@0: 
michael@0: --- end of INSTALL ---