From bb999339ce7a6d18e9c7dc4f40bfae6f38d9479e Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 1 Jun 2019 15:06:25 +0300 Subject: [PATCH] Update the documentation due to changes in loading font backends * doc/emacs/msdos.texi (Windows Fonts): Reflect the fact that Uniscribe is not enabled by default. --- doc/emacs/msdos.texi | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi index 27a7cd80968..dc34904a012 100644 --- a/doc/emacs/msdos.texi +++ b/doc/emacs/msdos.texi @@ -996,17 +996,23 @@ HarfBuzz support, and if the HarfBuzz DLL is installed on your system; like @code{uniscribe}, this backend supports only TrueType and OpenType fonts. Some languages requiring complex layout can only be properly supported by the Uniscribe or HarfBuzz backends. By default, -all backends are enabled if supported, with @code{harfbuzz} taking -priority over @code{uniscribe}, and @code{uniscribe} taking priority -over @code{gdi}. To override that and use the GDI backend even if -Uniscribe is available, invoke Emacs with the @kbd{-xrm -Emacs.fontBackend:gdi} command-line argument, or add a -@code{Emacs.fontBackend} resource with the value @code{gdi} in the -Registry under either the @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs} -or the @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs} key -(@pxref{Resources}). Similarly, to use the Uniscribe backend even if -HarfBuzz is available, use @kbd{-xrm Emacs.fontBackend:uniscribe} on -the command line that invokes Emacs. +two backends are enabled for each frame: @code{gdi} and either +@code{harfbuzz} or @code{uniscribe}, depending on which one is +available (if both are available, only @code{harfbuzz} is enabled by +default). The @code{harfbuzz} and @code{uniscribe} backends take +priority over @code{gdi} when Emacs looks for a suitable font. To +override that and use the GDI backend even if Uniscribe is available, +invoke Emacs with the @kbd{-xrm Emacs.fontBackend:gdi} command-line +argument, or add a @code{Emacs.fontBackend} resource with the value +@code{gdi} in the Registry under either the +@samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs} or the +@samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs} key (@pxref{Resources}). +Similarly, to use the Uniscribe backend even if HarfBuzz is available, +use @kbd{-xrm Emacs.fontBackend:uniscribe} on the command line that +invokes Emacs. You can also request all the 3 backends via the +@code{font-backend} frame parameter, but be warned that in that case +font searches for characters for which no fonts are available on the +system will take longer. @cindex font properties (MS Windows) @noindent -- 2.39.2