Commit d5ca74723cbdf873bd7a50dcccd175a05eaad501

David Turner 2007-01-10T14:18:15

* Jamfile, README, builds/win32/visualc/freetype.dsp, builds/win32/visualc/freetype.vcproj, docs/VERSION.DLL, include/freetype/freetype.h, include/freetype/t1tables.h, include/freetype/internal/tttypes.h: updating version number to 2.3.0 !! * include/freetype/ftchapters.h, include/freetype/ftgasp.h, include/freetype/ftlcdfil.h: updating reference documentation with GASP support and LCD filtering sections

diff --git a/ChangeLog b/ChangeLog
index 4fe7145..7eb64e3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 2007-01-10  David Turner  <david@freetype.org>
 
+	* Jamfile, README, builds/win32/visualc/freetype.dsp,
+	builds/win32/visualc/freetype.vcproj, docs/VERSION.DLL,
+	include/freetype/freetype.h, include/freetype/t1tables.h,
+	include/freetype/internal/tttypes.h: updating version
+	number to 2.3.0 !!
+
+	* include/freetype/ftchapters.h, include/freetype/ftgasp.h,
+	include/freetype/ftlcdfil.h: updating reference documentation
+	with GASP support and LCD filtering sections
+
 	* src/pshinter/pshalgo.c (psh_glyph_compute_inflections):
 	fixed a typo which created an endless loop with some malformed
 	font files
diff --git a/Jamfile b/Jamfile
index 35c98fe..9c0a622 100644
--- a/Jamfile
+++ b/Jamfile
@@ -193,7 +193,7 @@ rule RefDoc
 
 actions RefDoc
 {
-  python $(FT2_SRC)/tools/docmaker/docmaker.py --prefix=ft2 --title=FreeType-2.2.1 --output=$(DOC_DIR) $(FT2_INCLUDE)/freetype/*.h $(FT2_INCLUDE)/freetype/config/*.h
+  python $(FT2_SRC)/tools/docmaker/docmaker.py --prefix=ft2 --title=FreeType-2.3.0 --output=$(DOC_DIR) $(FT2_INCLUDE)/freetype/*.h $(FT2_INCLUDE)/freetype/config/*.h
 }
 
 RefDoc  refdoc ;
diff --git a/README b/README
index 51c56b2..f5fa23d 100644
--- a/README
+++ b/README
@@ -9,7 +9,7 @@
   is called `libttf'.  They are *not* compatible!
 
 
-  FreeType 2.2.1
+  FreeType 2.3.0
   ==============
 
   Please   read   the  docs/CHANGES   file,   it  contains   IMPORTANT
@@ -26,8 +26,8 @@
 
   and download one of the following files.
 
-    freetype-doc-2.2.1.tar.bz2
-    freetype-doc-2.2.1.tar.gz
+    freetype-doc-2.3.0.tar.bz2
+    freetype-doc-2.3.0.tar.gz
     ftdoc221.zip
 
 
diff --git a/builds/exports.mk b/builds/exports.mk
index 3fad4b8..5452b35 100644
--- a/builds/exports.mk
+++ b/builds/exports.mk
@@ -42,8 +42,8 @@ ifneq ($(EXPORTS_LIST),)
   # The list of public headers we're going to parse.
   PUBLIC_HEADERS := $(wildcard $(PUBLIC_DIR)/*.h)
 
-  # The `apinames' source and executable.  We use $E as the executable
-  # suffix, which *includes* the final dot.
+  # The `apinames' source and executable.  We use $E_BUILD as the host
+  # executable suffix, which *includes* the final dot.
   #
   # Note that $(APINAMES_OPTIONS) is empty, except for Windows compilers.
   #
diff --git a/builds/win32/visualc/freetype.dsp b/builds/win32/visualc/freetype.dsp
index 07e3552..f2cac93 100644
--- a/builds/win32/visualc/freetype.dsp
+++ b/builds/win32/visualc/freetype.dsp
@@ -54,7 +54,7 @@ BSC32=bscmake.exe
 # ADD BSC32 /nologo
 LIB32=link.exe -lib
 # ADD BASE LIB32 /nologo
-# ADD LIB32 /nologo /out:"..\..\..\objs\freetype221.lib"
+# ADD LIB32 /nologo /out:"..\..\..\objs\freetype230.lib"
 
 !ELSEIF  "$(CFG)" == "freetype - Win32 Debug"
 
@@ -78,7 +78,7 @@ BSC32=bscmake.exe
 # ADD BSC32 /nologo
 LIB32=link.exe -lib
 # ADD BASE LIB32 /nologo
-# ADD LIB32 /nologo /out:"..\..\..\objs\freetype221_D.lib"
+# ADD LIB32 /nologo /out:"..\..\..\objs\freetype230_D.lib"
 
 !ELSEIF  "$(CFG)" == "freetype - Win32 Debug Multithreaded"
 
@@ -102,8 +102,8 @@ BSC32=bscmake.exe
 # ADD BASE BSC32 /nologo
 # ADD BSC32 /nologo
 LIB32=link.exe -lib
-# ADD BASE LIB32 /nologo /out:"lib\freetype200b8_D.lib"
-# ADD LIB32 /nologo /out:"..\..\..\objs\freetype221MT_D.lib"
+# ADD BASE LIB32 /nologo /out:"lib\freetype230_D.lib"
+# ADD LIB32 /nologo /out:"..\..\..\objs\freetype230MT_D.lib"
 
 !ELSEIF  "$(CFG)" == "freetype - Win32 Release Multithreaded"
 
@@ -126,8 +126,8 @@ BSC32=bscmake.exe
 # ADD BASE BSC32 /nologo
 # ADD BSC32 /nologo
 LIB32=link.exe -lib
-# ADD BASE LIB32 /nologo /out:"lib\freetype200b8.lib"
-# ADD LIB32 /nologo /out:"..\..\..\objs\freetype221MT.lib"
+# ADD BASE LIB32 /nologo /out:"lib\freetype230.lib"
+# ADD LIB32 /nologo /out:"..\..\..\objs\freetype230MT.lib"
 
 !ELSEIF  "$(CFG)" == "freetype - Win32 Release Singlethreaded"
 
@@ -151,8 +151,8 @@ BSC32=bscmake.exe
 # ADD BASE BSC32 /nologo
 # ADD BSC32 /nologo
 LIB32=link.exe -lib
-# ADD BASE LIB32 /nologo /out:"..\..\..\objs\freetype206.lib"
-# ADD LIB32 /out:"..\..\..\objs\freetype221ST.lib"
+# ADD BASE LIB32 /nologo /out:"..\..\..\objs\freetype230.lib"
+# ADD LIB32 /out:"..\..\..\objs\freetype230ST.lib"
 # SUBTRACT LIB32 /nologo
 
 !ELSEIF  "$(CFG)" == "freetype - Win32 Debug Singlethreaded"
@@ -177,8 +177,8 @@ BSC32=bscmake.exe
 # ADD BASE BSC32 /nologo
 # ADD BSC32 /nologo
 LIB32=link.exe -lib
-# ADD BASE LIB32 /nologo /out:"..\..\..\objs\freetype206_D.lib"
-# ADD LIB32 /nologo /out:"..\..\..\objs\freetype221ST_D.lib"
+# ADD BASE LIB32 /nologo /out:"..\..\..\objs\freetype230_D.lib"
+# ADD LIB32 /nologo /out:"..\..\..\objs\freetype230ST_D.lib"
 
 !ENDIF 
 
diff --git a/builds/win32/visualc/freetype.vcproj b/builds/win32/visualc/freetype.vcproj
index dc68555..9e87284 100644
--- a/builds/win32/visualc/freetype.vcproj
+++ b/builds/win32/visualc/freetype.vcproj
@@ -69,7 +69,7 @@
 			/>
 			<Tool
 				Name="VCLibrarianTool"
-				OutputFile="..\..\..\objs\freetype221.lib"
+				OutputFile="..\..\..\objs\freetype230.lib"
 				SuppressStartupBanner="true"
 			/>
 			<Tool
@@ -144,7 +144,7 @@
 			/>
 			<Tool
 				Name="VCLibrarianTool"
-				OutputFile="..\..\..\objs\freetype221MT.lib"
+				OutputFile="..\..\..\objs\freetype230MT.lib"
 				SuppressStartupBanner="true"
 			/>
 			<Tool
@@ -219,7 +219,7 @@
 			/>
 			<Tool
 				Name="VCLibrarianTool"
-				OutputFile="..\..\..\objs\freetype221ST.lib"
+				OutputFile="..\..\..\objs\freetype230ST.lib"
 			/>
 			<Tool
 				Name="VCALinkTool"
@@ -291,7 +291,7 @@
 			/>
 			<Tool
 				Name="VCLibrarianTool"
-				OutputFile="..\..\..\objs\freetype221_D.lib"
+				OutputFile="..\..\..\objs\freetype230_D.lib"
 				SuppressStartupBanner="true"
 			/>
 			<Tool
@@ -364,7 +364,7 @@
 			/>
 			<Tool
 				Name="VCLibrarianTool"
-				OutputFile="..\..\..\objs\freetype221ST_D.lib"
+				OutputFile="..\..\..\objs\freetype230ST_D.lib"
 				SuppressStartupBanner="true"
 			/>
 			<Tool
@@ -438,7 +438,7 @@
 			/>
 			<Tool
 				Name="VCLibrarianTool"
-				OutputFile="..\..\..\objs\freetype221MT_D.lib"
+				OutputFile="..\..\..\objs\freetype230MT_D.lib"
 				SuppressStartupBanner="true"
 			/>
 			<Tool
diff --git a/docs/VERSION.DLL b/docs/VERSION.DLL
index 45108cf..00fa2cd 100644
--- a/docs/VERSION.DLL
+++ b/docs/VERSION.DLL
@@ -53,6 +53,7 @@ systems, but not all of them:
 
     release    libtool      so
   -------------------------------
+     2.3.0      9.11.3    6.3.11
      2.2.1      9.10.3    6.3.10
      2.2.0      9.9.3     6.3.9
      2.1.10     9.8.3     6.3.8
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index b87ead9..e2eeed4 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3313,8 +3313,8 @@ FT_BEGIN_HEADER
    *    macros.
    */
 #define FREETYPE_MAJOR  2
-#define FREETYPE_MINOR  2
-#define FREETYPE_PATCH  2
+#define FREETYPE_MINOR  3
+#define FREETYPE_PATCH  0
 
 
   /*************************************************************************/
diff --git a/include/freetype/ftchapters.h b/include/freetype/ftchapters.h
index f950cee..bd812c8 100644
--- a/include/freetype/ftchapters.h
+++ b/include/freetype/ftchapters.h
@@ -57,6 +57,7 @@
 /*    pfr_fonts                                                            */
 /*    winfnt_fonts                                                         */
 /*    font_formats                                                         */
+/*    gasp_table                                                           */
 /*                                                                         */
 /***************************************************************************/
 
@@ -94,5 +95,6 @@
 /*    module_management                                                    */
 /*    gzip                                                                 */
 /*    lzw                                                                  */
+/*    lcd_filtering                                                        */
 /*                                                                         */
 /***************************************************************************/
diff --git a/include/freetype/ftgasp.h b/include/freetype/ftgasp.h
index ae4add3..07c6883 100644
--- a/include/freetype/ftgasp.h
+++ b/include/freetype/ftgasp.h
@@ -22,6 +22,24 @@
 #include <ft2build.h>
 #include FT_FREETYPE_H
 
+ /***************************************************************************
+  *
+  * @section:
+  *    gasp_table
+  *
+  * @title:
+  *    Gasp Table
+  *
+  * @abstract:
+  *    Retrieving TrueType GASP table entries
+  *
+  * @description:
+  *   The function @FT_Get_Gasp can be used to query a TrueType or OpenType
+  *   font for specific entries in their GASP table, if any. This is mainly
+  *   useful when implementing native TrueType hinting with the bytecode
+  *   interpreter and when one wants to duplicate the Windows text rendering
+  *   results
+  */
 
   /*************************************************************************
    *
@@ -53,6 +71,8 @@
    * @note:
    *   `ClearType' is Microsoft's implementation of LCD rendering, partly
    *   protected by patents.
+   *
+   * @since: 2.3.0
    */
 #define FT_GASP_NO_TABLE               -1
 #define FT_GASP_DO_GRIDFIT           0x01
@@ -77,6 +97,8 @@
    * @return:
    *   Bit flags (see @FT_GASP_XXX), or @FT_GASP_NO_TABLE is there is no
    *   `gasp' table in the face.
+   *
+   * @since: 2.3.0
    */
   FT_EXPORT( FT_Int )
   FT_Get_Gasp( FT_Face  face,
diff --git a/include/freetype/ftlcdfil.h b/include/freetype/ftlcdfil.h
index a6559da..50416bc 100644
--- a/include/freetype/ftlcdfil.h
+++ b/include/freetype/ftlcdfil.h
@@ -26,6 +26,27 @@
 
 FT_BEGIN_HEADER
 
+ /***************************************************************************
+  *
+  * @section:
+  *    lcd_filtering
+  *
+  * @title:
+  *    LCD Filtering
+  *
+  * @abstract:
+  *    Reduce color fringes of LCD-optimized bitmaps
+  *
+  * @description:
+  *   The @FT_Library_SetLcdFilter API can be used to specify a low-pass filter
+  *   to be applied to LCD-optimized bitmaps generated through @FT_Render_Glyph.
+  *   This is useful to reduce color fringes when compared to unfiltered rendering.
+  *
+  *   Note that no filter is active by default, and that this function is
+  *   *not* implemented in default builds of the library. You need to #define
+  *   FT_CONFIG_OPTION_SUBPIXEL_RENDERING in your ftoption.h file in order to
+  *   activate it.
+  */
 
   /****************************************************************************
    *
@@ -47,8 +68,7 @@ FT_BEGIN_HEADER
    *   FT_LCD_FILTER_LIGHT ::
    *     The light filter is a variant that produces less blurriness at the
    *     cost of slightly more color fringes than the default one.  It might
-   *     be better than the default one, depending on the monitor, personal
-   *     vision, and taste.
+   *     be better, depending on taste, your monitor or your personal vision.
    *
    *   FT_LCD_FILTER_LEGACY ::
    *     This filter corresponds to the original libXft color filter.  It
@@ -59,6 +79,8 @@ FT_BEGIN_HEADER
    *
    *     This filter is only provided for comparison purposes, and might be
    *     disabled or stay unsupported in the future.
+   *
+   * @since: 2.3.0
    */
   typedef enum
   {
@@ -105,7 +127,7 @@ FT_BEGIN_HEADER
    *   do anything except returning `FT_Err_Unimplemented_Feature' if the
    *   configuration macro FT_CONFIG_OPTION_SUBPIXEL_RENDERING is not
    *   defined in your build of the library, which should correspond to all
-   *   default builds of the library.
+   *   default builds of FreeType.
    *
    *   The filter affects glyph bitmaps rendered through @FT_Render_Glyph,
    *   @FT_Outline_Get_Bitmap, @FT_Load_Glyph, and @FT_Load_Char.
@@ -123,6 +145,7 @@ FT_BEGIN_HEADER
    *   need to modify their layout and glyph positioning code when enabling
    *   the filter.
    *
+   * @since: 2.3.0
    */
   FT_EXPORT( FT_Error )
   FT_Library_SetLcdFilter( FT_Library    library,
diff --git a/include/freetype/internal/tttypes.h b/include/freetype/internal/tttypes.h
index 2acc2ee..8179cca 100644
--- a/include/freetype/internal/tttypes.h
+++ b/include/freetype/internal/tttypes.h
@@ -1424,7 +1424,7 @@ FT_BEGIN_HEADER
     TT_BDFRec             bdf;
 #endif /* TT_CONFIG_OPTION_BDF */
 
-    /* since 2.2.2 */
+    /* since 2.3.0 */
     FT_ULong              horz_metrics_offset;
     FT_ULong              vert_metrics_offset;
 
diff --git a/include/freetype/t1tables.h b/include/freetype/t1tables.h
index 7979ea5..250629d 100644
--- a/include/freetype/t1tables.h
+++ b/include/freetype/t1tables.h
@@ -256,7 +256,7 @@ FT_BEGIN_HEADER
 
     FT_BBox*         bboxes    [T1_MAX_MM_DESIGNS + 1];
 
-    /* since 2.2.2 */
+    /* since 2.3.0 */
 
     /* undocumented, optional: the default design instance;   */
     /* corresponds to default_weight_vector --                */