annotate man/screen.texi @ 56116:6725db0f57d5

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