ref: 396051daee490544322b6ca5964772ecbebeac52
parent: 7edc937fe679d14d66f55cf6f7fa607925d38f3c
author: Werner Lemberg <[email protected]>
date: Mon Jul 2 11:52:36 EDT 2018
s/xxx specific foo/xxx-specific foo/.
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -843,9 +843,8 @@
* other formats.
*
* encoding_id ::
- * A platform specific encoding number. This also
- * comes from the TrueType specification and gets
- * emulated similarly.
+ * A platform-specific encoding number. This also comes from the
+ * TrueType specification and gets emulated similarly.
*/
typedef struct FT_CharMapRec_
{@@ -952,17 +951,13 @@
* used in the font.
*
* family_name ::
- * The face's family name. This is an ASCII
- * string, usually in English, that describes
- * the typeface's family (like `Times New
- * Roman', `Bodoni', `Garamond', etc). This
- * is a least common denominator used to list
- * fonts. Some formats (TrueType & OpenType)
- * provide localized and Unicode versions of
- * this string. Applications should use the
- * format specific interface to access them.
- * Can be NULL (e.g., in fonts embedded in a
- * PDF file).
+ * The face's family name. This is an ASCII string, usually in
+ * English, that describes the typeface's family (like `Times New
+ * Roman', `Bodoni', `Garamond', etc). This is a least common
+ * denominator used to list fonts. Some formats (TrueType & OpenType)
+ * provide localized and Unicode versions of this string.
+ * Applications should use the format-specific interface to access
+ * them. Can be NULL (e.g., in fonts embedded in a PDF file).
*
* In case the font doesn't provide a specific
* family name entry, FreeType tries to
@@ -970,16 +965,13 @@
* entries.
*
* style_name ::
- * The face's style name. This is an ASCII
- * string, usually in English, that describes
- * the typeface's style (like `Italic',
- * `Bold', `Condensed', etc). Not all font
- * formats provide a style name, so this field
- * is optional, and can be set to NULL. As
- * for `family_name', some formats provide
- * localized and Unicode versions of this
- * string. Applications should use the format
- * specific interface to access them.
+ * The face's style name. This is an ASCII string, usually in
+ * English, that describes the typeface's style (like `Italic',
+ * `Bold', `Condensed', etc). Not all font formats provide a style
+ * name, so this field is optional, and can be set to NULL. As for
+ * `family_name', some formats provide localized and Unicode versions
+ * of this string. Applications should use the format-specific
+ * interface to access them.
*
* num_fixed_sizes ::
* The number of bitmap strikes in the face.
@@ -4699,7 +4691,7 @@
* Compute `(a*b)/c' with maximum accuracy, using a 64-bit
* intermediate integer whenever necessary.
*
- * This function isn't necessarily as fast as some processor specific
+ * This function isn't necessarily as fast as some processor-specific
* operations, but is at least completely portable.
*
* @input:
--- a/include/freetype/ftcid.h
+++ b/include/freetype/ftcid.h
@@ -41,10 +41,10 @@
* CID Fonts
*
* @abstract:
- * CID-keyed font specific API.
+ * CID-keyed font-specific API.
*
* @description:
- * This section contains the declaration of CID-keyed font specific
+ * This section contains the declaration of CID-keyed font-specific
* functions.
*
*/
--- a/include/freetype/ftpfr.h
+++ b/include/freetype/ftpfr.h
@@ -41,7 +41,7 @@
* PFR Fonts
*
* @abstract:
- * PFR/TrueDoc specific API.
+ * PFR/TrueDoc-specific API.
*
* @description:
* This section contains the declaration of PFR-specific functions.
--- a/include/freetype/ftwinfnt.h
+++ b/include/freetype/ftwinfnt.h
@@ -41,10 +41,10 @@
* Window FNT Files
*
* @abstract:
- * Windows FNT specific API.
+ * Windows FNT-specific API.
*
* @description:
- * This section contains the declaration of Windows FNT specific
+ * This section contains the declaration of Windows FNT-specific
* functions.
*
*/
--- a/include/freetype/internal/ftcalc.h
+++ b/include/freetype/internal/ftcalc.h
@@ -256,7 +256,7 @@
* (without rounding) with maximum accuracy (it uses a 64-bit
* intermediate integer whenever necessary).
*
- * This function isn't necessarily as fast as some processor specific
+ * This function isn't necessarily as fast as some processor-specific
* operations, but is at least completely portable.
*
* @input:
--- a/include/freetype/t1tables.h
+++ b/include/freetype/t1tables.h
@@ -43,10 +43,10 @@
* Type 1 Tables
*
* @abstract:
- * Type~1 (PostScript) specific font tables.
+ * Type~1-specific font tables.
*
* @description:
- * This section contains the definition of Type 1-specific tables,
+ * This section contains the definition of Type~1-specific tables,
* including structures related to other PostScript font formats.
*
* @order:
--- a/include/freetype/tttables.h
+++ b/include/freetype/tttables.h
@@ -42,7 +42,7 @@
* TrueType Tables
*
* @abstract:
- * TrueType specific table types and functions.
+ * TrueType-specific table types and functions.
*
* @description:
* This section contains definitions of some basic tables specific to