[gs-commits] rev 11607 - trunk/gs/doc
chrisl at ghostscript.com
chrisl at ghostscript.com
Fri Aug 6 08:27:21 UTC 2010
Author: chrisl
Date: 2010-08-06 08:27:20 +0000 (Fri, 06 Aug 2010)
New Revision: 11607
Modified:
trunk/gs/doc/Develop.htm
trunk/gs/doc/Make.htm
trunk/gs/doc/Psfiles.htm
trunk/gs/doc/Use.htm
Log:
Revise some of the FAPI related information.
Modified: trunk/gs/doc/Develop.htm
===================================================================
--- trunk/gs/doc/Develop.htm 2010-08-06 05:53:42 UTC (rev 11606)
+++ trunk/gs/doc/Develop.htm 2010-08-06 08:27:20 UTC (rev 11607)
@@ -1809,10 +1809,12 @@
<a href="../base/gdevsvg.c">base/gdevsvg.c</a>.
<p>
-The svgwrite device produces SVG only. The cairo device uses the cairo
-graphics library to produce PDF, EPS, SVG or PNG output, based on the
-requested filename extension.
+The svgwrite device produces SVG only.
+The cairo device has been removed for the
+Ghostscript version 9.0 release due to it's incompleteness
+and lack of attention.
+
<dt>
Text extraction:
<dd>
Modified: trunk/gs/doc/Make.htm
===================================================================
--- trunk/gs/doc/Make.htm 2010-08-06 05:53:42 UTC (rev 11606)
+++ trunk/gs/doc/Make.htm 2010-08-06 08:27:20 UTC (rev 11607)
@@ -2813,32 +2813,42 @@
<h2><a name="FT_build"></a>How to build Ghostscript with FreeType</h2>
<p>
-<em>Note: This section is only for users who wish to use Ghostscript with
-the FreeType font renderer. Other users please skip this section.
-</em>
+As of Ghostscript version 9.0, Ghostscript uses the Freetype
+scaler/renderer for all fonts (except Type 3) by default.
-<p>
Ghostscript sources include a copy of the the FreeType libary, or you
-can use a recent release which enables the incremental font interface.
+can use a recent release (Freetype 2.4.1 or later) which enables the
+incremental font interface.
<p>
-With the autoconf build (Linux, MacOS X, Solaris, etc.) just pass
-<tt>--enable-freetype</tt> to the configure script. This will compile
-in the freetype source code and enable the font api bridge to freetype.
-<p>
+As the FAPI/Freetype code in its current form is relatively new, the
+old AFS (Artifex Font Scaler) is still included in Ghostscript, and
+will remain until we are fully satisfied that the "real world" performance
+of the FAPI/Freetype is proven.
-<p>For Windows/MSVC you need to define FT_BRIGE=1 on the nmake
+To return a build to the AFS with the autoconf build (Linux, MacOS X,
+Solaris, etc.), pass the <tt>--disable-freetype</tt> to the
+configure script.
+
+<p>For Windows/MSVC you need to define FT_BRIGE=0 on the nmake
command line. For example:
-<blockquote><pre>nmake -f psi\msvc32.mak FT_BRIDGE=1</pre></blockquote>
+<blockquote><pre>nmake -f psi\msvc32.mak FT_BRIDGE=0</pre></blockquote>
</p>
<p>
-<p>With switching to freetype 2 as the default font renderer in April 2010, we
-added a new switch:<code>-dDisableFAPI=true</code> to revert to the older
-behavior, just in case serious regression happens that cannot be resolved in a timely manner.</p>
+<p>
+In a prebuilt binary (that is, one with FAPI/Freetype enabled by
+default, you can still revert to the AFS at run time by passing
+Ghostscript the <code>-dDisableFAPI=true</code> to revert to the older
+behavior, just in case a serious regression happens that cannot be resolved
+in a timely manner.
+
+Again, it is intended that this option will be removed in a future release.
+
+</p>
<!-- [2.0 end contents] ==================================================== -->
<!-- [3.0 begin visible trailer] =========================================== -->
Modified: trunk/gs/doc/Psfiles.htm
===================================================================
--- trunk/gs/doc/Psfiles.htm 2010-08-06 05:53:42 UTC (rev 11606)
+++ trunk/gs/doc/Psfiles.htm 2010-08-06 08:27:20 UTC (rev 11607)
@@ -66,22 +66,22 @@
PostScript Encodings:
<dd>
<a href="../lib/gs_ce_e.ps"><tt>gs_ce_e.ps</tt></a>,
-<a href="../lib/gs_il1_e.ps"><tt>gs_il1_e.ps</tt></a>,
-<a href="../lib/gs_std_e.ps"><tt>gs_std_e.ps</tt></a>,
-<a href="../lib/gs_sym_e.ps"><tt>gs_sym_e.ps</tt></a>.
+<a href="../Resource/Init/gs_il1_e.ps"><tt>gs_il1_e.ps</tt></a>,
+<a href="../Resource/Init/gs_std_e.ps"><tt>gs_std_e.ps</tt></a>,
+<a href="../Resource/Init/gs_sym_e.ps"><tt>gs_sym_e.ps</tt></a>.
<dt>
PDF Encodings:
<dd>
-<a href="../lib/gs_mex_e.ps"><tt>gs_mex_e.ps</tt></a>,
-<a href="../lib/gs_mro_e.ps"><tt>gs_mro_e.ps</tt></a>,
-<a href="../lib/gs_pdf_e.ps"><tt>gs_pdf_e.ps</tt></a>,
-<a href="../lib/gs_wan_e.ps"><tt>gs_wan_e.ps</tt></a>.
+<a href="../Resource/Init/gs_mex_e.ps"><tt>gs_mex_e.ps</tt></a>,
+<a href="../Resource/Init/gs_mro_e.ps"><tt>gs_mro_e.ps</tt></a>,
+<a href="../Resource/Init/gs_pdf_e.ps"><tt>gs_pdf_e.ps</tt></a>,
+<a href="../Resource/Init/gs_wan_e.ps"><tt>gs_wan_e.ps</tt></a>.
<dt>
Non-standard Encodings:
<dd>
-<a href="../lib/gs_dbt_e.ps"><tt>gs_dbt_e.ps</tt></a>,
+<a href="../Resource/Init/gs_dbt_e.ps"><tt>gs_dbt_e.ps</tt></a>,
<a href="../lib/gs_il2_e.ps"><tt>gs_il2_e.ps</tt></a>,
<a href="../lib/gs_ksb_e.ps"><tt>gs_ksb_e.ps</tt></a>,
<a href="../lib/gs_wl1_e.ps"><tt>gs_wl1_e.ps</tt></a>,
@@ -91,16 +91,16 @@
<dt>
Pseudo-encodings:
<dd>
-<a href="../lib/gs_css_e.ps"><tt>gs_css_e.ps</tt></a>,
+<a href="../Resource/Init/gs_css_e.ps"><tt>gs_css_e.ps</tt></a>,
<a href="../lib/gs_lgo_e.ps"><tt>gs_lgo_e.ps</tt></a>,
<a href="../lib/gs_lgx_e.ps"><tt>gs_lgx_e.ps</tt></a>,
-<a href="../lib/gs_mgl_e.ps"><tt>gs_mgl_e.ps</tt></a>.
+<a href="../Resource/Init/gs_mgl_e.ps"><tt>gs_mgl_e.ps</tt></a>.
</dl>
</dl>
<dl>
-<dt><a href="../lib/gs_btokn.ps"><tt>gs_btokn.ps</tt></a>
+<dt><a href="../Resource/Init/gs_btokn.ps"><tt>gs_btokn.ps</tt></a>
<dd><code>gs_init.ps</code> reads this in if the <b><tt>btoken</tt></b>
feature is included in the configuration. It provides support for binary
tokens.
@@ -114,86 +114,86 @@
</dl>
<dl>
-<dt><a href="../lib/gs_cff.ps"><tt>gs_cff.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cff.ps"><tt>gs_cff.ps</tt></a>
<dd>Load CFF (compressed) fonts.
</dl>
<dl>
-<dt><a href="../lib/gs_fntem.ps"><tt>gs_fntem.ps</tt></a>
+<dt><a href="../Resource/Init/gs_fntem.ps"><tt>gs_fntem.ps</tt></a>
<dd>Code for emulating PostScript fonts with non-PostScript font technologies.
</dl>
<dl>
-<dt><a href="../lib/gs_cidtt.ps"><tt>gs_cidtt.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cidtt.ps"><tt>gs_cidtt.ps</tt></a>
<dd>Code for emulating CID fonts with TrueType fonts.
</dl>
<dl>
-<dt><a href="../lib/gs_cidcm.ps"><tt>gs_cidcm.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cidcm.ps"><tt>gs_cidcm.ps</tt></a>
<dd>Code for recognizing font names of the form CIDFont-CMap (or
CIDFont--CMap) and creating the font automatically.
</dl>
<dl>
-<dt><a href="../lib/gs_ciddc.ps"><tt>gs_ciddc.ps</tt></a>
+<dt><a href="../Resource/Init/gs_ciddc.ps"><tt>gs_ciddc.ps</tt></a>
<dd>Defines Decoding and CIDDecoding resource categories and related procsets.
Used for for emulating PostScript fonts with non-PostScript font technologies.
</dl>
<dl>
-<dt><a href="../lib/gs_cidfm.ps"><tt>gs_cidfm.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cidfm.ps"><tt>gs_cidfm.ps</tt></a>
<dd>Provides resource mapping for CIDFont category.
</dl>
<dl>
-<dt><a href="../lib/gs_cidfn.ps"><tt>gs_cidfn.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cidfn.ps"><tt>gs_cidfn.ps</tt></a>
<dd><code>ProcSet</code> for implementing <b><tt>CIDFont</tt></b> and
<code>CIDMap</code> resources.
</dl>
<dl>
-<dt><a href="../lib/gs_cmap.ps"><tt>gs_cmap.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cmap.ps"><tt>gs_cmap.ps</tt></a>
<dd><code>ProcSet</code> for implementing <b><tt>CMap</tt></b> resources.
</dl>
<dl>
-<dt><a href="../lib/gs_cspace.ps"><tt>gs_cspace.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cspace.ps"><tt>gs_cspace.ps</tt></a>
<dd> PostScript portion of the basic color space handling;
see the extensive comment at the head of the file
for information.
</dl>
<dl>
-<dt><a href="../lib/gs_dscp.ps"><tt>gs_dscp.ps</tt></a>
+<dt><a href="../Resource/Init/gs_dscp.ps"><tt>gs_dscp.ps</tt></a>
<dd>Code to compensate for badly written PostScript files by setting
Orientation according to the DSC comments.
</dl>
<dl>
-<dt><a href="../lib/gs_epsf.ps"><tt>gs_epsf.ps</tt></a>
+<dt><a href="../Resource/Init/gs_epsf.ps"><tt>gs_epsf.ps</tt></a>
<dd>Allow the interpreter to recognize DOS EPSF file headers, and skip to the
PostScript section of the file.
</dl>
<dl>
-<dt><a href="../lib/gs_fapi.ps"><tt>gs_fapi.ps</tt></a>
+<dt><a href="../Resource/Init/gs_fapi.ps"><tt>gs_fapi.ps</tt></a>
<dd>Font API support.
</dl>
<dl>
-<dt><a href="../lib/gs_fonts.ps"><tt>gs_fonts.ps</tt></a>
+<dt><a href="../Resource/Init/gs_fonts.ps"><tt>gs_fonts.ps</tt></a>
<dd><code>gs_init.ps</code> reads this in. It initializes Ghostscript's
font machinery and provides some utility procedures that work with fonts.
</dl>
<dl>
-<dt><a href="../lib/gs_frsd.ps"><tt>gs_frsd.ps</tt></a>
+<dt><a href="../Resource/Init/gs_frsd.ps"><tt>gs_frsd.ps</tt></a>
<dd>Support for the PostScript LanguageLevel 3
<code>ReusableStreamDecode</code> filter.
</dl>
<dl>
-<dt><a href="../lib/gs_img.ps"><tt>gs_img.ps</tt></a>
+<dt><a href="../Resource/Init/gs_img.ps"><tt>gs_img.ps</tt></a>
<dd>Implementation of the traditional (non-dictionary)
form of the image and imagemask operators, and the
colorimage operator (including the Next alphaimage
@@ -201,26 +201,26 @@
</dl>
<dl>
-<dt><a href="../lib/gs_init.ps"><tt>gs_init.ps</tt></a>
+<dt><a href="../Resource/Init/gs_init.ps"><tt>gs_init.ps</tt></a>
<dd>Ghostscript reads this automatically when it starts up. It contains
definitions of many standard procedures and initialization for a wide
variety of things.
</dl>
<dl>
-<dt><a href="../lib/gs_lev2.ps"><tt>gs_lev2.ps</tt></a>
+<dt><a href="../Resource/Init/gs_lev2.ps"><tt>gs_lev2.ps</tt></a>
<dd><code>gs_init.ps</code> reads this in if the Ghostscript interpreter
includes Level 2 PostScript functions. It contains definitions of
procedures and miscellaneous initialization for the Level 2 functions.
</dl>
<dl>
-<dt><a href="../lib/gs_ll3.ps"><tt>gs_ll3.ps</tt></a>
+<dt><a href="../Resource/Init/gs_ll3.ps"><tt>gs_ll3.ps</tt></a>
<dd>Initialize PostScript LanguageLevel 3 functions.
</dl>
<dl>
-<dt><a href="../lib/gs_resmp.ps"><tt>gs_resmp.ps</tt></a>
+<dt><a href="../Resource/Init/gs_resmp.ps"><tt>gs_resmp.ps</tt></a>
<dd>A procset for redefining resource categories with a resource map.
</dl>
@@ -237,19 +237,19 @@
</dl>
<dl>
-<dt><a href="../lib/gs_res.ps"><tt>gs_res.ps</tt></a>
+<dt><a href="../Resource/Init/gs_res.ps"><tt>gs_res.ps</tt></a>
<dd><code>gs_init.ps</code> reads this in if the Level 2 resource
machinery is included. Currently, this is the case for all Level 2
configurations.
</dl>
<dl>
-<dt><a href="../lib/gs_setpd.ps"><tt>gs_setpd.ps</tt></a>
+<dt><a href="../Resource/Init/gs_setpd.ps"><tt>gs_setpd.ps</tt></a>
<dd>Implementation of the <code>setpagedevice</code> operator.
</dl>
<dl>
-<dt><a href="../lib/gs_statd.ps"><tt>gs_statd.ps</tt></a>
+<dt><a href="../Resource/Init/gs_statd.ps"><tt>gs_statd.ps</tt></a>
<dd><code>gs_init.ps</code> reads this in. It creates a dummy
<code>statusdict</code> and some other environmental odds and ends for
the benefit of PostScript files that really want to be printed on a
@@ -257,28 +257,28 @@
</dl>
<dl>
-<dt><a href="../lib/gs_trap.ps"><tt>gs_trap.ps</tt></a>
+<dt><a href="../Resource/Init/gs_trap.ps"><tt>gs_trap.ps</tt></a>
<dd>Stub support for the PostScript LanguageLevel 3 "In-RIP trapping"
feature.
</dl>
<dl>
-<dt><a href="../lib/gs_ttf.ps"><tt>gs_ttf.ps</tt></a>
+<dt><a href="../Resource/Init/gs_ttf.ps"><tt>gs_ttf.ps</tt></a>
<dd>Support code for direct use of TrueType fonts.
</dl>
<dl>
-<dt><a href="../lib/gs_typ32.ps"><tt>gs_typ32.ps</tt></a>
+<dt><a href="../Resource/Init/gs_typ32.ps"><tt>gs_typ32.ps</tt></a>
<dd>Initialization file for Type 32 fonts.
</dl>
<dl>
-<dt><a href="../lib/gs_typ42.ps"><tt>gs_typ42.ps</tt></a>
+<dt><a href="../Resource/Init/gs_typ42.ps"><tt>gs_typ42.ps</tt></a>
<dd>Support code for Type 42 fonts (TrueType font in a PostScript "wrapper").
</dl>
<dl>
-<dt><a href="../lib/gs_type1.ps"><tt>gs_type1.ps</tt></a>
+<dt><a href="../Resource/Init/gs_type1.ps"><tt>gs_type1.ps</tt></a>
<dd><code>gs_init.ps</code> reads this in if the Ghostscript interpreter
includes Type 1 font capability (which it normally does).
</dl>
@@ -293,28 +293,28 @@
to configure Ghostscript.
<dl>
-<dt><a href="../lib/Fontmap"><tt>Fontmap</tt></a>
+<dt><a href="../Resource/Init/Fontmap"><tt>Fontmap</tt></a>
<dd>Font mapping table.
</dl>
<dl>
-<dt><a href="../lib/cidfmap"><tt>cidfmap</tt></a>
+<dt><a href="../Resource/Init/cidfmap"><tt>cidfmap</tt></a>
<dd>CID font mapping table. Allows substitution of a CID font for another CID font or
a TrueType font for a CID font.
</dl>
<dl>
-<dt><a href="../lib/FAPIconfig"><tt>FAPIconfig</tt></a>
+<dt><a href="../Resource/Init/FAPIconfig"><tt>FAPIconfig</tt></a>
<dd>A configuration file for Font API client.
</dl>
<dl>
-<dt><a href="../lib/FAPIfontmap"><tt>FAPIfontmap</tt></a>
+<dt><a href="../Resource/Init/FAPIfontmap"><tt>FAPIfontmap</tt></a>
<dd>Font mapping table for Font-API-handled fonts.
</dl>
<dl>
-<dt><a href="../lib/FAPIcidfmap"><tt>FAPIcidfmap</tt></a>
+<dt><a href="../Resource/Init/FAPIcidfmap"><tt>FAPIcidfmap</tt></a>
<dd>Font mapping table for Font-API-handled CID fonts.
</dl>
@@ -334,13 +334,13 @@
</dl>
<dl>
-<dt><a href="../lib/gs_agl.ps"><tt>gs_agl.ps</tt></a>
+<dt><a href="../Resource/Init/gs_agl.ps"><tt>gs_agl.ps</tt></a>
<dd>Contains the mapping from Adobe glyph names to Unicode values, used to
support TrueType fonts.
</dl>
<dl>
-<dt><a href="../lib/gs_cet.ps"><tt>gs_cet.ps</tt></a>
+<dt><a href="../Resource/Init/gs_cet.ps"><tt>gs_cet.ps</tt></a>
<dd>Sets a number of alternate defaults to make Ghostscript
behave more like Adobe CPSI. Useful for running the CET conformance
test suite.
@@ -353,14 +353,14 @@
</dl>
<dl>
-<dt><a href="../lib/gs_diskf.ps"><tt>gs_diskf.ps</tt></a>
+<dt><a href="../Resource/Init/gs_diskf.ps"><tt>gs_diskf.ps</tt></a>
<dd>This file implements the <code>-dDISKFONTS</code> feature
(<code>diskfont.dev</code>). See the the usage documentation for <a
href="Use.htm#DISKFONTS">a description of this feature</a>.
</dl>
<dl>
-<dt><a href="../lib/gs_diskn.ps"><tt>gs_diskn.ps</tt></a>
+<dt><a href="../Resource/Init/gs_diskn.ps"><tt>gs_diskn.ps</tt></a>
<dd>This file implements the <code>%disk</code> IODevice
(<code>diskn.dev</code> feature). See the the language documentation
for information on the use of the %disk# devices. These PostScript
@@ -384,7 +384,7 @@
</dl>
<dl>
-<dt><a href="../lib/gs_pdfwr.ps"><tt>gs_pdfwr.ps</tt></a>
+<dt><a href="../Resource/Init/gs_pdfwr.ps"><tt>gs_pdfwr.ps</tt></a>
<dd>This file contains some patches for providing information to the
<code>pdfwrite</code> driver. It is included only if the
<code>pdfwrite</code> driver is included.
@@ -420,43 +420,43 @@
the Ghostscript source distribution.
<dl>
-<dt><a href="../lib/gs_l2img.ps"><tt>gs_l2img.ps</tt></a>
+<dt><a href="../Resource/Init/gs_l2img.ps"><tt>gs_l2img.ps</tt></a>
<dd>The <code>ProcSet</code> that emulates the PostScript Level 2
"<code>image</code>" operator on Level 1 systems.
</dl>
<dl>
-<dt><a href="../lib/pdf_base.ps"><tt>pdf_base.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_base.ps"><tt>pdf_base.ps</tt></a>
<dd>Utilities for interpreting PDF objects and streams.
</dl>
<dl>
-<dt><a href="../lib/pdf_draw.ps"><tt>pdf_draw.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_draw.ps"><tt>pdf_draw.ps</tt></a>
<dd>The interpreter for drawing-related PDF operations.
</dl>
<dl>
-<dt><a href="../lib/pdf_font.ps"><tt>pdf_font.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_font.ps"><tt>pdf_font.ps</tt></a>
<dd>Code for handling fonts in PDF files.
</dl>
<dl>
-<dt><a href="../lib/pdf_main.ps"><tt>pdf_main.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_main.ps"><tt>pdf_main.ps</tt></a>
<dd>Document- and page-level control for interpreting PDF files.
</dl>
<dl>
-<dt><a href="../lib/pdf_ops.ps"><tt>pdf_ops.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_ops.ps"><tt>pdf_ops.ps</tt></a>
<dd>Definitions for most of the PDF operators.
</dl>
<dl>
-<dt><a href="../lib/pdf_rbld.ps"><tt>pdf_rbld.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_rbld.ps"><tt>pdf_rbld.ps</tt></a>
<dd>Contains procedures for bebuilding damaged PDF files.
</dl>
<dl>
-<dt><a href="../lib/pdf_sec.ps"><tt>pdf_sec.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_sec.ps"><tt>pdf_sec.ps</tt></a>
<dd>PDF security (encryption) code.
</dl>
@@ -466,7 +466,7 @@
</dl>
<dl>
-<dt><a href="../lib/pdf_cslayer.ps"><tt>pdf_cslayer.ps</tt></a>
+<dt><a href="../Resource/Init/pdf_cslayer.ps"><tt>pdf_cslayer.ps</tt></a>
<dd>Layer data extraction utilities of Illustrator files.
</dl>
@@ -477,14 +477,14 @@
</dl>
<dl>
-<dt><a href="../lib/gs_icc.ps"><tt>gs_icc.ps</tt></a> <dd>Support for
+<dt><a href="../Resource/Init/gs_icc.ps"><tt>gs_icc.ps</tt></a> <dd>Support for
ICC color profiles. These are not a standard PostScript feature, but
are used in the PDF interpreter, as ICC profiles may be embedded in
PDF files.
</dl>
<dl>
-<dt><a href="../lib/opdfread.ps"><tt>opdfread.ps</tt></a>
+<dt><a href="../Resource/Init/opdfread.ps"><tt>opdfread.ps</tt></a>
<dd>Postscript procset for reading an ordered PDF file. This
is used by the <code>ps2ps</code>, <code>ps2ps2</code> scripts.
</dl>
@@ -515,14 +515,14 @@
the Ghostscript source distribution.
<dl>
-<dt><a href="../lib/gs_dpnxt.ps"><tt>gs_dpnxt.ps</tt></a>
+<dt><a href="../Resource/Init/gs_dpnxt.ps"><tt>gs_dpnxt.ps</tt></a>
<dd>NeXT Display PostScript extensions.
</dl>
<dl>
-<dt><a href="../lib/gs_dps.ps"><tt>gs_dps.ps</tt></a>,
-<a href="../lib/gs_dps1.ps"><tt>gs_dps1.ps</tt></a>,
-<a href="../lib/gs_dps2.ps"><tt>gs_dps2.ps</tt></a>
+<dt><a href="../Resource/Init/gs_dps.ps"><tt>gs_dps.ps</tt></a>,
+<a href="../Resource/Init/gs_dps1.ps"><tt>gs_dps1.ps</tt></a>,
+<a href="../Resource/Init/gs_dps2.ps"><tt>gs_dps2.ps</tt></a>
<dd><code>gs_init.ps</code> reads these in if the <b><tt>dps</tt></b>
feature is included in the configuration. They provide support for various
Display PostScript and Level 2 features.
Modified: trunk/gs/doc/Use.htm
===================================================================
--- trunk/gs/doc/Use.htm 2010-08-06 05:53:42 UTC (rev 11606)
+++ trunk/gs/doc/Use.htm 2010-08-06 08:27:20 UTC (rev 11607)
@@ -3532,10 +3532,11 @@
<h2><a name="FAPI_run"></a>Running Ghostscript with third-party font renderers</h2>
<p>
-Font API (FAPI) is a new feature which allows to attach third-party font
+Font API (FAPI) is a feature which allows to attach third-party font
renderers to Ghostscript.
This section explains how to run Ghostscript with third-party font
-renderers, such as UFST or Free Type.
+renderers, such as UFST. NOTE: FreeType is now the default font renderer
+for Ghostscript.
<p>
<em>Note: To run Ghostscript with UFST you need a license from Monotype Imaging.
@@ -3544,23 +3545,26 @@
<p>
<em>
-Important note: Third-party font renderers are incompatible
+Important note: Third-party font renderers may be incompatible
with devices that can embed fonts in their output (such as pdfwrite),
-because such renderers store fonts in a form from which Ghostscript cannot
-get the necessary information for embedding. Ghostscript disables such
-renderers when such device is being used. In particular, UFST and Free Type are
-disabled while running Ghostscript with the <code>pdfwrite</code>
-device.
+because such renderers may store fonts in a form from which Ghostscript cannot
+get the necessary information for embedding, for example, the Microtype fonts supplied
+with the UFST. Ghostscript can be configured to disable such renderers when such a
+device is being used.
</em>
<p>
-To run Ghostscript with Free Type, you first need to build Ghostscript
-with the Free Type bridge. Refer <a href="Make.htm#FT_build">How to build Ghostscript with Free Type</a>.
+As of Ghostscript version 9.0, Ghostscript uses Freetype 2.4.x as the default font
+scaler/renderer.
-<p>With switching to freetype 2 as the default font renderer in April 2010, we
-added a new switch:<code>-dDisableFAPI=true</code> to revert to the older
-behavior, just in case serious regression happens that cannot be resolved in a timely manner.</p>
+With this change, we added a new switch:<code>-dDisableFAPI=true</code> to revert to the older
+behavior, just in case serious regression happens that cannot be resolved in a timely manner.
+It is intended that this switch will be removed once the FAPI/Freetype implementation has
+proven itself robust and reliable in the "real world".
+
+</p>
+
<p>
To run Ghostscript with UFST, you first need to build Ghostscript
with the UFST bridge. Refer <a href="Make.htm#UFST_build">How to build Ghostscript with UFST</a>.
@@ -3802,7 +3806,7 @@
<p>
Note that UFST and Free Type cannot handle some Ghostscript fonts because
they do not include a PostScript interpreter and therefore have stronger restrictions on
-font formats than Ghostscript itself does.
+font formats than Ghostscript itself does - in particular, Type 3 fonts.
If their font types are listed in <code>HookDiskFonts</code> or in
<code>HookEmbeddedFonts</code>, Ghostscript interprets them as PS files,
then serializes font data into a RAM buffer and passes it to FAPI as
More information about the gs-commits
mailing list