1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-06 03:40:56 -08:00

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.
This commit is contained in:
Robert Pluim 2024-04-19 15:14:11 +02:00
parent 8074c08cd5
commit 45ebb66ccf
3 changed files with 9 additions and 2 deletions

View file

@ -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.

View file

@ -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