Skip to content

Commit 06166aa

Browse files
committed
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.
1 parent 2eb834e commit 06166aa

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

doc/lispref/frames.texi

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2294,14 +2294,17 @@ variable do not take effect immediately, only when you specify the
22942294
@item font-backend
22952295
A list of symbols, specifying the @dfn{font backends} to use for
22962296
drawing characters on the frame, in order of priority. In Emacs built
2297-
without Cairo drawing on X, there are currently three available font
2298-
backends: @code{x} (the X core font driver), @code{xft} (the Xft font
2299-
driver), and @code{xfthb} (the Xft font driver with HarfBuzz text
2300-
shaping). If built with the Cairo drawing, there are also three
2301-
available font backends on X: @code{x}, @code{ftcr} (the FreeType font
2302-
driver on Cairo), and @code{ftcrhb} (the FreeType font driver on Cairo
2303-
with HarfBuzz text shaping). On MS-Windows, there are currently three
2304-
available font backends: @code{gdi} (the core MS-Windows font driver),
2297+
without Cairo drawing on X, there are currently three potentially
2298+
available font backends: @code{x} (the X core font driver), @code{xft}
2299+
(the Xft font driver), and @code{xfthb} (the Xft font driver with
2300+
HarfBuzz text shaping). If built with Cairo drawing, there are also
2301+
three potentially available font backends on X: @code{x}, @code{ftcr}
2302+
(the FreeType font driver on Cairo), and @code{ftcrhb} (the FreeType
2303+
font driver on Cairo with HarfBuzz text shaping). Note that the
2304+
@code{ftcr} and @code{ftcrhb} drivers are mutually exclusive (and
2305+
similarly for @code{xft} and @code{xfthb}), with the choice being made
2306+
at build time. On MS-Windows, there are currently three available
2307+
font backends: @code{gdi} (the core MS-Windows font driver),
23052308
@code{uniscribe} (font driver for OTF and TTF fonts with text shaping
23062309
by the Uniscribe engine), and @code{harfbuzz} (font driver for OTF and
23072310
TTF fonts with HarfBuzz text shaping) (@pxref{Windows Fonts,,, emacs,

0 commit comments

Comments
 (0)