ref: a346abc0934de411f26f8472ffbc6c4e0a8f95c7
parent: 8de11f3def20c1e265ab0c60b7a4e81fa011ccf7
author: Werner Lemberg <[email protected]>
date: Thu Feb 21 04:19:09 EST 2019
s/`....`/'....'/ for SFNT table tags in documentation.
--- a/devel/ftoption.h
+++ b/devel/ftoption.h
@@ -299,13 +299,13 @@
* By default, FreeType 2 is compiled with the 'psnames' module. This
* module is in charge of converting a glyph name string into a Unicode
* value, or return a Macintosh standard glyph name for the use with the
- * TrueType `post` table.
+ * TrueType 'post' table.
*
* Undefine this macro if you do not want 'psnames' compiled in your
* build of FreeType. This has the following effects:
*
* - The TrueType driver will provide its own set of glyph names, if you
- * build it to support postscript names in the TrueType `post` table,
+ * build it to support postscript names in the TrueType 'post' table,
* but will not synthesize a missing Unicode charmap.
*
* - The Type~1 driver will not be able to synthesize a Unicode charmap
@@ -342,7 +342,7 @@
* (mac dfont, mac resource, macbinary containing a mac resource) on
* non-Mac platforms.
*
- * Note that the `FOND` resource isn't checked.
+ * Note that the 'FOND' resource isn't checked.
*/
#define FT_CONFIG_OPTION_MAC_FONTS
@@ -527,7 +527,7 @@
/**************************************************************************
*
* Define `TT_CONFIG_OPTION_COLOR_LAYERS` if you want to support coloured
- * outlines (from the `COLR`/`CPAL` tables) in all formats using the 'sfnt'
+ * outlines (from the 'COLR'/'CPAL' tables) in all formats using the 'sfnt'
* module (namely TrueType~& OpenType).
*/
#define TT_CONFIG_OPTION_COLOR_LAYERS
@@ -684,8 +684,8 @@
/**************************************************************************
*
* Define `TT_CONFIG_OPTION_GX_VAR_SUPPORT` if you want to include support
- * for Apple's distortable font technology (`fvar`, `gvar`, `cvar`, and
- * `avar` tables). Tagged 'Font Variations', this is now part of OpenType
+ * for Apple's distortable font technology ('fvar', 'gvar', 'cvar', and+ * 'avar' tables). Tagged 'Font Variations', this is now part of OpenType
* also. This has many similarities to Type~1 Multiple Masters support.
*/
#define TT_CONFIG_OPTION_GX_VAR_SUPPORT
@@ -694,7 +694,7 @@
/**************************************************************************
*
* Define `TT_CONFIG_OPTION_BDF` if you want to include support for an
- * embedded `BDF ` table within SFNT-based bitmap formats.
+ * embedded 'BDF~' table within SFNT-based bitmap formats.
*/
#define TT_CONFIG_OPTION_BDF
--- a/include/freetype/config/ftheader.h
+++ b/include/freetype/config/ftheader.h
@@ -624,8 +624,8 @@
*
* @description:
* A macro used in `#include` statements to name the file containing the
- * optional FreeType~2 API which validates OpenType tables (`BASE`,
- * `GDEF`, `GPOS`, `GSUB`, `JSTF`).
+ * optional FreeType~2 API which validates OpenType tables ('BASE',+ * 'GDEF', 'GPOS', 'GSUB', 'JSTF').
*
*/
#define FT_OPENTYPE_VALIDATE_H <freetype/ftotval.h>
@@ -638,8 +638,8 @@
*
* @description:
* A macro used in `#include` statements to name the file containing the
- * optional FreeType~2 API which validates TrueTypeGX/AAT tables (`feat`,
- * `mort`, `morx`, `bsln`, `just`, `kern`, `opbd`, `trak`, `prop`).
+ * optional FreeType~2 API which validates TrueTypeGX/AAT tables ('feat',+ * 'mort', 'morx', 'bsln', 'just', 'kern', 'opbd', 'trak', 'prop').
*
*/
#define FT_GX_VALIDATE_H <freetype/ftgxval.h>
@@ -765,7 +765,7 @@
*
* @description:
* A macro used in `#include` statements to name the file containing the
- * FreeType~2 API which handles the OpenType `CPAL` table.
+ * FreeType~2 API which handles the OpenType 'CPAL' table.
*/
#define FT_COLOR_H <freetype/ftcolor.h>
--- a/include/freetype/config/ftoption.h
+++ b/include/freetype/config/ftoption.h
@@ -299,13 +299,13 @@
* By default, FreeType 2 is compiled with the 'psnames' module. This
* module is in charge of converting a glyph name string into a Unicode
* value, or return a Macintosh standard glyph name for the use with the
- * TrueType `post` table.
+ * TrueType 'post' table.
*
* Undefine this macro if you do not want 'psnames' compiled in your
* build of FreeType. This has the following effects:
*
* - The TrueType driver will provide its own set of glyph names, if you
- * build it to support postscript names in the TrueType `post` table,
+ * build it to support postscript names in the TrueType 'post' table,
* but will not synthesize a missing Unicode charmap.
*
* - The Type~1 driver will not be able to synthesize a Unicode charmap
@@ -342,7 +342,7 @@
* (mac dfont, mac resource, macbinary containing a mac resource) on
* non-Mac platforms.
*
- * Note that the `FOND` resource isn't checked.
+ * Note that the 'FOND' resource isn't checked.
*/
#define FT_CONFIG_OPTION_MAC_FONTS
@@ -527,7 +527,7 @@
/**************************************************************************
*
* Define `TT_CONFIG_OPTION_COLOR_LAYERS` if you want to support coloured
- * outlines (from the `COLR`/`CPAL` tables) in all formats using the 'sfnt'
+ * outlines (from the 'COLR'/'CPAL' tables) in all formats using the 'sfnt'
* module (namely TrueType~& OpenType).
*/
#define TT_CONFIG_OPTION_COLOR_LAYERS
@@ -684,8 +684,8 @@
/**************************************************************************
*
* Define `TT_CONFIG_OPTION_GX_VAR_SUPPORT` if you want to include support
- * for Apple's distortable font technology (`fvar`, `gvar`, `cvar`, and
- * `avar` tables). Tagged 'Font Variations', this is now part of OpenType
+ * for Apple's distortable font technology ('fvar', 'gvar', 'cvar', and+ * 'avar' tables). Tagged 'Font Variations', this is now part of OpenType
* also. This has many similarities to Type~1 Multiple Masters support.
*/
#define TT_CONFIG_OPTION_GX_VAR_SUPPORT
@@ -694,7 +694,7 @@
/**************************************************************************
*
* Define `TT_CONFIG_OPTION_BDF` if you want to include support for an
- * embedded `BDF ` table within SFNT-based bitmap formats.
+ * embedded 'BDF~' table within SFNT-based bitmap formats.
*/
#define TT_CONFIG_OPTION_BDF
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -308,7 +308,7 @@
* `horiAdvance` or `vertAdvance`; you have to manually adjust these
* values to account for the added width and height.
*
- * FreeType doesn't use the `VORG` table data for CFF fonts because it
+ * FreeType doesn't use the 'VORG' table data for CFF fonts because it
* doesn't have an interface to quickly retrieve the glyph height. The
* y~coordinate of the vertical origin can be simply computed as
* `vertBearingY + height` after loading a glyph.
@@ -1032,7 +1032,7 @@
*
* For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
- * the font contains an `MVAR` table: `ascender`, `descender`, `height`,
+ * the font contains an 'MVAR' table: `ascender`, `descender`, `height`,
* `underline_position`, and `underline_thickness`.
*
* Especially for TrueType fonts see also the documentation for
@@ -1137,7 +1137,7 @@
* The face contains kerning information. If set, the kerning distance
* can be retrieved using the function @FT_Get_Kerning. Otherwise the
* function always return the vector (0,0). Note that FreeType doesn't
- * handle kerning data from the SFNT `GPOS` table (as present in many
+ * handle kerning data from the SFNT 'GPOS' table (as present in many
* OpenType fonts).
*
* FT_FACE_FLAG_FAST_GLYPHS ::
@@ -1163,7 +1163,7 @@
*
* FT_FACE_FLAG_HINTER ::
* The font driver has a hinting machine of its own. For example, with
- * TrueType fonts, it makes sense to use data from the SFNT `gasp`
+ * TrueType fonts, it makes sense to use data from the SFNT 'gasp'
* table only if the native TrueType hinting engine (with the bytecode
* interpreter) is available and active.
*
@@ -1482,7 +1482,7 @@
* @note:
* The style information as provided by FreeType is very basic. More
* details are beyond the scope and should be done on a higher level (for
- * example, by analyzing various fields of the `OS/2` table in SFNT based
+ * example, by analyzing various fields of the 'OS/2' table in SFNT based
* fonts).
*/
#define FT_STYLE_FLAG_ITALIC ( 1 << 0 )
@@ -2969,7 +2969,7 @@
* bitmaps, using the @FT_PIXEL_MODE_GRAY format.
*
* [Since 2.10] If the glyph index contains an entry in the face's
- * `COLR` table with a `CPAL` palette table (as defined in the OpenType
+ * 'COLR' table with a 'CPAL' palette table (as defined in the OpenType
* specification), make @FT_Render_Glyph provide a default blending of
* the color glyph layers associated with the glyph index, using the
* same bitmap format as embedded color bitmap images. This is mainly
@@ -2980,7 +2980,7 @@
*
* FT_LOAD_COMPUTE_METRICS ::
* [Since 2.6.1] Compute glyph metrics from the glyph data, without the
- * use of bundled metrics tables (for example, the `hdmx` table in
+ * use of bundled metrics tables (for example, the 'hdmx' table in
* TrueType fonts). This flag is mainly used by font validating or
* font editing applications, which need to ignore, verify, or edit
* those tables.
@@ -3460,7 +3460,7 @@
* out of the scope of this API function -- they can be implemented
* through format-specific interfaces.
*
- * Kerning for OpenType fonts implemented in a `GPOS` table is not
+ * Kerning for OpenType fonts implemented in a 'GPOS' table is not
* supported; use @FT_HAS_KERNING to find out whether a font has data
* that can be extracted with `FT_Get_Kerning`.
*/
@@ -3590,7 +3590,7 @@
*
* [Since 2.9] Special PostScript names for named instances are only
* returned if the named instance is set with @FT_Set_Named_Instance (and
- * the font has corresponding entries in its `fvar` table). If
+ * the font has corresponding entries in its 'fvar' table). If
* @FT_IS_VARIATION returns true, the algorithmically derived PostScript
* name is provided, not looking up special entries for named instances.
*/
@@ -3941,7 +3941,7 @@
* FT_SUBGLYPH_FLAG_XXX
*
* @description:
- * A list of constants describing subglyphs. Please refer to the `glyf`
+ * A list of constants describing subglyphs. Please refer to the 'glyf'
* table description in the OpenType specification for the meaning of the
* various flags (which get synthesized for non-OpenType subglyphs).
*
@@ -4030,11 +4030,11 @@
* Glyph Layer Management
*
* @abstract:
- * Retrieving and manipulating OpenType's `COLR` table data.
+ * Retrieving and manipulating OpenType's 'COLR' table data.
*
* @description:
* The functions described here allow access of colored glyph layer data
- * in OpenType's `COLR` tables.
+ * in OpenType's 'COLR' tables.
*/
@@ -4055,7 +4055,7 @@
* The current layer. Will be set by @FT_Get_Color_Glyph_Layer.
*
* p ::
- * An opaque pointer into `COLR` table data. The caller must set this
+ * An opaque pointer into 'COLR' table data. The caller must set this
* to `NULL` before the first call of @FT_Get_Color_Glyph_Layer.
*/
typedef struct FT_LayerIterator_
@@ -4073,7 +4073,7 @@
* FT_Get_Color_Glyph_Layer
*
* @description:
- * This is an interface to the `COLR` table in OpenType fonts to
+ * This is an interface to the 'COLR' table in OpenType fonts to
* iteratively retrieve the colored glyph layers associated with the
* current glyph slot.
*
--- a/include/freetype/ftcolor.h
+++ b/include/freetype/ftcolor.h
@@ -41,11 +41,11 @@
* Glyph Color Management
*
* @abstract:
- * Retrieving and manipulating OpenType's `CPAL` table data.
+ * Retrieving and manipulating OpenType's 'CPAL' table data.
*
* @description:
* The functions described here allow access and manipulation of color
- * palette entries in OpenType's `CPAL` tables.
+ * palette entries in OpenType's 'CPAL' tables.
*/
@@ -55,7 +55,7 @@
* FT_Color
*
* @description:
- * This structure models a BGRA color value of a `CPAL` palette entry.
+ * This structure models a BGRA color value of a 'CPAL' palette entry.
*
* The used color space is sRGB; the colors are not pre-multiplied, and
* alpha values must be explicitly set.
@@ -118,7 +118,7 @@
* FT_Palette_Data
*
* @description:
- * This structure holds the data of the `CPAL` table.
+ * This structure holds the data of the 'CPAL' table.
*
* @fields:
* num_palettes ::
@@ -126,13 +126,13 @@
*
* palette_name_ids ::
* A read-only array of palette name IDs with `num_palettes` elements,
- * corresponding to entries like 'dark' or 'light' in the font's `name`
+ * corresponding to entries like 'dark' or 'light' in the font's 'name'
* table.
*
- * An empty name ID in the `CPAL` table gets represented as value
+ * An empty name ID in the 'CPAL' table gets represented as value
* 0xFFFF.
*
- * `NULL` if the font's `CPAL` table doesn't contain appropriate data.
+ * `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
*
* palette_flags ::
* A read-only array of palette flags with `num_palettes` elements.
@@ -140,7 +140,7 @@
* @FT_PALETTE_FOR_LIGHT_BACKGROUND and
* @FT_PALETTE_FOR_DARK_BACKGROUND.
*
- * `NULL` if the font's `CPAL` table doesn't contain appropriate data.
+ * `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
*
* num_palette_entries ::
* The number of entries in a single palette. All palettes have the
@@ -150,14 +150,14 @@
* A read-only array of palette entry name IDs with
* `num_palette_entries`. In each palette, entries with the same index
* have the same function. For example, index~0 might correspond to
- * string 'outline' in the font's `name` table to indicate that this
+ * string 'outline' in the font's 'name' table to indicate that this
* palette entry is used for outlines, index~1 might correspond to
* 'fill' to indicate the filling color palette entry, etc.
*
- * An empty entry name ID in the `CPAL` table gets represented as value
+ * An empty entry name ID in the 'CPAL' table gets represented as value
* 0xFFFF.
*
- * `NULL` if the font's `CPAL` table doesn't contain appropriate data.
+ * `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
*
* @note:
* Use function @FT_Get_Sfnt_Name to map name IDs and entry name IDs to
@@ -226,7 +226,7 @@
*
* A corollary of (2) is that calling the function, then modifying some
* values, then calling the function again with the same arguments resets
- * all color entries to the original `CPAL` values; all user modifications
+ * all color entries to the original 'CPAL' values; all user modifications
* are lost.
*
* @input:
@@ -273,7 +273,7 @@
* FT_Palette_Set_Foreground_Color
*
* @description:
- * `COLR` uses palette index 0xFFFF to indicate a 'text foreground
+ * 'COLR' uses palette index 0xFFFF to indicate a 'text foreground
* color'. This function sets this value.
*
* @input:
@@ -291,7 +291,7 @@
* white opaque (BGRA value 0xFFFFFFFF) if
* @FT_PALETTE_FOR_DARK_BACKGROUND is present for the current palette,
* and black opaque (BGRA value 0x000000FF) otherwise, including the case
- * that no palette types are available in the `CPAL` table.
+ * that no palette types are available in the 'CPAL' table.
*
* This function always returns an error if the config macro
* `TT_CONFIG_OPTION_COLOR_LAYERS` is not defined in `ftoption.h`.
--- a/include/freetype/ftdriver.h
+++ b/include/freetype/ftdriver.h
@@ -233,7 +233,7 @@
* achieve some level of glyph symmetry. To enable reasonable
* performance (e.g., not having to run hinting on all glyphs just to get
* the widths) there was a bit in the head table indicating if the side
- * bearing was hinted, and additional tables, `hdmx` and `LTSH`, to cache
+ * bearing was hinted, and additional tables, 'hdmx' and 'LTSH', to cache
* hinting widths across multiple sizes and device aspect ratios.
*
* _Font Smoothing_
@@ -1070,7 +1070,7 @@
* coverages, this property sets the (auto-fitter) script to be used for
* the default (OpenType) script data of a font's GSUB table. Features
* for the default script are intended for all scripts not explicitly
- * handled in GSUB; an example is a `dlig` feature, containing the
+ * handled in GSUB; an example is a 'dlig' feature, containing the
* combination of the characters 'T', 'E', and 'L' to form a 'TEL'
* ligature.
*
--- a/include/freetype/ftgasp.h
+++ b/include/freetype/ftgasp.h
@@ -2,7 +2,7 @@
*
* ftgasp.h
*
- * Access of TrueType's `gasp` table (specification).
+ * Access of TrueType's 'gasp' table (specification).
*
* Copyright 2007-2019 by
* David Turner, Robert Wilhelm, and Werner Lemberg.
@@ -41,11 +41,11 @@
* Gasp Table
*
* @abstract:
- * Retrieving TrueType `gasp` table entries.
+ * 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 its `gasp` table, if any. This is mainly
+ * font for specific entries in its 'gasp' table, if any. This is mainly
* useful when implementing native TrueType hinting with the bytecode
* interpreter to duplicate the Windows text rendering results.
*/
@@ -106,7 +106,7 @@
*
* @description:
* For a TrueType or OpenType font file, return the rasterizer behaviour
- * flags from the font's `gasp` table corresponding to a given character
+ * flags from the font's 'gasp' table corresponding to a given character
* pixel size.
*
* @input:
@@ -118,7 +118,7 @@
*
* @return:
* Bit flags (see @FT_GASP_XXX), or @FT_GASP_NO_TABLE if there is no
- * `gasp` table in the face.
+ * 'gasp' table in the face.
*
* @note:
* If you want to use the MM functionality of OpenType variation fonts
--- a/include/freetype/ftgxval.h
+++ b/include/freetype/ftgxval.h
@@ -123,34 +123,34 @@
*
* @values:
* FT_VALIDATE_feat ::
- * Validate `feat` table.
+ * Validate 'feat' table.
*
* FT_VALIDATE_mort ::
- * Validate `mort` table.
+ * Validate 'mort' table.
*
* FT_VALIDATE_morx ::
- * Validate `morx` table.
+ * Validate 'morx' table.
*
* FT_VALIDATE_bsln ::
- * Validate `bsln` table.
+ * Validate 'bsln' table.
*
* FT_VALIDATE_just ::
- * Validate `just` table.
+ * Validate 'just' table.
*
* FT_VALIDATE_kern ::
- * Validate `kern` table.
+ * Validate 'kern' table.
*
* FT_VALIDATE_opbd ::
- * Validate `opbd` table.
+ * Validate 'opbd' table.
*
* FT_VALIDATE_trak ::
- * Validate `trak` table.
+ * Validate 'trak' table.
*
* FT_VALIDATE_prop ::
- * Validate `prop` table.
+ * Validate 'prop' table.
*
* FT_VALIDATE_lcar ::
- * Validate `lcar` table.
+ * Validate 'lcar' table.
*
* FT_VALIDATE_GX ::
* Validate all TrueTypeGX tables (feat, mort, morx, bsln, just, kern,
@@ -265,13 +265,13 @@
*
* @values:
* FT_VALIDATE_MS ::
- * Handle the `kern` table as a classic Microsoft kern table.
+ * Handle the 'kern' table as a classic Microsoft kern table.
*
* FT_VALIDATE_APPLE ::
- * Handle the `kern` table as a classic Apple kern table.
+ * Handle the 'kern' table as a classic Apple kern table.
*
* FT_VALIDATE_CKERN ::
- * Handle the `kern` as either classic Apple or Microsoft kern table.
+ * Handle the 'kern' as either classic Apple or Microsoft kern table.
*/
#define FT_VALIDATE_MS ( FT_VALIDATE_GX_START << 0 )
#define FT_VALIDATE_APPLE ( FT_VALIDATE_GX_START << 1 )
@@ -290,7 +290,7 @@
* library that actually does the text layout can access those tables
* without error checking (which can be quite time consuming).
*
- * The `kern` table validator in @FT_TrueTypeGX_Validate deals with both
+ * The 'kern' table validator in @FT_TrueTypeGX_Validate deals with both
* the new 32-bit format and the classic 16-bit format, while
* FT_ClassicKern_Validate only supports the classic 16-bit format.
*
--- a/include/freetype/ftincrem.h
+++ b/include/freetype/ftincrem.h
@@ -148,7 +148,7 @@
*
* Note that the format of the glyph's data bytes depends on the font
* file format. For TrueType, it must correspond to the raw bytes within
- * the `glyf` table. For PostScript formats, it must correspond to the
+ * the 'glyf' table. For PostScript formats, it must correspond to the
* **unencrypted** charstring bytes, without any `lenIV` header. It is
* undefined for any other format.
*
--- a/include/freetype/ftmm.h
+++ b/include/freetype/ftmm.h
@@ -144,7 +144,7 @@
* Adobe MM fonts if possible.
*
* strid ::
- * The axis name entry in the font's `name` table. This is another
+ * The axis name entry in the font's 'name' table. This is another
* (and often better) version of the 'name' field for TrueType GX or
* OpenType variation fonts. Not meaningful for Adobe MM fonts.
*
@@ -184,10 +184,10 @@
* entry for each axis.
*
* strid ::
- * The entry in `name` table identifying this instance.
+ * The entry in 'name' table identifying this instance.
*
* psid ::
- * The entry in `name` table identifying a PostScript name for this
+ * The entry in 'name' table identifying a PostScript name for this
* instance. Value 0xFFFF indicates a missing entry.
*/
typedef struct FT_Var_Named_Style_
@@ -222,7 +222,7 @@
*
* num_namedstyles ::
* The number of named styles; a 'named style' is a tuple of design
- * coordinates that has a string ID (in the `name` table) associated
+ * coordinates that has a string ID (in the 'name' table) associated
* with it. The font can tell the user that, for example,
* [Weight=1.5,Width=1.1] is 'Bold'. Another name for 'named style' is
* 'named instance'.
--- a/include/freetype/ftparams.h
+++ b/include/freetype/ftparams.h
@@ -58,7 +58,7 @@
*
* @description:
* A tag for @FT_Parameter to make @FT_Open_Face ignore typographic
- * family names in the `name` table (introduced in OpenType version 1.4).
+ * family names in the 'name' table (introduced in OpenType version 1.4).
* Use this for backward compatibility with legacy systems that have a
* four-faces-per-family restriction.
*
@@ -82,7 +82,7 @@
*
* @description:
* A tag for @FT_Parameter to make @FT_Open_Face ignore typographic
- * subfamily names in the `name` table (introduced in OpenType version
+ * subfamily names in the 'name' table (introduced in OpenType version
* 1.4). Use this for backward compatibility with legacy systems that
* have a four-faces-per-family restriction.
*
--- a/include/freetype/ftsnames.h
+++ b/include/freetype/ftsnames.h
@@ -2,7 +2,7 @@
*
* ftsnames.h
*
- * Simple interface to access SFNT `name` tables (which are used
+ * Simple interface to access SFNT 'name' tables (which are used
* to hold font names, copyright info, notices, etc.) (specification).
*
* This is _not_ used to retrieve glyph names!
@@ -50,7 +50,7 @@
*
* @description:
* The TrueType and OpenType specifications allow the inclusion of a
- * special names table (`name`) in font files. This table contains
+ * special names table ('name') in font files. This table contains* textual (and internationalized) information regarding the font, like
* family name, copyright, version, etc.
*
@@ -67,7 +67,7 @@
* FT_SfntName
*
* @description:
- * A structure used to model an SFNT `name` table entry.
+ * A structure used to model an SFNT 'name' table entry.
*
* @fields:
* platform_id ::
@@ -124,7 +124,7 @@
* FT_Get_Sfnt_Name_Count
*
* @description:
- * Retrieve the number of name strings in the SFNT `name` table.
+ * Retrieve the number of name strings in the SFNT 'name' table.
*
* @input:
* face ::
@@ -131,7 +131,7 @@
* A handle to the source face.
*
* @return:
- * The number of strings in the `name` table.
+ * The number of strings in the 'name' table.
*
* @note:
* This function always returns an error if the config macro
@@ -147,7 +147,7 @@
* FT_Get_Sfnt_Name
*
* @description:
- * Retrieve a string of the SFNT `name` table for a given index.
+ * Retrieve a string of the SFNT 'name' table for a given index.
*
* @input:
* face ::
@@ -169,10 +169,10 @@
* yourself; FreeType takes care of it if you call @FT_Done_Face.
*
* Use @FT_Get_Sfnt_Name_Count to get the total number of available
- * `name` table entries, then do a loop until you get the right platform,
+ * 'name' table entries, then do a loop until you get the right platform,
* encoding, and name ID.
*
- * `name` table format~1 entries can use language tags also, see
+ * 'name' table format~1 entries can use language tags also, see
* @FT_Get_Sfnt_LangTag.
*
* This function always returns an error if the config macro
@@ -190,7 +190,7 @@
* FT_SfntLangTag
*
* @description:
- * A structure to model a language tag entry from an SFNT `name` table.
+ * A structure to model a language tag entry from an SFNT 'name' table.
*
* @fields:
* string ::
@@ -222,7 +222,7 @@
*
* @description:
* Retrieve the language tag associated with a language ID of an SFNT
- * `name` table entry.
+ * 'name' table entry.
*
* @input:
* face ::
@@ -234,7 +234,7 @@
*
* @output:
* alangTag ::
- * The language tag associated with the `name` table entry's language
+ * The language tag associated with the 'name' table entry's language
* ID.
*
* @return:
@@ -245,7 +245,7 @@
* null-terminated. Note that you don't have to deallocate `string` by
* yourself; FreeType takes care of it if you call @FT_Done_Face.
*
- * Only `name` table format~1 supports language tags. For format~0
+ * Only 'name' table format~1 supports language tags. For format~0
* tables, this function always returns FT_Err_Invalid_Table. For
* invalid format~1 language ID values, FT_Err_Invalid_Argument is
* returned.
--- a/include/freetype/internal/tttypes.h
+++ b/include/freetype/internal/tttypes.h
@@ -58,7 +58,7 @@
*
* @fields:
* tag ::
- * Must be 'ttc ' to indicate a TrueType collection.
+ * Must be 'ttc~' to indicate a TrueType collection.
*
* version ::
* The version number.
@@ -1395,7 +1395,7 @@
*
* cvt ::
* The face's original control value table. Coordinates are expressed
- * in unscaled font units. Comes from the 'cvt ' table. Ignored for
+ * in unscaled font units. Comes from the 'cvt~' table. Ignored for
* Type 2 fonts.
*
* interpreter ::
--- a/include/freetype/ttnameid.h
+++ b/include/freetype/ttnameid.h
@@ -36,7 +36,7 @@
/**************************************************************************
*
* Possible values for the 'platform' identifier code in the name records
- * of an SFNT `name` table.
+ * of an SFNT 'name' table.
*
*/
@@ -291,7 +291,7 @@
*
* @description:
* Possible values of the language identifier field in the name records
- * of the SFNT `name` table if the 'platform' identifier code is
+ * of the SFNT 'name' table if the 'platform' identifier code is
* @TT_PLATFORM_MACINTOSH. These values are also used as return values
* for function @FT_Get_CMap_Language_ID.
*
@@ -431,7 +431,7 @@
*
* @description:
* Possible values of the language identifier field in the name records
- * of the SFNT `name` table if the 'platform' identifier code is
+ * of the SFNT 'name' table if the 'platform' identifier code is
* @TT_PLATFORM_MICROSOFT. These values are also used as return values
* for function @FT_Get_CMap_Language_ID.
*
@@ -441,7 +441,7 @@
*
* however, we only provide macros for language identifiers present in
* the OpenType specification: Microsoft has abandoned the concept of
- * LCIDs (language code identifiers), and format~1 of the `name` table
+ * LCIDs (language code identifiers), and format~1 of the 'name' table
* provides a better mechanism for languages not covered here.
*
* More legacy values not listed in the reference can be found in the
@@ -787,7 +787,7 @@
*
* @description:
* Possible values of the 'name' identifier field in the name records of
- * an SFNT `name` table. These values are platform independent.
+ * an SFNT 'name' table. These values are platform independent.
*/
#define TT_NAME_ID_COPYRIGHT 0
@@ -841,7 +841,7 @@
*
* @description:
* Possible bit mask values for the `ulUnicodeRangeX` fields in an SFNT
- * `OS/2` table.
+ * 'OS/2' table.
*/
/* ulUnicodeRange1 */
--- a/include/freetype/tttables.h
+++ b/include/freetype/tttables.h
@@ -117,8 +117,8 @@
* TT_HoriHeader
*
* @description:
- * A structure to model a TrueType horizontal header, the `hhea` table,
- * as well as the corresponding horizontal metrics table, `hmtx`.
+ * A structure to model a TrueType horizontal header, the 'hhea' table,
+ * as well as the corresponding horizontal metrics table, 'hmtx'.
*
* @fields:
* Version ::
@@ -132,7 +132,7 @@
* font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII).
*
- * You should use the `sTypoAscender` field of the `OS/2` table instead
+ * You should use the `sTypoAscender` field of the 'OS/2' table instead
* if you want the correct one.
*
* Descender ::
@@ -143,7 +143,7 @@
* font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII).
*
- * You should use the `sTypoDescender` field of the `OS/2` table
+ * You should use the `sTypoDescender` field of the 'OS/2' table
* instead if you want the correct one.
*
* Line_Gap ::
@@ -183,19 +183,19 @@
* Always~0.
*
* number_Of_HMetrics ::
- * Number of HMetrics entries in the `hmtx` table -- this value can be
+ * Number of HMetrics entries in the 'hmtx' table -- this value can be
* smaller than the total number of glyphs in the font.
*
* long_metrics ::
- * A pointer into the `hmtx` table.
+ * A pointer into the 'hmtx' table.
*
* short_metrics ::
- * A pointer into the `hmtx` table.
+ * A pointer into the 'hmtx' table.
*
* @note:
* For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
- * the font contains an `MVAR` table: `caret_Slope_Rise`,
+ * the font contains an 'MVAR' table: `caret_Slope_Rise`,
* `caret_Slope_Run`, and `caret_Offset`.
*/
typedef struct TT_HoriHeader_
@@ -221,7 +221,7 @@
/* The following fields are not defined by the OpenType specification */
/* but they are used to connect the metrics header to the relevant */
- /* `hmtx` table. */
+ /* 'hmtx' table. */
void* long_metrics;
void* short_metrics;
@@ -235,8 +235,8 @@
* TT_VertHeader
*
* @description:
- * A structure used to model a TrueType vertical header, the `vhea`
- * table, as well as the corresponding vertical metrics table, `vmtx`.
+ * A structure used to model a TrueType vertical header, the 'vhea'
+ * table, as well as the corresponding vertical metrics table, 'vmtx'.
*
* @fields:
* Version ::
@@ -250,7 +250,7 @@
* font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII).
*
- * You should use the `sTypoAscender` field of the `OS/2` table instead
+ * You should use the `sTypoAscender` field of the 'OS/2' table instead
* if you want the correct one.
*
* Descender ::
@@ -261,7 +261,7 @@
* font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII).
*
- * You should use the `sTypoDescender` field of the `OS/2` table
+ * You should use the `sTypoDescender` field of the 'OS/2' table
* instead if you want the correct one.
*
* Line_Gap ::
@@ -301,19 +301,19 @@
* Always~0.
*
* number_Of_VMetrics ::
- * Number of VMetrics entries in the `vmtx` table -- this value can be
+ * Number of VMetrics entries in the 'vmtx' table -- this value can be
* smaller than the total number of glyphs in the font.
*
* long_metrics ::
- * A pointer into the `vmtx` table.
+ * A pointer into the 'vmtx' table.
*
* short_metrics ::
- * A pointer into the `vmtx` table.
+ * A pointer into the 'vmtx' table.
*
* @note:
* For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
- * the font contains an `MVAR` table: `Ascender`, `Descender`,
+ * the font contains an 'MVAR' table: `Ascender`, `Descender`,
* `Line_Gap`, `caret_Slope_Rise`, `caret_Slope_Run`, and `caret_Offset`.
*/
typedef struct TT_VertHeader_
@@ -339,7 +339,7 @@
/* The following fields are not defined by the OpenType specification */
/* but they are used to connect the metrics header to the relevant */
- /* `vmtx` table. */
+ /* 'vmtx' table. */
void* long_metrics;
void* short_metrics;
@@ -353,16 +353,16 @@
* TT_OS2
*
* @description:
- * A structure to model a TrueType `OS/2` table. All fields comply to
+ * A structure to model a TrueType 'OS/2' table. All fields comply to
* the OpenType specification.
*
- * Note that we now support old Mac fonts that do not include an `OS/2`
+ * Note that we now support old Mac fonts that do not include an 'OS/2'
* table. In this case, the `version` field is always set to 0xFFFF.
*
* @note:
* For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
- * the font contains an `MVAR` table: `sCapHeight`, `sTypoAscender`,
+ * the font contains an 'MVAR' table: `sCapHeight`, `sTypoAscender`,
* `sTypoDescender`, `sTypoLineGap`, `sxHeight`, `usWinAscent`,
* `usWinDescent`, `yStrikeoutPosition`, `yStrikeoutSize`,
* `ySubscriptXOffset`, `ySubScriptXSize`, `ySubscriptYOffset`,
@@ -437,7 +437,7 @@
* TT_Postscript
*
* @description:
- * A structure to model a TrueType `post` table. All fields comply to
+ * A structure to model a TrueType 'post' table. All fields comply to
* the OpenType specification. This structure does not reference a
* font's PostScript glyph names; use @FT_Get_Glyph_Name to retrieve
* them.
@@ -445,7 +445,7 @@
* @note:
* For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
- * the font contains an `MVAR` table: `underlinePosition` and
+ * the font contains an 'MVAR' table: `underlinePosition` and
* `underlineThickness`.
*/
typedef struct TT_Postscript_
@@ -460,7 +460,7 @@
FT_ULong minMemType1;
FT_ULong maxMemType1;
- /* Glyph names follow in the `post` table, but we don't */
+ /* Glyph names follow in the 'post' table, but we don't */
/* load them by default. */
} TT_Postscript;
@@ -472,7 +472,7 @@
* TT_PCLT
*
* @description:
- * A structure to model a TrueType `PCLT` table. All fields comply to
+ * A structure to model a TrueType 'PCLT' table. All fields comply to
* the OpenType specification.
*/
typedef struct TT_PCLT_
@@ -502,7 +502,7 @@
* TT_MaxProfile
*
* @description:
- * The maximum profile (`maxp`) table contains many max values, which can
+ * The maximum profile ('maxp') table contains many max values, which can* be used to pre-allocate arrays for speeding up glyph loading and
* hinting.
*
@@ -673,7 +673,7 @@
* list.
*
* @example:
- * Here an example how to access the `vhea` table.
+ * Here an example how to access the 'vhea' table.
*
* ```
* TT_VertHeader* vert_header;
@@ -832,7 +832,7 @@
* FT_Get_CMap_Format
*
* @description:
- * Return the format of an SFNT `cmap` table.
+ * Return the format of an SFNT 'cmap' table.
*
* @input:
* charmap ::