From: Robert Pluim <rpluim@gmail.com>
Date: Mon, 20 Jan 2020 16:07:11 +0000 (+0100)
Subject: Document cairo-related fallout to font-backend settings
X-Git-Tag: emacs-28.0.90~7908^2~88^2
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d8da850979fc3502aaff14aec779e2aad3462cf5;p=emacs.git

Document cairo-related fallout to font-backend settings

* etc/NEWS: Document some of the possible adjustments required to
font settings when using Cairo.
---

diff --git a/etc/NEWS b/etc/NEWS
index 3fbd849bc20..e2a1eed9bbf 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -26,7 +26,17 @@ applies, and please also update docstrings as needed.
 
 ** Cairo is now used by default if found.
 '--with-cairo' is now the default, if the appropriate development files
-are found by 'configure'.
+are found by 'configure'.  Note that building with Cairo means using
+Pango instead of libXFT for font support.  Since Pango 1.44 has
+removed support for bitmapped fonts, this may require you to adjust
+your font settings.
+
+Note also that 'FontBackend' settings in .Xdefaults or .Xresources, or
+'font-backend' frame parameter settings in your init files, may need
+to be adjusted, as 'xft' is no longer a valid backend when using
+Cairo.  Use either 'ftcr' or 'ftcrhb' instead for FreeType and
+FreeType + HarfBuzz respectively.  'x' is still a valid backend.
+
 
 ---
 ** The ftx font backend driver has been removed.