diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 6fe35182a..fa7aa1105 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -2434,7 +2434,8 @@ FT_BEGIN_HEADER
   /*                                                                       */
   /*    If `type' is FT_SIZE_REQUEST_TYPE_SCALES, `width' and `height' are */
   /*    interpreted directly as 16.16 fractional scaling values, without   */
-  /*    any further modification.                                          */
+  /*    any further modification, and both `horiResolution' and            */
+  /*    `vertResolution' are ignored.                                      */
   /*                                                                       */
   typedef struct  FT_Size_RequestRec_
   {