[Emacs-diffs] harfbuzz bb99933: Update the documentation due to changes in loading font backends

[Eli Zaretskii]

branch: harfbuzz
commit bb999339ce7a6d18e9c7dc4f40bfae6f38d9479e
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    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 27a7cd8..dc34904 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
address@hidden 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
address@hidden 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
address@hidden in the Registry under either the
address@hidden or the
address@hidden 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
address@hidden 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