Minor documentation fixes.
diff --git a/include/freetype/ftcolor.h b/include/freetype/ftcolor.h
index efe3131..842bd63 100644
--- a/include/freetype/ftcolor.h
+++ b/include/freetype/ftcolor.h
@@ -238,9 +238,10 @@
*
* @output:
* apalette ::
- * An array of color entries for a palette with index `palette_index`.
- * If `apalette` is set to NULL, no array gets returned (and no color
- * entries can be modified).
+ * An array of color entries for a palette with index `palette_index`,
+ * having `num_palette_entries` elements (as found in the
+ * `FT_Palette_Data` structure). If `apalette` is set to NULL, no
+ * array gets returned (and no color entries can be modified).
*
* In case the font doesn't support color palettes, NULL is returned.
*
diff --git a/include/freetype/internal/sfnt.h b/include/freetype/internal/sfnt.h
index a3a901b..7cdad64 100644
--- a/include/freetype/internal/sfnt.h
+++ b/include/freetype/internal/sfnt.h
@@ -677,9 +677,14 @@
* Return the horizontal kerning value between two glyphs.
*
* @input:
- * face :: A handle to the source face object. left_glyph :: The left
- * glyph index.
- * right_glyph :: The right glyph index.
+ * face ::
+ * A handle to the source face object.
+ *
+ * left_glyph ::
+ * The left glyph index.
+ *
+ * right_glyph ::
+ * The right glyph index.
*
* @return:
* The kerning value in font units.
