1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-16 10:50:49 -08:00

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.
This commit is contained in:
Robert Pluim 2020-01-20 17:59:38 +01:00
parent 2eb834ead4
commit 06166aa719

View file

@ -2294,14 +2294,17 @@ variable do not take effect immediately, only when you specify the
@item font-backend @item font-backend
A list of symbols, specifying the @dfn{font backends} to use for A list of symbols, specifying the @dfn{font backends} to use for
drawing characters on the frame, in order of priority. In Emacs built drawing characters on the frame, in order of priority. In Emacs built
without Cairo drawing on X, there are currently three available font without Cairo drawing on X, there are currently three potentially
backends: @code{x} (the X core font driver), @code{xft} (the Xft font available font backends: @code{x} (the X core font driver), @code{xft}
driver), and @code{xfthb} (the Xft font driver with HarfBuzz text (the Xft font driver), and @code{xfthb} (the Xft font driver with
shaping). If built with the Cairo drawing, there are also three HarfBuzz text shaping). If built with Cairo drawing, there are also
available font backends on X: @code{x}, @code{ftcr} (the FreeType font three potentially available font backends on X: @code{x}, @code{ftcr}
driver on Cairo), and @code{ftcrhb} (the FreeType font driver on Cairo (the FreeType font driver on Cairo), and @code{ftcrhb} (the FreeType
with HarfBuzz text shaping). On MS-Windows, there are currently three font driver on Cairo with HarfBuzz text shaping). Note that the
available font backends: @code{gdi} (the core MS-Windows font driver), @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 @code{uniscribe} (font driver for OTF and TTF fonts with text shaping
by the Uniscribe engine), and @code{harfbuzz} (font driver for OTF and by the Uniscribe engine), and @code{harfbuzz} (font driver for OTF and
TTF fonts with HarfBuzz text shaping) (@pxref{Windows Fonts,,, emacs, TTF fonts with HarfBuzz text shaping) (@pxref{Windows Fonts,,, emacs,