kc3-lang/freetype

diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 49aa6f1..f3287b7 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -2326,7 +2326,10 @@ FT_BEGIN_HEADER
   /*    FT_Select_Size                                                     */
   /*                                                                       */
   /* <Description>                                                         */
-  /*    Select a bitmap strike.                                            */
+  /*    Select a bitmap strike.  To be more precise, this function sets    */
+  /*    the scaling factors of the active @FT_Size object in a face so     */
+  /*    that bitmaps from this particular strike are taken by              */
+  /*    @FT_Load_Glyph and friends.                                        */
   /*                                                                       */
   /* <InOut>                                                               */
   /*    face         :: A handle to a target face object.                  */
@@ -2350,6 +2353,8 @@ FT_BEGIN_HEADER
   /*    same is true for all named instances that are different from the   */
   /*    default instance.                                                  */
   /*                                                                       */
+  /*    Don't use this function if you are using the FreeType cache API.   */
+  /*                                                                       */
   FT_EXPORT( FT_Error )
   FT_Select_Size( FT_Face  face,
                   FT_Int   strike_index );