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