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.

(cherry picked from commit 45ebb66ccf28c1df63cfcfa00891be4e48cdedda)

diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index a16a9ea8f7119d8b5f11f1f403cb9952aed9f1eb..ab6125f5745851b8f8ed3f750976b0f508eab473 100644 (file)
--- 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 c243c2a39ef53f02ed1eccc74366e73d88799dbd..2bfcdd1716bc7bcd5bd895c6d4399db149128597 100644 (file)
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4011,7 +4011,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

diff --git a/src/fontset.c b/src/fontset.c
index a98d75606b3f9ce56f15998b320d1d1831673d10..bac0411995739eea156836658a483cc411260edb 100644 (file)
--- a/src/fontset.c
+++ b/src/fontset.c
@@ -1501,7 +1501,8 @@ CHARACTERS may be a script symbol.  In that case, use FONT-SPEC for
 all the characters that belong to the script.  See the variable
 `script-representative-chars' for the list of known scripts, and
 see the variable `char-script-table' for the script of any specific
-character.
+character.  Note: for the `symbol' script only, whether the FONTSET
+is actually used depends on the value of `use-default-font-for-symbols'.
 
 CHARACTERS may be a charset symbol.  In that case, use FONT-SPEC for
 all the characters in the charset.  See `list-character-sets' and