2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
SPECIAL NOTE FOR UNIX USERS
|
|
|
|
===========================
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
If you are installing this release of FreeType on a system that
|
|
|
|
already uses release 2.0.5 (or even an older version), you have to
|
2003-03-20 08:04:40 +01:00
|
|
|
perform a few special steps to ensure that everything goes well.
|
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
1. Enable the TrueType bytecode hinter if you need it
|
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
|
|
|
See the instructions in the file `TRUETYPE' of this directory.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Note that FreeType supports TrueType fonts without the bytecode
|
|
|
|
interpreter through its auto-hinter, which now generates relatively
|
|
|
|
good results with most fonts.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
2. Determine the correct installation path
|
|
|
|
------------------------------------------
|
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
|
|
|
By default, the configure script installs the library in
|
|
|
|
`/usr/local'. However, many Unix distributions now install the
|
|
|
|
library in `/usr', since FreeType is becoming a critical system
|
2003-03-20 08:04:40 +01:00
|
|
|
component.
|
|
|
|
|
|
|
|
If FreeType is already installed on your system, type
|
|
|
|
|
|
|
|
freetype-config --prefix
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
on the command line. This should return the installation path
|
* 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
|
|
|
(e.g., `/usr' or `/usr/local'). To avoid problems of parallel
|
2003-04-21 15:30:27 +02:00
|
|
|
FreeType versions, use this path for the --prefix option of the
|
|
|
|
configure script.
|
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 use `/usr' (or whatever you think is adequate for
|
2003-04-21 15:30:27 +02:00
|
|
|
your installation).
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
3. 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 (as an
|
|
|
|
exception you can use make++ which emulates GNU Make sufficiently;
|
|
|
|
see http://makepp.sourceforge.net). 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
|
|
|
|
* 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
|
|
|
Trying to compile the library with a different Make tool prints a
|
|
|
|
message like:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
Sorry, GNU make is required to build FreeType2.
|
|
|
|
|
* 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
|
|
|
and the build process is 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
|
|
|
4. 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:
|
|
|
|
|
|
|
|
./configure --prefix=<yourprefix>
|
|
|
|
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
|
|
|
where `<yourprefix>' must be replaced by the prefix returned by the
|
|
|
|
`freetype-config' command.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
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:
|
|
|
|
|
* 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
|
|
|
GNUMAKE=gmake ./configure --prefix=<yourprefix>
|
|
|
|
gmake
|
|
|
|
gmake install (as root)
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
5. Take care of XFree86 version 4
|
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
|
|
|
Certain Linux distributions install _several_ versions of FreeType
|
|
|
|
on your system. For example, on a fresh Mandrake 8.1 system, you
|
|
|
|
can find the following files:
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
/usr/lib/libfreetype.so which links to
|
|
|
|
/usr/lib/libfreetype.6.1.0.so
|
|
|
|
|
|
|
|
and
|
|
|
|
|
|
|
|
/usr/X11R6/lib/libfreetype.so which links to
|
|
|
|
/usr/X11R6/lib/libfreetype.6.0.so
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
Note that these files correspond to two distinct versions of the
|
|
|
|
library! It seems that this surprising issue is due to the install
|
|
|
|
scripts of recent XFree86 servers (from 4.1.0) which install their
|
* 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
|
|
|
own (dated) version of the library in `/usr/X11R6/lib'.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
In certain _rare_ cases you may experience minor problems if you
|
* 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
|
|
|
install this release of the library in `/usr' only, namely, that
|
|
|
|
certain applications do not benefit from the bug fixes and rendering
|
|
|
|
improvements you would expect.
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
There are two good ways to deal with this situation:
|
|
|
|
|
* 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
|
|
|
- Install the library _twice_, in `/usr' and in `/usr/X11R6' (you
|
2003-04-21 15:30:27 +02:00
|
|
|
have to do that each time you install a new FreeType release
|
|
|
|
though).
|
2003-03-20 08:04:40 +01:00
|
|
|
|
|
|
|
- Change the link in /usr/X11R6/lib/libfreetype.so to point to
|
|
|
|
|
|
|
|
/usr/lib/libfreetype.so,
|
|
|
|
|
|
|
|
and get rid of
|
|
|
|
|
|
|
|
/usr/X11R6/lib/libfreetype.6.0.so
|
|
|
|
|
2003-04-21 15:30:27 +02:00
|
|
|
The FreeType Team is not responsible for this problem, so please
|
|
|
|
contact either the XFree86 development team or your Linux
|
|
|
|
distributor to help clear this issue in case the information given
|
2003-03-20 08:04:40 +01:00
|
|
|
here doesn't help.
|
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, 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 UPGRADE.UNX ---
|