diff --git a/ChangeLog b/ChangeLog
index 26c722655..f9a6a26b9 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,7 @@
 2007-01-08  David Turner  <david@freetype.org>
 
+	* docs/CHANGES: updating documentation
+
 	* include/freetype/ftgasp.h, src/base/ftgasp.c: adding a
 	new API FT_Get_Gasp to return entries of the GASP table
 	corresponding to a given character pixel size.
diff --git a/docs/CHANGES b/docs/CHANGES
index c5fbebf39..3b6f41272 100644
--- a/docs/CHANGES
+++ b/docs/CHANGES
@@ -7,8 +7,49 @@ CHANGES BETWEEN 2.2.2 and 2.2.1
 
     - Various memory leaks have been found and fixed.
 
+    - Fixed the TrueType name loader that didn't deal properly with some
+      fonts that encode their names in UTF-16 (the spec was vague, and
+      the code assumed UCS-4)
+
+    - Fixed the TrueType bytecode loader to deal properly with subtle
+      monochrome/gray issues when scaling the CVT. Some fonts exhibited
+      bad rendering artefacts otherwise.
+
+    - FT_GlyphSlot_Embolden now supports vertical layouts correctly
+      (it mangled the vertical advance height)
+
+  II. NEW API FUNCTIONS
+
+    - FT_Library_SetLcdFilter allows you to select a special filter to
+      be applied to the bitmaps generated by FT_Render_Glyph when one
+      of FT_RENDER_MODE_LCD and FT_RENDER_MODE_LCD_V is used. This
+      filter is used to reduce color-fringes, several settings are
+      available through the FT_LCD_FILTER_XXX enum.
+
+      See its declaration and documentation in FT_LCD_FILTER_H, a.k.a.
+      include/freetype/ftlcdfil.h.
+
+      *IMPORTANT*: note that this function returns an error 
+      (FT_Err_Unimplemented_Feature) in default builds of the library
+      for patent reasons. See below
+
+
+    - FT_Get_Gasp allows you to query the TrueType GASP flags for a
+      given character pixel size. This is only useful to duplicate
+      Windows' text rendering, when the native bytecode interpreter is
+      enabled (which still isn't the default for other patent reasons)
+
+      Declaration and documentation in FT_GASP_H, a.k.a.
+      include/freetype/ftgasp.h
+
+
+
+  III. IMPORTANT CHANGES
+
+    - The auto-hinter has been severely tuned to improve its results
+      with serif fonts. This results in much better font rendering of
+      many web pages.
 
-  II. IMPORTANT CHANGES
 
     - The unpatented  hinter is now part  of the default  build of the
       library; we  have added  code to automatically  support `tricky'
@@ -33,6 +74,7 @@ CHANGES BETWEEN 2.2.2 and 2.2.1
       *disable*  the   feature  to  save  code   space  by  undefining
       TT_CONFIG_OPTION_UNPATENTED_HINTING in ftoption.h.
 
+
     - LCD-optimized rendering is now DISABLED in all default builds of
       the library, mainly due  to PATENT issues.  For more information
       see:
@@ -51,14 +93,27 @@ CHANGES BETWEEN 2.2.2 and 2.2.1
       The  displayed result  should  be equal  to normal  anti-aliased
       rendering.
 
+      Additionally, if FT_CONFIG_OPTION_SUBPIXEL_RENDERING is not
+      defined, the new FT_Library_SetLcdFilter function will return
+      the FT_Err_Unimplemented_Feature error code.
+
+
     - Some computation bugs in  the TrueType bytecode interpreter were
       found,  which  allow us  to  get rid  of  very  subtle and  rare
       differences we had experienced with the Windows renderer.
 
 
+    - It's now possible to cross-compile the library easily. See the
+      file docs/INSTALL.CROSS for details
+
+
   III. MISCELLANEOUS
 
-    - TrueType glyph loading is now about 25% faster.
+    - Various performance and memory footprint optimizations have been
+      performed on the TrueType and CFF font loaders, sometimes with
+      very drastic benefits (e.g. the TrueType loader is now about
+      25% faster, FreeType should use less heap memory in nearly all
+      conditions)
 
     - The anti-aliased rasterizer has been optimized and is now 15% to
       25%  percent  faster than  in  previous  versions, depending  on
@@ -67,6 +122,11 @@ CHANGES BETWEEN 2.2.2 and 2.2.1
     - The Type 1 loader has been improved; as an example, it now skips
       top-level dictionaries properly.
 
+    - fixed the PFR font loader so that font files without any outlines
+      are not recognized as FT_FACE_FLAG_SCALABLE anymore
+
+    - better support for Mac Fonts on POSIX systems, plus compilation
+      fixes for PPC64
 
 ======================================================================