1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-26 07:33:47 +00:00

(Fontsets): Update the description.

This commit is contained in:
Kenichi Handa 2009-03-13 05:07:14 +00:00
parent 413657ff04
commit d6eb4e250a
2 changed files with 29 additions and 9 deletions

View File

@ -1,3 +1,7 @@
2009-03-13 Kenichi Handa <handa@m17n.org>
* display.texi (Fontsets): Update the description.
2009-03-13 Chong Yidong <cyd@stupidchicken.com>
* advice.texi (Advising Primitives): Link to What Is a Function.

View File

@ -2883,32 +2883,48 @@ Then, the font specifications for all but Chinese GB2312 characters have
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}.
@defun set-fontset-font name character font-spec &optional frame add
This function modifies the existing fontset @var{name} to use the font
matching with @var{font-spec} for the character @var{character}.
If @var{name} is @code{nil}, this function modifies the default
If @var{name} is @code{nil}, this function modifies the fontset of the
selected frame or that of @var{frame} if @var{frame} is not
@code{nil}.
If @var{name} is @code{t}, this function modifies the default
fontset, whose short name is @samp{fontset-default}.
@var{character} may be a cons; @code{(@var{from} . @var{to})}, where
@var{from} and @var{to} are character codepoints. In that case, use
@var{fontname} for all characters in the range @var{from} and @var{to}
@var{font-spec} 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{font-spec} for all character in the charsets.
@var{fontname} may be a cons; @code{(@var{family} . @var{registry})},
@var{character} may be a script anme. In that case, use
@var{font-spec} for all character in the charsets.
@var{font-spec} may be a cons; @code{(@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).
@var{font-spec} may be a font name string.
The optional argument @var{add}, if non-@code{nil}, specifies how to
add @var{font-spec} to the font specifications previously set. If it
is @code{prepend}, @var{font-spec} is prepended. If it is
@code{append}, @var{font-spec} is appended. By default,
@var{font-spec} overrides the previous settings.
For instance, this changes the default fontset to use a font of which
registry name is @samp{JISX0208.1983} for all characters belonging to
family name is @samp{Kochi Gothic} for all characters belonging to
the charset @code{japanese-jisx0208}.
@smallexample
(set-fontset-font nil 'japanese-jisx0208 '(nil . "JISX0208.1983"))
(set-fontset-font t 'japanese-jisx0208
(font-spec :family "Kochi Gothic"))
@end smallexample
@end defun