annotate man/frames.texi @ 89298:e1d0641b8107

(indian-compose-region): Don't call compose-chars-after, instead call a function registered in composition-function-table.
author Kenichi Handa <handa@m17n.org>
date Thu, 07 Nov 2002 06:30:49 +0000
parents 66d4e41865b2
children c69907b4eb03
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.
36553
714ab908c5e1 (Faces, Font Lock, Highlight Changes)
Gerd Moellmann <gerd@gnu.org>
parents: 36504
diff changeset
2 @c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 99, 2000, 2001
28126
e7cf77f27506 Fix copyright line.
Dave Love <fx@gnu.org>
parents: 28124
diff changeset
3 @c Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @node Frames, International, Windows, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
6 @chapter Frames and X Windows
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @cindex frames
Dave Love <fx@gnu.org>
parents:
diff changeset
8
Dave Love <fx@gnu.org>
parents:
diff changeset
9 When using the X Window System, you can create multiple windows at the
Dave Love <fx@gnu.org>
parents:
diff changeset
10 X level in a single Emacs session. Each X window that belongs to Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
11 displays a @dfn{frame} which can contain one or several Emacs windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
12 A frame initially contains a single general-purpose Emacs window which
Dave Love <fx@gnu.org>
parents:
diff changeset
13 you can subdivide vertically or horizontally into smaller windows. A
Dave Love <fx@gnu.org>
parents:
diff changeset
14 frame normally contains its own echo area and minibuffer, but you can
Dave Love <fx@gnu.org>
parents:
diff changeset
15 make frames that don't have these---they use the echo area and
Dave Love <fx@gnu.org>
parents:
diff changeset
16 minibuffer of another frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
17
Dave Love <fx@gnu.org>
parents:
diff changeset
18 Editing you do in one frame also affects the other frames. For
Dave Love <fx@gnu.org>
parents:
diff changeset
19 instance, if you put text in the kill ring in one frame, you can yank it
Dave Love <fx@gnu.org>
parents:
diff changeset
20 in another frame. If you exit Emacs through @kbd{C-x C-c} in one frame,
Dave Love <fx@gnu.org>
parents:
diff changeset
21 it terminates all the frames. To delete just one frame, use @kbd{C-x 5
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
22 0} (that is zero, not @kbd{o}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
23
Dave Love <fx@gnu.org>
parents:
diff changeset
24 To avoid confusion, we reserve the word ``window'' for the
Dave Love <fx@gnu.org>
parents:
diff changeset
25 subdivisions that Emacs implements, and never use it to refer to a
Dave Love <fx@gnu.org>
parents:
diff changeset
26 frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
27
Dave Love <fx@gnu.org>
parents:
diff changeset
28 Emacs compiled for MS-DOS emulates some aspects of the window system
Dave Love <fx@gnu.org>
parents:
diff changeset
29 so that you can use many of the features described in this chapter.
Dave Love <fx@gnu.org>
parents:
diff changeset
30 @xref{MS-DOS Input}, for more information.
Dave Love <fx@gnu.org>
parents:
diff changeset
31
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
32 @cindex MS Windows
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
33 Emacs compiled for MS Windows mostly supports the same features as
41486
de636eea1557 Remove comments about tooltips not being supported on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 41374
diff changeset
34 under X. However, images and tool bars are not yet available in Emacs
de636eea1557 Remove comments about tooltips not being supported on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 41374
diff changeset
35 version 21.3 on MS-Windows.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
36
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
37 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
38 * Mouse Commands:: Moving, cutting, and pasting, with the mouse.
Dave Love <fx@gnu.org>
parents:
diff changeset
39 * Secondary Selection:: Cutting without altering point and mark.
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
40 * Clipboard:: Using the clipboard for selections.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
41 * Mouse References:: Using the mouse to select an item from a list.
Dave Love <fx@gnu.org>
parents:
diff changeset
42 * Menu Mouse Clicks:: Mouse clicks that bring up menus.
Dave Love <fx@gnu.org>
parents:
diff changeset
43 * Mode Line Mouse:: Mouse clicks on the mode line.
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
44 * Creating Frames:: Creating additional Emacs frames with various contents.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
45 * Frame Commands:: Iconifying, deleting, and switching frames.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
46 * Speedbar:: How to make and use a speedbar frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
47 * Multiple Displays:: How one Emacs job can talk to several displays.
Dave Love <fx@gnu.org>
parents:
diff changeset
48 * Special Buffer Frames:: You can make certain buffers have their own frames.
Dave Love <fx@gnu.org>
parents:
diff changeset
49 * Frame Parameters:: Changing the colors and other modes of frames.
Dave Love <fx@gnu.org>
parents:
diff changeset
50 * Scroll Bars:: How to enable and disable scroll bars; how to use them.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
51 * Wheeled Mice:: Using mouse wheels for scrolling.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
52 * Menu Bars:: Enabling and disabling the menu bar.
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
53 * Tool Bars:: Enabling and disabling the tool bar.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
54 * Dialog Boxes:: Controlling use of dialog boxes.
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38670
diff changeset
55 * Tooltips:: Showing "tooltips", AKA "balloon help" for active text.
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
56 * Mouse Avoidance:: Moving the mouse pointer out of the way.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
57 * Non-Window Terminals:: Multiple frames on terminals that show only one.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
58 * XTerm Mouse:: Using the mouse in an XTerm terminal emulator.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
59 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
60
Dave Love <fx@gnu.org>
parents:
diff changeset
61 @node Mouse Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
62 @section Mouse Commands for Editing
Dave Love <fx@gnu.org>
parents:
diff changeset
63 @cindex mouse buttons (what they do)
Dave Love <fx@gnu.org>
parents:
diff changeset
64
Dave Love <fx@gnu.org>
parents:
diff changeset
65 The mouse commands for selecting and copying a region are mostly
Dave Love <fx@gnu.org>
parents:
diff changeset
66 compatible with the @code{xterm} program. You can use the same mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
67 commands for copying between Emacs and other X client programs.
Dave Love <fx@gnu.org>
parents:
diff changeset
68
36729
d93d962f201d Minor change in @kindex.
Richard M. Stallman <rms@gnu.org>
parents: 36553
diff changeset
69 @kindex DELETE @r{(and mouse selection)}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
70 If you select a region with any of these mouse commands, and then
Dave Love <fx@gnu.org>
parents:
diff changeset
71 immediately afterward type the @key{DELETE} function key, it deletes the
Dave Love <fx@gnu.org>
parents:
diff changeset
72 region that you selected. The @key{BACKSPACE} function key and the
Dave Love <fx@gnu.org>
parents:
diff changeset
73 ASCII character @key{DEL} do not do this; if you type any other key
Dave Love <fx@gnu.org>
parents:
diff changeset
74 in between the mouse command and @key{DELETE}, it does not do this.
Dave Love <fx@gnu.org>
parents:
diff changeset
75
Dave Love <fx@gnu.org>
parents:
diff changeset
76 @findex mouse-set-region
Dave Love <fx@gnu.org>
parents:
diff changeset
77 @findex mouse-set-point
Dave Love <fx@gnu.org>
parents:
diff changeset
78 @findex mouse-yank-at-click
Dave Love <fx@gnu.org>
parents:
diff changeset
79 @findex mouse-save-then-click
Dave Love <fx@gnu.org>
parents:
diff changeset
80 @kindex Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
81 @kindex Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
82 @kindex Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
83 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
84 @item Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
85 Move point to where you click (@code{mouse-set-point}).
Dave Love <fx@gnu.org>
parents:
diff changeset
86 This is normally the left button.
Dave Love <fx@gnu.org>
parents:
diff changeset
87
Dave Love <fx@gnu.org>
parents:
diff changeset
88 @item Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
89 Set the region to the text you select by dragging, and copy it to the
Dave Love <fx@gnu.org>
parents:
diff changeset
90 kill ring (@code{mouse-set-region}). You can specify both ends of the
Dave Love <fx@gnu.org>
parents:
diff changeset
91 region with this single command.
Dave Love <fx@gnu.org>
parents:
diff changeset
92
Dave Love <fx@gnu.org>
parents:
diff changeset
93 @vindex mouse-scroll-min-lines
Dave Love <fx@gnu.org>
parents:
diff changeset
94 If you move the mouse off the top or bottom of the window while
Dave Love <fx@gnu.org>
parents:
diff changeset
95 dragging, the window scrolls at a steady rate until you move the mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
96 back into the window. This way, you can select regions that don't fit
Dave Love <fx@gnu.org>
parents:
diff changeset
97 entirely on the screen. The number of lines scrolled per step depends
Dave Love <fx@gnu.org>
parents:
diff changeset
98 on how far away from the window edge the mouse has gone; the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
99 @code{mouse-scroll-min-lines} specifies a minimum step size.
Dave Love <fx@gnu.org>
parents:
diff changeset
100
Dave Love <fx@gnu.org>
parents:
diff changeset
101 @item Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
102 Yank the last killed text, where you click (@code{mouse-yank-at-click}).
Dave Love <fx@gnu.org>
parents:
diff changeset
103 This is normally the middle button.
Dave Love <fx@gnu.org>
parents:
diff changeset
104
Dave Love <fx@gnu.org>
parents:
diff changeset
105 @item Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
106 This command, @code{mouse-save-then-kill}, has several functions
Dave Love <fx@gnu.org>
parents:
diff changeset
107 depending on where you click and the status of the region.
Dave Love <fx@gnu.org>
parents:
diff changeset
108
Dave Love <fx@gnu.org>
parents:
diff changeset
109 The most basic case is when you click @kbd{Mouse-1} in one place and
Dave Love <fx@gnu.org>
parents:
diff changeset
110 then @kbd{Mouse-3} in another. This selects the text between those two
Dave Love <fx@gnu.org>
parents:
diff changeset
111 positions as the region. It also copies the new region to the kill
Dave Love <fx@gnu.org>
parents:
diff changeset
112 ring, so that you can copy it to someplace else.
Dave Love <fx@gnu.org>
parents:
diff changeset
113
Dave Love <fx@gnu.org>
parents:
diff changeset
114 If you click @kbd{Mouse-1} in the text, scroll with the scroll bar, and
Dave Love <fx@gnu.org>
parents:
diff changeset
115 then click @kbd{Mouse-3}, it remembers where point was before scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
116 (where you put it with @kbd{Mouse-1}), and uses that position as the
Dave Love <fx@gnu.org>
parents:
diff changeset
117 other end of the region. This is so that you can select a region that
Dave Love <fx@gnu.org>
parents:
diff changeset
118 doesn't fit entirely on the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
119
Dave Love <fx@gnu.org>
parents:
diff changeset
120 More generally, if you do not have a highlighted region, @kbd{Mouse-3}
Dave Love <fx@gnu.org>
parents:
diff changeset
121 selects the text between point and the click position as the region. It
Dave Love <fx@gnu.org>
parents:
diff changeset
122 does this by setting the mark where point was, and moving point to where
Dave Love <fx@gnu.org>
parents:
diff changeset
123 you click.
Dave Love <fx@gnu.org>
parents:
diff changeset
124
Dave Love <fx@gnu.org>
parents:
diff changeset
125 If you have a highlighted region, or if the region was set just before
Dave Love <fx@gnu.org>
parents:
diff changeset
126 by dragging button 1, @kbd{Mouse-3} adjusts the nearer end of the region
Dave Love <fx@gnu.org>
parents:
diff changeset
127 by moving it to where you click. The adjusted region's text also
Dave Love <fx@gnu.org>
parents:
diff changeset
128 replaces the old region's text in the kill ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
129
Dave Love <fx@gnu.org>
parents:
diff changeset
130 If you originally specified the region using a double or triple
Dave Love <fx@gnu.org>
parents:
diff changeset
131 @kbd{Mouse-1}, so that the region is defined to consist of entire words
Dave Love <fx@gnu.org>
parents:
diff changeset
132 or lines, then adjusting the region with @kbd{Mouse-3} also proceeds by
Dave Love <fx@gnu.org>
parents:
diff changeset
133 entire words or lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
134
Dave Love <fx@gnu.org>
parents:
diff changeset
135 If you use @kbd{Mouse-3} a second time consecutively, at the same place,
Dave Love <fx@gnu.org>
parents:
diff changeset
136 that kills the region already selected.
Dave Love <fx@gnu.org>
parents:
diff changeset
137
Dave Love <fx@gnu.org>
parents:
diff changeset
138 @item Double-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
139 This key sets the region around the word which you click on. If you
Dave Love <fx@gnu.org>
parents:
diff changeset
140 click on a character with ``symbol'' syntax (such as underscore, in C
Dave Love <fx@gnu.org>
parents:
diff changeset
141 mode), it sets the region around the symbol surrounding that character.
Dave Love <fx@gnu.org>
parents:
diff changeset
142
Dave Love <fx@gnu.org>
parents:
diff changeset
143 If you click on a character with open-parenthesis or close-parenthesis
38205
a6d5498886e0 Avoid "sexp".
Richard M. Stallman <rms@gnu.org>
parents: 37234
diff changeset
144 syntax, it sets the region around the parenthetical grouping
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
145 which that character starts or ends. If you click on a character with
Dave Love <fx@gnu.org>
parents:
diff changeset
146 string-delimiter syntax (such as a singlequote or doublequote in C), it
Dave Love <fx@gnu.org>
parents:
diff changeset
147 sets the region around the string constant (using heuristics to figure
Dave Love <fx@gnu.org>
parents:
diff changeset
148 out whether that character is the beginning or the end of it).
Dave Love <fx@gnu.org>
parents:
diff changeset
149
Dave Love <fx@gnu.org>
parents:
diff changeset
150 @item Double-Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
151 This key selects a region made up of the words you drag across.
Dave Love <fx@gnu.org>
parents:
diff changeset
152
Dave Love <fx@gnu.org>
parents:
diff changeset
153 @item Triple-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
154 This key sets the region around the line you click on.
Dave Love <fx@gnu.org>
parents:
diff changeset
155
Dave Love <fx@gnu.org>
parents:
diff changeset
156 @item Triple-Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
157 This key selects a region made up of the lines you drag across.
Dave Love <fx@gnu.org>
parents:
diff changeset
158 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
159
Dave Love <fx@gnu.org>
parents:
diff changeset
160 The simplest way to kill text with the mouse is to press @kbd{Mouse-1}
Dave Love <fx@gnu.org>
parents:
diff changeset
161 at one end, then press @kbd{Mouse-3} twice at the other end.
Dave Love <fx@gnu.org>
parents:
diff changeset
162 @xref{Killing}. To copy the text into the kill ring without deleting it
Dave Love <fx@gnu.org>
parents:
diff changeset
163 from the buffer, press @kbd{Mouse-3} just once---or just drag across the
Dave Love <fx@gnu.org>
parents:
diff changeset
164 text with @kbd{Mouse-1}. Then you can copy it elsewhere by yanking it.
Dave Love <fx@gnu.org>
parents:
diff changeset
165
Dave Love <fx@gnu.org>
parents:
diff changeset
166 @vindex mouse-yank-at-point
Dave Love <fx@gnu.org>
parents:
diff changeset
167 To yank the killed or copied text somewhere else, move the mouse there
Dave Love <fx@gnu.org>
parents:
diff changeset
168 and press @kbd{Mouse-2}. @xref{Yanking}. However, if
Dave Love <fx@gnu.org>
parents:
diff changeset
169 @code{mouse-yank-at-point} is non-@code{nil}, @kbd{Mouse-2} yanks at
Dave Love <fx@gnu.org>
parents:
diff changeset
170 point. Then it does not matter where you click, or even which of the
Dave Love <fx@gnu.org>
parents:
diff changeset
171 frame's windows you click on. The default value is @code{nil}. This
Dave Love <fx@gnu.org>
parents:
diff changeset
172 variable also affects yanking the secondary selection.
Dave Love <fx@gnu.org>
parents:
diff changeset
173
Dave Love <fx@gnu.org>
parents:
diff changeset
174 @cindex cutting and X
Dave Love <fx@gnu.org>
parents:
diff changeset
175 @cindex pasting and X
Dave Love <fx@gnu.org>
parents:
diff changeset
176 @cindex X cutting and pasting
Dave Love <fx@gnu.org>
parents:
diff changeset
177 To copy text to another X window, kill it or save it in the kill ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
178 Under X, this also sets the @dfn{primary selection}. Then use the
Dave Love <fx@gnu.org>
parents:
diff changeset
179 ``paste'' or ``yank'' command of the program operating the other window
Dave Love <fx@gnu.org>
parents:
diff changeset
180 to insert the text from the selection.
Dave Love <fx@gnu.org>
parents:
diff changeset
181
37234
d293251ba14e Minor clarification; add xref for C-x RET x and C-x RET X.
Richard M. Stallman <rms@gnu.org>
parents: 37121
diff changeset
182 To copy text from another X window, use the ``cut'' or ``copy''
d293251ba14e Minor clarification; add xref for C-x RET x and C-x RET X.
Richard M. Stallman <rms@gnu.org>
parents: 37121
diff changeset
183 command of the program operating the other window, to select the text
d293251ba14e Minor clarification; add xref for C-x RET x and C-x RET X.
Richard M. Stallman <rms@gnu.org>
parents: 37121
diff changeset
184 you want. Then yank it in Emacs with @kbd{C-y} or @kbd{Mouse-2}.
d293251ba14e Minor clarification; add xref for C-x RET x and C-x RET X.
Richard M. Stallman <rms@gnu.org>
parents: 37121
diff changeset
185
43561
66d4e41865b2 (Mouse Commands): The default for selections encoding is
Eli Zaretskii <eliz@gnu.org>
parents: 43438
diff changeset
186 The standard coding system for X selections is
66d4e41865b2 (Mouse Commands): The default for selections encoding is
Eli Zaretskii <eliz@gnu.org>
parents: 43438
diff changeset
187 @code{compound-text-with-extensions}. To specify another coding
66d4e41865b2 (Mouse Commands): The default for selections encoding is
Eli Zaretskii <eliz@gnu.org>
parents: 43438
diff changeset
188 system for X selections, use @kbd{C-x @key{RET} x} or @kbd{C-x
66d4e41865b2 (Mouse Commands): The default for selections encoding is
Eli Zaretskii <eliz@gnu.org>
parents: 43438
diff changeset
189 @key{RET} X}. @xref{Specify Coding}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
190
Dave Love <fx@gnu.org>
parents:
diff changeset
191 These cutting and pasting commands also work on MS-Windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
192
Dave Love <fx@gnu.org>
parents:
diff changeset
193 @cindex primary selection
Dave Love <fx@gnu.org>
parents:
diff changeset
194 @cindex cut buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
195 @cindex selection, primary
Dave Love <fx@gnu.org>
parents:
diff changeset
196 @vindex x-cut-buffer-max
Dave Love <fx@gnu.org>
parents:
diff changeset
197 When Emacs puts text into the kill ring, or rotates text to the front
Dave Love <fx@gnu.org>
parents:
diff changeset
198 of the kill ring, it sets the @dfn{primary selection} in the X server.
Dave Love <fx@gnu.org>
parents:
diff changeset
199 This is how other X clients can access the text. Emacs also stores the
Dave Love <fx@gnu.org>
parents:
diff changeset
200 text in the cut buffer, but only if the text is short enough
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
201 (the value of @code{x-cut-buffer-max} specifies the maximum number of
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
202 characters); putting long strings in the cut buffer can be slow.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
203
Dave Love <fx@gnu.org>
parents:
diff changeset
204 The commands to yank the first entry in the kill ring actually check
Dave Love <fx@gnu.org>
parents:
diff changeset
205 first for a primary selection in another program; after that, they check
Dave Love <fx@gnu.org>
parents:
diff changeset
206 for text in the cut buffer. If neither of those sources provides text
Dave Love <fx@gnu.org>
parents:
diff changeset
207 to yank, the kill ring contents are used.
Dave Love <fx@gnu.org>
parents:
diff changeset
208
Dave Love <fx@gnu.org>
parents:
diff changeset
209 @node Secondary Selection
Dave Love <fx@gnu.org>
parents:
diff changeset
210 @section Secondary Selection
Dave Love <fx@gnu.org>
parents:
diff changeset
211 @cindex secondary selection
Dave Love <fx@gnu.org>
parents:
diff changeset
212
Dave Love <fx@gnu.org>
parents:
diff changeset
213 The @dfn{secondary selection} is another way of selecting text using
Dave Love <fx@gnu.org>
parents:
diff changeset
214 X. It does not use point or the mark, so you can use it to kill text
Dave Love <fx@gnu.org>
parents:
diff changeset
215 without setting point or the mark.
Dave Love <fx@gnu.org>
parents:
diff changeset
216
Dave Love <fx@gnu.org>
parents:
diff changeset
217 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
218 @findex mouse-set-secondary
Dave Love <fx@gnu.org>
parents:
diff changeset
219 @kindex M-Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @item M-Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
221 Set the secondary selection, with one end at the place where you press
Dave Love <fx@gnu.org>
parents:
diff changeset
222 down the button, and the other end at the place where you release it
Dave Love <fx@gnu.org>
parents:
diff changeset
223 (@code{mouse-set-secondary}). The highlighting appears and changes as
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
224 you drag. You can control the appearance of the highlighting by
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
225 customizing the @code{secondary-selection} face (@pxref{Face
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
226 Customization}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
227
Dave Love <fx@gnu.org>
parents:
diff changeset
228 If you move the mouse off the top or bottom of the window while
Dave Love <fx@gnu.org>
parents:
diff changeset
229 dragging, the window scrolls at a steady rate until you move the mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
230 back into the window. This way, you can mark regions that don't fit
Dave Love <fx@gnu.org>
parents:
diff changeset
231 entirely on the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
232
Dave Love <fx@gnu.org>
parents:
diff changeset
233 @findex mouse-start-secondary
Dave Love <fx@gnu.org>
parents:
diff changeset
234 @kindex M-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
235 @item M-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
236 Set one endpoint for the @dfn{secondary selection}
Dave Love <fx@gnu.org>
parents:
diff changeset
237 (@code{mouse-start-secondary}).
Dave Love <fx@gnu.org>
parents:
diff changeset
238
Dave Love <fx@gnu.org>
parents:
diff changeset
239 @findex mouse-secondary-save-then-kill
Dave Love <fx@gnu.org>
parents:
diff changeset
240 @kindex M-Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
241 @item M-Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
242 Make a secondary selection, using the place specified with @kbd{M-Mouse-1}
Dave Love <fx@gnu.org>
parents:
diff changeset
243 as the other end (@code{mouse-secondary-save-then-kill}). A second click
Dave Love <fx@gnu.org>
parents:
diff changeset
244 at the same place kills the secondary selection just made.
Dave Love <fx@gnu.org>
parents:
diff changeset
245
Dave Love <fx@gnu.org>
parents:
diff changeset
246 @findex mouse-yank-secondary
Dave Love <fx@gnu.org>
parents:
diff changeset
247 @kindex M-Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
248 @item M-Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
249 Insert the secondary selection where you click
Dave Love <fx@gnu.org>
parents:
diff changeset
250 (@code{mouse-yank-secondary}). This places point at the end of the
Dave Love <fx@gnu.org>
parents:
diff changeset
251 yanked text.
Dave Love <fx@gnu.org>
parents:
diff changeset
252 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
253
Dave Love <fx@gnu.org>
parents:
diff changeset
254 Double or triple clicking of @kbd{M-Mouse-1} operates on words and
Dave Love <fx@gnu.org>
parents:
diff changeset
255 lines, much like @kbd{Mouse-1}.
Dave Love <fx@gnu.org>
parents:
diff changeset
256
Dave Love <fx@gnu.org>
parents:
diff changeset
257 If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-Mouse-2}
Dave Love <fx@gnu.org>
parents:
diff changeset
258 yanks at point. Then it does not matter precisely where you click; all
Dave Love <fx@gnu.org>
parents:
diff changeset
259 that matters is which window you click on. @xref{Mouse Commands}.
Dave Love <fx@gnu.org>
parents:
diff changeset
260
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
261 @node Clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
262 @section Using the Clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
263 @cindex X clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
264 @cindex clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
265 @vindex x-select-enable-clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
266 @findex menu-bar-enable-clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
267 @cindex OpenWindows
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
268 @cindex Gnome
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
269
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
270 As well as the primary and secondary selection types, X supports a
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
271 @dfn{clipboard} selection type which is used by some applications,
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
272 particularly under OpenWindows and Gnome.
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
273
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
274 The command @kbd{M-x menu-bar-enable-clipboard} makes the @code{Cut},
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
275 @code{Paste} and @code{Copy} menu items, as well as the keys of the same
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
276 names, all use the clipboard.
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
277
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
278 You can customize the option @code{x-select-enable-clipboard} to make
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
279 the Emacs yank functions consult the clipboard before the primary
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
280 selection, and to make the kill functions to store in the clipboard as
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
281 well as the primary selection. Otherwise they do not access the
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
282 clipboard at all. Using the clipboard is the default on MS-Windows,
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
283 unlike most systems.
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
284
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
285 @node Mouse References
Dave Love <fx@gnu.org>
parents:
diff changeset
286 @section Following References with the Mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
287 @kindex Mouse-2 @r{(selection)}
Dave Love <fx@gnu.org>
parents:
diff changeset
288
Dave Love <fx@gnu.org>
parents:
diff changeset
289 Some Emacs buffers display lists of various sorts. These include
Dave Love <fx@gnu.org>
parents:
diff changeset
290 lists of files, of buffers, of possible completions, of matches for
Dave Love <fx@gnu.org>
parents:
diff changeset
291 a pattern, and so on.
Dave Love <fx@gnu.org>
parents:
diff changeset
292
Dave Love <fx@gnu.org>
parents:
diff changeset
293 Since yanking text into these buffers is not very useful, most of them
Dave Love <fx@gnu.org>
parents:
diff changeset
294 define @kbd{Mouse-2} specially, as a command to use or view the item you
Dave Love <fx@gnu.org>
parents:
diff changeset
295 click on.
Dave Love <fx@gnu.org>
parents:
diff changeset
296
Dave Love <fx@gnu.org>
parents:
diff changeset
297 For example, if you click @kbd{Mouse-2} on a file name in a Dired
Dave Love <fx@gnu.org>
parents:
diff changeset
298 buffer, you visit that file. If you click @kbd{Mouse-2} on an error
Dave Love <fx@gnu.org>
parents:
diff changeset
299 message in the @samp{*Compilation*} buffer, you go to the source code
Dave Love <fx@gnu.org>
parents:
diff changeset
300 for that error message. If you click @kbd{Mouse-2} on a completion in
Dave Love <fx@gnu.org>
parents:
diff changeset
301 the @samp{*Completions*} buffer, you choose that completion.
Dave Love <fx@gnu.org>
parents:
diff changeset
302
Dave Love <fx@gnu.org>
parents:
diff changeset
303 You can usually tell when @kbd{Mouse-2} has this special sort of
Dave Love <fx@gnu.org>
parents:
diff changeset
304 meaning because the sensitive text highlights when you move the mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
305 over it.
Dave Love <fx@gnu.org>
parents:
diff changeset
306
Dave Love <fx@gnu.org>
parents:
diff changeset
307 @node Menu Mouse Clicks
Dave Love <fx@gnu.org>
parents:
diff changeset
308 @section Mouse Clicks for Menus
Dave Love <fx@gnu.org>
parents:
diff changeset
309
Dave Love <fx@gnu.org>
parents:
diff changeset
310 Mouse clicks modified with the @key{CTRL} and @key{SHIFT} keys
Dave Love <fx@gnu.org>
parents:
diff changeset
311 bring up menus.
Dave Love <fx@gnu.org>
parents:
diff changeset
312
Dave Love <fx@gnu.org>
parents:
diff changeset
313 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
314 @item C-Mouse-1
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
315 @kindex C-Mouse-1
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
316 This menu is for selecting a buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
317
36504
3febda0f0d4b Delete indexing for MSB in `Menu Mouse Clicks';
Richard M. Stallman <rms@gnu.org>
parents: 36408
diff changeset
318 The MSB (``mouse select buffer'') global minor mode makes this
3febda0f0d4b Delete indexing for MSB in `Menu Mouse Clicks';
Richard M. Stallman <rms@gnu.org>
parents: 36408
diff changeset
319 menu smarter and more customizable. @xref{Buffer Menus}.
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
320
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
321 @item C-Mouse-2
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
322 @kindex C-Mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
323 This menu is for specifying faces and other text properties
Dave Love <fx@gnu.org>
parents:
diff changeset
324 for editing formatted text. @xref{Formatted Text}.
Dave Love <fx@gnu.org>
parents:
diff changeset
325
Dave Love <fx@gnu.org>
parents:
diff changeset
326 @item C-Mouse-3
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
327 @kindex C-Mouse-3
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
328 This menu is mode-specific. For most modes if Menu-bar mode is on, this
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
329 menu has the same items as all the mode-specific menu-bar menus put
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
330 together. Some modes may specify a different menu for this
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
331 button.@footnote{Some systems use @kbd{Mouse-3} for a mode-specific
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
332 menu. We took a survey of users, and found they preferred to keep
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
333 @kbd{Mouse-3} for selecting and killing regions. Hence the decision to
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
334 use @kbd{C-Mouse-3} for this menu.} If Menu-bar mode is off, this menu
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
335 contains all the items which would be present in the menu bar---not just
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
336 the mode-specific ones---so that you can access them without having to
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
337 display the menu bar.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
338
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
339 @item S-Mouse-1
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
340 This menu is for specifying the frame's principal font.
Dave Love <fx@gnu.org>
parents:
diff changeset
341 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
342
Dave Love <fx@gnu.org>
parents:
diff changeset
343 @node Mode Line Mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
344 @section Mode Line Mouse Commands
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
345 @cindex mode line, mouse
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
346 @cindex mouse on mode line
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
347
Dave Love <fx@gnu.org>
parents:
diff changeset
348 You can use mouse clicks on window mode lines to select and manipulate
Dave Love <fx@gnu.org>
parents:
diff changeset
349 windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
350
Dave Love <fx@gnu.org>
parents:
diff changeset
351 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
352 @item Mouse-1
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
353 @kindex Mouse-1 @r{(mode line)}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
354 @kbd{Mouse-1} on a mode line selects the window above. By dragging
Dave Love <fx@gnu.org>
parents:
diff changeset
355 @kbd{Mouse-1} on the mode line, you can move it, thus changing the
Dave Love <fx@gnu.org>
parents:
diff changeset
356 height of the windows above and below.
Dave Love <fx@gnu.org>
parents:
diff changeset
357
Dave Love <fx@gnu.org>
parents:
diff changeset
358 @item Mouse-2
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
359 @kindex Mouse-2 @r{(mode line)}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
360 @kbd{Mouse-2} on a mode line expands that window to fill its frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
361
Dave Love <fx@gnu.org>
parents:
diff changeset
362 @item Mouse-3
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
363 @kindex Mouse-3 @r{(mode line)}
35954
c869b148aa3f Document what does mouse-3 do on the mode line if there's only one window.
Eli Zaretskii <eliz@gnu.org>
parents: 35875
diff changeset
364 @kbd{Mouse-3} on a mode line deletes the window above. If the frame has
c869b148aa3f Document what does mouse-3 do on the mode line if there's only one window.
Eli Zaretskii <eliz@gnu.org>
parents: 35875
diff changeset
365 only one window, it buries the current buffer instead and switches to
c869b148aa3f Document what does mouse-3 do on the mode line if there's only one window.
Eli Zaretskii <eliz@gnu.org>
parents: 35875
diff changeset
366 another buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
367
Dave Love <fx@gnu.org>
parents:
diff changeset
368 @item C-Mouse-2
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
369 @kindex C-mouse-2 @r{(mode line)}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
370 @kbd{C-Mouse-2} on a mode line splits the window above
Dave Love <fx@gnu.org>
parents:
diff changeset
371 horizontally, above the place in the mode line where you click.
Dave Love <fx@gnu.org>
parents:
diff changeset
372 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
373
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
374 @kindex C-Mouse-2 @r{(scroll bar)}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
375 @kbd{C-Mouse-2} on a scroll bar splits the corresponding window
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
376 vertically, unless you are using an X toolkit's implementation of
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
377 scroll bars. @xref{Split Window}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
378
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
379 The commands above apply to areas of the mode line which do not have
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
380 special mouse bindings of their own. Some areas, such as the buffer
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
381 name and the major mode name, have their own special mouse bindings.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
382 Emacs displays information about these bindings when you hold the
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
383 mouse over such a place (@pxref{Tooltips}).
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
384
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
385 @node Creating Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
386 @section Creating Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
387 @cindex creating frames
Dave Love <fx@gnu.org>
parents:
diff changeset
388
Dave Love <fx@gnu.org>
parents:
diff changeset
389 @kindex C-x 5
Dave Love <fx@gnu.org>
parents:
diff changeset
390 The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}, with parallel
Dave Love <fx@gnu.org>
parents:
diff changeset
391 subcommands. The difference is that @kbd{C-x 5} commands create a new
Dave Love <fx@gnu.org>
parents:
diff changeset
392 frame rather than just a new window in the selected frame (@pxref{Pop
Dave Love <fx@gnu.org>
parents:
diff changeset
393 Up Window}). If an existing visible or iconified frame already displays
Dave Love <fx@gnu.org>
parents:
diff changeset
394 the requested material, these commands use the existing frame, after
Dave Love <fx@gnu.org>
parents:
diff changeset
395 raising or deiconifying as necessary.
Dave Love <fx@gnu.org>
parents:
diff changeset
396
Dave Love <fx@gnu.org>
parents:
diff changeset
397 The various @kbd{C-x 5} commands differ in how they find or create the
Dave Love <fx@gnu.org>
parents:
diff changeset
398 buffer to select:
Dave Love <fx@gnu.org>
parents:
diff changeset
399
Dave Love <fx@gnu.org>
parents:
diff changeset
400 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
401 @item C-x 5 2
Dave Love <fx@gnu.org>
parents:
diff changeset
402 @kindex C-x 5 2
Dave Love <fx@gnu.org>
parents:
diff changeset
403 @findex make-frame-command
Dave Love <fx@gnu.org>
parents:
diff changeset
404 Create a new frame (@code{make-frame-command}).
Dave Love <fx@gnu.org>
parents:
diff changeset
405 @item C-x 5 b @var{bufname} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
406 Select buffer @var{bufname} in another frame. This runs
Dave Love <fx@gnu.org>
parents:
diff changeset
407 @code{switch-to-buffer-other-frame}.
Dave Love <fx@gnu.org>
parents:
diff changeset
408 @item C-x 5 f @var{filename} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
409 Visit file @var{filename} and select its buffer in another frame. This
Dave Love <fx@gnu.org>
parents:
diff changeset
410 runs @code{find-file-other-frame}. @xref{Visiting}.
Dave Love <fx@gnu.org>
parents:
diff changeset
411 @item C-x 5 d @var{directory} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
412 Select a Dired buffer for directory @var{directory} in another frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
413 This runs @code{dired-other-frame}. @xref{Dired}.
Dave Love <fx@gnu.org>
parents:
diff changeset
414 @item C-x 5 m
Dave Love <fx@gnu.org>
parents:
diff changeset
415 Start composing a mail message in another frame. This runs
Dave Love <fx@gnu.org>
parents:
diff changeset
416 @code{mail-other-frame}. It is the other-frame variant of @kbd{C-x m}.
Dave Love <fx@gnu.org>
parents:
diff changeset
417 @xref{Sending Mail}.
Dave Love <fx@gnu.org>
parents:
diff changeset
418 @item C-x 5 .
Dave Love <fx@gnu.org>
parents:
diff changeset
419 Find a tag in the current tag table in another frame. This runs
Dave Love <fx@gnu.org>
parents:
diff changeset
420 @code{find-tag-other-frame}, the multiple-frame variant of @kbd{M-.}.
Dave Love <fx@gnu.org>
parents:
diff changeset
421 @xref{Tags}.
Dave Love <fx@gnu.org>
parents:
diff changeset
422 @item C-x 5 r @var{filename} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
423 @kindex C-x 5 r
Dave Love <fx@gnu.org>
parents:
diff changeset
424 @findex find-file-read-only-other-frame
Dave Love <fx@gnu.org>
parents:
diff changeset
425 Visit file @var{filename} read-only, and select its buffer in another
Dave Love <fx@gnu.org>
parents:
diff changeset
426 frame. This runs @code{find-file-read-only-other-frame}.
Dave Love <fx@gnu.org>
parents:
diff changeset
427 @xref{Visiting}.
Dave Love <fx@gnu.org>
parents:
diff changeset
428 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
429
Dave Love <fx@gnu.org>
parents:
diff changeset
430 @cindex default-frame-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
431 @cindex initial-frame-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
432 You can control the appearance of new frames you create by setting the
Dave Love <fx@gnu.org>
parents:
diff changeset
433 frame parameters in @code{default-frame-alist}. You can use the
Dave Love <fx@gnu.org>
parents:
diff changeset
434 variable @code{initial-frame-alist} to specify parameters that affect
Dave Love <fx@gnu.org>
parents:
diff changeset
435 only the initial frame. @xref{Initial Parameters,,, elisp, The Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
436 Lisp Reference Manual}, for more information.
Dave Love <fx@gnu.org>
parents:
diff changeset
437
Dave Love <fx@gnu.org>
parents:
diff changeset
438 @cindex font (default)
Dave Love <fx@gnu.org>
parents:
diff changeset
439 The easiest way to specify the principal font for all your Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
440 frames is with an X resource (@pxref{Font X}), but you can also do it by
Dave Love <fx@gnu.org>
parents:
diff changeset
441 modifying @code{default-frame-alist} to specify the @code{font}
Dave Love <fx@gnu.org>
parents:
diff changeset
442 parameter, as shown here:
Dave Love <fx@gnu.org>
parents:
diff changeset
443
Dave Love <fx@gnu.org>
parents:
diff changeset
444 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
445 (add-to-list 'default-frame-alist '(font . "10x20"))
Dave Love <fx@gnu.org>
parents:
diff changeset
446 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
447
38670
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
448 @noindent
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
449 Here's a similar example for specifying a foreground color:
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
450
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
451 @example
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
452 (add-to-list 'default-frame-alist '(background-color . "blue"))
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
453 @end example
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
454
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
455
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
456 @node Frame Commands
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
457 @section Frame Commands
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
458
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
459 The following commands let you create, delete and operate on frames:
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
460
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
461 @table @kbd
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
462 @item C-z
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
463 @kindex C-z @r{(X windows)}
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
464 @findex iconify-or-deiconify-frame
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
465 Iconify the selected Emacs frame (@code{iconify-or-deiconify-frame}).
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
466 The normal meaning of @kbd{C-z}, to suspend Emacs, is not useful under a
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
467 window system, so it has a different binding in that case.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
468
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
469 If you type this command on an Emacs frame's icon, it deiconifies the frame.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
470
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
471 @item C-x 5 0
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
472 @kindex C-x 5 0
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
473 @findex delete-frame
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
474 Delete the selected frame (@code{delete-frame}). This is not allowed if
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
475 there is only one frame.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
476
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
477 @item C-x 5 o
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
478 @kindex C-x 5 o
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
479 @findex other-frame
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
480 Select another frame, raise it, and warp the mouse to it so that it
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
481 stays selected. If you repeat this command, it cycles through all the
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
482 frames on your terminal.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
483
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
484 @item C-x 5 1
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
485 @kindex C-x 5 1
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
486 @findex delete-other-frames
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
487 Delete all frames except the selected one.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
488 @end table
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
489
43438
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
490 @vindex focus-follows-mouse
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
491 To make the command @kbd{C-x 5 o} work properly, you must tell Emacs
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
492 how the system (or the window manager) generally handles
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
493 focus-switching between windows. There are two possibilities: either
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
494 simply moving the mouse onto a window selects it (gives it focus), or
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
495 you have to click on it in a suitable way to do so. Unfortunately
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
496 there is no way Emacs can find out automatically which way the system
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
497 handles this, so you have to explicitly say, by setting the variable
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
498 @code{focus-follows-mouse}. If just moving the mouse onto a window
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
499 selects it, that variable should be @code{t}; if a click is necessary,
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
500 the variable should be @code{nil}.
26a4fefad579 Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents: 42751
diff changeset
501
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
502 @node Speedbar
Dave Love <fx@gnu.org>
parents:
diff changeset
503 @section Making and Using a Speedbar Frame
Dave Love <fx@gnu.org>
parents:
diff changeset
504 @cindex speedbar
Dave Love <fx@gnu.org>
parents:
diff changeset
505
Dave Love <fx@gnu.org>
parents:
diff changeset
506 An Emacs frame can have a @dfn{speedbar}, which is a vertical window
Dave Love <fx@gnu.org>
parents:
diff changeset
507 that serves as a scrollable menu of files you could visit and tags
Dave Love <fx@gnu.org>
parents:
diff changeset
508 within those files. To create a speedbar, type @kbd{M-x speedbar}; this
Dave Love <fx@gnu.org>
parents:
diff changeset
509 creates a speedbar window for the selected frame. From then on, you can
Dave Love <fx@gnu.org>
parents:
diff changeset
510 click on a file name in the speedbar to visit that file in the
Dave Love <fx@gnu.org>
parents:
diff changeset
511 corresponding Emacs frame, or click on a tag name to jump to that tag in
Dave Love <fx@gnu.org>
parents:
diff changeset
512 the Emacs frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
513
Dave Love <fx@gnu.org>
parents:
diff changeset
514 Initially the speedbar lists the immediate contents of the current
Dave Love <fx@gnu.org>
parents:
diff changeset
515 directory, one file per line. Each line also has a box, @samp{[+]} or
Dave Love <fx@gnu.org>
parents:
diff changeset
516 @samp{<+>}, that you can click on with @kbd{Mouse-2} to ``open up'' the
Dave Love <fx@gnu.org>
parents:
diff changeset
517 contents of that item. If the line names a directory, opening it adds
Dave Love <fx@gnu.org>
parents:
diff changeset
518 the contents of that directory to the speedbar display, underneath the
Dave Love <fx@gnu.org>
parents:
diff changeset
519 directory's own line. If the line lists an ordinary file, opening it up
Dave Love <fx@gnu.org>
parents:
diff changeset
520 adds a list of the tags in that file to the speedbar display. When a
Dave Love <fx@gnu.org>
parents:
diff changeset
521 file is opened up, the @samp{[+]} changes to @samp{[-]}; you can click
Dave Love <fx@gnu.org>
parents:
diff changeset
522 on that box to ``close up'' that file (hide its contents).
Dave Love <fx@gnu.org>
parents:
diff changeset
523
Dave Love <fx@gnu.org>
parents:
diff changeset
524 Some major modes, including Rmail mode, Info, and GUD, have
Dave Love <fx@gnu.org>
parents:
diff changeset
525 specialized ways of putting useful items into the speedbar for you to
Dave Love <fx@gnu.org>
parents:
diff changeset
526 select. For example, in Rmail mode, the speedbar shows a list of Rmail
Dave Love <fx@gnu.org>
parents:
diff changeset
527 files, and lets you move the current message to another Rmail file by
Dave Love <fx@gnu.org>
parents:
diff changeset
528 clicking on its @samp{<M>} box.
Dave Love <fx@gnu.org>
parents:
diff changeset
529
Dave Love <fx@gnu.org>
parents:
diff changeset
530 A speedbar belongs to one Emacs frame, and always operates on that
Dave Love <fx@gnu.org>
parents:
diff changeset
531 frame. If you use multiple frames, you can make a speedbar for some or
Dave Love <fx@gnu.org>
parents:
diff changeset
532 all of the frames; type @kbd{M-x speedbar} in any given frame to make a
Dave Love <fx@gnu.org>
parents:
diff changeset
533 speedbar for it.
Dave Love <fx@gnu.org>
parents:
diff changeset
534
Dave Love <fx@gnu.org>
parents:
diff changeset
535 @node Multiple Displays
Dave Love <fx@gnu.org>
parents:
diff changeset
536 @section Multiple Displays
Dave Love <fx@gnu.org>
parents:
diff changeset
537 @cindex multiple displays
Dave Love <fx@gnu.org>
parents:
diff changeset
538
35188
94d46968a93f Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents: 34523
diff changeset
539 A single Emacs can talk to more than one X display. Initially, Emacs
94d46968a93f Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents: 34523
diff changeset
540 uses just one display---the one specified with the @env{DISPLAY}
94d46968a93f Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents: 34523
diff changeset
541 environment variable or with the @samp{--display} option (@pxref{Initial
94d46968a93f Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents: 34523
diff changeset
542 Options}). To connect to another display, use the command
94d46968a93f Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents: 34523
diff changeset
543 @code{make-frame-on-display}:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
544
Dave Love <fx@gnu.org>
parents:
diff changeset
545 @findex make-frame-on-display
Dave Love <fx@gnu.org>
parents:
diff changeset
546 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
547 @item M-x make-frame-on-display @key{RET} @var{display} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
548 Create a new frame on display @var{display}.
Dave Love <fx@gnu.org>
parents:
diff changeset
549 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
550
Dave Love <fx@gnu.org>
parents:
diff changeset
551 A single X server can handle more than one screen. When you open
Dave Love <fx@gnu.org>
parents:
diff changeset
552 frames on two screens belonging to one server, Emacs knows they share a
Dave Love <fx@gnu.org>
parents:
diff changeset
553 single keyboard, and it treats all the commands arriving from these
Dave Love <fx@gnu.org>
parents:
diff changeset
554 screens as a single stream of input.
Dave Love <fx@gnu.org>
parents:
diff changeset
555
Dave Love <fx@gnu.org>
parents:
diff changeset
556 When you open frames on different X servers, Emacs makes a separate
Dave Love <fx@gnu.org>
parents:
diff changeset
557 input stream for each server. This way, two users can type
Dave Love <fx@gnu.org>
parents:
diff changeset
558 simultaneously on the two displays, and Emacs will not garble their
Dave Love <fx@gnu.org>
parents:
diff changeset
559 input. Each server also has its own selected frame. The commands you
Dave Love <fx@gnu.org>
parents:
diff changeset
560 enter with a particular X server apply to that server's selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
561
Dave Love <fx@gnu.org>
parents:
diff changeset
562 Despite these features, people using the same Emacs job from different
Dave Love <fx@gnu.org>
parents:
diff changeset
563 displays can still interfere with each other if they are not careful.
Dave Love <fx@gnu.org>
parents:
diff changeset
564 For example, if any one types @kbd{C-x C-c}, that exits the Emacs job
Dave Love <fx@gnu.org>
parents:
diff changeset
565 for all of them!
Dave Love <fx@gnu.org>
parents:
diff changeset
566
Dave Love <fx@gnu.org>
parents:
diff changeset
567 @node Special Buffer Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
568 @section Special Buffer Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
569
Dave Love <fx@gnu.org>
parents:
diff changeset
570 @vindex special-display-buffer-names
Dave Love <fx@gnu.org>
parents:
diff changeset
571 You can make certain chosen buffers, for which Emacs normally creates
Dave Love <fx@gnu.org>
parents:
diff changeset
572 a second window when you have just one window, appear in special frames
Dave Love <fx@gnu.org>
parents:
diff changeset
573 of their own. To do this, set the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
574 @code{special-display-buffer-names} to a list of buffer names; any
Dave Love <fx@gnu.org>
parents:
diff changeset
575 buffer whose name is in that list automatically gets a special frame,
Dave Love <fx@gnu.org>
parents:
diff changeset
576 when an Emacs command wants to display it ``in another window.''
Dave Love <fx@gnu.org>
parents:
diff changeset
577
Dave Love <fx@gnu.org>
parents:
diff changeset
578 For example, if you set the variable this way,
Dave Love <fx@gnu.org>
parents:
diff changeset
579
Dave Love <fx@gnu.org>
parents:
diff changeset
580 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
581 (setq special-display-buffer-names
Dave Love <fx@gnu.org>
parents:
diff changeset
582 '("*Completions*" "*grep*" "*tex-shell*"))
Dave Love <fx@gnu.org>
parents:
diff changeset
583 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
584
Dave Love <fx@gnu.org>
parents:
diff changeset
585 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
586 then completion lists, @code{grep} output and the @TeX{} mode shell
Dave Love <fx@gnu.org>
parents:
diff changeset
587 buffer get individual frames of their own. These frames, and the
Dave Love <fx@gnu.org>
parents:
diff changeset
588 windows in them, are never automatically split or reused for any other
Dave Love <fx@gnu.org>
parents:
diff changeset
589 buffers. They continue to show the buffers they were created for,
Dave Love <fx@gnu.org>
parents:
diff changeset
590 unless you alter them by hand. Killing the special buffer deletes its
Dave Love <fx@gnu.org>
parents:
diff changeset
591 frame automatically.
Dave Love <fx@gnu.org>
parents:
diff changeset
592
Dave Love <fx@gnu.org>
parents:
diff changeset
593 @vindex special-display-regexps
Dave Love <fx@gnu.org>
parents:
diff changeset
594 More generally, you can set @code{special-display-regexps} to a list
Dave Love <fx@gnu.org>
parents:
diff changeset
595 of regular expressions; then a buffer gets its own frame if its name
Dave Love <fx@gnu.org>
parents:
diff changeset
596 matches any of those regular expressions. (Once again, this applies only
Dave Love <fx@gnu.org>
parents:
diff changeset
597 to buffers that normally get displayed for you in a separate window.)
Dave Love <fx@gnu.org>
parents:
diff changeset
598
Dave Love <fx@gnu.org>
parents:
diff changeset
599 @vindex special-display-frame-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
600 The variable @code{special-display-frame-alist} specifies the frame
Dave Love <fx@gnu.org>
parents:
diff changeset
601 parameters for these frames. It has a default value, so you don't need
Dave Love <fx@gnu.org>
parents:
diff changeset
602 to set it.
Dave Love <fx@gnu.org>
parents:
diff changeset
603
Dave Love <fx@gnu.org>
parents:
diff changeset
604 For those who know Lisp, an element of
Dave Love <fx@gnu.org>
parents:
diff changeset
605 @code{special-display-buffer-names} or @code{special-display-regexps}
Dave Love <fx@gnu.org>
parents:
diff changeset
606 can also be a list. Then the first element is the buffer name or
Dave Love <fx@gnu.org>
parents:
diff changeset
607 regular expression; the rest of the list specifies how to create the
Dave Love <fx@gnu.org>
parents:
diff changeset
608 frame. It can be an association list specifying frame parameter values;
Dave Love <fx@gnu.org>
parents:
diff changeset
609 these values take precedence over parameter values specified in
Dave Love <fx@gnu.org>
parents:
diff changeset
610 @code{special-display-frame-alist}. Alternatively, it can have this
Dave Love <fx@gnu.org>
parents:
diff changeset
611 form:
Dave Love <fx@gnu.org>
parents:
diff changeset
612
Dave Love <fx@gnu.org>
parents:
diff changeset
613 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
614 (@var{function} @var{args}...)
Dave Love <fx@gnu.org>
parents:
diff changeset
615 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
616
Dave Love <fx@gnu.org>
parents:
diff changeset
617 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
618 where @var{function} is a symbol. Then the frame is constructed by
Dave Love <fx@gnu.org>
parents:
diff changeset
619 calling @var{function}; its first argument is the buffer, and its
Dave Love <fx@gnu.org>
parents:
diff changeset
620 remaining arguments are @var{args}.
Dave Love <fx@gnu.org>
parents:
diff changeset
621
Dave Love <fx@gnu.org>
parents:
diff changeset
622 An analogous feature lets you specify buffers which should be
Dave Love <fx@gnu.org>
parents:
diff changeset
623 displayed in the selected window. @xref{Force Same Window}. The
Dave Love <fx@gnu.org>
parents:
diff changeset
624 same-window feature takes precedence over the special-frame feature;
Dave Love <fx@gnu.org>
parents:
diff changeset
625 therefore, if you add a buffer name to
Dave Love <fx@gnu.org>
parents:
diff changeset
626 @code{special-display-buffer-names} and it has no effect, check to see
Dave Love <fx@gnu.org>
parents:
diff changeset
627 whether that feature is also in use for the same buffer name.
Dave Love <fx@gnu.org>
parents:
diff changeset
628
Dave Love <fx@gnu.org>
parents:
diff changeset
629 @node Frame Parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
630 @section Setting Frame Parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
631 @cindex colors
Dave Love <fx@gnu.org>
parents:
diff changeset
632 @cindex Auto-Raise mode
Dave Love <fx@gnu.org>
parents:
diff changeset
633 @cindex Auto-Lower mode
Dave Love <fx@gnu.org>
parents:
diff changeset
634
Dave Love <fx@gnu.org>
parents:
diff changeset
635 This section describes commands for altering the display style and
Dave Love <fx@gnu.org>
parents:
diff changeset
636 window management behavior of the selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
637
Dave Love <fx@gnu.org>
parents:
diff changeset
638 @findex set-foreground-color
Dave Love <fx@gnu.org>
parents:
diff changeset
639 @findex set-background-color
Dave Love <fx@gnu.org>
parents:
diff changeset
640 @findex set-cursor-color
Dave Love <fx@gnu.org>
parents:
diff changeset
641 @findex set-mouse-color
Dave Love <fx@gnu.org>
parents:
diff changeset
642 @findex set-border-color
Dave Love <fx@gnu.org>
parents:
diff changeset
643 @findex auto-raise-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
644 @findex auto-lower-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
645 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
646 @item M-x set-foreground-color @key{RET} @var{color} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
647 Specify color @var{color} for the foreground of the selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
648 (This also changes the foreground color of the default face.)
Dave Love <fx@gnu.org>
parents:
diff changeset
649
Dave Love <fx@gnu.org>
parents:
diff changeset
650 @item M-x set-background-color @key{RET} @var{color} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
651 Specify color @var{color} for the background of the selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
652 (This also changes the background color of the default face.)
Dave Love <fx@gnu.org>
parents:
diff changeset
653
Dave Love <fx@gnu.org>
parents:
diff changeset
654 @item M-x set-cursor-color @key{RET} @var{color} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
655 Specify color @var{color} for the cursor of the selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
656
Dave Love <fx@gnu.org>
parents:
diff changeset
657 @item M-x set-mouse-color @key{RET} @var{color} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
658 Specify color @var{color} for the mouse cursor when it is over the
Dave Love <fx@gnu.org>
parents:
diff changeset
659 selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
660
Dave Love <fx@gnu.org>
parents:
diff changeset
661 @item M-x set-border-color @key{RET} @var{color} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
662 Specify color @var{color} for the border of the selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
663
Dave Love <fx@gnu.org>
parents:
diff changeset
664 @item M-x list-colors-display
Dave Love <fx@gnu.org>
parents:
diff changeset
665 Display the defined color names and show what the colors look like.
Dave Love <fx@gnu.org>
parents:
diff changeset
666 This command is somewhat slow.
Dave Love <fx@gnu.org>
parents:
diff changeset
667
Dave Love <fx@gnu.org>
parents:
diff changeset
668 @item M-x auto-raise-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
669 Toggle whether or not the selected frame should auto-raise. Auto-raise
Dave Love <fx@gnu.org>
parents:
diff changeset
670 means that every time you move the mouse onto the frame, it raises the
Dave Love <fx@gnu.org>
parents:
diff changeset
671 frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
672
Dave Love <fx@gnu.org>
parents:
diff changeset
673 Note that this auto-raise feature is implemented by Emacs itself. Some
Dave Love <fx@gnu.org>
parents:
diff changeset
674 window managers also implement auto-raise. If you enable auto-raise for
Dave Love <fx@gnu.org>
parents:
diff changeset
675 Emacs frames in your X window manager, it should work, but it is beyond
Dave Love <fx@gnu.org>
parents:
diff changeset
676 Emacs's control and therefore @code{auto-raise-mode} has no effect on
Dave Love <fx@gnu.org>
parents:
diff changeset
677 it.
Dave Love <fx@gnu.org>
parents:
diff changeset
678
Dave Love <fx@gnu.org>
parents:
diff changeset
679 @item M-x auto-lower-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
680 Toggle whether or not the selected frame should auto-lower.
Dave Love <fx@gnu.org>
parents:
diff changeset
681 Auto-lower means that every time you move the mouse off the frame,
Dave Love <fx@gnu.org>
parents:
diff changeset
682 the frame moves to the bottom of the stack of X windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
683
Dave Love <fx@gnu.org>
parents:
diff changeset
684 The command @code{auto-lower-mode} has no effect on auto-lower
Dave Love <fx@gnu.org>
parents:
diff changeset
685 implemented by the X window manager. To control that, you must use
Dave Love <fx@gnu.org>
parents:
diff changeset
686 the appropriate window manager features.
Dave Love <fx@gnu.org>
parents:
diff changeset
687
Dave Love <fx@gnu.org>
parents:
diff changeset
688 @findex set-frame-font
Dave Love <fx@gnu.org>
parents:
diff changeset
689 @item M-x set-frame-font @key{RET} @var{font} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
690 @cindex font (principal)
Dave Love <fx@gnu.org>
parents:
diff changeset
691 Specify font @var{font} as the principal font for the selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
692 The principal font controls several face attributes of the
Dave Love <fx@gnu.org>
parents:
diff changeset
693 @code{default} face (@pxref{Faces}). For example, if the principal font
Dave Love <fx@gnu.org>
parents:
diff changeset
694 has a height of 12 pt, all text will be drawn in 12 pt fonts, unless you
Dave Love <fx@gnu.org>
parents:
diff changeset
695 use another face that specifies a different height. @xref{Font X}, for
Dave Love <fx@gnu.org>
parents:
diff changeset
696 ways to list the available fonts on your system.
Dave Love <fx@gnu.org>
parents:
diff changeset
697
Dave Love <fx@gnu.org>
parents:
diff changeset
698 @kindex S-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
699 You can also set a frame's principal font through a pop-up menu.
Dave Love <fx@gnu.org>
parents:
diff changeset
700 Press @kbd{S-Mouse-1} to activate this menu.
Dave Love <fx@gnu.org>
parents:
diff changeset
701 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
702
Dave Love <fx@gnu.org>
parents:
diff changeset
703 In Emacs versions that use an X toolkit, the color-setting and
Dave Love <fx@gnu.org>
parents:
diff changeset
704 font-setting functions don't affect menus and the menu bar, since they
Dave Love <fx@gnu.org>
parents:
diff changeset
705 are displayed by their own widget classes. To change the appearance of
41374
608e18d9fb18 Fix cross-references to "Resources".
Eli Zaretskii <eliz@gnu.org>
parents: 40527
diff changeset
706 the menus and menu bar, you must use X resources (@pxref{Resources}).
42751
eb194a8d11de "Colors X" -> "Colors".
Eli Zaretskii <eliz@gnu.org>
parents: 41486
diff changeset
707 @xref{Colors}, regarding colors. @xref{Font X}, regarding choice of
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
708 font.
Dave Love <fx@gnu.org>
parents:
diff changeset
709
38670
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
710 Colors, fonts, and other attributes of the frame's display can also
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
711 be customized by setting frame parameters in the variable
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
712 @code{default-frame-alist} (@pxref{Creating Frames}). For a detailed
80a860105400 (Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents: 38205
diff changeset
713 description of frame parameters and customization, see @ref{Frame
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
714 Parameters,,, elisp, The Emacs Lisp Reference Manual}.
Dave Love <fx@gnu.org>
parents:
diff changeset
715
Dave Love <fx@gnu.org>
parents:
diff changeset
716 @node Scroll Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
717 @section Scroll Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
718 @cindex Scroll Bar mode
Dave Love <fx@gnu.org>
parents:
diff changeset
719 @cindex mode, Scroll Bar
Dave Love <fx@gnu.org>
parents:
diff changeset
720
Dave Love <fx@gnu.org>
parents:
diff changeset
721 When using X, Emacs normally makes a @dfn{scroll bar} at the left of
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
722 each Emacs window.@footnote{Placing it at the left is usually more
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
723 useful with overlapping frames with text starting at the left margin.}
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
724 The scroll bar runs the height of the window, and shows a moving
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
725 rectangular inner box which represents the portion of the buffer
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
726 currently displayed. The entire height of the scroll bar represents the
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
727 entire length of the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
728
Dave Love <fx@gnu.org>
parents:
diff changeset
729 You can use @kbd{Mouse-2} (normally, the middle button) in the scroll
Dave Love <fx@gnu.org>
parents:
diff changeset
730 bar to move or drag the inner box up and down. If you move it to the
Dave Love <fx@gnu.org>
parents:
diff changeset
731 top of the scroll bar, you see the top of the buffer. If you move it to
Dave Love <fx@gnu.org>
parents:
diff changeset
732 the bottom of the scroll bar, you see the bottom of the buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
733
Dave Love <fx@gnu.org>
parents:
diff changeset
734 The left and right buttons in the scroll bar scroll by controlled
Dave Love <fx@gnu.org>
parents:
diff changeset
735 increments. @kbd{Mouse-1} (normally, the left button) moves the line at
Dave Love <fx@gnu.org>
parents:
diff changeset
736 the level where you click up to the top of the window. @kbd{Mouse-3}
Dave Love <fx@gnu.org>
parents:
diff changeset
737 (normally, the right button) moves the line at the top of the window
Dave Love <fx@gnu.org>
parents:
diff changeset
738 down to the level where you click. By clicking repeatedly in the same
Dave Love <fx@gnu.org>
parents:
diff changeset
739 place, you can scroll by the same distance over and over.
Dave Love <fx@gnu.org>
parents:
diff changeset
740
34523
ae23bd13d2ee *** empty log message ***
Dave Love <fx@gnu.org>
parents: 34444
diff changeset
741 If you are using Emacs's own implementation of scroll bars, as opposed
34444
ffd94915c70a *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents: 34040
diff changeset
742 to scroll bars from an X toolkit, you can also click @kbd{C-Mouse-2} in
ffd94915c70a *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents: 34040
diff changeset
743 the scroll bar to split a window vertically. The split occurs on the
ffd94915c70a *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents: 34040
diff changeset
744 line where you click.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
745
Dave Love <fx@gnu.org>
parents:
diff changeset
746 @findex scroll-bar-mode
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
747 @vindex scroll-bar-mode
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
748 You can enable or disable Scroll Bar mode with the command @kbd{M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
749 scroll-bar-mode}. With no argument, it toggles the use of scroll bars.
Dave Love <fx@gnu.org>
parents:
diff changeset
750 With an argument, it turns use of scroll bars on if and only if the
Dave Love <fx@gnu.org>
parents:
diff changeset
751 argument is positive. This command applies to all frames, including
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
752 frames yet to be created. Customize the option @code{scroll-bar-mode}
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
753 to control the use of scroll bars at startup. You can use it to specify
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
754 that they are placed at the right of windows if you prefer that. You
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
755 can use the X resource @samp{verticalScrollBars} to control the initial
41374
608e18d9fb18 Fix cross-references to "Resources".
Eli Zaretskii <eliz@gnu.org>
parents: 40527
diff changeset
756 setting of Scroll Bar mode similarly. @xref{Resources}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
757
Dave Love <fx@gnu.org>
parents:
diff changeset
758 @findex toggle-scroll-bar
Dave Love <fx@gnu.org>
parents:
diff changeset
759 To enable or disable scroll bars for just the selected frame, use the
Dave Love <fx@gnu.org>
parents:
diff changeset
760 @kbd{M-x toggle-scroll-bar} command.
Dave Love <fx@gnu.org>
parents:
diff changeset
761
36979
d6339c5b09f1 (Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents: 36864
diff changeset
762 @vindex scroll-bar-width
d6339c5b09f1 (Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents: 36864
diff changeset
763 @cindex width of the scroll bar
d6339c5b09f1 (Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents: 36864
diff changeset
764 You can control the scroll bar width by changing the value of the
d6339c5b09f1 (Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents: 36864
diff changeset
765 @code{scroll-bar-width} frame parameter.
d6339c5b09f1 (Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents: 36864
diff changeset
766
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
767 @node Wheeled Mice
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
768 @section Scrolling With ``Wheeled'' Mice
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
769
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
770 @cindex mouse wheel
36864
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
771 @cindex wheel, mouse
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
772 @findex mouse-wheel-mode
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
773 @cindex Mouse Wheel minor mode
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
774 @cindex mode, Mouse Wheel
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
775 Some mice have a ``wheel'' instead of a third button. You can
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
776 usually click the wheel to act as either @kbd{Mouse-2} or
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
777 @kbd{Mouse-3}, depending on the setup. You can also use the wheel to
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
778 scroll windows instead of using the scroll bar or keyboard commands.
36864
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
779 To do so, turn on Mouse Wheel global minor mode with the command
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
780 @kbd{M-x mouse-wheel-mode} or by customizing the option
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
781 @code{mouse-wheel-mode}. Support for the wheel depends on the system
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
782 generating appropriate events for Emacs.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
783
35875
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
784 @vindex mouse-wheel-follow-mouse
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
785 @vindex mouse-wheel-scroll-amount
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
786 The variables @code{mouse-wheel-follow-mouse} and
35875
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
787 @code{mouse-wheel-scroll-amount} determine where and by how much
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
788 buffers are scrolled.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
789
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
790 @node Menu Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
791 @section Menu Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
792 @cindex Menu Bar mode
Dave Love <fx@gnu.org>
parents:
diff changeset
793 @cindex mode, Menu Bar
Dave Love <fx@gnu.org>
parents:
diff changeset
794
Dave Love <fx@gnu.org>
parents:
diff changeset
795 You can turn display of menu bars on or off with @kbd{M-x
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
796 menu-bar-mode} or by customizing the option @code{menu-bar-mode}.
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
797 With no argument, this command toggles Menu Bar mode, a
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
798 minor mode. With an argument, the command turns Menu Bar mode on if the
Dave Love <fx@gnu.org>
parents:
diff changeset
799 argument is positive, off if the argument is not positive. You can use
Dave Love <fx@gnu.org>
parents:
diff changeset
800 the X resource @samp{menuBarLines} to control the initial setting of
41374
608e18d9fb18 Fix cross-references to "Resources".
Eli Zaretskii <eliz@gnu.org>
parents: 40527
diff changeset
801 Menu Bar mode. @xref{Resources}.
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
802
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
803 @kindex C-Mouse-3 @r{(when menu bar is disabled)}
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
804 Expert users often turn off the menu bar, especially on text-only
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
805 terminals, where this makes one additional line available for text.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
806 If the menu bar is off, you can still pop up a menu of its contents
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38670
diff changeset
807 with @kbd{C-Mouse-3} on a display which supports pop-up menus.
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
808 @xref{Menu Mouse Clicks}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
809
Dave Love <fx@gnu.org>
parents:
diff changeset
810 @xref{Menu Bar}, for information on how to invoke commands with the
40527
65438689dd69 Add xrefs to X Resources.
Richard M. Stallman <rms@gnu.org>
parents: 39267
diff changeset
811 menu bar. @xref{X Resources}, for how to customize the menu bar
65438689dd69 Add xrefs to X Resources.
Richard M. Stallman <rms@gnu.org>
parents: 39267
diff changeset
812 menus.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
813
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
814 @node Tool Bars
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
815 @section Tool Bars
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
816 @cindex Tool Bar mode
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
817 @cindex mode, Tool Bar
34040
dbe2757d6cb8 Tool bar tweak.
Dave Love <fx@gnu.org>
parents: 33920
diff changeset
818 @cindex icons, tool bar
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
819
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
820 The @dfn{tool bar} is a line (or multiple lines) of icons at the top
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
821 of the Emacs window. You can click on these icons with the mouse
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
822 to do various jobs.
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
823
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
824 The global tool bar contains general commands. Some major modes
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
825 define their own tool bars to replace it. A few ``special'' modes
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
826 that are not designed for ordinary editing remove some items from the
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
827 global tool bar.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
828
36408
f6cf1681b74a Fix tool bar caveat.
Dave Love <fx@gnu.org>
parents: 36384
diff changeset
829 Tool bars work only on a graphical display. The tool bar uses colored
f6cf1681b74a Fix tool bar caveat.
Dave Love <fx@gnu.org>
parents: 36384
diff changeset
830 XPM icons if Emacs was built with XPM support. Otherwise, the tool
f6cf1681b74a Fix tool bar caveat.
Dave Love <fx@gnu.org>
parents: 36384
diff changeset
831 bar uses monochrome icons (PBM or XBM format).
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
832
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
833 You can turn display of tool bars on or off with @kbd{M-x
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
834 tool-bar-mode}.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
835
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
836 @node Dialog Boxes
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
837 @section Using Dialog Boxes
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
838 @cindex dialog boxes
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
839
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
840 @vindex use-dialog-box
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
841 A dialog box is a special kind of menu for asking you a yes-or-no
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
842 question or some other special question. Many Emacs commands use a
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
843 dialog box to ask a yes-or-no question, if you used the mouse to
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
844 invoke the command to begin with.
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
845
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
846 You can customize the option @code{use-dialog-box} to suppress the
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
847 use of dialog boxes. This also controls whether to use file selection
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
848 windows (but those are not supported on all platforms).
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
849
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
850 @node Tooltips
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
851 @section Tooltips (or ``Balloon Help'')
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
852
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
853 @cindex balloon help
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
854 Tooltips are small X windows displaying a help string at the current
28432
a232089b2eea Tooltips extra. C-x 5 1.
Dave Love <fx@gnu.org>
parents: 28126
diff changeset
855 mouse position, typically over text---including the mode line---which
a232089b2eea Tooltips extra. C-x 5 1.
Dave Love <fx@gnu.org>
parents: 28126
diff changeset
856 can be activated with the mouse or other keys. (This facility is
36185
62cf166239f3 Change in quoting.
Richard M. Stallman <rms@gnu.org>
parents: 36156
diff changeset
857 sometimes known as @dfn{balloon help}.) Help text may be available for
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
858 menu items too.
28432
a232089b2eea Tooltips extra. C-x 5 1.
Dave Love <fx@gnu.org>
parents: 28126
diff changeset
859
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
860 @findex tooltip-mode
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
861 To use tooltips, enable Tooltip mode with the command @kbd{M-x
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
862 tooltip-mode}. The customization group @code{tooltip} controls
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
863 various aspects of how tooltips work. When Tooltip mode is disabled,
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
864 the help text is displayed in the echo area instead.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
865
40527
65438689dd69 Add xrefs to X Resources.
Richard M. Stallman <rms@gnu.org>
parents: 39267
diff changeset
866 @xref{X Resources}, for information on customizing the windows
65438689dd69 Add xrefs to X Resources.
Richard M. Stallman <rms@gnu.org>
parents: 39267
diff changeset
867 that display tooltips.
35730
37c3ff967327 Document non-support of tool bar and tooltips on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 35188
diff changeset
868
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
869 @node Mouse Avoidance
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
870 @section Mouse Avoidance
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
871 @cindex avoiding mouse in the way of your typing
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
872 @cindex mouse avoidance
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
873
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
874 @vindex mouse-avoidance-mode
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
875 Mouse Avoidance mode keeps the window system mouse pointer away from
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
876 point, to avoid obscuring text. Whenever it moves the mouse, it also
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
877 raises the frame. To use Mouse Avoidance mode, customize the option
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
878 @code{mouse-avoidance-mode}. You can set this to various values to
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
879 move the mouse in several ways:
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
880
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
881 @table @code
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
882 @item banish
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38670
diff changeset
883 Move the mouse to the upper-right corner on any key-press;
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
884 @item exile
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
885 Move the mouse to the corner only if the cursor gets too close,
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
886 and allow it to return once the cursor is out of the way;
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
887 @item jump
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
888 If the cursor gets too close to the mouse, displace the mouse
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
889 a random distance & direction;
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
890 @item animate
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
891 As @code{jump}, but shows steps along the way for illusion of motion;
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
892 @item cat-and-mouse
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
893 The same as @code{animate};
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
894 @item proteus
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
895 As @code{animate}, but changes the shape of the mouse pointer too.
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
896 @end table
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
897
36156
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
898 @findex mouse-avoidance-mode
3a9de976b35c Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents: 35954
diff changeset
899 You can also use the command @kbd{M-x mouse-avoidance-mode} to enable
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
900 the mode.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
901
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
902 @node Non-Window Terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
903 @section Non-Window Terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
904 @cindex non-window terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
905 @cindex single-frame terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
906
Dave Love <fx@gnu.org>
parents:
diff changeset
907 If your terminal does not have a window system that Emacs supports,
Dave Love <fx@gnu.org>
parents:
diff changeset
908 then it can display only one Emacs frame at a time. However, you can
Dave Love <fx@gnu.org>
parents:
diff changeset
909 still create multiple Emacs frames, and switch between them. Switching
Dave Love <fx@gnu.org>
parents:
diff changeset
910 frames on these terminals is much like switching between different
Dave Love <fx@gnu.org>
parents:
diff changeset
911 window configurations.
Dave Love <fx@gnu.org>
parents:
diff changeset
912
Dave Love <fx@gnu.org>
parents:
diff changeset
913 Use @kbd{C-x 5 2} to create a new frame and switch to it; use @kbd{C-x
Dave Love <fx@gnu.org>
parents:
diff changeset
914 5 o} to cycle through the existing frames; use @kbd{C-x 5 0} to delete
Dave Love <fx@gnu.org>
parents:
diff changeset
915 the current frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
916
Dave Love <fx@gnu.org>
parents:
diff changeset
917 Each frame has a number to distinguish it. If your terminal can
Dave Love <fx@gnu.org>
parents:
diff changeset
918 display only one frame at a time, the selected frame's number @var{n}
Dave Love <fx@gnu.org>
parents:
diff changeset
919 appears near the beginning of the mode line, in the form
Dave Love <fx@gnu.org>
parents:
diff changeset
920 @samp{F@var{n}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
921
Dave Love <fx@gnu.org>
parents:
diff changeset
922 @findex set-frame-name
Dave Love <fx@gnu.org>
parents:
diff changeset
923 @findex select-frame-by-name
Dave Love <fx@gnu.org>
parents:
diff changeset
924 @samp{F@var{n}} is actually the frame's name. You can also specify a
Dave Love <fx@gnu.org>
parents:
diff changeset
925 different name if you wish, and you can select a frame by its name. Use
Dave Love <fx@gnu.org>
parents:
diff changeset
926 the command @kbd{M-x set-frame-name @key{RET} @var{name} @key{RET}} to
Dave Love <fx@gnu.org>
parents:
diff changeset
927 specify a new name for the selected frame, and use @kbd{M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
928 select-frame-by-name @key{RET} @var{name} @key{RET}} to select a frame
Dave Love <fx@gnu.org>
parents:
diff changeset
929 according to its name. The name you specify appears in the mode line
Dave Love <fx@gnu.org>
parents:
diff changeset
930 when the frame is selected.
Dave Love <fx@gnu.org>
parents:
diff changeset
931
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
932 @node XTerm Mouse
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
933 @section Using a Mouse in Terminal Emulators
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
934 @cindex xterm, mouse support
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
935 @cindex terminal emulators, mouse support
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
936
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
937 Some terminal emulators under X support mouse clicks in the terminal
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
938 window. In a terminal emulator which is compatible with @code{xterm},
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
939 you can use @kbd{M-x xterm-mouse-mode} to enable simple use of the
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
940 mouse---only single clicks are supported. The normal @code{xterm} mouse
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
941 functionality is still available by holding down the @kbd{SHIFT} key
36864
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
942 when you press the mouse button. The Linux console supports this
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
943 mode if it has support for the mouse enabled, e.g.@: using the
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
944 @command{gpm} daemon.