Mercurial > hg > xemacs-beta
diff man/lispref/display.texi @ 412:697ef44129c6 r21-2-14
Import from CVS: tag r21-2-14
author | cvs |
---|---|
date | Mon, 13 Aug 2007 11:20:41 +0200 |
parents | 501cfd01ee6d |
children |
line wrap: on
line diff
--- a/man/lispref/display.texi Mon Aug 13 11:19:22 2007 +0200 +++ b/man/lispref/display.texi Mon Aug 13 11:20:41 2007 +0200 @@ -874,13 +874,13 @@ All other codes in the range 0 through 31, and code 127, display in one of two ways according to the value of @code{ctl-arrow}. If it is non-@code{nil}, these codes map to sequences of two glyphs, where the -first glyph is the @sc{ascii} code for @samp{^}. (A display table can +first glyph is the @sc{ASCII} code for @samp{^}. (A display table can specify a glyph to use instead of @samp{^}.) Otherwise, these codes map just like the codes in the range 128 to 255. @item Character codes 128 through 255 map to sequences of four glyphs, where -the first glyph is the @sc{ascii} code for @samp{\}, and the others are +the first glyph is the @sc{ASCII} code for @samp{\}, and the others are digit characters representing the code in octal. (A display table can specify a glyph to use instead of @samp{\}.) @end itemize @@ -921,7 +921,7 @@ @cindex display table You can use the @dfn{display table} feature to control how all 256 possible character codes display on the screen. This is useful for -displaying European languages that have letters not in the @sc{ascii} +displaying European languages that have letters not in the @sc{ASCII} character set. The display table maps each character code into a sequence of @@ -996,71 +996,6 @@ to a ``glyph table'' and such. Note that ``glyph'' has a different meaning in XEmacs.) -@defvar current-display-table - -The display table currently in use. This is a specifier. - -Display tables are used to control how characters are displayed. Each -time that redisplay processes a character, it is looked up in all the -display tables that apply (obtained by calling @code{specifier-instance} -on @code{current-display-table} and any overriding display tables -specified in currently active faces). The first entry found that -matches the character determines how the character is displayed. If -there is no matching entry, the default display method is -used. (Non-control characters are displayed as themselves and control -characters are displayed according to the buffer-local variable -@code{ctl-arrow}. Control characters are further affected by -@code{control-arrow-glyph} and @code{octal-escape-glyph}.) - -Each instantiator in this specifier and the display-table specifiers -in faces is a display table or a list of such tables. If a list, each -table will be searched in turn for an entry matching a particular -character. Each display table is one of - -@itemize @bullet -@item -A vector, specifying values for characters starting at 0. -@item -A char table, either of type @code{char} or @code{generic}. -@item -A range table. -@end itemize - -Each entry in a display table should be one of - -@itemize @bullet -@item -nil (this entry is ignored and the search continues). -@item -A character (use this character; if it happens to be the same as -the original character, default processing happens, otherwise -redisplay attempts to display this character directly; -#### At some point recursive display-table lookup will be -implemented). -@item -A string (display each character in the string directly; -#### At some point recursive display-table lookup will be -implemented). -@item -A glyph (display the glyph; -#### At some point recursive display-table lookup will be -implemented when a string glyph is being processed). -@item -A cons of the form (format "@var{string}") where @var{string} is a -printf-like spec used to process the character. #### Unfortunately no -formatting directives other than %% are implemented. -@item -A vector (each element of the vector is processed recursively; -in such a case, nil elements in the vector are simply ignored). - -#### At some point in the near future, display tables are likely to -be expanded to include other features, such as referencing characters -in particular fonts and allowing the character search to continue -all the way up the chain of specifier instantiators. These features -are necessary to properly display Unicode characters. -@end itemize -@end defvar - Individual faces can also specify an overriding display table; this is set using @code{set-face-display-table}. @xref{Faces}. @@ -1105,9 +1040,9 @@ @end example If you are editing buffers written in the ISO Latin 1 character set and -your terminal doesn't handle anything but @sc{ascii}, you can load the +your terminal doesn't handle anything but @sc{ASCII}, you can load the file @file{iso-ascii} to set up a display table that displays the other -ISO characters as explanatory sequences of @sc{ascii} characters. For +ISO characters as explanatory sequences of @sc{ASCII} characters. For example, the character ``o with umlaut'' displays as @samp{@{"o@}}. Some European countries have terminals that don't support ISO Latin 1