updating documentation to warn about potential binary compatibility problems
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 129
diff --git a/README b/README
index b1a4e06..c59627f 100644
--- a/README
+++ b/README
@@ -1,3 +1,31 @@
+=====================================================================
+IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT
+
+ During development that followed the 2.1.4 release, some
+ unfortunate changes to the source code did break *binary*
+ compatibility of the library with previous releases. This had the
+ potential to severely break any system where a version of FreeType
+ was installed from recent CVS sources.
+
+ We did undo the changes, and everything should be completely
+ compatible now. However, due to other subtleties too long to be
+ explained here, there may still be a tiny risk that the current
+ sources break some rare applications.
+
+ This package is thus FreeType 2.1.5 release candidate 1 and has
+ been released for testing. If you install it on your system, please
+ be certain to be able to install a previous version in the case
+ where something would go wrong.
+
+ We will make the official 2.1.5 release as soon as we're convinced
+ that it will not break anything.
+
+
+IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT
+=====================================================================
+
+
+
Special notes to Unix users
===========================
diff --git a/docs/CHANGES b/docs/CHANGES
index 4d0d218..01d1229 100644
--- a/docs/CHANGES
+++ b/docs/CHANGES
@@ -1,3 +1,30 @@
+=====================================================================
+IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT
+
+ During development that followed the 2.1.4 release, some
+ unfortunate changes to the source code did break *binary*
+ compatibility of the library with previous releases. This had the
+ potential to severely break any system where a version of FreeType
+ was installed from recent CVS sources.
+
+ We did undo the changes, and everything should be completely
+ compatible now. However, due to other subtleties too long to be
+ explained here, there may still be a tiny risk that the current
+ sources break some rare applications.
+
+ This package is thus FreeType 2.1.5 release candidate 1 and has
+ been released for testing. If you install it on your system, please
+ be certain to be able to install a previous version in the case
+ where something would go wrong.
+
+ We will make the official 2.1.5 release as soon as we're convinced
+ that it will not break anything.
+
+
+IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT
+=====================================================================
+
+
LATEST CHANGES BETWEEN 2.1.5 and 2.1.4
@@ -6,7 +33,7 @@ LATEST CHANGES BETWEEN 2.1.5 and 2.1.4
- Parsing the /CIDFontName field now removes the leading slash to
be in sync with other font drivers.
- - gzip support was buggy.
+ - gzip support was buggy. Some fonts could not be read.
- Fonts which have nested subglyphs more than one level deep no
longer cause a segfault.
@@ -18,7 +45,8 @@ LATEST CHANGES BETWEEN 2.1.5 and 2.1.4
overwritten.
- The font matrix wasn't applied to the advance width for Type1, CID,
- and CFF fonts.
+ and CFF fonts. This caused problem when loading certain synthetic
+ Type 1 fonts like "Helvetica Narrow"
- The test for the charset registry in BDF and PCF fonts is now
case-insensitive.
@@ -40,8 +68,6 @@ LATEST CHANGES BETWEEN 2.1.5 and 2.1.4
II. IMPORTANT CHANGES
- - Unpatented hinting (see below) XXX
-
- Accessing bitmap font formats has been synchronized. To do that
the FT_Bitmap_Size structure has been extended to contain new
fields `size', `x_ppem', and `y_ppem'.
@@ -74,19 +100,12 @@ LATEST CHANGES BETWEEN 2.1.5 and 2.1.4
- The autohinter has been further improved; for example, `m' glyphs
now retain its vertical symmetry.
- - Added the optional unpatented hinting system for TrueType. It
- allows typefaces which need hinting to produce correct glyph forms
- (e.g., Chinese typefaces from Dynalab) to work acceptably without
- infringing Apple patents. This system is compiled only if
- TT_CONFIG_OPTION_COMPILE_UNPATENTED_HINTING is defined in
- ftoption.h.
-
- Partial support of Mac fonts on non-Mac platforms.
- `make refdoc' (after first `make') builds the HTML documentation.
You need Python for this.
- - The make build system should now work more reliable on DOS-like
+ - The make build system should now work more reliably on DOS-like
platforms.
- Support for EMX gcc and Watson C/C++ compilers on MS-DOS has been
@@ -192,7 +211,7 @@ LATEST CHANGES BETWEEN 2.1.4 and 2.1.3
with FreeType (i.e., comparing release/libtool/so numbers, and how to
use them in autoconf scripts).
- - The installation documentation has been seriously revamped.
+ - The installation documentation has been seriously revamped.
Everything is now in the "docs" directory.