+
−This  file describes various  problems that  have been  encountered in
+
−compiling,  installing  and   running  FreeType  2.   Suggestions  for
+
−additions or other improvements to this file are welcome.
+
−
+
−----------------------------------------------------------------------
+
−
+
−Running Problems
+
−================
+
−
+
−
+
−* Some Type 1, Multiple Masters, and CID-keyed PostScript fonts aren't
+
−  handled correctly.
+
−
+
−-----
+
−
+
−Of course,  there might be  bugs in FreeType,  but some fonts based on
+
−the  PostScript  format can't  be handled indeed.  The reason  is that
+
−FreeType  doesn't contain a full  PostScript  interpreter  but applies
+
−pattern matching instead.  In case a font doesn't follow the  standard
+
−structure of the given font format, FreeType fails.  A typical example
+
−is Adobe's `Optima'  font family which  contains extra code  to switch
+
−between low and high resolution versions of the glyphs.
+
−
+
−It might be  possible to patch  FreeType in  some situations,  though.
+
−Please report failing fonts so that we investigate the problem and set
+
−up a list of such problematic fonts.
+
−
+
−
+
−* Why do identical FreeType  versions render differently  on different
+
−  platforms?
+
−
+
−-----
+
−
+
−Different distributions compile FreeType with different options.   The
+
−developer  version of  a  distribution's  FreeType  package,  which is
+
−needed to compile  your program  against FreeType,  includes the  file
+
−ftoption.h.  Compare  each platform's  copy of ftoption.h to  find the
+
−differences.
+
−
+
−
+
−----------------------------------------------------------------------
+
−
+
−
+
−Compilation Problems
+
−====================
+
−
+
−
+
−* I get an `internal compilation error' (ICE) while compiling FreeType
+
−  2.2.1 with Intel C++.
+
−
+
−  This has been reported for the following compiler version:
+
−
+
−    Intel(R) C++ Compiler for 32-bit applications,
+
−      Version 9.0 Build 20050430Z Package ID: W_CC_P_9.0.019
+
−
+
−-----
+
−
+
−The best solution is to update the compiler to version
+
−
+
−  Intel(R) C++ Compiler for 32-bit applications,
+
−    Version 9.1 Build 20060323Z Package ID: W_CC_P_9.1.022
+
−
+
−or newer.  If this isn't feasible, apply the following patch.
+
−
+
−
+
−--- src/cache/ftcbasic.c 20 Mar 2006 12:10:24 -0000 1.20
+
−+++ src/cache/ftcbasic.c.patched 15 May 2006 02:51:02 -0000
+
−@@ -252,7 +252,7 @@
+
−   */
+
−
+
−   FT_CALLBACK_TABLE_DEF
+
−-  const FTC_IFamilyClassRec  ftc_basic_image_family_class =
+
−+  FTC_IFamilyClassRec  ftc_basic_image_family_class =
+
−   {
+
−     {
+
−       sizeof ( FTC_BasicFamilyRec ),
+
−@@ -266,7 +266,7 @@
+
−
+
−
+
−   FT_CALLBACK_TABLE_DEF
+
−-  const FTC_GCacheClassRec  ftc_basic_image_cache_class =
+
−+  FTC_GCacheClassRec  ftc_basic_image_cache_class =
+
−   {
+
−     {
+
−       ftc_inode_new,
+
−
+
−
+
−----------------------------------------------------------------------
+
−
+
−--- end of PROBLEMS ---