summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRobert Pluim <rpluim@gmail.com>2024-04-19 15:14:11 +0200
committerRobert Pluim <rpluim@gmail.com>2024-05-14 17:18:32 +0200
commit45ebb66ccf28c1df63cfcfa00891be4e48cdedda (patch)
treec5d81dddc711c0c193600636357ecb66af8be3b0 /doc
parent8074c08cd553ab6ee5ffe61cc2e56fb1e0a4fe34 (diff)
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.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/mule.texi4
-rw-r--r--doc/lispref/display.texi4
2 files changed, 7 insertions, 1 deletions
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