801 |
created if necessary, and put into Help mode. Finally, the buffer is |
created if necessary, and put into Help mode. Finally, the buffer is |
802 |
displayed in some window, but not selected. |
displayed in some window, but not selected. |
803 |
|
|
804 |
If the @var{forms} do not change the major mode in the output buffer, so |
If the @var{forms} do not change the major mode in the output buffer, |
805 |
that it is still Help mode at the end of their execution, then |
so that it is still Help mode at the end of their execution, then |
806 |
@code{with-output-to-temp-buffer} makes this buffer read-only at the |
@code{with-output-to-temp-buffer} makes this buffer read-only at the |
807 |
end, and also scans it for function and variable names to make them into |
end, and also scans it for function and variable names to make them |
808 |
clickable cross-references. |
into clickable cross-references. @xref{Documentation Tips, , Tips for |
809 |
|
Documentation Strings}. |
810 |
|
|
811 |
The string @var{buffer-name} specifies the temporary buffer, which |
The string @var{buffer-name} specifies the temporary buffer, which |
812 |
need not already exist. The argument must be a string, not a buffer. |
need not already exist. The argument must be a string, not a buffer. |
2077 |
font choice, but not all. Part of the choice depends on what character |
font choice, but not all. Part of the choice depends on what character |
2078 |
it is. |
it is. |
2079 |
|
|
|
For multibyte characters, typically each font covers only one |
|
|
character set. So each character set (@pxref{Character Sets}) specifies |
|
|
a registry and encoding to use, with the character set's |
|
|
@code{x-charset-registry} property. Its value is a string containing |
|
|
the registry and the encoding, with a dash between them: |
|
|
|
|
|
@example |
|
|
(plist-get (charset-plist 'latin-iso8859-1) |
|
|
'x-charset-registry) |
|
|
@result{} "ISO8859-1" |
|
|
@end example |
|
|
|
|
|
Unibyte text does not have character sets, so displaying a unibyte |
|
|
character takes the registry and encoding from the variable |
|
|
@code{face-default-registry}. |
|
|
|
|
|
@defvar face-default-registry |
|
|
This variable specifies which registry and encoding to use in choosing |
|
|
fonts for unibyte characters. The value is initialized at Emacs startup |
|
|
time from the font the user specified for Emacs. |
|
|
@end defvar |
|
|
|
|
2080 |
If the face specifies a fontset name, that fontset determines a |
If the face specifies a fontset name, that fontset determines a |
2081 |
pattern for fonts of the given charset. If the face specifies a font |
pattern for fonts of the given charset. If the face specifies a font |
2082 |
family, a font pattern is constructed. |
family, a font pattern is constructed. |
2414 |
For the remaining character sets, those that you don't specify |
For the remaining character sets, those that you don't specify |
2415 |
explicitly, Emacs chooses a font based on @var{fontpattern}: it replaces |
explicitly, Emacs chooses a font based on @var{fontpattern}: it replaces |
2416 |
@samp{fontset-@var{alias}} with a value that names one character set. |
@samp{fontset-@var{alias}} with a value that names one character set. |
2417 |
For the @sc{ascii} character set, @samp{fontset-@var{alias}} is replaced |
For the @acronym{ASCII} character set, @samp{fontset-@var{alias}} is replaced |
2418 |
with @samp{ISO8859-1}. |
with @samp{ISO8859-1}. |
2419 |
|
|
2420 |
In addition, when several consecutive fields are wildcards, Emacs |
In addition, when several consecutive fields are wildcards, Emacs |
2430 |
@end example |
@end example |
2431 |
|
|
2432 |
@noindent |
@noindent |
2433 |
the font specification for @sc{ascii} characters would be this: |
the font specification for @acronym{ASCII} characters would be this: |
2434 |
|
|
2435 |
@example |
@example |
2436 |
-*-fixed-medium-r-normal-*-24-*-ISO8859-1 |
-*-fixed-medium-r-normal-*-24-*-ISO8859-1 |
2459 |
Chinese GB2312 characters has a wild card @samp{*} in the @var{family} |
Chinese GB2312 characters has a wild card @samp{*} in the @var{family} |
2460 |
field. |
field. |
2461 |
|
|
2462 |
|
@defun set-fontset-font name character fontname &optional frame |
2463 |
|
This function modifies the existing fontset @var{name} to |
2464 |
|
use the font name @var{fontname} for the character @var{character}. |
2465 |
|
|
2466 |
|
If @var{name} is @code{nil}, this function modifies the default |
2467 |
|
fontset of which short name is @samp{fontset-default}. |
2468 |
|
|
2469 |
|
@var{character} may be a cons; @code{(@var{from} . @var{to})}, where |
2470 |
|
@var{from} and @var{to} are non-generic characters. In that case, use |
2471 |
|
@var{fontname} for all characters in the range @var{from} and @var{to} |
2472 |
|
(inclusive). |
2473 |
|
|
2474 |
|
@var{character} may be a charset. In that case, use |
2475 |
|
@var{fontname} for all character in the charsets. |
2476 |
|
|
2477 |
|
@var{fontname} may be a cons; @code{(@var{family} . @var{registry})}, |
2478 |
|
where @var{family} is a family name of a font (possibly including a |
2479 |
|
foundry name at the head), @var{registry} is a registry name of a font |
2480 |
|
(possibly including an encoding name at the tail). |
2481 |
|
|
2482 |
|
For instance, this changes the default fontset to use a font of which |
2483 |
|
registry name is @samp{JISX0208.1983} for all characters belonging to |
2484 |
|
the charset @code{japanese-jisx0208}. |
2485 |
|
|
2486 |
|
@example |
2487 |
|
(set-fontset-font nil 'japanese-jisx0208 '(nil . "JISX0208.1983")) |
2488 |
|
@end example |
2489 |
|
|
2490 |
|
@end defun |
2491 |
|
|
2492 |
@defun char-displayable-p char |
@defun char-displayable-p char |
2493 |
This function returns @code{t} if Emacs ought to be able to display |
This function returns @code{t} if Emacs ought to be able to display |
2494 |
@var{char}. More precisely, if the selected frame's fontset has a |
@var{char}. More precisely, if the selected frame's fontset has a |
3476 |
All other codes in the range 0 through 31, and code 127, display in one |
All other codes in the range 0 through 31, and code 127, display in one |
3477 |
of two ways according to the value of @code{ctl-arrow}. If it is |
of two ways according to the value of @code{ctl-arrow}. If it is |
3478 |
non-@code{nil}, these codes map to sequences of two glyphs, where the |
non-@code{nil}, these codes map to sequences of two glyphs, where the |
3479 |
first glyph is the @sc{ascii} code for @samp{^}. (A display table can |
first glyph is the @acronym{ASCII} code for @samp{^}. (A display table can |
3480 |
specify a glyph to use instead of @samp{^}.) Otherwise, these codes map |
specify a glyph to use instead of @samp{^}.) Otherwise, these codes map |
3481 |
just like the codes in the range 128 to 255. |
just like the codes in the range 128 to 255. |
3482 |
|
|
3483 |
On MS-DOS terminals, Emacs arranges by default for the character code |
On MS-DOS terminals, Emacs arranges by default for the character code |
3484 |
127 to be mapped to the glyph code 127, which normally displays as an |
127 to be mapped to the glyph code 127, which normally displays as an |
3485 |
empty polygon. This glyph is used to display non-@sc{ascii} characters |
empty polygon. This glyph is used to display non-@acronym{ASCII} characters |
3486 |
that the MS-DOS terminal doesn't support. @xref{MS-DOS and MULE,,, |
that the MS-DOS terminal doesn't support. @xref{MS-DOS and MULE,,, |
3487 |
emacs, The GNU Emacs Manual}. |
emacs, The GNU Emacs Manual}. |
3488 |
|
|
3489 |
@item |
@item |
3490 |
Character codes 128 through 255 map to sequences of four glyphs, where |
Character codes 128 through 255 map to sequences of four glyphs, where |
3491 |
the first glyph is the @sc{ascii} code for @samp{\}, and the others are |
the first glyph is the @acronym{ASCII} code for @samp{\}, and the others are |
3492 |
digit characters representing the character code in octal. (A display |
digit characters representing the character code in octal. (A display |
3493 |
table can specify a glyph to use instead of @samp{\}.) |
table can specify a glyph to use instead of @samp{\}.) |
3494 |
|
|
3551 |
@cindex display table |
@cindex display table |
3552 |
You can use the @dfn{display table} feature to control how all possible |
You can use the @dfn{display table} feature to control how all possible |
3553 |
character codes display on the screen. This is useful for displaying |
character codes display on the screen. This is useful for displaying |
3554 |
European languages that have letters not in the @sc{ascii} character |
European languages that have letters not in the @acronym{ASCII} character |
3555 |
set. |
set. |
3556 |
|
|
3557 |
The display table maps each character code into a sequence of |
The display table maps each character code into a sequence of |