More minor doc fixes.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index fd5228a..a159ae9 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -4098,6 +4098,8 @@ FT_BEGIN_HEADER
* meaning of the various flags (which get synthesized for
* non-OpenType subglyphs).
*
+ * https://docs.microsoft.com/en-us/typography/opentype/spec/glyf#composite-glyph-description
+ *
* @values:
* FT_SUBGLYPH_FLAG_ARGS_ARE_WORDS ::
* FT_SUBGLYPH_FLAG_ARGS_ARE_XY_VALUES ::
@@ -4170,6 +4172,23 @@ FT_BEGIN_HEADER
FT_Matrix *p_transform );
+ /**************************************************************************
+ *
+ * @section:
+ * layer_management
+ *
+ * @title:
+ * Glyph Layer Management
+ *
+ * @abstract:
+ * 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.
+ *
+
+
/**********************************************************************
*
* @struct:
@@ -4304,6 +4323,13 @@ FT_BEGIN_HEADER
/**************************************************************************
*
+ * @section:
+ * base_interface
+ *
+ */
+
+ /**************************************************************************
+ *
* @enum:
* FT_FSTYPE_XXX
*
@@ -4859,8 +4885,6 @@ FT_BEGIN_HEADER
* FT_Face_CheckTrueTypePatents
* FT_Face_SetUnpatentedHinting
*
- * FREETYPE_XXX
- *
*/
diff --git a/include/freetype/ftcache.h b/include/freetype/ftcache.h
index 7ec9b68..03233eb 100644
--- a/include/freetype/ftcache.h
+++ b/include/freetype/ftcache.h
@@ -145,6 +145,7 @@ FT_BEGIN_HEADER
/*************************************************************************
*
* @type:
+ * FTC_FaceID
*
* @description:
* An opaque pointer type that is used to identity face objects. The
diff --git a/include/freetype/ftchapters.h b/include/freetype/ftchapters.h
index 2efbb0a..f4297d3 100644
--- a/include/freetype/ftchapters.h
+++ b/include/freetype/ftchapters.h
@@ -34,6 +34,8 @@
* basic_types
* base_interface
* glyph_variants
+ * color_management
+ * layer_management
* glyph_management
* mac_specific
* sizes_management
diff --git a/include/freetype/ftcolor.h b/include/freetype/ftcolor.h
index e7ee31f..90015e3 100644
--- a/include/freetype/ftcolor.h
+++ b/include/freetype/ftcolor.h
@@ -45,7 +45,7 @@ FT_BEGIN_HEADER
*
* @description:
* The functions described here allow access and manipulation of color
- * palette entries in OpenType's `CPAL' table.
+ * palette entries in OpenType's `CPAL' tables.
*/
diff --git a/include/freetype/ftglyph.h b/include/freetype/ftglyph.h
index e1f72a9..3841930 100644
--- a/include/freetype/ftglyph.h
+++ b/include/freetype/ftglyph.h
@@ -226,25 +226,28 @@ FT_BEGIN_HEADER
/**************************************************************************
*
* @function:
- * FT_New_Glyph
+ * FT_New_Glyph
*
* @description:
- * A function used to create a new empty glyph image. Note that
- * the created @FT_Glyph object must be released with @FT_Done_Glyph.
+ * A function used to create a new empty glyph image. Note that the
+ * created @FT_Glyph object must be released with @FT_Done_Glyph.
*
* @input:
- * library :: A handle to the FreeType library object.
+ * library ::
+ * A handle to the FreeType library object.
*
- * format :: The format of the glyph's image.
+ * format ::
+ * The format of the glyph's image.
*
* @output:
- * aglyph :: A handle to the glyph object.
+ * aglyph ::
+ * A handle to the glyph object.
*
* @return:
- * FreeType error code. 0~means success.
+ * FreeType error code. 0~means success.
*
- * @since
- * 2.10
+ * @since:
+ * 2.10
*/
FT_EXPORT( FT_Error )
FT_New_Glyph( FT_Library library,