/[emacs]/emacs/lispref/display.texi
ViewVC logotype

Diff of /emacs/lispref/display.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.83.2.2 by miles, Tue Oct 14 23:10:11 2003 UTC revision 1.83.2.3 by miles, Fri Nov 21 00:35:46 2003 UTC
# Line 801  they print into the buffer named @var{bu Line 801  they print into the buffer named @var{bu
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.
# Line 2076  face attributes, as determined by face m Line 2077  face attributes, as determined by face m
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.
# Line 2435  times in the specification string. Line 2414  times in the specification string.
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
# Line 2451  better to use the smaller font in its ow Line 2430  better to use the smaller font in its ow
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
# Line 2480  Then, the font specifications for all bu Line 2459  Then, the font specifications for all bu
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
# Line 3467  Character code 10 is a newline. Line 3476  Character code 10 is a newline.
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    
# Line 3542  independent of the user-settable tab sto Line 3551  independent of the user-settable tab sto
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

Legend:
Removed from v.1.83.2.2  
changed lines
  Added in v.1.83.2.3

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26