summaryrefslogtreecommitdiff
path: root/include
diff options
context:
space:
mode:
authorWerner Lemberg <wl@gnu.org>2022-10-10 12:31:53 +0200
committerWerner Lemberg <wl@gnu.org>2022-10-10 12:41:49 +0200
commit5182264a40e70ff31be0a0ec8a0d5ffb5f65582e (patch)
treed34fdd6b46e786bf2705ca3267eeab4341ab573f /include
parent0d66abca4b0df394c1e423040bcb1bedcca878b9 (diff)
downloadfreetype2-5182264a40e70ff31be0a0ec8a0d5ffb5f65582e.tar.gz
[cff] Remove `FT_CONFIG_OPTION_NO_GLYPH_NAMES`.
This ancient option stayed completely undocumented. Given that the 'cff' driver requires the 'psnames' module, it makes no sense today to have this macro. * src/cff/cffdrivr.c (cff_services), src/cff/cffobjs.c (cff_face_init): Remove corresponding conditional code.
Diffstat (limited to 'include')
-rw-r--r--include/freetype/freetype.h20
1 files changed, 12 insertions, 8 deletions
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 18f3c13d4..81ca12ad7 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -4174,12 +4174,14 @@ FT_BEGIN_HEADER
* The glyph index. 0~means 'undefined character code'.
*
* @note:
- * The acceptable glyph name might come from
- * [Adobe Glyph List](https://github.com/adobe-type-tools/agl-aglfn).
- * See @FT_Get_Glyph_Name for the resiprocal function.
- *
- * This function always returns~0 if the config macro
- * `FT_CONFIG_OPTION_NO_GLYPH_NAMES` is not defined in `ftoption.h`.
+ * Acceptable glyph names might come from the [Adobe Glyph
+ * List](https://github.com/adobe-type-tools/agl-aglfn). See
+ * @FT_Get_Glyph_Name for the inverse functionality.
+ *
+ * This function has limited capabilities if the config macro
+ * `FT_CONFIG_OPTION_POSTSCRIPT_NAMES` is not defined in `ftoption.h`:
+ * It then works only for fonts that actually embed glyph names (which
+ * many recent OpenType fonts do not).
*/
FT_EXPORT( FT_UInt )
FT_Get_Name_Index( FT_Face face,
@@ -4223,8 +4225,10 @@ FT_BEGIN_HEADER
* Be aware that FreeType reorders glyph indices internally so that glyph
* index~0 always corresponds to the 'missing glyph' (called '.notdef').
*
- * This function always returns an error if the config macro
- * `FT_CONFIG_OPTION_NO_GLYPH_NAMES` is not defined in `ftoption.h`.
+ * This function has limited capabilities if the config macro
+ * `FT_CONFIG_OPTION_POSTSCRIPT_NAMES` is not defined in `ftoption.h`:
+ * It then works only for fonts that actually embed glyph names (which
+ * many recent OpenType fonts do not).
*/
FT_EXPORT( FT_Error )
FT_Get_Glyph_Name( FT_Face face,