diff --git a/include/freetype/ftcolor.h b/include/freetype/ftcolor.h
index efe3131ae..842bd6312 100644
--- a/include/freetype/ftcolor.h
+++ b/include/freetype/ftcolor.h
@@ -238,9 +238,10 @@ FT_BEGIN_HEADER
    *
    * @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 a3a901bd2..7cdad648f 100644
--- a/include/freetype/internal/sfnt.h
+++ b/include/freetype/internal/sfnt.h
@@ -677,9 +677,14 @@ FT_BEGIN_HEADER
    *    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.