annotate man/display.texi @ 33969:96d72c104f9a raeburn-tag-5-for-export

Add hints to `automatic-hscrolling' to doc strings.
author Gerd Moellmann <gerd@gnu.org>
date Tue, 28 Nov 2000 16:50:40 +0000
parents 67204e92850a
children 3a0a4c2b6633
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
33730
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
2 @c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997, 2000 Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3 @c See file emacs.texi for copying conditions.
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @node Display, Search, Registers, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @chapter Controlling the Display
Dave Love <fx@gnu.org>
parents:
diff changeset
6
Dave Love <fx@gnu.org>
parents:
diff changeset
7 Since only part of a large buffer fits in the window, Emacs tries to
Dave Love <fx@gnu.org>
parents:
diff changeset
8 show a part that is likely to be interesting. Display-control commands
Dave Love <fx@gnu.org>
parents:
diff changeset
9 allow you to specify which part of the text you want to see, and how to
Dave Love <fx@gnu.org>
parents:
diff changeset
10 display it.
Dave Love <fx@gnu.org>
parents:
diff changeset
11
Dave Love <fx@gnu.org>
parents:
diff changeset
12 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
13 * Scrolling:: Moving text up and down in a window.
Dave Love <fx@gnu.org>
parents:
diff changeset
14 * Horizontal Scrolling:: Moving text left and right in a window.
Dave Love <fx@gnu.org>
parents:
diff changeset
15 * Follow Mode:: Follow mode lets two windows scroll as one.
Dave Love <fx@gnu.org>
parents:
diff changeset
16 * Selective Display:: Hiding lines with lots of indentation.
Dave Love <fx@gnu.org>
parents:
diff changeset
17 * Optional Mode Line:: Optional mode line display features.
Dave Love <fx@gnu.org>
parents:
diff changeset
18 * Text Display:: How text characters are normally displayed.
Dave Love <fx@gnu.org>
parents:
diff changeset
19 * Display Vars:: Information on variables for customizing display.
Dave Love <fx@gnu.org>
parents:
diff changeset
20 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
21
Dave Love <fx@gnu.org>
parents:
diff changeset
22 @node Scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
23 @section Scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
24
Dave Love <fx@gnu.org>
parents:
diff changeset
25 If a buffer contains text that is too large to fit entirely within a
Dave Love <fx@gnu.org>
parents:
diff changeset
26 window that is displaying the buffer, Emacs shows a contiguous portion of
Dave Love <fx@gnu.org>
parents:
diff changeset
27 the text. The portion shown always contains point.
Dave Love <fx@gnu.org>
parents:
diff changeset
28
Dave Love <fx@gnu.org>
parents:
diff changeset
29 @cindex scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
30 @dfn{Scrolling} means moving text up or down in the window so that
Dave Love <fx@gnu.org>
parents:
diff changeset
31 different parts of the text are visible. Scrolling forward means that text
Dave Love <fx@gnu.org>
parents:
diff changeset
32 moves up, and new text appears at the bottom. Scrolling backward moves
Dave Love <fx@gnu.org>
parents:
diff changeset
33 text down and new text appears at the top.
Dave Love <fx@gnu.org>
parents:
diff changeset
34
Dave Love <fx@gnu.org>
parents:
diff changeset
35 Scrolling happens automatically if you move point past the bottom or top
Dave Love <fx@gnu.org>
parents:
diff changeset
36 of the window. You can also explicitly request scrolling with the commands
Dave Love <fx@gnu.org>
parents:
diff changeset
37 in this section.
Dave Love <fx@gnu.org>
parents:
diff changeset
38
Dave Love <fx@gnu.org>
parents:
diff changeset
39 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
40 @item C-l
Dave Love <fx@gnu.org>
parents:
diff changeset
41 Clear screen and redisplay, scrolling the selected window to center
Dave Love <fx@gnu.org>
parents:
diff changeset
42 point vertically within it (@code{recenter}).
Dave Love <fx@gnu.org>
parents:
diff changeset
43 @item C-v
Dave Love <fx@gnu.org>
parents:
diff changeset
44 Scroll forward (a windowful or a specified number of lines) (@code{scroll-up}).
Dave Love <fx@gnu.org>
parents:
diff changeset
45 @item @key{NEXT}
Dave Love <fx@gnu.org>
parents:
diff changeset
46 Likewise, scroll forward.
Dave Love <fx@gnu.org>
parents:
diff changeset
47 @item M-v
Dave Love <fx@gnu.org>
parents:
diff changeset
48 Scroll backward (@code{scroll-down}).
Dave Love <fx@gnu.org>
parents:
diff changeset
49 @item @key{PRIOR}
Dave Love <fx@gnu.org>
parents:
diff changeset
50 Likewise, scroll backward.
Dave Love <fx@gnu.org>
parents:
diff changeset
51 @item @var{arg} C-l
Dave Love <fx@gnu.org>
parents:
diff changeset
52 Scroll so point is on line @var{arg} (@code{recenter}).
Dave Love <fx@gnu.org>
parents:
diff changeset
53 @item C-M-l
Dave Love <fx@gnu.org>
parents:
diff changeset
54 Scroll heuristically to bring useful information onto the screen
Dave Love <fx@gnu.org>
parents:
diff changeset
55 (@code{reposition-window}).
Dave Love <fx@gnu.org>
parents:
diff changeset
56 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
57
Dave Love <fx@gnu.org>
parents:
diff changeset
58 @kindex C-l
Dave Love <fx@gnu.org>
parents:
diff changeset
59 @findex recenter
Dave Love <fx@gnu.org>
parents:
diff changeset
60 The most basic scrolling command is @kbd{C-l} (@code{recenter}) with
Dave Love <fx@gnu.org>
parents:
diff changeset
61 no argument. It clears the entire screen and redisplays all windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
62 In addition, it scrolls the selected window so that point is halfway
Dave Love <fx@gnu.org>
parents:
diff changeset
63 down from the top of the window.
Dave Love <fx@gnu.org>
parents:
diff changeset
64
Dave Love <fx@gnu.org>
parents:
diff changeset
65 @kindex C-v
Dave Love <fx@gnu.org>
parents:
diff changeset
66 @kindex M-v
Dave Love <fx@gnu.org>
parents:
diff changeset
67 @kindex NEXT
Dave Love <fx@gnu.org>
parents:
diff changeset
68 @kindex PRIOR
Dave Love <fx@gnu.org>
parents:
diff changeset
69 @findex scroll-up
Dave Love <fx@gnu.org>
parents:
diff changeset
70 @findex scroll-down
Dave Love <fx@gnu.org>
parents:
diff changeset
71 The scrolling commands @kbd{C-v} and @kbd{M-v} let you move all the text
Dave Love <fx@gnu.org>
parents:
diff changeset
72 in the window up or down a few lines. @kbd{C-v} (@code{scroll-up}) with an
Dave Love <fx@gnu.org>
parents:
diff changeset
73 argument shows you that many more lines at the bottom of the window, moving
Dave Love <fx@gnu.org>
parents:
diff changeset
74 the text and point up together as @kbd{C-l} might. @kbd{C-v} with a
Dave Love <fx@gnu.org>
parents:
diff changeset
75 negative argument shows you more lines at the top of the window.
Dave Love <fx@gnu.org>
parents:
diff changeset
76 @kbd{M-v} (@code{scroll-down}) is like @kbd{C-v}, but moves in the
Dave Love <fx@gnu.org>
parents:
diff changeset
77 opposite direction. The function keys @key{NEXT} and @key{PRIOR} are
Dave Love <fx@gnu.org>
parents:
diff changeset
78 equivalent to @kbd{C-v} and @kbd{M-v}.
Dave Love <fx@gnu.org>
parents:
diff changeset
79
Dave Love <fx@gnu.org>
parents:
diff changeset
80 The names of scroll commands are based on the direction that the text
Dave Love <fx@gnu.org>
parents:
diff changeset
81 moves in the window. Thus, the command to scroll forward is called
Dave Love <fx@gnu.org>
parents:
diff changeset
82 @code{scroll-up} because it moves the text upward on the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
83
Dave Love <fx@gnu.org>
parents:
diff changeset
84 @vindex next-screen-context-lines
Dave Love <fx@gnu.org>
parents:
diff changeset
85 To read the buffer a windowful at a time, use @kbd{C-v} with no argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
86 It takes the last two lines at the bottom of the window and puts them at
Dave Love <fx@gnu.org>
parents:
diff changeset
87 the top, followed by nearly a whole windowful of lines not previously
Dave Love <fx@gnu.org>
parents:
diff changeset
88 visible. If point was in the text scrolled off the top, it moves to the
Dave Love <fx@gnu.org>
parents:
diff changeset
89 new top of the window. @kbd{M-v} with no argument moves backward with
Dave Love <fx@gnu.org>
parents:
diff changeset
90 overlap similarly. The number of lines of overlap across a @kbd{C-v} or
Dave Love <fx@gnu.org>
parents:
diff changeset
91 @kbd{M-v} is controlled by the variable @code{next-screen-context-lines}; by
Dave Love <fx@gnu.org>
parents:
diff changeset
92 default, it is 2.
Dave Love <fx@gnu.org>
parents:
diff changeset
93
Dave Love <fx@gnu.org>
parents:
diff changeset
94 @vindex scroll-preserve-screen-position
Dave Love <fx@gnu.org>
parents:
diff changeset
95 Some users like the full-screen scroll commands to keep point at the
Dave Love <fx@gnu.org>
parents:
diff changeset
96 same screen line. To enable this behavior, set the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
97 @code{scroll-preserve-screen-position} to a non-@code{nil} value. This
Dave Love <fx@gnu.org>
parents:
diff changeset
98 mode is convenient for browsing through a file by scrolling by
Dave Love <fx@gnu.org>
parents:
diff changeset
99 screenfuls; if you come back to the screen where you started, point goes
Dave Love <fx@gnu.org>
parents:
diff changeset
100 back to the line where it started. However, this mode is inconvenient
Dave Love <fx@gnu.org>
parents:
diff changeset
101 when you move to the next screen in order to move point to the text
Dave Love <fx@gnu.org>
parents:
diff changeset
102 there.
Dave Love <fx@gnu.org>
parents:
diff changeset
103
Dave Love <fx@gnu.org>
parents:
diff changeset
104 Another way to do scrolling is with @kbd{C-l} with a numeric argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
105 @kbd{C-l} does not clear the screen when given an argument; it only scrolls
Dave Love <fx@gnu.org>
parents:
diff changeset
106 the selected window. With a positive argument @var{n}, it repositions text
Dave Love <fx@gnu.org>
parents:
diff changeset
107 to put point @var{n} lines down from the top. An argument of zero puts
Dave Love <fx@gnu.org>
parents:
diff changeset
108 point on the very top line. Point does not move with respect to the text;
Dave Love <fx@gnu.org>
parents:
diff changeset
109 rather, the text and point move rigidly on the screen. @kbd{C-l} with a
Dave Love <fx@gnu.org>
parents:
diff changeset
110 negative argument puts point that many lines from the bottom of the window.
Dave Love <fx@gnu.org>
parents:
diff changeset
111 For example, @kbd{C-u - 1 C-l} puts point on the bottom line, and @kbd{C-u
Dave Love <fx@gnu.org>
parents:
diff changeset
112 - 5 C-l} puts it five lines from the bottom. Just @kbd{C-u} as argument,
Dave Love <fx@gnu.org>
parents:
diff changeset
113 as in @kbd{C-u C-l}, scrolls point to the center of the selected window.
Dave Love <fx@gnu.org>
parents:
diff changeset
114
Dave Love <fx@gnu.org>
parents:
diff changeset
115 @kindex C-M-l
Dave Love <fx@gnu.org>
parents:
diff changeset
116 @findex reposition-window
Dave Love <fx@gnu.org>
parents:
diff changeset
117 The @kbd{C-M-l} command (@code{reposition-window}) scrolls the current
Dave Love <fx@gnu.org>
parents:
diff changeset
118 window heuristically in a way designed to get useful information onto
Dave Love <fx@gnu.org>
parents:
diff changeset
119 the screen. For example, in a Lisp file, this command tries to get the
Dave Love <fx@gnu.org>
parents:
diff changeset
120 entire current defun onto the screen if possible.
Dave Love <fx@gnu.org>
parents:
diff changeset
121
Dave Love <fx@gnu.org>
parents:
diff changeset
122 @vindex scroll-conservatively
Dave Love <fx@gnu.org>
parents:
diff changeset
123 Scrolling happens automatically if point has moved out of the visible
Dave Love <fx@gnu.org>
parents:
diff changeset
124 portion of the text when it is time to display. Normally, automatic
Dave Love <fx@gnu.org>
parents:
diff changeset
125 scrolling centers point vertically within the window. However, if you
Dave Love <fx@gnu.org>
parents:
diff changeset
126 set @code{scroll-conservatively} to a small number @var{n}, then if you
Dave Love <fx@gnu.org>
parents:
diff changeset
127 move point just a little off the screen---less than @var{n} lines---then
Dave Love <fx@gnu.org>
parents:
diff changeset
128 Emacs scrolls the text just far enough to bring point back on screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
129 By default, @code{scroll-conservatively} is 0.
Dave Love <fx@gnu.org>
parents:
diff changeset
130
31126
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
131 @cindex aggressive scrolling
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
132 @vindex scroll-up-aggressively
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
133 @vindex scroll-down-aggressively
31188
b00126124976 Fix a typo.
Eli Zaretskii <eliz@gnu.org>
parents: 31126
diff changeset
134 If you prefer a more aggressive scrolling, customize the values of the
31126
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
135 variables @code{scroll-up-aggressively} and
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
136 @code{scroll-down-aggressively}. The value of
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
137 @code{scroll-up-aggressively} should be either nil or a fraction @var{f}
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
138 between 0 and 1. If it is a fraction, that specifies where on the
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
139 screen to put point when scrolling upward. More precisely, when a
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
140 window scrolls up because point is above the window start, the new start
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
141 position is chosen to put point @var{f} part of the window height from
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
142 the top. The larger @var{f}, the more aggressive the scrolling.
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
143
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
144 A value of @code{nil} is equivalent to .5, since its effect is to center
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
145 point.
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
146
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
147 Likewise, @code{scroll-down-aggressively} is used for scrolling down.
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
148 The value, @var{f}, specifies how far point should be placed from the
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
149 bottom of the window; thus, as with @code{scroll-up-aggressively}, a
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
150 larger value scrolls more aggressively.
66e5313fd5bc Document scroll-up-aggressively and scroll-down-aggressively.
Eli Zaretskii <eliz@gnu.org>
parents: 31041
diff changeset
151
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
152 @vindex scroll-margin
Dave Love <fx@gnu.org>
parents:
diff changeset
153 The variable @code{scroll-margin} restricts how close point can come
Dave Love <fx@gnu.org>
parents:
diff changeset
154 to the top or bottom of a window. Its value is a number of screen
Dave Love <fx@gnu.org>
parents:
diff changeset
155 lines; if point comes within that many lines of the top or bottom of the
Dave Love <fx@gnu.org>
parents:
diff changeset
156 window, Emacs recenters the window. By default, @code{scroll-margin} is
Dave Love <fx@gnu.org>
parents:
diff changeset
157 0.
Dave Love <fx@gnu.org>
parents:
diff changeset
158
Dave Love <fx@gnu.org>
parents:
diff changeset
159 @node Horizontal Scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
160 @section Horizontal Scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
161 @cindex horizontal scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
162
Dave Love <fx@gnu.org>
parents:
diff changeset
163 @dfn{Horizontal scrolling} means shifting all the lines sideways
Dave Love <fx@gnu.org>
parents:
diff changeset
164 within a window---so that some of the text near the left margin
Dave Love <fx@gnu.org>
parents:
diff changeset
165 is not displayed at all.
Dave Love <fx@gnu.org>
parents:
diff changeset
166
Dave Love <fx@gnu.org>
parents:
diff changeset
167 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
168 @item C-x <
Dave Love <fx@gnu.org>
parents:
diff changeset
169 Scroll text in current window to the left (@code{scroll-left}).
Dave Love <fx@gnu.org>
parents:
diff changeset
170 @item C-x >
Dave Love <fx@gnu.org>
parents:
diff changeset
171 Scroll to the right (@code{scroll-right}).
Dave Love <fx@gnu.org>
parents:
diff changeset
172 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
173
Dave Love <fx@gnu.org>
parents:
diff changeset
174 When a window has been scrolled horizontally, text lines are truncated
Dave Love <fx@gnu.org>
parents:
diff changeset
175 rather than continued (@pxref{Continuation Lines}), with a @samp{$}
Dave Love <fx@gnu.org>
parents:
diff changeset
176 appearing in the first column when there is text truncated to the left,
Dave Love <fx@gnu.org>
parents:
diff changeset
177 and in the last column when there is text truncated to the right.
Dave Love <fx@gnu.org>
parents:
diff changeset
178
Dave Love <fx@gnu.org>
parents:
diff changeset
179 @kindex C-x <
Dave Love <fx@gnu.org>
parents:
diff changeset
180 @kindex C-x >
Dave Love <fx@gnu.org>
parents:
diff changeset
181 @findex scroll-left
Dave Love <fx@gnu.org>
parents:
diff changeset
182 @findex scroll-right
Dave Love <fx@gnu.org>
parents:
diff changeset
183 The command @kbd{C-x <} (@code{scroll-left}) scrolls the selected
Dave Love <fx@gnu.org>
parents:
diff changeset
184 window to the left by @var{n} columns with argument @var{n}. This moves
Dave Love <fx@gnu.org>
parents:
diff changeset
185 part of the beginning of each line off the left edge of the window.
Dave Love <fx@gnu.org>
parents:
diff changeset
186 With no argument, it scrolls by almost the full width of the window (two
Dave Love <fx@gnu.org>
parents:
diff changeset
187 columns less, to be precise).
Dave Love <fx@gnu.org>
parents:
diff changeset
188
Dave Love <fx@gnu.org>
parents:
diff changeset
189 @kbd{C-x >} (@code{scroll-right}) scrolls similarly to the right. The
Dave Love <fx@gnu.org>
parents:
diff changeset
190 window cannot be scrolled any farther to the right once it is displayed
Dave Love <fx@gnu.org>
parents:
diff changeset
191 normally (with each line starting at the window's left margin);
Dave Love <fx@gnu.org>
parents:
diff changeset
192 attempting to do so has no effect. This means that you don't have to
Dave Love <fx@gnu.org>
parents:
diff changeset
193 calculate the argument precisely for @w{@kbd{C-x >}}; any sufficiently large
Dave Love <fx@gnu.org>
parents:
diff changeset
194 argument will restore the normal display.
Dave Love <fx@gnu.org>
parents:
diff changeset
195
31041
240df9dae7a7 Document the automatic hscrolling.
Eli Zaretskii <eliz@gnu.org>
parents: 30870
diff changeset
196 @cindex horizontal scrolling
240df9dae7a7 Document the automatic hscrolling.
Eli Zaretskii <eliz@gnu.org>
parents: 30870
diff changeset
197 @vindex automatic-hscrolling
240df9dae7a7 Document the automatic hscrolling.
Eli Zaretskii <eliz@gnu.org>
parents: 30870
diff changeset
198 Emacs automatically scrolls a window horizontally whenever that is
240df9dae7a7 Document the automatic hscrolling.
Eli Zaretskii <eliz@gnu.org>
parents: 30870
diff changeset
199 necessary to keep point visible and not too far from the left or right
240df9dae7a7 Document the automatic hscrolling.
Eli Zaretskii <eliz@gnu.org>
parents: 30870
diff changeset
200 edge. If you don't want this, customize the variable
240df9dae7a7 Document the automatic hscrolling.
Eli Zaretskii <eliz@gnu.org>
parents: 30870
diff changeset
201 @code{automatic-hscrolling} and set it to nil.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
202
Dave Love <fx@gnu.org>
parents:
diff changeset
203 @node Follow Mode
Dave Love <fx@gnu.org>
parents:
diff changeset
204 @section Follow Mode
Dave Love <fx@gnu.org>
parents:
diff changeset
205 @cindex Follow mode
Dave Love <fx@gnu.org>
parents:
diff changeset
206 @cindex mode, Follow
Dave Love <fx@gnu.org>
parents:
diff changeset
207
Dave Love <fx@gnu.org>
parents:
diff changeset
208 @dfn{Follow mode} is a minor mode that makes two windows showing the
Dave Love <fx@gnu.org>
parents:
diff changeset
209 same buffer scroll as one tall ``virtual window.'' To use Follow mode,
Dave Love <fx@gnu.org>
parents:
diff changeset
210 go to a frame with just one window, split it into two side-by-side
Dave Love <fx@gnu.org>
parents:
diff changeset
211 windows using @kbd{C-x 3}, and then type @kbd{M-x follow-mode}. From
Dave Love <fx@gnu.org>
parents:
diff changeset
212 then on, you can edit the buffer in either of the two windows, or scroll
Dave Love <fx@gnu.org>
parents:
diff changeset
213 either one; the other window follows it.
Dave Love <fx@gnu.org>
parents:
diff changeset
214
Dave Love <fx@gnu.org>
parents:
diff changeset
215 To turn off Follow mode, type @kbd{M-x follow-mode} a second time.
Dave Love <fx@gnu.org>
parents:
diff changeset
216
Dave Love <fx@gnu.org>
parents:
diff changeset
217 @node Selective Display
Dave Love <fx@gnu.org>
parents:
diff changeset
218 @section Selective Display
Dave Love <fx@gnu.org>
parents:
diff changeset
219 @findex set-selective-display
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @kindex C-x $
Dave Love <fx@gnu.org>
parents:
diff changeset
221
Dave Love <fx@gnu.org>
parents:
diff changeset
222 Emacs has the ability to hide lines indented more than a certain number
Dave Love <fx@gnu.org>
parents:
diff changeset
223 of columns (you specify how many columns). You can use this to get an
Dave Love <fx@gnu.org>
parents:
diff changeset
224 overview of a part of a program.
Dave Love <fx@gnu.org>
parents:
diff changeset
225
Dave Love <fx@gnu.org>
parents:
diff changeset
226 To hide lines, type @kbd{C-x $} (@code{set-selective-display}) with a
Dave Love <fx@gnu.org>
parents:
diff changeset
227 numeric argument @var{n}. Then lines with at least @var{n} columns of
Dave Love <fx@gnu.org>
parents:
diff changeset
228 indentation disappear from the screen. The only indication of their
Dave Love <fx@gnu.org>
parents:
diff changeset
229 presence is that three dots (@samp{@dots{}}) appear at the end of each
Dave Love <fx@gnu.org>
parents:
diff changeset
230 visible line that is followed by one or more hidden ones.
Dave Love <fx@gnu.org>
parents:
diff changeset
231
Dave Love <fx@gnu.org>
parents:
diff changeset
232 The commands @kbd{C-n} and @kbd{C-p} move across the hidden lines as
Dave Love <fx@gnu.org>
parents:
diff changeset
233 if they were not there.
Dave Love <fx@gnu.org>
parents:
diff changeset
234
Dave Love <fx@gnu.org>
parents:
diff changeset
235 The hidden lines are still present in the buffer, and most editing
Dave Love <fx@gnu.org>
parents:
diff changeset
236 commands see them as usual, so you may find point in the middle of the
Dave Love <fx@gnu.org>
parents:
diff changeset
237 hidden text. When this happens, the cursor appears at the end of the
Dave Love <fx@gnu.org>
parents:
diff changeset
238 previous line, after the three dots. If point is at the end of the
Dave Love <fx@gnu.org>
parents:
diff changeset
239 visible line, before the newline that ends it, the cursor appears before
Dave Love <fx@gnu.org>
parents:
diff changeset
240 the three dots.
Dave Love <fx@gnu.org>
parents:
diff changeset
241
Dave Love <fx@gnu.org>
parents:
diff changeset
242 To make all lines visible again, type @kbd{C-x $} with no argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
243
Dave Love <fx@gnu.org>
parents:
diff changeset
244 @vindex selective-display-ellipses
Dave Love <fx@gnu.org>
parents:
diff changeset
245 If you set the variable @code{selective-display-ellipses} to
Dave Love <fx@gnu.org>
parents:
diff changeset
246 @code{nil}, the three dots do not appear at the end of a line that
Dave Love <fx@gnu.org>
parents:
diff changeset
247 precedes hidden lines. Then there is no visible indication of the
Dave Love <fx@gnu.org>
parents:
diff changeset
248 hidden lines. This variable becomes local automatically when set.
Dave Love <fx@gnu.org>
parents:
diff changeset
249
Dave Love <fx@gnu.org>
parents:
diff changeset
250 @node Optional Mode Line
Dave Love <fx@gnu.org>
parents:
diff changeset
251 @section Optional Mode Line Features
Dave Love <fx@gnu.org>
parents:
diff changeset
252
Dave Love <fx@gnu.org>
parents:
diff changeset
253 @cindex Line Number mode
Dave Love <fx@gnu.org>
parents:
diff changeset
254 @cindex mode, Line Number
Dave Love <fx@gnu.org>
parents:
diff changeset
255 @findex line-number-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
256 The current line number of point appears in the mode line when Line
Dave Love <fx@gnu.org>
parents:
diff changeset
257 Number mode is enabled. Use the command @kbd{M-x line-number-mode} to
Dave Love <fx@gnu.org>
parents:
diff changeset
258 turn this mode on and off; normally it is on. The line number appears
Dave Love <fx@gnu.org>
parents:
diff changeset
259 before the buffer percentage @var{pos}, with the letter @samp{L} to
Dave Love <fx@gnu.org>
parents:
diff changeset
260 indicate what it is. @xref{Minor Modes}, for more information about
Dave Love <fx@gnu.org>
parents:
diff changeset
261 minor modes and about how to use this command.
Dave Love <fx@gnu.org>
parents:
diff changeset
262
Dave Love <fx@gnu.org>
parents:
diff changeset
263 @vindex line-number-display-limit
29841
2b8edcad6b0f (Optional Mode Line): Add index entry for removing the line-number
Eli Zaretskii <eliz@gnu.org>
parents: 29753
diff changeset
264 @cindex line number display, removing the limit
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
265 If the buffer is very large (larger than the value of
Dave Love <fx@gnu.org>
parents:
diff changeset
266 @code{line-number-display-limit}), then the line number doesn't appear.
Dave Love <fx@gnu.org>
parents:
diff changeset
267 Emacs doesn't compute the line number when the buffer is large, because
29753
7d573ed000ce line-number-display-limit change
Dave Love <fx@gnu.org>
parents: 28800
diff changeset
268 that would be too slow. Set it to @code{nil} to remove the limit. If
7d573ed000ce line-number-display-limit change
Dave Love <fx@gnu.org>
parents: 28800
diff changeset
269 you have narrowed the buffer (@pxref{Narrowing}), the displayed line
7d573ed000ce line-number-display-limit change
Dave Love <fx@gnu.org>
parents: 28800
diff changeset
270 number is relative to the accessible portion of the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
271
Dave Love <fx@gnu.org>
parents:
diff changeset
272 @cindex Column Number mode
Dave Love <fx@gnu.org>
parents:
diff changeset
273 @cindex mode, Column Number
Dave Love <fx@gnu.org>
parents:
diff changeset
274 @findex column-number-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
275 You can also display the current column number by turning on Column
Dave Love <fx@gnu.org>
parents:
diff changeset
276 Number mode. It displays the current column number preceded by the
Dave Love <fx@gnu.org>
parents:
diff changeset
277 letter @samp{C}. Type @kbd{M-x column-number-mode} to toggle this mode.
Dave Love <fx@gnu.org>
parents:
diff changeset
278
Dave Love <fx@gnu.org>
parents:
diff changeset
279 @findex display-time
Dave Love <fx@gnu.org>
parents:
diff changeset
280 @cindex time (on mode line)
Dave Love <fx@gnu.org>
parents:
diff changeset
281 Emacs can optionally display the time and system load in all mode
30870
4f58e2bbcb08 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 29841
diff changeset
282 lines. To enable this feature, type @kbd{M-x display-time} or customize
4f58e2bbcb08 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 29841
diff changeset
283 the option @code{display-time-mode}. The information added to the mode
4f58e2bbcb08 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 29841
diff changeset
284 line usually appears after the buffer name, before the mode names and
4f58e2bbcb08 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 29841
diff changeset
285 their parentheses. It looks like this:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
286
Dave Love <fx@gnu.org>
parents:
diff changeset
287 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @var{hh}:@var{mm}pm @var{l.ll}
Dave Love <fx@gnu.org>
parents:
diff changeset
289 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
290
Dave Love <fx@gnu.org>
parents:
diff changeset
291 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
292 @vindex display-time-24hr-format
Dave Love <fx@gnu.org>
parents:
diff changeset
293 Here @var{hh} and @var{mm} are the hour and minute, followed always by
Dave Love <fx@gnu.org>
parents:
diff changeset
294 @samp{am} or @samp{pm}. @var{l.ll} is the average number of running
Dave Love <fx@gnu.org>
parents:
diff changeset
295 processes in the whole system recently. (Some fields may be missing if
Dave Love <fx@gnu.org>
parents:
diff changeset
296 your operating system cannot support them.) If you prefer time display
Dave Love <fx@gnu.org>
parents:
diff changeset
297 in 24-hour format, set the variable @code{display-time-24hr-format}
Dave Love <fx@gnu.org>
parents:
diff changeset
298 to @code{t}.
Dave Love <fx@gnu.org>
parents:
diff changeset
299
Dave Love <fx@gnu.org>
parents:
diff changeset
300 @cindex mail (on mode line)
28800
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
301 @vindex display-time-use-mail-icon
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
302 @vindex display-time-mail-face
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
303 The word @samp{Mail} appears after the load level if there is mail
28800
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
304 for you that you have not read yet. On a graphical display you can use
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
305 an icon instead of @samp{Mail} by customizing
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
306 @code{display-time-use-mail-icon}; this may save some space on the mode
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
307 line. You can customize @code{display-time-mail-face} to make the mail
d10b6cddbf91 display-time-use-mail-icon
Dave Love <fx@gnu.org>
parents: 27219
diff changeset
308 indicator prominent.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
309
Dave Love <fx@gnu.org>
parents:
diff changeset
310 @node Text Display
Dave Love <fx@gnu.org>
parents:
diff changeset
311 @section How Text Is Displayed
Dave Love <fx@gnu.org>
parents:
diff changeset
312 @cindex characters (in text)
Dave Love <fx@gnu.org>
parents:
diff changeset
313
Dave Love <fx@gnu.org>
parents:
diff changeset
314 ASCII printing characters (octal codes 040 through 0176) in Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
315 buffers are displayed with their graphics. So are non-ASCII multibyte
Dave Love <fx@gnu.org>
parents:
diff changeset
316 printing characters (octal codes above 0400).
Dave Love <fx@gnu.org>
parents:
diff changeset
317
Dave Love <fx@gnu.org>
parents:
diff changeset
318 Some ASCII control characters are displayed in special ways. The
Dave Love <fx@gnu.org>
parents:
diff changeset
319 newline character (octal code 012) is displayed by starting a new line.
Dave Love <fx@gnu.org>
parents:
diff changeset
320 The tab character (octal code 011) is displayed by moving to the next
Dave Love <fx@gnu.org>
parents:
diff changeset
321 tab stop column (normally every 8 columns).
Dave Love <fx@gnu.org>
parents:
diff changeset
322
Dave Love <fx@gnu.org>
parents:
diff changeset
323 Other ASCII control characters are normally displayed as a caret
Dave Love <fx@gnu.org>
parents:
diff changeset
324 (@samp{^}) followed by the non-control version of the character; thus,
Dave Love <fx@gnu.org>
parents:
diff changeset
325 control-A is displayed as @samp{^A}.
Dave Love <fx@gnu.org>
parents:
diff changeset
326
33744
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
327 Non-ASCII characters 0200 through 0237 (octal) are displayed with
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
328 octal escape sequences; thus, character code 0230 (octal) is displayed
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
329 as @samp{\230}. The display of character codes 0240 through 0377
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
330 (octal) may be either as escape sequences or as graphics. They do not
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
331 normally occur in multibyte buffers but if they do, they are displayed
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
332 as Latin-1 graphics. In unibyte mode, if you enable European display
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
333 they are displayed using their graphics (assuming your terminal supports
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
334 them), otherwise as escape sequences. @xref{Single-Byte Character
67204e92850a Tweak non-ASCII display.
Dave Love <fx@gnu.org>
parents: 33730
diff changeset
335 Support}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
336
Dave Love <fx@gnu.org>
parents:
diff changeset
337 @node Display Vars
Dave Love <fx@gnu.org>
parents:
diff changeset
338 @section Variables Controlling Display
Dave Love <fx@gnu.org>
parents:
diff changeset
339
Dave Love <fx@gnu.org>
parents:
diff changeset
340 This section contains information for customization only. Beginning
Dave Love <fx@gnu.org>
parents:
diff changeset
341 users should skip it.
Dave Love <fx@gnu.org>
parents:
diff changeset
342
Dave Love <fx@gnu.org>
parents:
diff changeset
343 @vindex mode-line-inverse-video
33730
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
344 The variable @code{mode-line-inverse-video} is an obsolete way of
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
345 controlling whether the mode line is displayed in inverse video; the
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
346 preferred way of doing this is to change the @code{mode-line} face.
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
347 @xref{Mode Line}. If you specify the foreground color for the
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
348 @code{mode-line} face, and @code{mode-line-inverse-video} is
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
349 non-@code{nil}, then the default background color for that face is the
055f3e6bf32c (Display Vars): Note that `mode-line-inverse-video' is deprecated.
Miles Bader <miles@gnu.org>
parents: 32624
diff changeset
350 usual foreground color. @xref{Faces}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
351
Dave Love <fx@gnu.org>
parents:
diff changeset
352 @vindex inverse-video
Dave Love <fx@gnu.org>
parents:
diff changeset
353 If the variable @code{inverse-video} is non-@code{nil}, Emacs attempts
Dave Love <fx@gnu.org>
parents:
diff changeset
354 to invert all the lines of the display from what they normally are.
Dave Love <fx@gnu.org>
parents:
diff changeset
355
Dave Love <fx@gnu.org>
parents:
diff changeset
356 @vindex visible-bell
Dave Love <fx@gnu.org>
parents:
diff changeset
357 If the variable @code{visible-bell} is non-@code{nil}, Emacs attempts
Dave Love <fx@gnu.org>
parents:
diff changeset
358 to make the whole screen blink when it would normally make an audible bell
Dave Love <fx@gnu.org>
parents:
diff changeset
359 sound. This variable has no effect if your terminal does not have a way
Dave Love <fx@gnu.org>
parents:
diff changeset
360 to make the screen blink.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
361
Dave Love <fx@gnu.org>
parents:
diff changeset
362 @vindex no-redraw-on-reenter
Dave Love <fx@gnu.org>
parents:
diff changeset
363 When you reenter Emacs after suspending, Emacs normally clears the
Dave Love <fx@gnu.org>
parents:
diff changeset
364 screen and redraws the entire display. On some terminals with more than
Dave Love <fx@gnu.org>
parents:
diff changeset
365 one page of memory, it is possible to arrange the termcap entry so that
Dave Love <fx@gnu.org>
parents:
diff changeset
366 the @samp{ti} and @samp{te} strings (output to the terminal when Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
367 is entered and exited, respectively) switch between pages of memory so
Dave Love <fx@gnu.org>
parents:
diff changeset
368 as to use one page for Emacs and another page for other output. Then
Dave Love <fx@gnu.org>
parents:
diff changeset
369 you might want to set the variable @code{no-redraw-on-reenter}
Dave Love <fx@gnu.org>
parents:
diff changeset
370 non-@code{nil}; this tells Emacs to assume, when resumed, that the
Dave Love <fx@gnu.org>
parents:
diff changeset
371 screen page it is using still contains what Emacs last wrote there.
Dave Love <fx@gnu.org>
parents:
diff changeset
372
Dave Love <fx@gnu.org>
parents:
diff changeset
373 @vindex echo-keystrokes
Dave Love <fx@gnu.org>
parents:
diff changeset
374 The variable @code{echo-keystrokes} controls the echoing of multi-character
Dave Love <fx@gnu.org>
parents:
diff changeset
375 keys; its value is the number of seconds of pause required to cause echoing
Dave Love <fx@gnu.org>
parents:
diff changeset
376 to start, or zero meaning don't echo at all. @xref{Echo Area}.
Dave Love <fx@gnu.org>
parents:
diff changeset
377
Dave Love <fx@gnu.org>
parents:
diff changeset
378 @vindex ctl-arrow
Dave Love <fx@gnu.org>
parents:
diff changeset
379 If the variable @code{ctl-arrow} is @code{nil}, control characters in
Dave Love <fx@gnu.org>
parents:
diff changeset
380 the buffer are displayed with octal escape sequences, except for newline
Dave Love <fx@gnu.org>
parents:
diff changeset
381 and tab. Altering the value of @code{ctl-arrow} makes it local to the
Dave Love <fx@gnu.org>
parents:
diff changeset
382 current buffer; until that time, the default value is in effect. The
Dave Love <fx@gnu.org>
parents:
diff changeset
383 default is initially @code{t}. @xref{Display Tables,, Display Tables,
Dave Love <fx@gnu.org>
parents:
diff changeset
384 elisp, The Emacs Lisp Reference Manual}.
Dave Love <fx@gnu.org>
parents:
diff changeset
385
Dave Love <fx@gnu.org>
parents:
diff changeset
386 @vindex tab-width
Dave Love <fx@gnu.org>
parents:
diff changeset
387 Normally, a tab character in the buffer is displayed as whitespace which
Dave Love <fx@gnu.org>
parents:
diff changeset
388 extends to the next display tab stop position, and display tab stops come
Dave Love <fx@gnu.org>
parents:
diff changeset
389 at intervals equal to eight spaces. The number of spaces per tab is
Dave Love <fx@gnu.org>
parents:
diff changeset
390 controlled by the variable @code{tab-width}, which is made local by
Dave Love <fx@gnu.org>
parents:
diff changeset
391 changing it, just like @code{ctl-arrow}. Note that how the tab character
Dave Love <fx@gnu.org>
parents:
diff changeset
392 in the buffer is displayed has nothing to do with the definition of
Dave Love <fx@gnu.org>
parents:
diff changeset
393 @key{TAB} as a command. The variable @code{tab-width} must have an
Dave Love <fx@gnu.org>
parents:
diff changeset
394 integer value between 1 and 1000, inclusive.
Dave Love <fx@gnu.org>
parents:
diff changeset
395
Dave Love <fx@gnu.org>
parents:
diff changeset
396 @c @vindex truncate-lines @c No index entry here, because we have one
Dave Love <fx@gnu.org>
parents:
diff changeset
397 @c in the continuation section.
Dave Love <fx@gnu.org>
parents:
diff changeset
398 If the variable @code{truncate-lines} is non-@code{nil}, then each
Dave Love <fx@gnu.org>
parents:
diff changeset
399 line of text gets just one screen line for display; if the text line is
Dave Love <fx@gnu.org>
parents:
diff changeset
400 too long, display shows only the part that fits. If
Dave Love <fx@gnu.org>
parents:
diff changeset
401 @code{truncate-lines} is @code{nil}, then long text lines display as
Dave Love <fx@gnu.org>
parents:
diff changeset
402 more than one screen line, enough to show the whole text of the line.
Dave Love <fx@gnu.org>
parents:
diff changeset
403 @xref{Continuation Lines}. Altering the value of @code{truncate-lines}
Dave Love <fx@gnu.org>
parents:
diff changeset
404 makes it local to the current buffer; until that time, the default value
Dave Love <fx@gnu.org>
parents:
diff changeset
405 is in effect. The default is initially @code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
406
Dave Love <fx@gnu.org>
parents:
diff changeset
407 @c @vindex truncate-partial-width-windows @c Idx entry is in Split Windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
408 If the variable @code{truncate-partial-width-windows} is
Dave Love <fx@gnu.org>
parents:
diff changeset
409 non-@code{nil}, it forces truncation rather than continuation in any
Dave Love <fx@gnu.org>
parents:
diff changeset
410 window less than the full width of the screen or frame, regardless of
Dave Love <fx@gnu.org>
parents:
diff changeset
411 the value of @code{truncate-lines}. For information about side-by-side
Dave Love <fx@gnu.org>
parents:
diff changeset
412 windows, see @ref{Split Window}. See also @ref{Display,, Display,
Dave Love <fx@gnu.org>
parents:
diff changeset
413 elisp, The Emacs Lisp Reference Manual}.
Dave Love <fx@gnu.org>
parents:
diff changeset
414
Dave Love <fx@gnu.org>
parents:
diff changeset
415 @vindex baud-rate
32624
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
416 The variable @code{baud-rate} holds the output speed of the terminal,
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
417 as far as Emacs knows. Setting this variable does not change the speed
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
418 of actual data transmission, but the value is used for calculations such
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
419 as padding. On terminals, it also affects decisions about whether to
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
420 scroll part of the screen or redraw it instead.
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
421
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
422 On window-systems, @code{baud-rate} is only used to determine how
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
423 frequently to look for pending input during display updating. A higher
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
424 value of @code{baud-rate} means that check for pending input will be
cc6228b81571 (Display Vars): Fix description of the role of
Gerd Moellmann <gerd@gnu.org>
parents: 31188
diff changeset
425 done less frequently.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
426
Dave Love <fx@gnu.org>
parents:
diff changeset
427 You can customize the way any particular character code is displayed
Dave Love <fx@gnu.org>
parents:
diff changeset
428 by means of a display table. @xref{Display Tables,, Display Tables,
Dave Love <fx@gnu.org>
parents:
diff changeset
429 elisp, The Emacs Lisp Reference Manual}.