Home | History | Annotate | Download | only in docs
      1 
      2 There are  several ways  to build the  FreeType library,  depending on
      3 your system and the level of  customization you need.  Here is a short
      4 overview of the documentation available:
      5 
      6 
      7 I. 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.80 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 
     60 II. 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       http://makepp.sourceforge.net
     74 
     75     for more information; you need version 1.19 or newer, and you must
     76     pass option `--norc-substitution'.
     77 
     78 ----------------------------------------------------------------------
     79 
     80 Copyright 2000-2018 by
     81 David Turner, Robert Wilhelm, and Werner Lemberg.
     82 
     83 This  file is  part of  the FreeType  project, and  may only  be used,
     84 modified,  and distributed  under the  terms of  the  FreeType project
     85 license,  LICENSE.TXT.  By  continuing to  use, modify,  or distribute
     86 this file you  indicate that you have read  the license and understand
     87 and accept it fully.
     88 
     89 
     90 --- end of INSTALL ---
     91