From b8dd404d1342d435d207fb2377a7dc6e281f3b22 Mon Sep 17 00:00:00 2001
From: Werner Lemberg <wl@gnu.org>
Date: Sun, 16 Sep 2018 07:22:23 +0200
Subject: [PATCH] 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 83c7f14a4..25db58428 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.