2003-03-20 08:04:40 +01:00
|
|
|
This document contains instructions on how to build the FreeType library
|
* 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
|
|
|
on Unix systems. This also works for emulations like Cygwin or MSys on
|
2003-03-20 08:04:40 +01:00
|
|
|
Win32:
|
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
1. Ensure that you are using GNU Make
|
2003-03-20 08:04:40 +01:00
|
|
|
-------------------------------------
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The FreeType build system _exclusively_ works with GNU Make. You
|
|
|
|
will not be able to compile the library with the instructions below
|
|
|
|
using any other alternative (including BSD Make).
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
[Well, this is not really correct. Recently, a perl implementation
|
|
|
|
of make called `makepp' has appeared which can also build FreeType 2
|
* 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
|
|
|
successfully on Unix platforms. See
|
|
|
|
|
|
|
|
http://makepp.sourceforge.net
|
|
|
|
|
|
|
|
for more details; you need version 1.19 or newer, and you must pass
|
2004-04-13 10:35:05 +02:00
|
|
|
option `--norc-substitution'.]
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Trying to compile the library with a different Make tool will print
|
|
|
|
a message like:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Sorry, GNU make is required to build FreeType2.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
and the build process will be aborted. If this happens, install GNU
|
|
|
|
Make on your system, and use the GNUMAKE environment variable to
|
|
|
|
name it.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
2. Build and install the library
|
|
|
|
--------------------------------
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The following should work on all Unix systems where the `make'
|
2003-03-20 08:04:40 +01:00
|
|
|
command invokes GNU Make:
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
./configure [options]
|
2003-03-20 08:04:40 +01:00
|
|
|
make
|
|
|
|
make install (as root)
|
|
|
|
|
* 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 default installation path is `/usr/local'. It can be changed
|
2003-04-21 15:30:27 +02:00
|
|
|
with the `--prefix=<path>' option. Example:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
./configure --prefix=/usr
|
|
|
|
|
|
|
|
When using a different command to invoke GNU Make, use the GNUMAKE
|
|
|
|
variable. For example, if `gmake' is the command to use on your
|
2003-03-20 08:04:40 +01:00
|
|
|
system, do something like:
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
GNUMAKE=gmake ./configure [options]
|
2003-03-20 08:04:40 +01:00
|
|
|
gmake
|
|
|
|
gmake install (as root)
|
|
|
|
|
* 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 this still doesn't work, there must be a problem with your system
|
|
|
|
(e.g., you are using a very old version of GNU Make).
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
It is possible to compile FreeType in a different directory.
|
|
|
|
Assuming the FreeType source files in directory `/src/freetype' a
|
|
|
|
compilation in directory `foo' works as follows:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
cd foo
|
|
|
|
/src/freetype/configure [options]
|
|
|
|
make
|
|
|
|
make install
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2005-06-05 01:00:25 +02:00
|
|
|
------------------------------------------------------------------------
|
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
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
--- end of INSTALL.UNX ---
|