2003-04-21 15:30:27 +02:00
|
|
|
This document contains instructions how to build the FreeType library on
|
|
|
|
non-Unix systems with the help of GNU Make. Note that if you are
|
|
|
|
running Cygwin or MSys in Windows, you should follow the instructions in
|
|
|
|
the file INSTALL.UNX instead.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
FreeType 2 includes a powerful and flexible build system that allows
|
|
|
|
you to easily compile it on a great variety of platforms from the
|
2003-03-20 08:04:40 +01:00
|
|
|
command line. To do so, just follow these simple instructions:
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
1. Install GNU Make
|
|
|
|
-------------------
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
Because GNU Make is the only Make tool supported to compile FreeType
|
|
|
|
2, you should install it on your machine.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The FreeType 2 build system relies on many features special to GNU
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
Make.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
NEARLY ALL OTHER MAKE TOOLS FAIL, INCLUDING `BSD MAKE', SO REALLY
|
|
|
|
INSTALL A RECENT VERSION OF GNU MAKE ON YOUR SYSTEM!
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Note that make++, a make tool written in Perl, supports enough
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
features of GNU make to compile FreeType. See
|
|
|
|
|
|
|
|
http://makepp.sourceforge.net
|
|
|
|
|
|
|
|
for more information; you need version 1.19 or newer, and you must
|
|
|
|
pass option `--norc-substitution'.
|
2003-04-21 15:30:27 +02:00
|
|
|
|
|
|
|
Make sure that you are invoking GNU Make from the command line, by
|
2003-03-20 08:04:40 +01:00
|
|
|
typing something like:
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
make -v
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
to display its version number.
|
|
|
|
|
|
|
|
VERSION 3.78.1 OR NEWER IS NEEDED!
|
|
|
|
|
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
2. Invoke `make'
|
2003-04-21 15:30:27 +02:00
|
|
|
----------------
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Go to the root directory of FreeType 2, then simply invoke GNU Make
|
|
|
|
from the command line. This will launch the FreeType 2 host
|
|
|
|
platform detection routines. A summary will be displayed, for
|
2003-03-20 08:04:40 +01:00
|
|
|
example, on Win32:
|
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
==============================================================
|
|
|
|
FreeType build system -- automatic system detection
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The following settings are used:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
platform win32
|
|
|
|
compiler gcc
|
|
|
|
configuration directory ./builds/win32
|
|
|
|
configuration rules ./builds/win32/w32-gcc.mk
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
If this does not correspond to your system or settings please
|
|
|
|
remove the file 'config.mk' from this directory then read the
|
|
|
|
INSTALL file for help.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
Otherwise, simply type 'make' again to build the library
|
|
|
|
or 'make refdoc' to build the API reference (the latter needs
|
|
|
|
python).
|
2003-04-21 15:30:27 +02:00
|
|
|
=============================================================
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
If the detected settings correspond to your platform and compiler,
|
|
|
|
skip to step 5. Note that if your platform is completely alien to
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
the build system, the detected platform will be `ansi'.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
3. Configure the build system for a different compiler
|
|
|
|
------------------------------------------------------
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
If the build system correctly detected your platform, but you want
|
|
|
|
to use a different compiler than the one specified in the summary
|
|
|
|
(for most platforms, gcc is the defaut compiler), invoke GNU Make
|
2003-03-20 08:04:40 +01:00
|
|
|
with
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
make setup <compiler>
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Examples:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
to use Visual C++ on Win32, type: "make setup visualc"
|
|
|
|
to use Borland C++ on Win32, type "make setup bcc32"
|
|
|
|
to use Watcom C++ on Win32, type "make setup watcom"
|
|
|
|
to use Intel C++ on Win32, type "make setup intelc"
|
|
|
|
to use LCC-Win32 on Win32, type: "make setup lcc"
|
|
|
|
to use Watcom C++ on OS/2, type "make setup watcom"
|
|
|
|
to use VisualAge C++ on OS/2, type "make setup visualage"
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The <compiler> name to use is platform-dependent. The list of
|
|
|
|
available compilers for your system is available in the file
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
`builds/<system>/detect.mk'.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
If you are satisfied by the new configuration summary, skip to
|
2003-04-21 15:30:27 +02:00
|
|
|
step 5.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
4. Configure the build system for an unknown platform/compiler
|
|
|
|
--------------------------------------------------------------
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The auto-detection/setup phase of the build system copies a file to
|
|
|
|
the current directory under the name `config.mk'.
|
|
|
|
|
|
|
|
For example, on OS/2+gcc, it would simply copy
|
2003-03-20 08:04:40 +01:00
|
|
|
`builds/os2/os2-gcc.mk' to `./config.mk'.
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
If for some reason your platform isn't correctly detected, copy
|
|
|
|
manually the configuration sub-makefile to `./config.mk' and go to
|
|
|
|
step 5.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Note that this file is a sub-Makefile used to specify Make variables
|
|
|
|
for compiler and linker invocation during the build. You can easily
|
|
|
|
create your own version from one of the existing configuration
|
|
|
|
files, then copy it to the current directory under the name
|
|
|
|
`./config.mk'.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
5. Build the library
|
|
|
|
--------------------
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The auto-detection/setup phase should have copied a file in the
|
|
|
|
current directory, called `./config.mk'. This file contains
|
|
|
|
definitions of various Make variables used to invoke the compiler
|
|
|
|
and linker during the build.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
To launch the build, simply invoke GNU Make again: The top Makefile
|
|
|
|
will detect the configuration file and run the build with it.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Final note
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The build system builds a statically linked library of the font
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
engine in the `objs' directory. It does _not_ support the build of
|
2003-04-21 15:30:27 +02:00
|
|
|
DLLs on Windows and OS/2. If you need these, you have to either use
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
an IDE-specific project file, or follow the instructions in
|
|
|
|
`INSTALL.ANY' to create your own Makefiles.
|
2003-04-21 15:30:27 +02:00
|
|
|
|
2005-06-05 01:00:25 +02:00
|
|
|
------------------------------------------------------------------------
|
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
Copyright 2003, 2004, 2005 by
|
2005-06-05 01:00:25 +02:00
|
|
|
David Turner, Robert Wilhelm, and Werner Lemberg.
|
|
|
|
|
* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.
* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.
* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
2005-08-30 02:22:46 +02:00
|
|
|
This file is part of the FreeType project, and may only be used,
|
|
|
|
modified, and distributed under the terms of the FreeType project
|
|
|
|
license, LICENSE.TXT. By continuing to use, modify, or distribute this
|
|
|
|
file you indicate that you have read the license and understand and
|
2005-06-05 01:00:25 +02:00
|
|
|
accept it fully.
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
|
|
|
|
--- end of INSTALL.GNU ---
|