]> git.eshelyaron.com Git - emacs.git/commitdiff
Update the documentation due to changes in loading font backends
authorEli Zaretskii <eliz@gnu.org>
Sat, 1 Jun 2019 12:06:25 +0000 (15:06 +0300)
committerEli Zaretskii <eliz@gnu.org>
Sat, 1 Jun 2019 12:06:25 +0000 (15:06 +0300)
* doc/emacs/msdos.texi (Windows Fonts): Reflect the fact that
Uniscribe is not enabled by default.

doc/emacs/msdos.texi

index 27a7cd80968865cda36bec659f88768ac233dd01..dc34904a01231e1c84cc5a1f89a12e64f1ee7fe7 100644 (file)
@@ -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