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