added README.UNX for Unix users
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128
diff --git a/ChangeLog b/ChangeLog
index ca1e72e..ad8d3b5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,7 @@
2002-01-04 David Turner <david@freetype.org>
+ * README.UNX: added special README file for Unix users
+
* builds/unix/ftsystem.c (FT_New_Stream): fixed typo
* src/base/ftobjs.c: added #include FT_OUTLINE_H to get rid
diff --git a/README.UNX b/README.UNX
new file mode 100644
index 0000000..933f599
--- /dev/null
+++ b/README.UNX
@@ -0,0 +1,109 @@
+SPECIAL NOTE FOR UNIX USERS:
+============================
+
+ If you're installing this release of FreeType on a system that
+ already uses release 2.0.5 (or even an older version), you'll
+ need to perform a few special steps to ensure that everything
+ goes well:
+
+
+ I. Enable the TrueType bytecode hinter if you need it:
+ ------------------------------------------------------
+
+ The TrueType bytecode interpreter is disabled in all
+ public releases of the FreeType packages for patents
+ reasons (see www.freetype.org/patents.html for more
+ details).
+
+ However, many Linux distributions do enable the
+ interpreter in the FreeType packages (DEB/RPM/etc..) they
+ produce for their platforms. If you're using TrueType fonts
+ on your system, you'll most probably want to enable it
+ manually by doing the following:
+
+ - open the file "include/freetype/config/ftoption.h"
+
+ - locate a line that says:
+
+ #undef TT_CONFIG_OPTION_BYTECODE_ITNERPRETER
+
+ - change it to:
+
+ #define TT_CONFIG_OPTION_BYTECODE_INTERPRETER
+
+ of course, this must be done _before_ compiling the
+ library
+
+
+ II. Determine the correct installation path:
+ --------------------------------------------
+
+ By default, the source package will install the library
+ in "/usr/local". However, many Unix distributions now
+ install the library in "/usr", since FreeType is becoming
+ a critical system component
+
+
+ If FreeType is already installed on your system, type
+
+ freetype-config --prefix
+
+ on the command line. This should return the installation
+ path to use below (e.g. "/usr" or "/usr/local"). Otherwise,
+ simply use "/usr"
+
+
+ then, to build and install the library, type:
+
+ make setup unix CFG="--prefix=<yourprefix>"
+ make
+ make install (as root)
+
+ where "<yourprefix>" must be replaced by the prefix returned
+ by the "freetype-config" command.
+
+
+ III. Take care of XFree86 4:
+ ----------------------------
+
+ Certain recent Linux distributions will install _several_
+ versions of FreeType on your system.. For example, on a
+ fresh Mandrake 8.1 system, you'll find the following files:
+
+ /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
+
+ 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 irremediably install their own (dated) version of
+ the library in "/usr/X11R6/lib"
+
+ In certain _rare_ cases, you may experience minor problems if
+ you install this release of the library in "/usr" only, namely,
+ that certain applications will not benefit from the bug fixes
+ and rendering improvements you'd expect..
+
+ There are two good ways to deal with such nasty systems:
+
+ - install the library _twice_, in "/usr" and in "/usr/X11R6"
+ (you'll need to do that each time you install a new
+ FreeType release though)
+
+ - 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
+
+
+ The FreeType Team is not responsible for this mess, so please contact
+ either the XFree86 development team or your Linux distributor to help
+ clear this issue.., or if the above information doesn't help..
+
+
+
+
\ No newline at end of file