updating documentation

ChangeLog

@@ -3,6 +3,8 @@
         * src/autohint/ahtypes.h: disabling metrics hinting in the auto-hinter.
         this produces much better anti-aliased text
 
+        * docs/CHANGES: updating the changes documentation
+
 2002-09-25  Anthony Fok  <anthony@thizlinux.com>
 
         * src/sfnt/ttcmap0.c: added support for opens___.ttf (it contains

docs/CHANGES

@@ -32,7 +32,7 @@ LATEST CHANGES BETWEEN 2.1.3 and 2.1.2
       offsets are computed).
 
 
-  II. MISCELLANEOUS
+  II. IMPORTANT CHANGES
 
     - The automatic and postscript hinters have both been updated.  This
       results in a relatively important increase of rendering quality since
@@ -42,6 +42,50 @@ LATEST CHANGES BETWEEN 2.1.3 and 2.1.2
 
       for additional details on this topic.
 
+    - The "load_flags" parameter of FT_Load_Glyph is now an FT_Int32
+      (instead of just being an FT_Int).  This breaks source and binary
+      compatibility for 16bit systems only, while retaining both of them for
+      32 and 64 bit ones.
+
+      Some new flags have been added consequently:
+
+        FT_LOAD_NO_AUTOHINT   :: Disable the use of the auto-hinter
+                                 (but not native format hinters).
+
+        FT_LOAD_TARGET_NORMAL :: Hint and render for normal anti-aliased
+                                 displays.
+
+        FT_LOAD_TARGET_MONO   :: Hint and render for 1-bit displays.
+
+        FT_LOAD_TARGET_LCD    :: Hint and render for horizontal RGB or BGR
+                                 sub-pixel displays (like LCD screens).
+                                 THIS IS STILL EXPERIMENTAL!
+
+        FT_LOAD_TARGET_LCD_V  :: Same as FT_LOAD_TARGET_LCD, for vertical
+                                 sub-pixel displays (like rotated LCD
+                                 screens).  THIS IS STILL EXPERIMENTAL!
+
+      FT_LOAD_MONOCHROME is still supported, but only affects rendering, not
+      the hinting.
+
+      Note that the 'ftview' demo program available in the 'ft2demos' package
+      has been updated to support LCD-optimized display on non-paletted
+      displays (under Win32 and X11)
+
+
+    - The cache API has been slightly modified (it's still a beta after all!!):
+
+       - the type FTC_ImageDesc has been removed, it is now replaced by
+         FTC_ImageTypeRec. Note that one of its fields is a 'load_flag'
+         parameter for FT_Load_Glyph
+
+       - the field "num_grays" of FT_SBitRec has been changed to "max_grays"
+         in order to fit within a single byte. Its maximum value is thus 255
+         (instead of 256 as previously)
+
+
+  III. MISCELLANEOUS
+
     - Added support for the DESTDIR variable during "make install".  This
       simplifies packaging of FreeType.
 
@@ -61,7 +105,7 @@ LATEST CHANGES BETWEEN 2.1.3 and 2.1.2
          python src/tools/docmaker/docmaker.py \
                 --prefix=ft2 \
                 --title=FreeType-2.1.3 \
-                --output=<outputdirectory> 
+                --output=<outputdirectory>
                 include/freetype/*.h \
                 include/freetype/config/*.h \
                 include/freetype/cache/*.h
@@ -80,32 +124,6 @@ LATEST CHANGES BETWEEN 2.1.3 and 2.1.2
       under-way.  Many internal functions, constants, and types have been
       renamed.
 
-    - The "load_flags" parameter of FT_Load_Glyph is now an FT_Int32
-      (instead of just being an FT_Int).  This breaks source and binary
-      compatibility for 16bit systems only, while retaining both of them for
-      32 and 64 bit ones.
-
-      Some new flags have been added consequently:
-
-        FT_LOAD_NO_AUTOHINT   :: Disable the use of the auto-hinter
-                                 (but not native format hinters).
-
-        FT_LOAD_TARGET_NORMAL :: Hint and render for normal anti-aliased
-                                 displays.
-
-        FT_LOAD_TARGET_MONO   :: Hint and render for 1-bit displays.
-
-        FT_LOAD_TARGET_LCD    :: Hint and render for horizontal RGB or BGR
-                                 sub-pixel displays (like LCD screens).
-                                 THIS IS STILL EXPERIMENTAL!
-
-        FT_LOAD_TARGET_LCD_V  :: Same as FT_LOAD_TARGET_LCD, for vertical
-                                 sub-pixel displays (like rotated LCD
-                                 screens).  THIS IS STILL EXPERIMENTAL!
-
-      FT_LOAD_MONOCHROME is still supported, but only affects rendering, not
-      the hinting.
-
 
 ========================================================================