[freetype2] master b8dd404: freetype.h: Add warning w.r.t. B/W hinting and rendering (#54589).

[Werner LEMBERG]

branch: master
commit b8dd404d1342d435d207fb2377a7dc6e281f3b22
Author: Werner Lemberg <address@hidden>
Commit: Werner Lemberg <address@hidden>

    freetype.h: Add warning w.r.t. B/W hinting and rendering (#54589).
---
 include/freetype/freetype.h | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 83c7f14..25db584 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3091,6 +3091,12 @@ FT_BEGIN_HEADER
    *     output.  The result is probably unpleasant if the glyph is rendered
    *     in non-monochrome modes.
    *
+   *     Note that for outline fonts only the TrueType font driver has proper
+   *     monochrome hinting support, provided the TTFs contain hints for B/W
+   *     rendering (which most fonts no longer provide).  If these conditions
+   *     are not met it is very likely that you get ugly results at smaller
+   *     sizes.
+   *
    *   FT_LOAD_TARGET_LCD ::
    *     A variant of @FT_LOAD_TARGET_LIGHT optimized for horizontally
    *     decimated LCD displays.