David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 1 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 2 | SPECIAL 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 Turner | 944b729 | 2002-01-31 17:42:05 +0000 | [diff] [blame] | 10 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 17 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-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 Lemberg | 12a8741 | 2002-01-29 01:11:23 +0000 | [diff] [blame] | 27 | #undef TT_CONFIG_OPTION_BYTECODE_INTERPRETER |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 28 | |
| 29 | - change it to: |
| 30 | |
| 31 | #define TT_CONFIG_OPTION_BYTECODE_INTERPRETER |
| 32 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 33 | of course, this must be done _before_ compiling the library |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 34 | |
| 35 | |
David Turner | 944b729 | 2002-01-31 17:42:05 +0000 | [diff] [blame] | 36 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 37 | II. Determine the correct installation path |
| 38 | ------------------------------------------- |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 39 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 44 | |
| 45 | If FreeType is already installed on your system, type |
| 46 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 47 | freetype-config --prefix |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 48 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 54 | |
David Turner | ce9a044 | 2002-01-08 18:33:55 +0000 | [diff] [blame] | 55 | ./configure --prefix=<yourprefix> |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 56 | make |
David Turner | 944b729 | 2002-01-31 17:42:05 +0000 | [diff] [blame] | 57 | make install (as root) |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 58 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 61 | |
| 62 | |
David Turner | 944b729 | 2002-01-31 17:42:05 +0000 | [diff] [blame] | 63 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 64 | III. Take care of XFree86 version 4 |
| 65 | ----------------------------------- |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 66 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 70 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 73 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 74 | and |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 75 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 78 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 84 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 89 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 90 | There are two good ways to deal with this situation: |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 91 | |
Werner Lemberg | ac81295 | 2002-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 Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 95 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 96 | - Change the link in /usr/X11R6/lib/libfreetype.so to point to |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 97 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 98 | /usr/lib/libfreetype.so, |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 99 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 100 | and get rid of |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 101 | |
Werner Lemberg | ac81295 | 2002-01-06 16:42:44 +0000 | [diff] [blame] | 102 | /usr/X11R6/lib/libfreetype.6.0.so |
David Turner | b1748d4 | 2002-01-04 16:36:42 +0000 | [diff] [blame] | 103 | |
Werner Lemberg | ac81295 | 2002-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. |