Changeset 4166 for trunk/lispref/display.texi
- Timestamp:
- 09/18/06 20:48:14 (2 years ago)
- Files:
-
- trunk/lispref/display.texi (modified) (5 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
trunk/lispref/display.texi
r4161 r4166 120 120 If the optional argument @var{force} is non-@code{nil}, it forces an 121 121 immediate and complete redisplay even if input is available. 122 123 Returns @code{t} if redisplay was performed, or @code{nil} otherwise. 122 124 @end defun 123 125 … … 2817 2819 there is text below the screen. 2818 2820 2819 There are fourkinds of basic values:2821 There are three kinds of basic values: 2820 2822 2821 2823 @table @asis 2822 2824 @item @code{nil} 2823 Don't display the icons.2825 Don't display any of these fringe icons. 2824 2826 @item @code{left} 2825 Display the min the left fringe.2827 Display the angle icons and arrows in the left fringe. 2826 2828 @item @code{right} 2827 Display the min the right fringe.2828 @item @var{anything-else}2829 Display the icon at the top of the window top in the left fringe, and other2830 in the right fringe.2829 Display the angle icons and arrows in the right fringe. 2830 @item any non-alist 2831 Display the angle icons in the left fringe 2832 and don't display the arrows. 2831 2833 @end table 2832 2834 2833 If value is a cons @code{(@var{angles} . @var{arrows})}, @var{angles} 2834 controls the angle icons, and @var{arrows} controls the arrows. Both 2835 @var{angles} and @var{arrows} work according to the table above. 2836 Thus, @code{(t . right)} places the top angle icon in the left 2837 fringe, the bottom angle icon in the right fringe, and both arrows in 2838 the right fringe. 2835 Otherwise the value should be an alist that specifies which fringe 2836 indicators to display and where. Each element of the alist should 2837 have the form @code{(@var{indicator} . @var{position})}. Here, 2838 @var{indicator} is one of @code{top}, @code{bottom}, @code{up}, 2839 @code{down}, and @code{t} (which covers all the icons not yet 2840 specified), while @var{position} is one of @code{left}, @code{right} 2841 and @code{nil}. 2842 2843 For example, @code{((top . left) (t . right))} places the top angle 2844 bitmap in left fringe, and the bottom angle bitmap as well as both 2845 arrow bitmaps in right fringe. To show the angle bitmaps in the left 2846 fringe, and no arrow bitmaps, use @code{((top . left) (bottom . left))}. 2839 2847 @end defvar 2840 2848 … … 5111 5119 The ordinary elements of the display table are indexed by character 5112 5120 codes; the element at index @var{c} says how to display the character 5113 code @var{c}. The value should be @code{nil} or a vector of glyph5114 values (@pxref{Glyphs}). If an element is @code{nil}, it says to 5115 display that characteraccording to the usual display conventions5121 code @var{c}. The value should be @code{nil} or a vector of the 5122 glyphs to be output (@pxref{Glyphs}). @code{nil} says to display the 5123 character @var{c} according to the usual display conventions 5116 5124 (@pxref{Usual Display}). 5117 5125 5118 If you use the display table to change the display of newline 5119 characters, the whole buffer will be displayed as one long ``line.'' 5126 @strong{Warning:} if you use the display table to change the display 5127 of newline characters, the whole buffer will be displayed as one long 5128 ``line.'' 5120 5129 5121 5130 The display table also has six ``extra slots'' which serve special … … 5244 5253 image that takes up a single character position on the screen. Glyphs 5245 5254 are represented in Lisp as integers, just as characters are. Normally 5246 Emacs finds glyphs in the display table (@pxref{Display Tables}).5247 5248 A glyph c an be @dfn{simple} or it can be defined by the @dfn{glyph5249 table}. A simple glyph is just a way of specifying a character anda5250 face to output it in. The glyph code for a simple glyph, mod 524288,5251 is the character to output, and the glyph code divided by 524288 5252 specifies the face number (@pxref{Face Functions}) to use while5253 outputting it. (524288 is5255 glyph come from vectors in the display table (@pxref{Display Tables}). 5256 5257 A glyph code can be @dfn{simple} or it can be defined by the 5258 @dfn{glyph table}. A simple glyph code is just a way of specifying a 5259 character and a face to output it in. When a glyph code is simple, 5260 the code, mod 524288, is the character to output, and the code divided 5261 by 524288 specifies the face number (@pxref{Face Functions}) to use 5262 while outputting it. (524288 is 5254 5263 @ifnottex 5255 5264 2**19.) … … 5261 5270 5262 5271 On character terminals, you can set up a @dfn{glyph table} to define 5263 the meaning of glyph codes. The glyph codes is the value of the 5264 variable @code{glyph-table}. 5272 the meaning of glyph codes. 5265 5273 5266 5274 @defvar glyph-table 5267 The value of this variable is the current glyph table. It should be a 5268 vector; the @var{g}th element defines glyph code @var{g}. 5275 The value of this variable is the current glyph table. It should be 5276 @code{nil} or a vector whose @var{g}th element defines glyph code 5277 @var{g}. 5269 5278 5270 5279 If a glyph code is greater than or equal to the length of the glyph 5271 table, that code is automatically simple. If the value of 5272 @code{glyph-table} is @code{nil} instead of a vector, then all glyphs 5273 are simple. The glyph table is not used on graphical displays, only 5274 on character terminals. On graphical displays, all glyphs are simple. 5275 @end defvar 5276 5277 Here are the possible types of elements in the glyph table: 5280 table, that code is automatically simple. If @code{glyph-table} is 5281 @code{nil} then all glyph codes are simple. 5282 5283 The glyph table is used only on character terminals. On graphical 5284 displays, all glyph codes are simple. 5285 @end defvar 5286 5287 Here are the meaningful types of elements in the glyph table: 5278 5288 5279 5289 @table @asis 5280 5290 @item @var{string} 5281 5291 Send the characters in @var{string} to the terminal to output 5282 this glyph. This alternative is available on character terminals, 5283 but not on graphical displays. 5292 this glyph code. 5284 5293 5285 5294 @item @var{integer} 5286 5295 Define this glyph code as an alias for glyph code @var{integer}. You 5287 can use an alias to specify a face code for the glyph and use a small5288 number as its code.5296 can use such an alias to define a small-numbered glyph code which 5297 specifies a face. 5289 5298 5290 5299 @item @code{nil} 5291 This glyph is simple.5300 This glyph code is simple. 5292 5301 @end table 5293 5302
