kc3-lang/freetype

diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index c0e5112..80bc5f3 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3068,8 +3068,8 @@ FT_BEGIN_HEADER
   /*       and apply gamma to get them in a linear space,                  */
   /*                                                                       */
   /*    2. use OVER to blend the two linear colors using the glyph pixel   */
-  /*       as the alpha value (remember, the glyph bitmap is a coverage    */
-  /*       bitmap), and                                                    */
+  /*       as the alpha value (remember, the glyph bitmap is an alpha      */
+  /*       coverage bitmap), and                                           */
   /*                                                                       */
   /*    3. apply inverse gamma to the blended pixel and write it back to   */
   /*       the image.                                                      */
@@ -3089,7 +3089,8 @@ FT_BEGIN_HEADER
   /*    gives equal weight to the three color primaries and does not       */
   /*    exceed a sum of 0x100, see section @lcd_filtering.  Then the       */
   /*    only difference to gray linear blending is that subpixel-rendered  */
-  /*    linear blending is done 3~times per pixel.                         */
+  /*    linear blending is done 3~times per pixel: red foreground subpixel */
+  /*    to red background subpixel and so on for green and blue.           */
   /*                                                                       */
   /* <InOut>                                                               */
   /*    slot        :: A handle to the glyph slot containing the image to  */
diff --git a/include/freetype/ftlcdfil.h b/include/freetype/ftlcdfil.h
index 91facf9..653ed36 100644
--- a/include/freetype/ftlcdfil.h
+++ b/include/freetype/ftlcdfil.h
@@ -50,7 +50,9 @@ FT_BEGIN_HEADER
    *   subpixels are color pixels, using them unfiltered creates severe
    *   color fringes.  Use the @FT_Library_SetLcdFilter API to specify a
    *   low-pass filter, which is then applied to subpixel-rendered bitmaps
-   *   generated through @FT_Render_Glyph.
+   *   generated through @FT_Render_Glyph.  The filter sacrifices some of
+   *   the higher resolution to reduce color fringes, making the glyph image
+   *   slightly blurrier.  Positional improvements will remain.
    *
    *   Note that no filter is active by default, and that this function is
    *   *not* implemented in default builds of the library.  You need to