Skip to content

Commit 7e37e61

Browse files
committed
Correct statement about ftcr and recommend HarfBuzz
* doc/lispref/frames.texi (Font and Color Parameters): Correct statement about availability of ftcr in the presence of HarfBuzz. Recommend HarfBuzz.
1 parent 4aec94d commit 7e37e61

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

doc/lispref/frames.texi

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2300,17 +2300,17 @@ available font backends: @code{x} (the X core font driver), @code{xft}
23002300
HarfBuzz text shaping). If built with Cairo drawing, there are also
23012301
three potentially available font backends on X: @code{x}, @code{ftcr}
23022302
(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),
2308-
@code{uniscribe} (font driver for OTF and TTF fonts with text shaping
2309-
by the Uniscribe engine), and @code{harfbuzz} (font driver for OTF and
2310-
TTF fonts with HarfBuzz text shaping) (@pxref{Windows Fonts,,, emacs,
2311-
The GNU Emacs Manual}). On other systems, there is only one available
2312-
font backend, so it does not make sense to modify this frame
2313-
parameter.
2303+
font driver on Cairo with HarfBuzz text shaping). When Emacs is built
2304+
with HarfBuzz, the default font driver is @code{ftcrhb}, although use
2305+
of the @code{ftcr} driver is still possible, but not recommended. On
2306+
MS-Windows, there are currently three available font backends:
2307+
@code{gdi} (the core MS-Windows font driver), @code{uniscribe} (font
2308+
driver for OTF and TTF fonts with text shaping by the Uniscribe
2309+
engine), and @code{harfbuzz} (font driver for OTF and TTF fonts with
2310+
HarfBuzz text shaping) (@pxref{Windows Fonts,,, emacs, The GNU Emacs
2311+
Manual}). The @code{harfbuzz} driver is similarly recommended. On
2312+
other systems, there is only one available font backend, so it does
2313+
not make sense to modify this frame parameter.
23142314

23152315
@vindex background-mode@r{, a frame parameter}
23162316
@item background-mode

0 commit comments

Comments
 (0)