summaryrefslogtreecommitdiff
path: root/doc/lispref/frames.texi
diff options
context:
space:
mode:
authorRobert Pluim <rpluim@gmail.com>2020-01-20 17:59:38 +0100
committerRobert Pluim <rpluim@gmail.com>2020-01-20 18:01:57 +0100
commit06166aa7192d3fc01e5aa242936daf5e88adb904 (patch)
tree5db0a7c8b96dcbad065c945d83050372bcbe536e /doc/lispref/frames.texi
parent2eb834ead401fa83270cad585a4310e2e05b8baa (diff)
downloademacs-06166aa7192d3fc01e5aa242936daf5e88adb904.tar.gz
emacs-06166aa7192d3fc01e5aa242936daf5e88adb904.tar.bz2
emacs-06166aa7192d3fc01e5aa242936daf5e88adb904.zip
Improve explanation of available font backends under X
* frames.texi (Font and Color Parameters): Clarify that you can't have HarfBuzz and non-HarfBuzz at the same time for xft and cairo font backends.
Diffstat (limited to 'doc/lispref/frames.texi')
-rw-r--r--doc/lispref/frames.texi19
1 files changed, 11 insertions, 8 deletions
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 05038c6f52b..0c42ebfd67a 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2294,14 +2294,17 @@ variable do not take effect immediately, only when you specify the
@item font-backend
A list of symbols, specifying the @dfn{font backends} to use for
drawing characters on the frame, in order of priority. In Emacs built
-without Cairo drawing on X, there are currently three available font
-backends: @code{x} (the X core font driver), @code{xft} (the Xft font
-driver), and @code{xfthb} (the Xft font driver with HarfBuzz text
-shaping). If built with the Cairo drawing, there are also three
-available font backends on X: @code{x}, @code{ftcr} (the FreeType font
-driver on Cairo), and @code{ftcrhb} (the FreeType font driver on Cairo
-with HarfBuzz text shaping). On MS-Windows, there are currently three
-available font backends: @code{gdi} (the core MS-Windows font driver),
+without Cairo drawing on X, there are currently three potentially
+available font backends: @code{x} (the X core font driver), @code{xft}
+(the Xft font driver), and @code{xfthb} (the Xft font driver with
+HarfBuzz text shaping). If built with Cairo drawing, there are also
+three potentially available font backends on X: @code{x}, @code{ftcr}
+(the FreeType font driver on Cairo), and @code{ftcrhb} (the FreeType
+font driver on Cairo with HarfBuzz text shaping). Note that the
+@code{ftcr} and @code{ftcrhb} drivers are mutually exclusive (and
+similarly for @code{xft} and @code{xfthb}), with the choice being made
+at build time. On MS-Windows, there are currently three available
+font backends: @code{gdi} (the core MS-Windows font driver),
@code{uniscribe} (font driver for OTF and TTF fonts with text shaping
by the Uniscribe engine), and @code{harfbuzz} (font driver for OTF and
TTF fonts with HarfBuzz text shaping) (@pxref{Windows Fonts,,, emacs,