docs/INSTALL

There are several ways to  build the FreeType library, depending on your
system  and  the level  of  customization you  need.   Here  is a  short
overview of the documentation available:


I. Normal installation and upgrades
===================================

  1. Native TrueType Hinting

    Native TrueType  hinting is disabled  by default[1].  If  you really
    need it, read the file "TRUETYPE" for information.

  2. Unix Systems (as well as Cygwin or MSys on Windows)

    Please read *both* UPGRADE.UNX and INSTALL.UNX to install or upgrade
    FreeType 2  on a Unix system.   Note that you *will*  need GNU Make,
    since other make tools won't work (this includes BSD Make).

  3. On VMS with the "mms" build tool
  
    See INSTALL.VMS for installation instructions on this platform.

  4. Other systems using GNU Make
  
    On non-Unix platforms, it is possible to build the library using GNU
    Make utility.   Note that  *NO OTHER MAKE  TOOL WILL  WORK*[2]! This
    methods  supports  several compilers  on  Windows,  OS/2, and  BeOS,
    including Mingw, Visual C++, Borland C++, and more.

    Instructions are provided in the file "INSTALL.GNU".

  5. With an IDE Project File (e.g. for Visual Studio or CodeWarrior)
  
    We provide  a small  number of "project  files" for various  IDEs to
    automatically build the library as  well.  Note that these files are
    not supported and sporadically maintained by FreeType developers, so
    don't expect them to work in each release.
    
    To find  them, have a look  at the content  of the "builds/<system>"
    directory, where <system> stands for your OS or environment.

  6. From you own IDE, or own Makefiles
  
    If you want to create your own project file, follow the instructions
    given in the "INSTALL.ANY" document of this directory.


II. Custom builds of the library
================================

  Customizing the  compilation of  FreeType is easy,  and allows  you to
  select only  the components of the  font engine that  you really need.
  For more details read the file "CUSTOMIZE".


------------------------------------------------------------------------

[1] More details on:  http://www.freetype.org/patents.html

[2] make++, a  make tool written in Perl, has  sufficient support of GNU
    make       extensions       to       build      FreeType.        See
    http://makepp.sourceforge.net for more information.

--- end of INSTALL ---