annotate man/screen.texi @ 40952:2ca1b56f3bb1

Indent properly `generic-flet', `generic-labels', `with-accessors', `with-condition-restarts'.
author Sam Steingold <sds@gnu.org>
date Mon, 12 Nov 2001 19:58:33 +0000
parents 3b40423b9355
children d91a628dadfe
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.
39287
3b40423b9355 Update the copyright years.
Eli Zaretskii <eliz@gnu.org>
parents: 39268
diff changeset
2 @c Copyright (C) 1985,86,87,93,94,95,1997,2001 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 Screen, User Input, Acknowledgments, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @chapter The Organization of the Screen
Dave Love <fx@gnu.org>
parents:
diff changeset
6 @cindex screen
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @cindex parts of the screen
Dave Love <fx@gnu.org>
parents:
diff changeset
8 @c
Dave Love <fx@gnu.org>
parents:
diff changeset
9
Dave Love <fx@gnu.org>
parents:
diff changeset
10 On a text-only terminal, the Emacs display occupies the whole screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
11 On the X Window System, Emacs creates its own X windows to use. We use
Dave Love <fx@gnu.org>
parents:
diff changeset
12 the term @dfn{frame} to mean an entire text-only screen or an entire X
Dave Love <fx@gnu.org>
parents:
diff changeset
13 window used by Emacs. Emacs uses both kinds of frames in the same way
Dave Love <fx@gnu.org>
parents:
diff changeset
14 to display your editing. Emacs normally starts out with just one frame,
Dave Love <fx@gnu.org>
parents:
diff changeset
15 but you can create additional frames if you wish. @xref{Frames}.
Dave Love <fx@gnu.org>
parents:
diff changeset
16
37350
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
17 When you start Emacs, the entire frame except for the top and bottom
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
18 is devoted to the text you are editing. This area is called the
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
19 @dfn{window}. At the top there is normally a @dfn{menu bar} where you
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
20 can access a series of menus; then there may be a @dfn{tool bar}, a
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
21 row of icons that perform editing commands if you click on them.
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
22 Below this, the window begins. The last line is a special @dfn{echo
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
23 area} or @dfn{minibuffer window}, where prompts appear and where you
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
24 can enter information when Emacs asks for it. See below for more
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
25 information about these special lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
26
Dave Love <fx@gnu.org>
parents:
diff changeset
27 You can subdivide the large text window horizontally or vertically
Dave Love <fx@gnu.org>
parents:
diff changeset
28 into multiple text windows, each of which can be used for a different
Dave Love <fx@gnu.org>
parents:
diff changeset
29 file (@pxref{Windows}). In this manual, the word ``window'' always
Dave Love <fx@gnu.org>
parents:
diff changeset
30 refers to the subdivisions of a frame within Emacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
31
Dave Love <fx@gnu.org>
parents:
diff changeset
32 The window that the cursor is in is the @dfn{selected window}, in
Dave Love <fx@gnu.org>
parents:
diff changeset
33 which editing takes place. Most Emacs commands implicitly apply to the
Dave Love <fx@gnu.org>
parents:
diff changeset
34 text in the selected window (though mouse commands generally operate on
Dave Love <fx@gnu.org>
parents:
diff changeset
35 whatever window you click them in, whether selected or not). The other
Dave Love <fx@gnu.org>
parents:
diff changeset
36 windows display text for reference only, unless/until you select them.
Dave Love <fx@gnu.org>
parents:
diff changeset
37 If you use multiple frames under the X Window System, then giving the
Dave Love <fx@gnu.org>
parents:
diff changeset
38 input focus to a particular frame selects a window in that frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
39
37350
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
40 Each window's last line is a @dfn{mode line}, which describes what
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
41 is going on in that window. It appears in inverse video, if the
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
42 terminal supports that; its contents normally begin with
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
43 @w{@samp{--:-- @ *scratch*}} when Emacs starts. The mode line
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
44 displays status information such as what buffer is being displayed
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
45 above it in the window, what major and minor modes are in use, and
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
46 whether the buffer contains unsaved changes.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
47
Dave Love <fx@gnu.org>
parents:
diff changeset
48 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
49 * Point:: The place in the text where editing commands operate.
Dave Love <fx@gnu.org>
parents:
diff changeset
50 * Echo Area:: Short messages appear at the bottom of the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
51 * Mode Line:: Interpreting the mode line.
Dave Love <fx@gnu.org>
parents:
diff changeset
52 * Menu Bar:: How to use the menu bar.
Dave Love <fx@gnu.org>
parents:
diff changeset
53 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
54
Dave Love <fx@gnu.org>
parents:
diff changeset
55 @node Point
Dave Love <fx@gnu.org>
parents:
diff changeset
56 @section Point
Dave Love <fx@gnu.org>
parents:
diff changeset
57 @cindex point
Dave Love <fx@gnu.org>
parents:
diff changeset
58 @cindex cursor
Dave Love <fx@gnu.org>
parents:
diff changeset
59
Dave Love <fx@gnu.org>
parents:
diff changeset
60 Within Emacs, the terminal's cursor shows the location at which
Dave Love <fx@gnu.org>
parents:
diff changeset
61 editing commands will take effect. This location is called @dfn{point}.
Dave Love <fx@gnu.org>
parents:
diff changeset
62 Many Emacs commands move point through the text, so that you can edit at
Dave Love <fx@gnu.org>
parents:
diff changeset
63 different places in it. You can also place point by clicking mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
64 button 1.
Dave Love <fx@gnu.org>
parents:
diff changeset
65
Dave Love <fx@gnu.org>
parents:
diff changeset
66 While the cursor appears to point @emph{at} a character, you should
Dave Love <fx@gnu.org>
parents:
diff changeset
67 think of point as @emph{between} two characters; it points @emph{before}
Dave Love <fx@gnu.org>
parents:
diff changeset
68 the character that appears under the cursor. For example, if your text
Dave Love <fx@gnu.org>
parents:
diff changeset
69 looks like @samp{frob} with the cursor over the @samp{b}, then point is
Dave Love <fx@gnu.org>
parents:
diff changeset
70 between the @samp{o} and the @samp{b}. If you insert the character
Dave Love <fx@gnu.org>
parents:
diff changeset
71 @samp{!} at that position, the result is @samp{fro!b}, with point
Dave Love <fx@gnu.org>
parents:
diff changeset
72 between the @samp{!} and the @samp{b}. Thus, the cursor remains over
Dave Love <fx@gnu.org>
parents:
diff changeset
73 the @samp{b}, as before.
Dave Love <fx@gnu.org>
parents:
diff changeset
74
Dave Love <fx@gnu.org>
parents:
diff changeset
75 Sometimes people speak of ``the cursor'' when they mean ``point,'' or
Dave Love <fx@gnu.org>
parents:
diff changeset
76 speak of commands that move point as ``cursor motion'' commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
77
39164
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
78 Text-only terminals have only one cursor, and when output is in
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
79 progress it must appear where the output is being displayed. This
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
80 does not mean that point is moving. It is only that Emacs has no way
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
81 to show you the location of point except when the terminal is idle.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
82
Dave Love <fx@gnu.org>
parents:
diff changeset
83 If you are editing several files in Emacs, each in its own buffer,
Dave Love <fx@gnu.org>
parents:
diff changeset
84 each buffer has its own point location. A buffer that is not currently
Dave Love <fx@gnu.org>
parents:
diff changeset
85 displayed remembers where point is in case you display it again later.
Dave Love <fx@gnu.org>
parents:
diff changeset
86
39164
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
87 When Emacs displays multiple windows, each window has its own point
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
88 location. On text-only terminals, the cursor shows the location of
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
89 point in the selected window. On graphical terminals, Emacs shows a
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
90 cursor in each window; the selected window's cursor is solid, and the
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
91 other cursors are hollow. Either way, the cursor or cursors tell you
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
92 which window is selected. If the same buffer appears in more than one
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
93 window, each window has its own position for point in that buffer, and
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
94 (when possible) its own cursor.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
95
39164
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
96 @xref{Cursor Display}, for customization options that control display
ecf35d2638f4 Explain about multiple cursors.
Richard M. Stallman <rms@gnu.org>
parents: 38870
diff changeset
97 of the cursor or cursors.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
98
36185
62cf166239f3 Change in quoting.
Richard M. Stallman <rms@gnu.org>
parents: 36174
diff changeset
99 The term ``point'' comes from the character @samp{.}, which was the
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
100 command in TECO (the language in which the original Emacs was written)
36185
62cf166239f3 Change in quoting.
Richard M. Stallman <rms@gnu.org>
parents: 36174
diff changeset
101 for accessing the value now called ``point.''
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
102
Dave Love <fx@gnu.org>
parents:
diff changeset
103 @node Echo Area
Dave Love <fx@gnu.org>
parents:
diff changeset
104 @section The Echo Area
Dave Love <fx@gnu.org>
parents:
diff changeset
105 @cindex echo area
Dave Love <fx@gnu.org>
parents:
diff changeset
106 @c
Dave Love <fx@gnu.org>
parents:
diff changeset
107
Dave Love <fx@gnu.org>
parents:
diff changeset
108 The line at the bottom of the frame (below the mode line) is the
Dave Love <fx@gnu.org>
parents:
diff changeset
109 @dfn{echo area}. It is used to display small amounts of text for
Dave Love <fx@gnu.org>
parents:
diff changeset
110 several purposes.
Dave Love <fx@gnu.org>
parents:
diff changeset
111
Dave Love <fx@gnu.org>
parents:
diff changeset
112 @dfn{Echoing} means displaying the characters that you type. Outside
Dave Love <fx@gnu.org>
parents:
diff changeset
113 Emacs, the operating system normally echoes all your input. Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
114 handles echoing differently.
Dave Love <fx@gnu.org>
parents:
diff changeset
115
Dave Love <fx@gnu.org>
parents:
diff changeset
116 Single-character commands do not echo in Emacs, and multi-character
Dave Love <fx@gnu.org>
parents:
diff changeset
117 commands echo only if you pause while typing them. As soon as you pause
Dave Love <fx@gnu.org>
parents:
diff changeset
118 for more than a second in the middle of a command, Emacs echoes all the
Dave Love <fx@gnu.org>
parents:
diff changeset
119 characters of the command so far. This is to @dfn{prompt} you for the
Dave Love <fx@gnu.org>
parents:
diff changeset
120 rest of the command. Once echoing has started, the rest of the command
Dave Love <fx@gnu.org>
parents:
diff changeset
121 echoes immediately as you type it. This behavior is designed to give
Dave Love <fx@gnu.org>
parents:
diff changeset
122 confident users fast response, while giving hesitant users maximum
Dave Love <fx@gnu.org>
parents:
diff changeset
123 feedback. You can change this behavior by setting a variable
36209
e80f51792a09 Fix xref to Display Custom.
Richard M. Stallman <rms@gnu.org>
parents: 36185
diff changeset
124 (@pxref{Display Custom}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
125
Dave Love <fx@gnu.org>
parents:
diff changeset
126 @cindex error message in the echo area
38870
d44abb4e68b2 Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents: 38128
diff changeset
127 If a command cannot be executed, it may display an @dfn{error message}
38128
67a7dd5130d0 Minor fixes.
Richard M. Stallman <rms@gnu.org>
parents: 37986
diff changeset
128 in the echo area. Error messages are accompanied by beeping or by
67a7dd5130d0 Minor fixes.
Richard M. Stallman <rms@gnu.org>
parents: 37986
diff changeset
129 flashing the screen. The error also discards any input you have typed
67a7dd5130d0 Minor fixes.
Richard M. Stallman <rms@gnu.org>
parents: 37986
diff changeset
130 ahead.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
131
38870
d44abb4e68b2 Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents: 38128
diff changeset
132 Some commands display informative messages in the echo area. These
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
133 messages look much like error messages, but they are not announced with
Dave Love <fx@gnu.org>
parents:
diff changeset
134 a beep and do not throw away input. Sometimes the message tells you
Dave Love <fx@gnu.org>
parents:
diff changeset
135 what the command has done, when this is not obvious from looking at the
38870
d44abb4e68b2 Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents: 38128
diff changeset
136 text being edited. Sometimes the sole purpose of a command is to show
d44abb4e68b2 Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents: 38128
diff changeset
137 you a message giving you specific information---for example, @kbd{C-x =}
d44abb4e68b2 Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents: 38128
diff changeset
138 displays a message describing the character position of point in the text
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
139 and its current column in the window. Commands that take a long time
Dave Love <fx@gnu.org>
parents:
diff changeset
140 often display messages ending in @samp{...} while they are working, and
Dave Love <fx@gnu.org>
parents:
diff changeset
141 add @samp{done} at the end when they are finished.
Dave Love <fx@gnu.org>
parents:
diff changeset
142
Dave Love <fx@gnu.org>
parents:
diff changeset
143 @cindex @samp{*Messages*} buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
144 @cindex saved echo area messages
Dave Love <fx@gnu.org>
parents:
diff changeset
145 @cindex messages saved from echo area
Dave Love <fx@gnu.org>
parents:
diff changeset
146 Echo-area informative messages are saved in an editor buffer named
Dave Love <fx@gnu.org>
parents:
diff changeset
147 @samp{*Messages*}. (We have not explained buffers yet; see
Dave Love <fx@gnu.org>
parents:
diff changeset
148 @ref{Buffers}, for more information about them.) If you miss a message
Dave Love <fx@gnu.org>
parents:
diff changeset
149 that appears briefly on the screen, you can switch to the
Dave Love <fx@gnu.org>
parents:
diff changeset
150 @samp{*Messages*} buffer to see it again. (Successive progress messages
Dave Love <fx@gnu.org>
parents:
diff changeset
151 are often collapsed into one in that buffer.)
Dave Love <fx@gnu.org>
parents:
diff changeset
152
Dave Love <fx@gnu.org>
parents:
diff changeset
153 @vindex message-log-max
Dave Love <fx@gnu.org>
parents:
diff changeset
154 The size of @samp{*Messages*} is limited to a certain number of lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
155 The variable @code{message-log-max} specifies how many lines. Once the
Dave Love <fx@gnu.org>
parents:
diff changeset
156 buffer has that many lines, each line added at the end deletes one line
Dave Love <fx@gnu.org>
parents:
diff changeset
157 from the beginning. @xref{Variables}, for how to set variables such as
Dave Love <fx@gnu.org>
parents:
diff changeset
158 @code{message-log-max}.
Dave Love <fx@gnu.org>
parents:
diff changeset
159
Dave Love <fx@gnu.org>
parents:
diff changeset
160 The echo area is also used to display the @dfn{minibuffer}, a window that
Dave Love <fx@gnu.org>
parents:
diff changeset
161 is used for reading arguments to commands, such as the name of a file to be
Dave Love <fx@gnu.org>
parents:
diff changeset
162 edited. When the minibuffer is in use, the echo area begins with a prompt
Dave Love <fx@gnu.org>
parents:
diff changeset
163 string that usually ends with a colon; also, the cursor appears in that line
Dave Love <fx@gnu.org>
parents:
diff changeset
164 because it is the selected window. You can always get out of the
Dave Love <fx@gnu.org>
parents:
diff changeset
165 minibuffer by typing @kbd{C-g}. @xref{Minibuffer}.
Dave Love <fx@gnu.org>
parents:
diff changeset
166
Dave Love <fx@gnu.org>
parents:
diff changeset
167 @node Mode Line
Dave Love <fx@gnu.org>
parents:
diff changeset
168 @section The Mode Line
Dave Love <fx@gnu.org>
parents:
diff changeset
169 @cindex mode line
Dave Love <fx@gnu.org>
parents:
diff changeset
170 @cindex top level
Dave Love <fx@gnu.org>
parents:
diff changeset
171 @c
Dave Love <fx@gnu.org>
parents:
diff changeset
172
36174
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
173 Each text window's last line is a @dfn{mode line}, which describes
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
174 what is going on in that window. When there is only one text window,
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
175 the mode line appears right above the echo area; it is the
37350
401a53e249b5 Mention the tool bar. Clarify what the mode line looks like.
Richard M. Stallman <rms@gnu.org>
parents: 36209
diff changeset
176 next-to-last line in the frame. The mode line starts and ends with
36174
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
177 dashes. On a text-mode display, the mode line is in inverse video if
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
178 the terminal supports that; on a graphics display, the mode line has a
39268
5a3dae2132b4 Spelling correction.
Richard M. Stallman <rms@gnu.org>
parents: 39164
diff changeset
179 3D box appearance to help it stand out.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
180
Dave Love <fx@gnu.org>
parents:
diff changeset
181 Normally, the mode line looks like this:
Dave Love <fx@gnu.org>
parents:
diff changeset
182
Dave Love <fx@gnu.org>
parents:
diff changeset
183 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
184 -@var{cs}:@var{ch} @var{buf} (@var{major} @var{minor})--@var{line}--@var{pos}------
Dave Love <fx@gnu.org>
parents:
diff changeset
185 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
186
Dave Love <fx@gnu.org>
parents:
diff changeset
187 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
188 This gives information about the buffer being displayed in the window: the
Dave Love <fx@gnu.org>
parents:
diff changeset
189 buffer's name, what major and minor modes are in use, whether the buffer's
Dave Love <fx@gnu.org>
parents:
diff changeset
190 text has been changed, and how far down the buffer you are currently
Dave Love <fx@gnu.org>
parents:
diff changeset
191 looking.
Dave Love <fx@gnu.org>
parents:
diff changeset
192
Dave Love <fx@gnu.org>
parents:
diff changeset
193 @var{ch} contains two stars @samp{**} if the text in the buffer has
Dave Love <fx@gnu.org>
parents:
diff changeset
194 been edited (the buffer is ``modified''), or @samp{--} if the buffer has
Dave Love <fx@gnu.org>
parents:
diff changeset
195 not been edited. For a read-only buffer, it is @samp{%*} if the buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
196 is modified, and @samp{%%} otherwise.
Dave Love <fx@gnu.org>
parents:
diff changeset
197
Dave Love <fx@gnu.org>
parents:
diff changeset
198 @var{buf} is the name of the window's @dfn{buffer}. In most cases
Dave Love <fx@gnu.org>
parents:
diff changeset
199 this is the same as the name of a file you are editing. @xref{Buffers}.
Dave Love <fx@gnu.org>
parents:
diff changeset
200
Dave Love <fx@gnu.org>
parents:
diff changeset
201 The buffer displayed in the selected window (the window that the
37986
e11682cc1516 selected buffer => current buffer.
Richard M. Stallman <rms@gnu.org>
parents: 37350
diff changeset
202 cursor is in) is also Emacs's current buffer, the one that editing
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
203 takes place in. When we speak of what some command does to ``the
37986
e11682cc1516 selected buffer => current buffer.
Richard M. Stallman <rms@gnu.org>
parents: 37350
diff changeset
204 buffer,'' we are talking about the current buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
205
Dave Love <fx@gnu.org>
parents:
diff changeset
206 @var{line} is @samp{L} followed by the current line number of point.
Dave Love <fx@gnu.org>
parents:
diff changeset
207 This is present when Line Number mode is enabled (which it normally is).
Dave Love <fx@gnu.org>
parents:
diff changeset
208 You can optionally display the current column number too, by turning on
Dave Love <fx@gnu.org>
parents:
diff changeset
209 Column Number mode (which is not enabled by default because it is
Dave Love <fx@gnu.org>
parents:
diff changeset
210 somewhat slower). @xref{Optional Mode Line}.
Dave Love <fx@gnu.org>
parents:
diff changeset
211
Dave Love <fx@gnu.org>
parents:
diff changeset
212 @var{pos} tells you whether there is additional text above the top of
Dave Love <fx@gnu.org>
parents:
diff changeset
213 the window, or below the bottom. If your buffer is small and it is all
Dave Love <fx@gnu.org>
parents:
diff changeset
214 visible in the window, @var{pos} is @samp{All}. Otherwise, it is
Dave Love <fx@gnu.org>
parents:
diff changeset
215 @samp{Top} if you are looking at the beginning of the buffer, @samp{Bot}
Dave Love <fx@gnu.org>
parents:
diff changeset
216 if you are looking at the end of the buffer, or @samp{@var{nn}%}, where
Dave Love <fx@gnu.org>
parents:
diff changeset
217 @var{nn} is the percentage of the buffer above the top of the
Dave Love <fx@gnu.org>
parents:
diff changeset
218 window.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
219
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @var{major} is the name of the @dfn{major mode} in effect in the
Dave Love <fx@gnu.org>
parents:
diff changeset
221 buffer. At any time, each buffer is in one and only one of the possible
Dave Love <fx@gnu.org>
parents:
diff changeset
222 major modes. The major modes available include Fundamental mode (the
Dave Love <fx@gnu.org>
parents:
diff changeset
223 least specialized), Text mode, Lisp mode, C mode, Texinfo mode, and many
Dave Love <fx@gnu.org>
parents:
diff changeset
224 others. @xref{Major Modes}, for details of how the modes differ and how
Dave Love <fx@gnu.org>
parents:
diff changeset
225 to select one.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
226
Dave Love <fx@gnu.org>
parents:
diff changeset
227 Some major modes display additional information after the major mode
Dave Love <fx@gnu.org>
parents:
diff changeset
228 name. For example, Rmail buffers display the current message number and
Dave Love <fx@gnu.org>
parents:
diff changeset
229 the total number of messages. Compilation buffers and Shell buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
230 display the status of the subprocess.
Dave Love <fx@gnu.org>
parents:
diff changeset
231
Dave Love <fx@gnu.org>
parents:
diff changeset
232 @var{minor} is a list of some of the @dfn{minor modes} that are turned
Dave Love <fx@gnu.org>
parents:
diff changeset
233 on at the moment in the window's chosen buffer. For example,
Dave Love <fx@gnu.org>
parents:
diff changeset
234 @samp{Fill} means that Auto Fill mode is on. @samp{Abbrev} means that
Dave Love <fx@gnu.org>
parents:
diff changeset
235 Word Abbrev mode is on. @samp{Ovwrt} means that Overwrite mode is on.
Dave Love <fx@gnu.org>
parents:
diff changeset
236 @xref{Minor Modes}, for more information. @samp{Narrow} means that the
Dave Love <fx@gnu.org>
parents:
diff changeset
237 buffer being displayed has editing restricted to only a portion of its
Dave Love <fx@gnu.org>
parents:
diff changeset
238 text. This is not really a minor mode, but is like one.
Dave Love <fx@gnu.org>
parents:
diff changeset
239 @xref{Narrowing}. @samp{Def} means that a keyboard macro is being
Dave Love <fx@gnu.org>
parents:
diff changeset
240 defined. @xref{Keyboard Macros}.
Dave Love <fx@gnu.org>
parents:
diff changeset
241
Dave Love <fx@gnu.org>
parents:
diff changeset
242 In addition, if Emacs is currently inside a recursive editing level,
Dave Love <fx@gnu.org>
parents:
diff changeset
243 square brackets (@samp{[@dots{}]}) appear around the parentheses that
Dave Love <fx@gnu.org>
parents:
diff changeset
244 surround the modes. If Emacs is in one recursive editing level within
Dave Love <fx@gnu.org>
parents:
diff changeset
245 another, double square brackets appear, and so on. Since recursive
Dave Love <fx@gnu.org>
parents:
diff changeset
246 editing levels affect Emacs globally, not just one buffer, the square
Dave Love <fx@gnu.org>
parents:
diff changeset
247 brackets appear in every window's mode line or not in any of them.
Dave Love <fx@gnu.org>
parents:
diff changeset
248 @xref{Recursive Edit}.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
249
Dave Love <fx@gnu.org>
parents:
diff changeset
250 Non-windowing terminals can only show a single Emacs frame at a time
Dave Love <fx@gnu.org>
parents:
diff changeset
251 (@pxref{Frames}). On such terminals, the mode line displays the name of
Dave Love <fx@gnu.org>
parents:
diff changeset
252 the selected frame, after @var{ch}. The initial frame's name is
Dave Love <fx@gnu.org>
parents:
diff changeset
253 @samp{F1}.
Dave Love <fx@gnu.org>
parents:
diff changeset
254
Dave Love <fx@gnu.org>
parents:
diff changeset
255 @var{cs} states the coding system used for the file you are editing.
Dave Love <fx@gnu.org>
parents:
diff changeset
256 A dash indicates the default state of affairs: no code conversion,
Dave Love <fx@gnu.org>
parents:
diff changeset
257 except for end-of-line translation if the file contents call for that.
Dave Love <fx@gnu.org>
parents:
diff changeset
258 @samp{=} means no conversion whatsoever. Nontrivial code conversions
Dave Love <fx@gnu.org>
parents:
diff changeset
259 are represented by various letters---for example, @samp{1} refers to ISO
Dave Love <fx@gnu.org>
parents:
diff changeset
260 Latin-1. @xref{Coding Systems}, for more information. If you are using
Dave Love <fx@gnu.org>
parents:
diff changeset
261 an input method, a string of the form @samp{@var{i}>} is added to the
Dave Love <fx@gnu.org>
parents:
diff changeset
262 beginning of @var{cs}; @var{i} identifies the input method. (Some input
Dave Love <fx@gnu.org>
parents:
diff changeset
263 methods show @samp{+} or @samp{@@} instead of @samp{>}.) @xref{Input
Dave Love <fx@gnu.org>
parents:
diff changeset
264 Methods}.
Dave Love <fx@gnu.org>
parents:
diff changeset
265
Dave Love <fx@gnu.org>
parents:
diff changeset
266 When you are using a character-only terminal (not a window system),
Dave Love <fx@gnu.org>
parents:
diff changeset
267 @var{cs} uses three characters to describe, respectively, the coding
Dave Love <fx@gnu.org>
parents:
diff changeset
268 system for keyboard input, the coding system for terminal output, and
Dave Love <fx@gnu.org>
parents:
diff changeset
269 the coding system used for the file you are editing.
Dave Love <fx@gnu.org>
parents:
diff changeset
270
Dave Love <fx@gnu.org>
parents:
diff changeset
271 When multibyte characters are not enabled, @var{cs} does not appear at
Dave Love <fx@gnu.org>
parents:
diff changeset
272 all. @xref{Enabling Multibyte}.
Dave Love <fx@gnu.org>
parents:
diff changeset
273
Dave Love <fx@gnu.org>
parents:
diff changeset
274 @cindex end-of-line conversion, mode-line indication
Dave Love <fx@gnu.org>
parents:
diff changeset
275 The colon after @var{cs} can change to another string in certain
30866
aad48d49f25c (Mode Line): xref Mode Line Mouse
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
276 circumstances. Emacs uses newline characters to separate lines in the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
277 Some files use different conventions for separating lines: either
Dave Love <fx@gnu.org>
parents:
diff changeset
278 carriage-return linefeed (the MS-DOS convention) or just carriage-return
Dave Love <fx@gnu.org>
parents:
diff changeset
279 (the Macintosh convention). If the buffer's file uses carriage-return
Dave Love <fx@gnu.org>
parents:
diff changeset
280 linefeed, the colon changes to either a backslash (@samp{\}) or
Dave Love <fx@gnu.org>
parents:
diff changeset
281 @samp{(DOS)}, depending on the operating system. If the file uses just
Dave Love <fx@gnu.org>
parents:
diff changeset
282 carriage-return, the colon indicator changes to either a forward slash
Dave Love <fx@gnu.org>
parents:
diff changeset
283 (@samp{/}) or @samp{(Mac)}. On some systems, Emacs displays
Dave Love <fx@gnu.org>
parents:
diff changeset
284 @samp{(Unix)} instead of the colon even for files that use newline to
Dave Love <fx@gnu.org>
parents:
diff changeset
285 separate lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
286
Dave Love <fx@gnu.org>
parents:
diff changeset
287 @vindex eol-mnemonic-unix
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @vindex eol-mnemonic-dos
Dave Love <fx@gnu.org>
parents:
diff changeset
289 @vindex eol-mnemonic-mac
Dave Love <fx@gnu.org>
parents:
diff changeset
290 @vindex eol-mnemonic-undecided
Dave Love <fx@gnu.org>
parents:
diff changeset
291 You can customize the mode line display for each of the end-of-line
Dave Love <fx@gnu.org>
parents:
diff changeset
292 formats by setting each of the variables @code{eol-mnemonic-unix},
Dave Love <fx@gnu.org>
parents:
diff changeset
293 @code{eol-mnemonic-dos}, @code{eol-mnemonic-mac}, and
Dave Love <fx@gnu.org>
parents:
diff changeset
294 @code{eol-mnemonic-undecided} to any string you find appropriate.
38128
67a7dd5130d0 Minor fixes.
Richard M. Stallman <rms@gnu.org>
parents: 37986
diff changeset
295 @xref{Variables}, for an explanation of how to set variables.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
296
Dave Love <fx@gnu.org>
parents:
diff changeset
297 @xref{Optional Mode Line}, for features that add other handy
Dave Love <fx@gnu.org>
parents:
diff changeset
298 information to the mode line, such as the current column number of
Dave Love <fx@gnu.org>
parents:
diff changeset
299 point, the current time, and whether new mail for you has arrived.
Dave Love <fx@gnu.org>
parents:
diff changeset
300
36174
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
301 The mode line is mouse-sensitive; when you move the mouse across
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
302 various parts of it, Emacs displays help text to say what a click in
19101dffc5c1 Don't say that the mode line is taller, because we are fixing that.
Richard M. Stallman <rms@gnu.org>
parents: 35434
diff changeset
303 that place will do. @xref{Mode Line Mouse}.
30866
aad48d49f25c (Mode Line): xref Mode Line Mouse
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
304
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
305 @node Menu Bar
Dave Love <fx@gnu.org>
parents:
diff changeset
306 @section The Menu Bar
Dave Love <fx@gnu.org>
parents:
diff changeset
307 @cindex menu bar
Dave Love <fx@gnu.org>
parents:
diff changeset
308
Dave Love <fx@gnu.org>
parents:
diff changeset
309 Each Emacs frame normally has a @dfn{menu bar} at the top which you
Dave Love <fx@gnu.org>
parents:
diff changeset
310 can use to perform certain common operations. There's no need to list
Dave Love <fx@gnu.org>
parents:
diff changeset
311 them here, as you can more easily see for yourself.
Dave Love <fx@gnu.org>
parents:
diff changeset
312
Dave Love <fx@gnu.org>
parents:
diff changeset
313 @kindex M-`
Dave Love <fx@gnu.org>
parents:
diff changeset
314 @kindex F10
Dave Love <fx@gnu.org>
parents:
diff changeset
315 @findex tmm-menubar
Dave Love <fx@gnu.org>
parents:
diff changeset
316 When you are using a window system, you can use the mouse to choose a
Dave Love <fx@gnu.org>
parents:
diff changeset
317 command from the menu bar. An arrow pointing right, after the menu
Dave Love <fx@gnu.org>
parents:
diff changeset
318 item, indicates that the item leads to a subsidiary menu; @samp{...} at
Dave Love <fx@gnu.org>
parents:
diff changeset
319 the end means that the command will read arguments from the keyboard
Dave Love <fx@gnu.org>
parents:
diff changeset
320 before it actually does anything.
Dave Love <fx@gnu.org>
parents:
diff changeset
321
Dave Love <fx@gnu.org>
parents:
diff changeset
322 To view the full command name and documentation for a menu item, type
Dave Love <fx@gnu.org>
parents:
diff changeset
323 @kbd{C-h k}, and then select the menu bar with the mouse in the usual
Dave Love <fx@gnu.org>
parents:
diff changeset
324 way (@pxref{Key Help}).
Dave Love <fx@gnu.org>
parents:
diff changeset
325
Dave Love <fx@gnu.org>
parents:
diff changeset
326 On text-only terminals with no mouse, you can use the menu bar by
Dave Love <fx@gnu.org>
parents:
diff changeset
327 typing @kbd{M-`} or @key{F10} (these run the command
Dave Love <fx@gnu.org>
parents:
diff changeset
328 @code{tmm-menubar}). This command enters a mode in which you can select
Dave Love <fx@gnu.org>
parents:
diff changeset
329 a menu item from the keyboard. A provisional choice appears in the echo
Dave Love <fx@gnu.org>
parents:
diff changeset
330 area. You can use the left and right arrow keys to move through the
Dave Love <fx@gnu.org>
parents:
diff changeset
331 menu to different choices. When you have found the choice you want,
Dave Love <fx@gnu.org>
parents:
diff changeset
332 type @key{RET} to select it.
Dave Love <fx@gnu.org>
parents:
diff changeset
333
Dave Love <fx@gnu.org>
parents:
diff changeset
334 Each menu item also has an assigned letter or digit which designates
Dave Love <fx@gnu.org>
parents:
diff changeset
335 that item; it is usually the initial of some word in the item's name.
Dave Love <fx@gnu.org>
parents:
diff changeset
336 This letter or digit is separated from the item name by @samp{=>}. You
Dave Love <fx@gnu.org>
parents:
diff changeset
337 can type the item's letter or digit to select the item.
Dave Love <fx@gnu.org>
parents:
diff changeset
338
Dave Love <fx@gnu.org>
parents:
diff changeset
339 Some of the commands in the menu bar have ordinary key bindings as
Dave Love <fx@gnu.org>
parents:
diff changeset
340 well; if so, the menu lists one equivalent key binding in parentheses
Dave Love <fx@gnu.org>
parents:
diff changeset
341 after the item itself.