← Back to branch summary

~oif-team/ubuntu/natty/qt4-x11/xi2.1

« back to all changes in this revision

Viewing changes to src/3rdparty/freetype/docs/INSTALL.GNU

  • Committer: Bazaar Package Importer
  • Author(s): Adam Conrad
  • Date: 2005-08-24 04:09:09 UTC
  • Revision ID: james.westby@ubuntu.com-20050824040909-xmxe9jfr4a0w5671
Tags: upstream-4.0.0
Import upstream version 4.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/3rdparty/freetype/docs/INSTALL.GNU
 
1
This document contains instructions how to build the FreeType library on
 
2
non-Unix  systems with  the help  of  GNU Make.   Note that  if you  are
 
3
running Cygwin or MSys in Windows, you should follow the instructions in
 
4
the file INSTALL.UNX instead.
 
5
 
 
6
 
 
7
  FreeType 2 includes  a powerful and flexible build  system that allows
 
8
  you to  easily compile  it on  a great variety  of platforms  from the
 
9
  command line.  To do so, just follow these simple instructions:
 
10
 
 
11
  1. Install GNU Make
 
12
  -------------------
 
13
 
 
14
    Because  GNU  Make  is  the  only Make  tool  supported  to  compile
 
15
    FreeType 2, you should install it on your machine.
 
16
 
 
17
    The FreeType 2  build system relies on many  features special to GNU
 
18
    Make --  trying to build the  library with any other  Make tool will
 
19
    *fail*.
 
20
 
 
21
    NEARLY  ALL OTHER  MAKE TOOLS  WILL FAIL,  INCLUDING "BSD  MAKE", SO
 
22
    REALLY INSTALL A RECENT VERSION OF GNU MAKE ON YOUR SYSTEM!
 
23
 
 
24
    Note  that make++,  a make  tool  written in  Perl, supports  enough
 
25
    features    of    GNU     make    to    compile    FreeType.     See
 
26
    http://makepp.sourceforge.net for more information; you need version
 
27
    1.19 or newer, and you must pass option `--norc-substitution'.
 
28
 
 
29
    Make sure that  you are invoking GNU Make from  the command line, by
 
30
    typing something like:
 
31
 
 
32
      make -v
 
33
 
 
34
    to display its version number.
 
35
 
 
36
    VERSION 3.78.1 OR NEWER IS NEEDED!
 
37
 
 
38
 
 
39
  2. Invoke 'make'
 
40
  ----------------
 
41
 
 
42
    Go to the root directory of  FreeType 2, then simply invoke GNU Make
 
43
    from  the  command line.   This  will  launch  the FreeType  2  host
 
44
    platform  detection  routines.  A  summary  will  be displayed,  for
 
45
    example, on Win32:
 
46
 
 
47
 
 
48
      ==============================================================
 
49
      FreeType build system -- automatic system detection
 
50
 
 
51
      The following settings are used:
 
52
 
 
53
        platform                     win32
 
54
        compiler                     gcc
 
55
        configuration directory      ./builds/win32
 
56
        configuration rules          ./builds/win32/w32-gcc.mk
 
57
 
 
58
      If this does not correspond to your system or settings please
 
59
      remove the file 'config.mk' from this directory then read the
 
60
      INSTALL file for help.
 
61
 
 
62
      Otherwise, simply type 'make' again to build the library.
 
63
      =============================================================
 
64
 
 
65
 
 
66
    If the  detected settings correspond to your  platform and compiler,
 
67
    skip to step  5.  Note that if your platform  is completely alien to
 
68
    the build system, the detected platform will be 'ansi'.
 
69
 
 
70
 
 
71
  3. Configure the build system for a different compiler
 
72
  ------------------------------------------------------
 
73
 
 
74
    If the build  system correctly detected your platform,  but you want
 
75
    to use  a different compiler than  the one specified  in the summary
 
76
    (for most  platforms, gcc is  the defaut compiler), invoke  GNU Make
 
77
    with
 
78
 
 
79
      make setup <compiler>
 
80
 
 
81
    Examples:
 
82
 
 
83
      to use Visual C++ on Win32, type:  "make setup visualc"
 
84
      to use Borland C++ on Win32, type  "make setup bcc32"
 
85
      to use Watcom C++ on Win32, type   "make setup watcom"
 
86
      to use Intel C++ on Win32, type    "make setup intelc"
 
87
      to use LCC-Win32 on Win32, type:   "make setup lcc"
 
88
      to use Watcom C++ on OS/2, type    "make setup watcom"
 
89
      to use VisualAge C++ on OS/2, type "make setup visualage"
 
90
 
 
91
    The  <compiler> name  to  use is  platform-dependent.   The list  of
 
92
    available  compilers  for  your  system  is available  in  the  file
 
93
    `builds/<system>/detect.mk'
 
94
 
 
95
    If  you are  satisfied by  the  new configuration  summary, skip  to
 
96
    step 5.
 
97
 
 
98
 
 
99
  4. Configure the build system for an unknown platform/compiler
 
100
  --------------------------------------------------------------
 
101
 
 
102
    The auto-detection/setup phase of the  build system copies a file to
 
103
    the current directory under the name `config.mk'.
 
104
 
 
105
    For    example,    on     OS/2+gcc,    it    would    simply    copy
 
106
    `builds/os2/os2-gcc.mk' to `./config.mk'.
 
107
 
 
108
    If  for some  reason your  platform isn't  correctly  detected, copy
 
109
    manually the  configuration sub-makefile to `./config.mk'  and go to
 
110
    step 5.
 
111
 
 
112
    Note that this file is a sub-Makefile used to specify Make variables
 
113
    for compiler and linker invocation during the build.  You can easily
 
114
    create  your own  version  from one  of  the existing  configuration
 
115
    files,  then  copy  it  to  the current  directory  under  the  name
 
116
    `./config.mk'.
 
117
 
 
118
 
 
119
  5. Build the library
 
120
  --------------------
 
121
 
 
122
    The  auto-detection/setup phase  should have  copied a  file  in the
 
123
    current  directory,   called  `./config.mk'.   This   file  contains
 
124
    definitions of  various Make variables  used to invoke  the compiler
 
125
    and linker during the build.
 
126
 
 
127
    To launch the build, simply  invoke GNU Make again: The top Makefile
 
128
    will detect the configuration file and run the build with it.
 
129
 
 
130
 
 
131
  Final note
 
132
  
 
133
    The  build system  builds a  statically linked  library of  the font
 
134
    engine in the "objs" directory.   It does _not_ support the build of
 
135
    DLLs on Windows and OS/2.  If you need these, you have to either use
 
136
    a  IDE-specific   project  file,  or  follow   the  instructions  in
 
137
    "INSTALL.ANY" to create your own Makefiles.
 
138
 
 
139
 
 
140
--- end of INSTALL.GNU ---