From 45ebb66ccf28c1df63cfcfa00891be4e48cdedda Mon Sep 17 00:00:00 2001
From: Robert Pluim
Date: Fri, 19 Apr 2024 15:14:11 +0200
Subject: Document 'use-default-font-for-symbols' more

"why does my set-fontset-font call not work for symbols" is a common
question, and it's because 'use-default-font-for-symbols' is not
discoverable enough.

* doc/emacs/mule.texi (Modifying Fontsets): Mention it here.
* doc/lispref/display.texi (Fontsets): And here.
* src/fontset.c (Fset_fontset_font): And most importantly here.
---
 doc/emacs/mule.texi      | 4 ++++
 doc/lispref/display.texi | 4 +++-
 2 files changed, 7 insertions(+), 1 deletion(-)

(limited to 'doc')

diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index a16a9ea8f71..ab6125f5745 100644
--- a/doc/emacs/mule.texi
+++ b/doc/emacs/mule.texi
@@ -1671,6 +1671,10 @@ used.  Some examples are:
                   nil 'append)
 @end example
 
+When modifying the fontset for the @code{symbol} script, the value of
+@code{use-default-font-for-symbols} will affect whether the fontset is
+actually used.
+
 @noindent
 @xref{Fontsets, , , elisp, GNU Emacs Lisp Reference Manual}, for more
 details about using the @code{set-fontset-font} function.
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 011738df268..a9f89406070 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -3983,7 +3983,9 @@ that case, use @var{font-spec} for all the characters in the charset.
 
 @var{characters} may be a script symbol (@pxref{Character Properties,
 char-script-table}).  In that case, use @var{font-spec} for all the
-characters belonging to the script.
+characters belonging to the script.  See also
+@code{use-default-font-for-symbols}, which affects font selection
+when @var{fontset} is @code{symbol}.
 
 @var{characters} may be @code{nil}, which means to use @var{font-spec}
 for any character in @var{fontset} for which no font-spec is
-- 
cgit v1.2.1