master d8da850: Document cairo-related fallout to font-backend settings

[Robert Pluim]

branch: master
commit d8da850979fc3502aaff14aec779e2aad3462cf5
Author: Robert Pluim <address@hidden>
Commit: Robert Pluim <address@hidden>

    Document cairo-related fallout to font-backend settings
    
    * etc/NEWS: Document some of the possible adjustments required to
    font settings when using Cairo.
---
 etc/NEWS | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/etc/NEWS b/etc/NEWS
index 3fbd849..e2a1eed 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.