comparison lispref/display.texi @ 52932:eb3f1895daff

(Fontsets): Add description of the function set-fontset-font.

52931:3f44b2120fba

Then, the font specifications for all but Chinese GB2312 characters have
@samp{fixed} in the @var{family} field, and the font specification for
Chinese GB2312 characters has a wild card @samp{*} in the @var{family}
field.

@defun char-displayable-p char
This function returns @code{t} if Emacs ought to be able to display
@var{char}.  More precisely, if the selected frame's fontset has a
font to display the character set that @var{char} belongs to.

52932:eb3f1895daff

Then, the font specifications for all but Chinese GB2312 characters have
@samp{fixed} in the @var{family} field, and the font specification for
Chinese GB2312 characters has a wild card @samp{*} in the @var{family}
field.

@defun set-fontset-font name character fontname &optional frame
This function modifies the existing fontset @var{name} to
use the font name @var{fontname} for the character @var{character}.

If @var{name} is nil, this function modifies the default
fontset of which short name is "fontset-default".

@var{character} may be a cons; @samp{(@var{from}
. @var{to})}, where @var{from} and @var{to} are non-generic
characters.  In that case, use @var{fontname} for all
characters in the range @var{from} and @var{to} (inclusive).

@var{character} may be a charset.  In that case, use
@var{fontname} for all character in the charsets.

@var{fontname} may be a cons; @samp{(@var{family}
. @var{registry})}, where @var{family} is a family name of a
font (possibly including a foundry name at the head),
@var{registry} is a registry name of a font (possibly
including an encoding name at the tail).

For instance, this changes the default fontset to use a font
of which registry name is "JISX0208.1983" for all characters
belonging to the charset `japanese-jisx0208'.

@example
(set-fontset-font nil 'japanese-jisx0208 '(nil . "JISX0208.1983"))
@end example

@end defun

@defun char-displayable-p char
This function returns @code{t} if Emacs ought to be able to display
@var{char}.  More precisely, if the selected frame's fontset has a
font to display the character set that @var{char} belongs to.