Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / freetype / e459d742e6236df43f542b8c29dfdcf05d69716c / . / README.UNX
blob: 838ee8ab28370eb2098f61aae64cee7f9d278818 [file] [log] [blame]
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]1
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]2SPECIAL NOTE FOR UNIX USERS
3===========================
4
5 If you are installing this release of FreeType on a system that
6 already uses release 2.0.5 (or even an older version), you have to
7 perform a few special steps to ensure that everything goes well.
8
9
David Turner944b7292002-01-31 17:42:05 +0000[diff] [blame]10
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]11 I. Enable the TrueType bytecode hinter if you need it
12 -----------------------------------------------------
13
14 The TrueType bytecode interpreter is disabled in all public
15 releases of the FreeType packages for patents reasons (see
16 http://www.freetype.org/patents.html for more details).
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]17
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]18 However, many Linux distributions do enable the interpreter in the
19 FreeType packages (DEB/RPM/etc.) they produce for their platforms.
20 If you are using TrueType fonts on your system, you most probably
21 want to enable it manually by doing the following:
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]22
23 - open the file "include/freetype/config/ftoption.h"
24
25 - locate a line that says:
26
Werner Lemberg12a87412002-01-29 01:11:23 +0000[diff] [blame]27 #undef TT_CONFIG_OPTION_BYTECODE_INTERPRETER
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]28
29 - change it to:
30
31 #define TT_CONFIG_OPTION_BYTECODE_INTERPRETER
32
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]33 of course, this must be done _before_ compiling the library
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]34
35
David Turner944b7292002-01-31 17:42:05 +0000[diff] [blame]36
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]37 II. Determine the correct installation path
38 -------------------------------------------
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]39
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]40 By default, the source package will install the library in
41 "/usr/local". However, many Unix distributions now install the
42 library in "/usr", since FreeType is becoming a critical system
43 component.
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]44
45 If FreeType is already installed on your system, type
46
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]47 freetype-config --prefix
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]48
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]49 on the command line. This should return the installation path to
50 use below (e.g. "/usr" or "/usr/local"). Otherwise, simply use
51 "/usr".
52
53 Then, to build and install the library, type:
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]54
David Turnerce9a0442002-01-08 18:33:55 +0000[diff] [blame]55 ./configure --prefix=<yourprefix>
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]56 make
David Turner944b7292002-01-31 17:42:05 +0000[diff] [blame]57 make install (as root)
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]58
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]59 where "<yourprefix>" must be replaced by the prefix returned by
60 the "freetype-config" command.
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]61
62
David Turner944b7292002-01-31 17:42:05 +0000[diff] [blame]63
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]64 III. Take care of XFree86 version 4
65 -----------------------------------
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]66
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]67 Certain recent Linux distributions will install _several_ versions
68 of FreeType on your system. For example, on a fresh Mandrake 8.1
69 system, you can find the following files:
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]70
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]71 /usr/lib/libfreetype.so which links to
72 /usr/lib/libfreetype.6.1.0.so
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]73
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]74 and
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]75
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]76 /usr/X11R6/lib/libfreetype.so which links to
77 /usr/X11R6/lib/libfreetype.6.0.so
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]78
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]79 Note that these files correspond to two distinct versions of the
80 library! It seems that this surprising issue is due to the
81 install scripts of recent XFree86 servers (from 4.1.0) which
82 irremediably install their own (dated) version of the library in
83 "/usr/X11R6/lib".
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]84
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]85 In certain _rare_ cases you may experience minor problems if you
86 install this release of the library in "/usr" only, namely, that
87 certain applications will not benefit from the bug fixes and
88 rendering improvements you'd expect.
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]89
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]90 There are two good ways to deal with this situation:
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]91
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]92 - Install the library _twice_, in "/usr" and in "/usr/X11R6"
93 (you have to do that each time you install a new FreeType
94 release though).
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]95
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]96 - Change the link in /usr/X11R6/lib/libfreetype.so to point to
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]97
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]98 /usr/lib/libfreetype.so,
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]99
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]100 and get rid of
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]101
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]102 /usr/X11R6/lib/libfreetype.6.0.so
David Turnerb1748d42002-01-04 16:36:42 +0000[diff] [blame]103
Werner Lembergac812952002-01-06 16:42:44 +0000[diff] [blame]104 The FreeType Team is not responsible for this problem, so please
105 contact either the XFree86 development team or your Linux
106 distributor to help clear this issue in case the information given
107 here doesn't help.