Mercurial > emacs
annotate man/frames.texi @ 81015:72b9f4dba30d
(show-paren-function): Undo 2007-04-19 and 2007-04-20 changes.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Mon, 21 May 2007 20:09:57 +0000 |
parents | 588363d97121 |
children | 02b9a9aa5b0c dc002877ce12 e6fdae9180d4 |
rev | line source |
---|---|
25829 | 1 @c This is part of the Emacs manual. |
64890
3723093a21fd
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64458
diff
changeset
|
2 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 1999, 2000, |
75348 | 3 @c 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc. |
25829 | 4 @c See file emacs.texi for copying conditions. |
5 @node Frames, International, Windows, Top | |
68542 | 6 @chapter Frames and Graphical Displays |
25829 | 7 @cindex frames |
8 | |
68542 | 9 When using a graphical display, you can create multiple windows at |
10 the system in a single Emacs session. Each system-level window that | |
11 belongs to Emacs displays a @dfn{frame} which can contain one or | |
12 several Emacs windows. A frame initially contains a single | |
13 general-purpose Emacs window which you can subdivide vertically or | |
14 horizontally into smaller windows. A frame normally contains its own | |
15 echo area and minibuffer, but you can make frames that don't have | |
16 these---they use the echo area and minibuffer of another frame. | |
25829 | 17 |
68542 | 18 To avoid confusion, we reserve the word ``window'' for the |
19 subdivisions that Emacs implements, and never use it to refer to a | |
20 frame. | |
21 | |
22 Editing you do in one frame affects the other frames. For | |
25829 | 23 instance, if you put text in the kill ring in one frame, you can yank it |
24 in another frame. If you exit Emacs through @kbd{C-x C-c} in one frame, | |
25 it terminates all the frames. To delete just one frame, use @kbd{C-x 5 | |
37121 | 26 0} (that is zero, not @kbd{o}). |
25829 | 27 |
68542 | 28 Emacs compiled for MS-DOS emulates some windowing functionality, |
25829 | 29 so that you can use many of the features described in this chapter. |
70444
fea4846478f5
(Frames): Replace inforef to emacs-xtra by conditional xref's, depending on
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
30 @iftex |
69898
601830ae280c
move MS-DOS material to emacs-xtra.texi
Karl Berry <karl@gnu.org>
parents:
68844
diff
changeset
|
31 @xref{MS-DOS Mouse,,,emacs-xtra,Specialized Emacs Features}. |
70444
fea4846478f5
(Frames): Replace inforef to emacs-xtra by conditional xref's, depending on
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
32 @end iftex |
fea4846478f5
(Frames): Replace inforef to emacs-xtra by conditional xref's, depending on
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
33 @ifnottex |
fea4846478f5
(Frames): Replace inforef to emacs-xtra by conditional xref's, depending on
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
34 @xref{MS-DOS Mouse}. |
fea4846478f5
(Frames): Replace inforef to emacs-xtra by conditional xref's, depending on
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
35 @end ifnottex |
fea4846478f5
(Frames): Replace inforef to emacs-xtra by conditional xref's, depending on
Eli Zaretskii <eliz@gnu.org>
parents:
69898
diff
changeset
|
36 |
25829 | 37 @menu |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
38 * Cut and Paste:: Mouse commands for cut and paste. |
25829 | 39 * Mouse References:: Using the mouse to select an item from a list. |
40 * Menu Mouse Clicks:: Mouse clicks that bring up menus. | |
41 * 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
|
42 * 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
|
43 * Frame Commands:: Iconifying, deleting, and switching frames. |
25829 | 44 * Speedbar:: How to make and use a speedbar frame. |
45 * Multiple Displays:: How one Emacs job can talk to several displays. | |
46 * Special Buffer Frames:: You can make certain buffers have their own frames. | |
47 * Frame Parameters:: Changing the colors and other modes of frames. | |
48 * 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
|
49 * Wheeled Mice:: Using mouse wheels for scrolling. |
59895
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
50 * Drag and Drop:: Using drag and drop to open files and insert text. |
25829 | 51 * Menu Bars:: Enabling and disabling the menu bar. |
31609 | 52 * 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
|
53 * Dialog Boxes:: Controlling use of dialog boxes. |
62172
517435a249bb
(Tooltips): Describe help tooltips and GUD tooltips
Nick Roberts <nickrob@snap.net.nz>
parents:
62161
diff
changeset
|
54 * Tooltips:: Displaying information at the current mouse position. |
28124 | 55 * Mouse Avoidance:: Moving the mouse pointer out of the way. |
25829 | 56 * Non-Window Terminals:: Multiple frames on terminals that show only one. |
71482
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
57 * Text-Only Mouse:: Using the mouse in text-only terminals. |
25829 | 58 @end menu |
59 | |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
60 @node Cut and Paste |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
61 @section Killing and Yanking on Graphical Displays |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
62 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
63 This section describes facilities for selecting a region, killing, |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
64 and yanking using the mouse. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
65 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
66 @menu |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
67 * Mouse Commands:: Moving, cutting, and pasting, with the mouse. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
68 * Cut/Paste Other App:: Transfering text between Emacs and other apps. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
69 * Word and Line Mouse:: Mouse commands for selecting whole words or lines. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
70 * Secondary Selection:: Cutting without altering point and mark. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
71 * Clipboard:: Using the clipboard for selections. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
72 @end menu |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
73 |
25829 | 74 @node Mouse Commands |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
75 @subsection Mouse Commands for Editing |
25829 | 76 @cindex mouse buttons (what they do) |
77 | |
78 The mouse commands for selecting and copying a region are mostly | |
79 compatible with the @code{xterm} program. You can use the same mouse | |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
80 commands for copying between Emacs and other window-based programs. |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
81 Most of these commands also work in Emacs when you run it under an |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
82 @code{xterm} terminal. |
25829 | 83 |
36729
d93d962f201d
Minor change in @kindex.
Richard M. Stallman <rms@gnu.org>
parents:
36553
diff
changeset
|
84 @kindex DELETE @r{(and mouse selection)} |
25829 | 85 If you select a region with any of these mouse commands, and then |
86 immediately afterward type the @key{DELETE} function key, it deletes the | |
87 region that you selected. The @key{BACKSPACE} function key and the | |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52401
diff
changeset
|
88 @acronym{ASCII} character @key{DEL} do not do this; if you type any other key |
25829 | 89 in between the mouse command and @key{DELETE}, it does not do this. |
90 | |
91 @findex mouse-set-region | |
92 @findex mouse-set-point | |
93 @findex mouse-yank-at-click | |
94 @findex mouse-save-then-click | |
95 @kindex Mouse-1 | |
96 @kindex Mouse-2 | |
97 @kindex Mouse-3 | |
98 @table @kbd | |
99 @item Mouse-1 | |
100 Move point to where you click (@code{mouse-set-point}). | |
101 This is normally the left button. | |
102 | |
60952
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
103 @vindex x-mouse-click-focus-ignore-position |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
104 Normally, Emacs does not distinguish between ordinary mouse clicks and |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
105 clicks that select a frame. When you click on a frame to select it, |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
106 that also changes the selected window and cursor position according to |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
107 the mouse click position. On the X window system, you can change this |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
108 behavior by setting the variable |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
109 @code{x-mouse-click-focus-ignore-position} to @code{t}. Then the |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
110 first click selects the frame, but does not affect the selected window |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
111 or cursor position. If you click again in the same place, since that |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
112 click will be in the selected frame, it will change the window or |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
113 cursor position. |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
114 |
25829 | 115 @item Drag-Mouse-1 |
116 Set the region to the text you select by dragging, and copy it to the | |
117 kill ring (@code{mouse-set-region}). You can specify both ends of the | |
118 region with this single command. | |
119 | |
120 @vindex mouse-scroll-min-lines | |
121 If you move the mouse off the top or bottom of the window while | |
122 dragging, the window scrolls at a steady rate until you move the mouse | |
123 back into the window. This way, you can select regions that don't fit | |
124 entirely on the screen. The number of lines scrolled per step depends | |
125 on how far away from the window edge the mouse has gone; the variable | |
126 @code{mouse-scroll-min-lines} specifies a minimum step size. | |
127 | |
60952
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
128 @vindex mouse-drag-copy-region |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
129 If the variable @code{mouse-drag-copy-region} is @code{nil}, this |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
130 mouse command does not copy the selected region into the kill ring. |
7dd13cb23e14
(Mouse Commands): Document x-mouse-click-focus-ignore-position and
Richard M. Stallman <rms@gnu.org>
parents:
60793
diff
changeset
|
131 |
25829 | 132 @item Mouse-2 |
133 Yank the last killed text, where you click (@code{mouse-yank-at-click}). | |
134 This is normally the middle button. | |
135 | |
136 @item Mouse-3 | |
137 This command, @code{mouse-save-then-kill}, has several functions | |
138 depending on where you click and the status of the region. | |
139 | |
140 The most basic case is when you click @kbd{Mouse-1} in one place and | |
141 then @kbd{Mouse-3} in another. This selects the text between those two | |
142 positions as the region. It also copies the new region to the kill | |
143 ring, so that you can copy it to someplace else. | |
144 | |
145 If you click @kbd{Mouse-1} in the text, scroll with the scroll bar, and | |
146 then click @kbd{Mouse-3}, it remembers where point was before scrolling | |
147 (where you put it with @kbd{Mouse-1}), and uses that position as the | |
148 other end of the region. This is so that you can select a region that | |
149 doesn't fit entirely on the screen. | |
150 | |
151 More generally, if you do not have a highlighted region, @kbd{Mouse-3} | |
152 selects the text between point and the click position as the region. It | |
153 does this by setting the mark where point was, and moving point to where | |
154 you click. | |
155 | |
156 If you have a highlighted region, or if the region was set just before | |
157 by dragging button 1, @kbd{Mouse-3} adjusts the nearer end of the region | |
158 by moving it to where you click. The adjusted region's text also | |
159 replaces the old region's text in the kill ring. | |
160 | |
161 If you originally specified the region using a double or triple | |
162 @kbd{Mouse-1}, so that the region is defined to consist of entire words | |
163 or lines, then adjusting the region with @kbd{Mouse-3} also proceeds by | |
164 entire words or lines. | |
165 | |
166 If you use @kbd{Mouse-3} a second time consecutively, at the same place, | |
167 that kills the region already selected. | |
168 @end table | |
169 | |
170 The simplest way to kill text with the mouse is to press @kbd{Mouse-1} | |
171 at one end, then press @kbd{Mouse-3} twice at the other end. | |
172 @xref{Killing}. To copy the text into the kill ring without deleting it | |
173 from the buffer, press @kbd{Mouse-3} just once---or just drag across the | |
174 text with @kbd{Mouse-1}. Then you can copy it elsewhere by yanking it. | |
175 | |
176 @vindex mouse-yank-at-point | |
177 To yank the killed or copied text somewhere else, move the mouse there | |
178 and press @kbd{Mouse-2}. @xref{Yanking}. However, if | |
179 @code{mouse-yank-at-point} is non-@code{nil}, @kbd{Mouse-2} yanks at | |
180 point. Then it does not matter where you click, or even which of the | |
181 frame's windows you click on. The default value is @code{nil}. This | |
182 variable also affects yanking the secondary selection. | |
183 | |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
184 @cindex Delete Selection mode |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
185 @cindex mode, Delete Selection |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
186 @findex delete-selection-mode |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
187 Many graphical applications follow the convention that insertion while text |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
188 is selected deletes the selected text. You can make Emacs behave this |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
189 way by enabling Delete Selection mode---with @kbd{M-x |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
190 delete-selection-mode} or using Custom. Another effect of this mode |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
191 is that @key{DEL}, @kbd{C-d} and some other keys, when a selection |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
192 exists, will kill the whole selection. It also enables Transient Mark |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
193 mode (@pxref{Transient Mark}). |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
194 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
195 @node Cut/Paste Other App |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
196 @subsection Cut and Paste with Other Window Applications |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
197 |
68542 | 198 @cindex cutting |
199 @cindex pasting | |
25829 | 200 @cindex X cutting and pasting |
68542 | 201 To copy text to another windowing application, kill it or save it in |
202 the kill ring. Then use the ``paste'' or ``yank'' command of the | |
203 other application to insert the text. | |
25829 | 204 |
68542 | 205 To copy text from another windowing application, use its ``cut'' or |
206 ``copy'' command to select the text you want. Then yank it in Emacs | |
207 with @kbd{C-y} or @kbd{Mouse-2}. | |
25829 | 208 |
209 @cindex primary selection | |
210 @cindex cut buffer | |
211 @cindex selection, primary | |
212 @vindex x-cut-buffer-max | |
68542 | 213 When Emacs puts text into the kill ring, or rotates text to the |
214 front of the kill ring, it sets the @dfn{primary selection} in the | |
215 window system. This is how other windowing applications can access | |
216 the text. On the X Window System, emacs also stores the text in the | |
217 cut buffer, but only if the text is short enough (the value of | |
218 @code{x-cut-buffer-max} specifies the maximum number of characters); | |
219 putting long strings in the cut buffer can be slow. | |
25829 | 220 |
221 The commands to yank the first entry in the kill ring actually check | |
222 first for a primary selection in another program; after that, they check | |
223 for text in the cut buffer. If neither of those sources provides text | |
224 to yank, the kill ring contents are used. | |
225 | |
68542 | 226 The standard coding system for X Window System selections is |
227 @code{compound-text-with-extensions}. To specify another coding | |
228 system for selections, use @kbd{C-x @key{RET} x} or @kbd{C-x @key{RET} | |
229 X}. @xref{Communication Coding}. | |
230 | |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
231 @node Word and Line Mouse |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
232 @subsection Mouse Commands for Words and Lines |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
233 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
234 These variants of @kbd{Mouse-1} select entire words or lines at a time. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
235 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
236 @table @kbd |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
237 @item Double-Mouse-1 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
238 This key sets the region around the word which you click on. If you |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
239 click on a character with ``symbol'' syntax (such as underscore, in C |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
240 mode), it sets the region around the symbol surrounding that character. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
241 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
242 If you click on a character with open-parenthesis or close-parenthesis |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
243 syntax, it sets the region around the parenthetical grouping |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
244 which that character starts or ends. If you click on a character with |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
245 string-delimiter syntax (such as a singlequote or doublequote in C), it |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
246 sets the region around the string constant (using heuristics to figure |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
247 out whether that character is the beginning or the end of it). |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
248 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
249 @item Double-Drag-Mouse-1 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
250 This key selects a region made up of the words you drag across. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
251 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
252 @item Triple-Mouse-1 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
253 This key sets the region around the line you click on. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
254 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
255 @item Triple-Drag-Mouse-1 |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
256 This key selects a region made up of the lines you drag across. |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
257 @end table |
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
258 |
25829 | 259 @node Secondary Selection |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
260 @subsection Secondary Selection |
25829 | 261 @cindex secondary selection |
262 | |
263 The @dfn{secondary selection} is another way of selecting text using | |
68542 | 264 the X Window System. It does not use point or the mark, so you can |
265 use it to kill text without setting point or the mark. | |
25829 | 266 |
267 @table @kbd | |
268 @findex mouse-set-secondary | |
269 @kindex M-Drag-Mouse-1 | |
270 @item M-Drag-Mouse-1 | |
271 Set the secondary selection, with one end at the place where you press | |
272 down the button, and the other end at the place where you release it | |
273 (@code{mouse-set-secondary}). The highlighting appears and changes as | |
37121 | 274 you drag. You can control the appearance of the highlighting by |
275 customizing the @code{secondary-selection} face (@pxref{Face | |
276 Customization}). | |
25829 | 277 |
278 If you move the mouse off the top or bottom of the window while | |
279 dragging, the window scrolls at a steady rate until you move the mouse | |
280 back into the window. This way, you can mark regions that don't fit | |
281 entirely on the screen. | |
282 | |
56822
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
283 This way of setting the secondary selection does not alter the kill ring. |
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
284 |
25829 | 285 @findex mouse-start-secondary |
286 @kindex M-Mouse-1 | |
287 @item M-Mouse-1 | |
288 Set one endpoint for the @dfn{secondary selection} | |
289 (@code{mouse-start-secondary}). | |
290 | |
291 @findex mouse-secondary-save-then-kill | |
292 @kindex M-Mouse-3 | |
293 @item M-Mouse-3 | |
294 Make a secondary selection, using the place specified with @kbd{M-Mouse-1} | |
56822
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
295 as the other end (@code{mouse-secondary-save-then-kill}). This also |
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
296 puts the selected text in the kill ring. A second click at the same |
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
297 place kills the secondary selection just made. |
25829 | 298 |
299 @findex mouse-yank-secondary | |
300 @kindex M-Mouse-2 | |
301 @item M-Mouse-2 | |
302 Insert the secondary selection where you click | |
303 (@code{mouse-yank-secondary}). This places point at the end of the | |
304 yanked text. | |
305 @end table | |
306 | |
307 Double or triple clicking of @kbd{M-Mouse-1} operates on words and | |
308 lines, much like @kbd{Mouse-1}. | |
309 | |
75529
66c67706eaa7
(Secondary Selection): Window clicked does not matter when
Chong Yidong <cyd@stupidchicken.com>
parents:
75348
diff
changeset
|
310 If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-Mouse-2} yanks |
66c67706eaa7
(Secondary Selection): Window clicked does not matter when
Chong Yidong <cyd@stupidchicken.com>
parents:
75348
diff
changeset
|
311 at point. Then it does not matter precisely where you click, or even |
66c67706eaa7
(Secondary Selection): Window clicked does not matter when
Chong Yidong <cyd@stupidchicken.com>
parents:
75348
diff
changeset
|
312 which of the frame's windows you click on. @xref{Mouse Commands}. |
25829 | 313 |
33920 | 314 @node Clipboard |
74899
88568ee4f8e8
(Cut and Paste): New section to hold other nodes.
Richard M. Stallman <rms@gnu.org>
parents:
73179
diff
changeset
|
315 @subsection Using the Clipboard |
33920 | 316 @cindex clipboard |
317 @vindex x-select-enable-clipboard | |
318 @findex menu-bar-enable-clipboard | |
319 @cindex OpenWindows | |
320 @cindex Gnome | |
321 | |
68542 | 322 Apart from the primary and secondary selection types, Emacs can |
323 handle the @dfn{clipboard} selection type which is used by some | |
324 applications, particularly under OpenWindows and Gnome. | |
33920 | 325 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
326 The command @kbd{M-x menu-bar-enable-clipboard} makes the @code{Cut}, |
33920 | 327 @code{Paste} and @code{Copy} menu items, as well as the keys of the same |
328 names, all use the clipboard. | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49453
diff
changeset
|
329 |
59798
0816b427495a
Don't say just "option" when talking about variables.
Richard M. Stallman <rms@gnu.org>
parents:
59153
diff
changeset
|
330 You can customize the variable @code{x-select-enable-clipboard} to make |
33920 | 331 the Emacs yank functions consult the clipboard before the primary |
332 selection, and to make the kill functions to store in the clipboard as | |
333 well as the primary selection. Otherwise they do not access the | |
68844
0bd1d58e9cb0
(Clipboard): Mention Mac OS port.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents:
68689
diff
changeset
|
334 clipboard at all. Using the clipboard is the default on MS-Windows and Mac, |
68542 | 335 but not on other systems. |
33920 | 336 |
25829 | 337 @node Mouse References |
338 @section Following References with the Mouse | |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
339 @kindex Mouse-1 @r{(selection)} |
25829 | 340 @kindex Mouse-2 @r{(selection)} |
341 | |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
342 Some read-only Emacs buffers include references you can follow, or |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
343 commands you can activate. These include names of files, of buffers, |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
344 of possible completions, of matches for a pattern, as well as the |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
345 buttons in Help buffers and customization buffers. You can follow the |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
346 reference or activate the command by moving point to it and typing |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
347 @key{RET}. You can also do this with the mouse, using either |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
348 @kbd{Mouse-1} or @kbd{Mouse-2}. |
25829 | 349 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
350 Since yanking text into a read-only buffer is not allowed, these |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
351 buffers generally define @kbd{Mouse-2} to follow a reference or |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
352 activate a command. For example, if you click @kbd{Mouse-2} on a file |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
353 name in a Dired buffer, you visit that file. If you click |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
354 @kbd{Mouse-2} on an error message in the @samp{*Compilation*} buffer, |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
355 you go to the source code for that error message. If you click |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
356 @kbd{Mouse-2} on a completion in the @samp{*Completions*} buffer, you |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
357 choose that completion. |
25829 | 358 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
359 However, most applications use @kbd{Mouse-1} to do this sort of |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
360 thing, so Emacs implements this too. If you click @kbd{Mouse-1} |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
361 quickly on a reference or button, it follows or activates. If you |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
362 click slowly, it moves point as usual. Dragging, meaning moving the |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
363 mouse while it is held down, also has its usual behavior of setting |
62161
337108d8074e
(Mouse References): Clarify `mouse-1-click-follows-link'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61837
diff
changeset
|
364 the region. |
25829 | 365 |
62161
337108d8074e
(Mouse References): Clarify `mouse-1-click-follows-link'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61837
diff
changeset
|
366 @vindex mouse-1-click-in-non-selected-windows |
60254
3e7559716275
(Mouse References): Add mouse-1-click-in-non-selected-windows.
Kim F. Storm <storm@cua.dk>
parents:
60120
diff
changeset
|
367 Normally, the @kbd{Mouse-1} click behavior is performed on links in |
3e7559716275
(Mouse References): Add mouse-1-click-in-non-selected-windows.
Kim F. Storm <storm@cua.dk>
parents:
60120
diff
changeset
|
368 any window. The variable @code{mouse-1-click-in-non-selected-windows} |
3e7559716275
(Mouse References): Add mouse-1-click-in-non-selected-windows.
Kim F. Storm <storm@cua.dk>
parents:
60120
diff
changeset
|
369 controls whether @kbd{Mouse-1} has this behavior even in non-selected |
3e7559716275
(Mouse References): Add mouse-1-click-in-non-selected-windows.
Kim F. Storm <storm@cua.dk>
parents:
60120
diff
changeset
|
370 windows, or only in the selected window. |
3e7559716275
(Mouse References): Add mouse-1-click-in-non-selected-windows.
Kim F. Storm <storm@cua.dk>
parents:
60120
diff
changeset
|
371 |
45879
92c22a8f55a6
Document mouse-highlight variable.
Richard M. Stallman <rms@gnu.org>
parents:
44326
diff
changeset
|
372 @vindex mouse-highlight |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
373 You can usually tell when @kbd{Mouse-1} and @kbd{Mouse-2} have this |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
374 special sort of meaning because the sensitive text highlights when you |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
375 move the mouse over it. The variable @code{mouse-highlight} controls |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
376 whether to do this highlighting always (even when such text appears |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
377 where the mouse already is), never, or only immediately after you move |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
378 the mouse. |
25829 | 379 |
62161
337108d8074e
(Mouse References): Clarify `mouse-1-click-follows-link'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61837
diff
changeset
|
380 @vindex mouse-1-click-follows-link |
337108d8074e
(Mouse References): Clarify `mouse-1-click-follows-link'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61837
diff
changeset
|
381 In Emacs versions before 22, only @kbd{Mouse-2} follows links and |
68542 | 382 @kbd{Mouse-1} always sets point. If you prefer this older behavior, |
383 set the variable @code{mouse-1-click-follows-link} to @code{nil}. | |
384 This variable also lets you choose various other alternatives for | |
385 following links with the mouse. Type @kbd{C-h v | |
386 mouse-1-click-follows-link @key{RET}} for more details. | |
62161
337108d8074e
(Mouse References): Clarify `mouse-1-click-follows-link'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61837
diff
changeset
|
387 |
25829 | 388 @node Menu Mouse Clicks |
389 @section Mouse Clicks for Menus | |
390 | |
68542 | 391 Several mouse clicks with the @key{CTRL} and @key{SHIFT} modifiers |
25829 | 392 bring up menus. |
393 | |
394 @table @kbd | |
395 @item C-Mouse-1 | |
30872 | 396 @kindex C-Mouse-1 |
25829 | 397 This menu is for selecting a buffer. |
398 | |
36504
3febda0f0d4b
Delete indexing for MSB in `Menu Mouse Clicks';
Richard M. Stallman <rms@gnu.org>
parents:
36408
diff
changeset
|
399 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
|
400 menu smarter and more customizable. @xref{Buffer Menus}. |
30872 | 401 |
25829 | 402 @item C-Mouse-2 |
30872 | 403 @kindex C-Mouse-2 |
25829 | 404 This menu is for specifying faces and other text properties |
405 for editing formatted text. @xref{Formatted Text}. | |
406 | |
407 @item C-Mouse-3 | |
30872 | 408 @kindex C-Mouse-3 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
409 This menu is mode-specific. For most modes if Menu-bar mode is on, |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
410 this menu has the same items as all the mode-specific menu-bar menus |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
411 put together. Some modes may specify a different menu for this |
30872 | 412 button.@footnote{Some systems use @kbd{Mouse-3} for a mode-specific |
413 menu. We took a survey of users, and found they preferred to keep | |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
414 @kbd{Mouse-3} for selecting and killing regions. Hence the decision |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
415 to use @kbd{C-Mouse-3} for this menu. To use @kbd{Mouse-3} instead, |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
416 do @code{(global-set-key [mouse-3] 'mouse-popup-menubar-stuff)}.} If |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
417 Menu-bar mode is off, this menu contains all the items which would be |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
418 present in the menu bar---not just the mode-specific ones---so that |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
419 you can access them without having to display the menu bar. |
25829 | 420 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
421 @item S-Mouse-1 |
68542 | 422 This menu is for specifying the frame's default font. |
25829 | 423 @end table |
424 | |
425 @node Mode Line Mouse | |
426 @section Mode Line Mouse Commands | |
30872 | 427 @cindex mode line, mouse |
428 @cindex mouse on mode line | |
25829 | 429 |
430 You can use mouse clicks on window mode lines to select and manipulate | |
431 windows. | |
432 | |
63010
dcd17e7ebcda
(Mode Line Mouse): Mention mode-line-highlight effect.
Eli Zaretskii <eliz@gnu.org>
parents:
62385
diff
changeset
|
433 Some areas of the mode line, such as the buffer name and the major |
dcd17e7ebcda
(Mode Line Mouse): Mention mode-line-highlight effect.
Eli Zaretskii <eliz@gnu.org>
parents:
62385
diff
changeset
|
434 mode name, have their own special mouse bindings. These areas are |
dcd17e7ebcda
(Mode Line Mouse): Mention mode-line-highlight effect.
Eli Zaretskii <eliz@gnu.org>
parents:
62385
diff
changeset
|
435 highlighted when you hold the mouse over them, and information about |
68542 | 436 the special bindings will be displayed (@pxref{Tooltips}). This |
437 section's commands do not apply in those areas. | |
63010
dcd17e7ebcda
(Mode Line Mouse): Mention mode-line-highlight effect.
Eli Zaretskii <eliz@gnu.org>
parents:
62385
diff
changeset
|
438 |
25829 | 439 @table @kbd |
440 @item Mouse-1 | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
441 @kindex Mouse-1 @r{(mode line)} |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
442 @kbd{Mouse-1} on a mode line selects the window it belongs to. By |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
443 dragging @kbd{Mouse-1} on the mode line, you can move it, thus |
68542 | 444 changing the height of the windows above and below. Changing heights |
445 with the mouse in this way never deletes windows, it just refuses to | |
446 make any window smaller than the minimum height. | |
25829 | 447 |
448 @item Mouse-2 | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
449 @kindex Mouse-2 @r{(mode line)} |
25829 | 450 @kbd{Mouse-2} on a mode line expands that window to fill its frame. |
451 | |
452 @item Mouse-3 | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
453 @kindex Mouse-3 @r{(mode line)} |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
454 @kbd{Mouse-3} on a mode line deletes the window it belongs to. If the |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
455 frame has only one window, it buries the current buffer instead, and |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
456 switches to another buffer. |
25829 | 457 |
458 @item C-Mouse-2 | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
459 @kindex C-mouse-2 @r{(mode line)} |
25829 | 460 @kbd{C-Mouse-2} on a mode line splits the window above |
461 horizontally, above the place in the mode line where you click. | |
462 @end table | |
463 | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
464 @kindex C-Mouse-2 @r{(scroll bar)} |
68542 | 465 @kindex Mouse-1 @r{(scroll bar)} |
466 Using @kbd{Mouse-1} on the divider between two side-by-side mode | |
467 lines, you can move the vertical boundary left or right. Using | |
468 @kbd{C-Mouse-2} on a scroll bar splits the corresponding window | |
56822
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
469 vertically. @xref{Split Window}. |
25829 | 470 |
471 @node Creating Frames | |
472 @section Creating Frames | |
473 @cindex creating frames | |
474 | |
475 @kindex C-x 5 | |
476 The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}, with parallel | |
477 subcommands. The difference is that @kbd{C-x 5} commands create a new | |
478 frame rather than just a new window in the selected frame (@pxref{Pop | |
479 Up Window}). If an existing visible or iconified frame already displays | |
480 the requested material, these commands use the existing frame, after | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
49453
diff
changeset
|
481 raising or deiconifying as necessary. |
25829 | 482 |
483 The various @kbd{C-x 5} commands differ in how they find or create the | |
484 buffer to select: | |
485 | |
486 @table @kbd | |
487 @item C-x 5 2 | |
488 @kindex C-x 5 2 | |
489 @findex make-frame-command | |
490 Create a new frame (@code{make-frame-command}). | |
491 @item C-x 5 b @var{bufname} @key{RET} | |
492 Select buffer @var{bufname} in another frame. This runs | |
493 @code{switch-to-buffer-other-frame}. | |
494 @item C-x 5 f @var{filename} @key{RET} | |
495 Visit file @var{filename} and select its buffer in another frame. This | |
496 runs @code{find-file-other-frame}. @xref{Visiting}. | |
497 @item C-x 5 d @var{directory} @key{RET} | |
498 Select a Dired buffer for directory @var{directory} in another frame. | |
499 This runs @code{dired-other-frame}. @xref{Dired}. | |
500 @item C-x 5 m | |
501 Start composing a mail message in another frame. This runs | |
502 @code{mail-other-frame}. It is the other-frame variant of @kbd{C-x m}. | |
503 @xref{Sending Mail}. | |
504 @item C-x 5 . | |
505 Find a tag in the current tag table in another frame. This runs | |
506 @code{find-tag-other-frame}, the multiple-frame variant of @kbd{M-.}. | |
507 @xref{Tags}. | |
508 @item C-x 5 r @var{filename} @key{RET} | |
509 @kindex C-x 5 r | |
510 @findex find-file-read-only-other-frame | |
511 Visit file @var{filename} read-only, and select its buffer in another | |
512 frame. This runs @code{find-file-read-only-other-frame}. | |
513 @xref{Visiting}. | |
514 @end table | |
515 | |
516 @cindex default-frame-alist | |
517 @cindex initial-frame-alist | |
77193
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
518 @cindex face customization, in @file{~/.emacs} |
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
519 @cindex color customization, in @file{~/.emacs} |
25829 | 520 You can control the appearance of new frames you create by setting the |
521 frame parameters in @code{default-frame-alist}. You can use the | |
522 variable @code{initial-frame-alist} to specify parameters that affect | |
523 only the initial frame. @xref{Initial Parameters,,, elisp, The Emacs | |
524 Lisp Reference Manual}, for more information. | |
525 | |
526 @cindex font (default) | |
527 The easiest way to specify the principal font for all your Emacs | |
528 frames is with an X resource (@pxref{Font X}), but you can also do it by | |
529 modifying @code{default-frame-alist} to specify the @code{font} | |
530 parameter, as shown here: | |
531 | |
532 @example | |
533 (add-to-list 'default-frame-alist '(font . "10x20")) | |
534 @end example | |
535 | |
38670
80a860105400
(Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents:
38205
diff
changeset
|
536 @noindent |
80a860105400
(Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents:
38205
diff
changeset
|
537 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
|
538 |
80a860105400
(Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents:
38205
diff
changeset
|
539 @example |
64419
30e914c69e59
(Creating Frames): Fix foreground color example.
Richard M. Stallman <rms@gnu.org>
parents:
63010
diff
changeset
|
540 (add-to-list 'default-frame-alist '(foreground-color . "blue")) |
38670
80a860105400
(Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents:
38205
diff
changeset
|
541 @end example |
80a860105400
(Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents:
38205
diff
changeset
|
542 |
77193
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
543 @noindent |
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
544 By putting such customizations in your @file{~/.emacs} init file, you |
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
545 can control the appearance of all the frames Emacs creates, including |
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
546 the initial one. |
588363d97121
(Creating Frames): Mention that face customizations can be put in .emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
77129
diff
changeset
|
547 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
548 @node Frame Commands |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
549 @section Frame Commands |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
550 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
551 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
|
552 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
553 @table @kbd |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
554 @item C-z |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
555 @kindex C-z @r{(X windows)} |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
556 @findex iconify-or-deiconify-frame |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
557 Iconify the selected Emacs frame (@code{iconify-or-deiconify-frame}). |
73179 | 558 When typed on an Emacs frame's icon, deiconify instead. |
559 | |
68689
05a209d3a8c2
Minor cleanups. "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents:
68639
diff
changeset
|
560 The normal meaning of @kbd{C-z}, to suspend Emacs, is not useful under |
05a209d3a8c2
Minor cleanups. "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents:
68639
diff
changeset
|
561 a graphical display that allows multiple applications to operate |
70483 | 562 simultaneously in their own windows, so Emacs gives @kbd{C-z} a |
68689
05a209d3a8c2
Minor cleanups. "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents:
68639
diff
changeset
|
563 different binding in that case. |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
564 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
565 @item C-x 5 0 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
566 @kindex C-x 5 0 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
567 @findex delete-frame |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
568 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
|
569 there is only one frame. |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
570 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
571 @item C-x 5 o |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
572 @kindex C-x 5 o |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
573 @findex other-frame |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
574 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
|
575 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
|
576 frames on your terminal. |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
577 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
578 @item C-x 5 1 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
579 @kindex C-x 5 1 |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
580 @findex delete-other-frames |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
581 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
|
582 @end table |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
583 |
43438
26a4fefad579
Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents:
42751
diff
changeset
|
584 @vindex focus-follows-mouse |
26a4fefad579
Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents:
42751
diff
changeset
|
585 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
|
586 how the system (or the window manager) generally handles |
26a4fefad579
Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents:
42751
diff
changeset
|
587 focus-switching between windows. There are two possibilities: either |
26a4fefad579
Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents:
42751
diff
changeset
|
588 simply moving the mouse onto a window selects it (gives it focus), or |
72048
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
589 you have to click on it in a suitable way to do so. On X, this focus |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
590 policy also affects whether the focus is given to a frame that Emacs |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
591 raises. Unfortunately there is no way Emacs can find out |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
592 automatically which way the system handles this, so you have to |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
593 explicitly say, by setting the variable @code{focus-follows-mouse}. |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
594 If just moving the mouse onto a window selects it, that variable |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
595 should be @code{t}; if a click is necessary, the variable should be |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
596 @code{nil}. |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
597 |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
598 The window manager that is part of MS-Windows always gives focus to a |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
599 frame that raises, so this variable has no effect in the native |
608984477c3d
(Frame Commands): Mention that focus-follows-mouse doesn't have effect on
Eli Zaretskii <eliz@gnu.org>
parents:
71482
diff
changeset
|
600 MS-Windows build of Emacs. |
43438
26a4fefad579
Document focus-follows-mouse.
Richard M. Stallman <rms@gnu.org>
parents:
42751
diff
changeset
|
601 |
25829 | 602 @node Speedbar |
65955
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
603 @section Speedbar Frames |
25829 | 604 @cindex speedbar |
605 | |
65955
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
606 @cindex attached frame (of speedbar) |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
607 The @dfn{speedbar} is a special frame for conveniently navigating in |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
608 or operating on another frame. The speedbar, when it exists, is |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
609 always associated with a specific frame, called its @dfn{attached |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
610 frame}; all speedbar operations act on that frame. |
65947
97a58f78b188
* frames.texi (Speedbar): Add information on keybindings,
Chong Yidong <cyd@stupidchicken.com>
parents:
65806
diff
changeset
|
611 |
65955
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
612 Type @kbd{M-x speedbar} to create the speedbar and associate it with |
65978
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
613 the current frame. To dismiss the speedbar, type @kbd{M-x speedbar} |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
614 again, or select the speedbar and type @kbd{q}. (You can also delete |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
615 the speedbar frame like any other Emacs frame.) If you wish to |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
616 associate the speedbar with a different frame, dismiss it and call |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
617 @kbd{M-x speedbar} from that frame. |
25829 | 618 |
65955
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
619 The speedbar can operate in various modes. Its default mode is |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
620 @dfn{File Display} mode, which shows the files in the current |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
621 directory of the selected window of the attached frame, one file per |
65978
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
622 line. Clicking on a file name visits that file in the selected window |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
623 of the attached frame, and clicking on a directory name shows that |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
624 directory in the speedbar (@pxref{Mouse References}). Each line also |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
625 has a box, @samp{[+]} or @samp{<+>}, that you can click on to |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
626 @dfn{expand} the contents of that item. Expanding a directory adds |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
627 the contents of that directory to the speedbar display, underneath the |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
628 directory's own line. Expanding an ordinary file adds a list of the |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
629 tags in that file to the speedbar display; you can click on a tag name |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
630 to jump to that tag in the selected window of the attached frame. |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
631 When a file or directory is expanded, the @samp{[+]} changes to |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
632 @samp{[-]}; you can click on that box to @dfn{contract} the item, |
6d475e9c0289
* frames.texi (Speedbar): A couple more clarifications.
Chong Yidong <cyd@stupidchicken.com>
parents:
65955
diff
changeset
|
633 hiding its contents. |
65947
97a58f78b188
* frames.texi (Speedbar): Add information on keybindings,
Chong Yidong <cyd@stupidchicken.com>
parents:
65806
diff
changeset
|
634 |
65955
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
635 You navigate through the speedbar using the keyboard, too. Typing |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
636 @kbd{RET} while point is on a line in the speedbar is equivalent to |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
637 clicking the item on the current line, and @kbd{SPC} expands or |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
638 contracts the item. @kbd{U} displays the parent directory of the |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
639 current directory. To copy, delete, or rename the file on the current |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
640 line, type @kbd{C}, @kbd{D}, and @kbd{R} respectively. To create a |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
641 new directory, type @kbd{M}. |
65947
97a58f78b188
* frames.texi (Speedbar): Add information on keybindings,
Chong Yidong <cyd@stupidchicken.com>
parents:
65806
diff
changeset
|
642 |
65955
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
643 Another general-purpose speedbar mode is @dfn{Buffer Display} mode; |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
644 in this mode, the speedbar displays a list of Emacs buffers. To |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
645 switch to this mode, type @kbd{b} in the speedbar. To return to File |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
646 Display mode, type @kbd{f}. You can also change the display mode by |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
647 clicking @kbd{mouse-3} anywhere in the speedbar window (or |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
648 @kbd{mouse-1} on the mode-line) and selecting @samp{Displays} in the |
982867e0921a
(Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents:
65947
diff
changeset
|
649 pop-up menu. |
25829 | 650 |
651 Some major modes, including Rmail mode, Info, and GUD, have | |
652 specialized ways of putting useful items into the speedbar for you to | |
653 select. For example, in Rmail mode, the speedbar shows a list of Rmail | |
654 files, and lets you move the current message to another Rmail file by | |
655 clicking on its @samp{<M>} box. | |
656 | |
65947
97a58f78b188
* frames.texi (Speedbar): Add information on keybindings,
Chong Yidong <cyd@stupidchicken.com>
parents:
65806
diff
changeset
|
657 For more details on using and programming the speedbar, @xref{Top, |
97a58f78b188
* frames.texi (Speedbar): Add information on keybindings,
Chong Yidong <cyd@stupidchicken.com>
parents:
65806
diff
changeset
|
658 Speedbar,,speedbar, Speedbar Manual}. |
25829 | 659 |
660 @node Multiple Displays | |
661 @section Multiple Displays | |
662 @cindex multiple displays | |
663 | |
35188
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
parents:
34523
diff
changeset
|
664 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
|
665 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
|
666 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
|
667 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
|
668 @code{make-frame-on-display}: |
25829 | 669 |
670 @findex make-frame-on-display | |
671 @table @kbd | |
672 @item M-x make-frame-on-display @key{RET} @var{display} @key{RET} | |
673 Create a new frame on display @var{display}. | |
674 @end table | |
675 | |
676 A single X server can handle more than one screen. When you open | |
677 frames on two screens belonging to one server, Emacs knows they share a | |
678 single keyboard, and it treats all the commands arriving from these | |
679 screens as a single stream of input. | |
680 | |
681 When you open frames on different X servers, Emacs makes a separate | |
682 input stream for each server. This way, two users can type | |
683 simultaneously on the two displays, and Emacs will not garble their | |
684 input. Each server also has its own selected frame. The commands you | |
685 enter with a particular X server apply to that server's selected frame. | |
686 | |
687 Despite these features, people using the same Emacs job from different | |
688 displays can still interfere with each other if they are not careful. | |
689 For example, if any one types @kbd{C-x C-c}, that exits the Emacs job | |
690 for all of them! | |
691 | |
692 @node Special Buffer Frames | |
693 @section Special Buffer Frames | |
694 | |
695 @vindex special-display-buffer-names | |
68542 | 696 You can make certain chosen buffers, which Emacs normally displays |
697 in ``another window,'' appear in special frames of their own. To do | |
698 this, set the variable @code{special-display-buffer-names} to a list | |
699 of buffer names; any buffer whose name is in that list automatically | |
700 gets a special frame, when an Emacs command wants to display it ``in | |
701 another window.'' | |
25829 | 702 |
703 For example, if you set the variable this way, | |
704 | |
705 @example | |
706 (setq special-display-buffer-names | |
707 '("*Completions*" "*grep*" "*tex-shell*")) | |
708 @end example | |
709 | |
710 @noindent | |
711 then completion lists, @code{grep} output and the @TeX{} mode shell | |
712 buffer get individual frames of their own. These frames, and the | |
713 windows in them, are never automatically split or reused for any other | |
714 buffers. They continue to show the buffers they were created for, | |
715 unless you alter them by hand. Killing the special buffer deletes its | |
716 frame automatically. | |
717 | |
718 @vindex special-display-regexps | |
719 More generally, you can set @code{special-display-regexps} to a list | |
720 of regular expressions; then a buffer gets its own frame if its name | |
721 matches any of those regular expressions. (Once again, this applies only | |
68542 | 722 to buffers that normally get displayed for you in ``another window.'') |
25829 | 723 |
724 @vindex special-display-frame-alist | |
725 The variable @code{special-display-frame-alist} specifies the frame | |
726 parameters for these frames. It has a default value, so you don't need | |
727 to set it. | |
728 | |
729 For those who know Lisp, an element of | |
730 @code{special-display-buffer-names} or @code{special-display-regexps} | |
731 can also be a list. Then the first element is the buffer name or | |
732 regular expression; the rest of the list specifies how to create the | |
46206
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
733 frame. It can be an association list specifying frame parameter |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
734 values; these values take precedence over parameter values specified |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
735 in @code{special-display-frame-alist}. If you specify the symbol |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
736 @code{same-window} as a ``frame parameter'' in this list, with a |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
737 non-@code{nil} value, that means to use the selected window if |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
738 possible. If you use the symbol @code{same-frame} as a ``frame |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
739 parameter'' in this list, with a non-@code{nil} value, that means to |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
740 use the selected frame if possible. |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
741 |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
742 Alternatively, the value can have this form: |
25829 | 743 |
744 @example | |
745 (@var{function} @var{args}...) | |
746 @end example | |
747 | |
748 @noindent | |
749 where @var{function} is a symbol. Then the frame is constructed by | |
750 calling @var{function}; its first argument is the buffer, and its | |
751 remaining arguments are @var{args}. | |
752 | |
753 An analogous feature lets you specify buffers which should be | |
754 displayed in the selected window. @xref{Force Same Window}. The | |
755 same-window feature takes precedence over the special-frame feature; | |
756 therefore, if you add a buffer name to | |
757 @code{special-display-buffer-names} and it has no effect, check to see | |
758 whether that feature is also in use for the same buffer name. | |
759 | |
760 @node Frame Parameters | |
761 @section Setting Frame Parameters | |
762 @cindex Auto-Raise mode | |
763 @cindex Auto-Lower mode | |
764 | |
68542 | 765 @kindex S-Mouse-1 |
766 You can specify the font and colors used for text display, and the | |
767 colors for the frame borders, the cursor, and the mouse cursor, by | |
768 customizing the faces @code{default}, @code{border}, @code{cursor} and | |
769 @code{mouse}. @xref{Face Customization}. You can also set a frame's | |
770 default font through a pop-up menu. Press @kbd{S-Mouse-1} to activate | |
771 this menu. | |
25829 | 772 |
68542 | 773 These commands are available for controlling the window management |
774 behavior of the selected frame. | |
775 | |
25829 | 776 @table @kbd |
68542 | 777 @findex auto-raise-mode |
25829 | 778 @item M-x auto-raise-mode |
779 Toggle whether or not the selected frame should auto-raise. Auto-raise | |
780 means that every time you move the mouse onto the frame, it raises the | |
781 frame. | |
782 | |
68542 | 783 Some window managers also implement auto-raise. If you enable |
784 auto-raise for Emacs frames in your window manager, it will work, but | |
785 it is beyond Emacs' control, so @code{auto-raise-mode} has no effect | |
786 on it. | |
25829 | 787 |
68542 | 788 @findex auto-lower-mode |
25829 | 789 @item M-x auto-lower-mode |
790 Toggle whether or not the selected frame should auto-lower. | |
791 Auto-lower means that every time you move the mouse off the frame, | |
68542 | 792 the frame moves to the bottom of the stack on the screen. |
25829 | 793 |
794 The command @code{auto-lower-mode} has no effect on auto-lower | |
68542 | 795 implemented by the window manager. To control that, you must use the |
796 appropriate window manager features. | |
25829 | 797 @end table |
798 | |
799 In Emacs versions that use an X toolkit, the color-setting and | |
800 font-setting functions don't affect menus and the menu bar, since they | |
801 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
|
802 the menus and menu bar, you must use X resources (@pxref{Resources}). |
42751 | 803 @xref{Colors}, regarding colors. @xref{Font X}, regarding choice of |
25829 | 804 font. |
805 | |
38670
80a860105400
(Creating Frame): One more example of using default-frame-alist.
Eli Zaretskii <eliz@gnu.org>
parents:
38205
diff
changeset
|
806 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
|
807 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
|
808 @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
|
809 description of frame parameters and customization, see @ref{Frame |
25829 | 810 Parameters,,, elisp, The Emacs Lisp Reference Manual}. |
811 | |
812 @node Scroll Bars | |
813 @section Scroll Bars | |
814 @cindex Scroll Bar mode | |
815 @cindex mode, Scroll Bar | |
816 | |
68542 | 817 On graphical displays, Emacs normally makes a @dfn{scroll bar} at |
818 the left of each Emacs window.@footnote{Placing it at the left is | |
819 usually more useful with overlapping frames with text starting at the | |
820 left margin.} The scroll bar runs the height of the window, and shows | |
821 a moving rectangular inner box which represents the portion of the | |
822 buffer currently displayed. The entire height of the scroll bar | |
823 represents the entire length of the buffer. | |
25829 | 824 |
825 You can use @kbd{Mouse-2} (normally, the middle button) in the scroll | |
826 bar to move or drag the inner box up and down. If you move it to the | |
827 top of the scroll bar, you see the top of the buffer. If you move it to | |
828 the bottom of the scroll bar, you see the bottom of the buffer. | |
829 | |
830 The left and right buttons in the scroll bar scroll by controlled | |
831 increments. @kbd{Mouse-1} (normally, the left button) moves the line at | |
832 the level where you click up to the top of the window. @kbd{Mouse-3} | |
833 (normally, the right button) moves the line at the top of the window | |
834 down to the level where you click. By clicking repeatedly in the same | |
835 place, you can scroll by the same distance over and over. | |
836 | |
56822
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
837 You can also click @kbd{C-Mouse-2} in the scroll bar to split a |
e62b4de1b18d
(Secondary Selection): Setting the secondary selection with
Luc Teirlinck <teirllm@auburn.edu>
parents:
53950
diff
changeset
|
838 window vertically. The split occurs on the line where you click. |
25829 | 839 |
840 @findex scroll-bar-mode | |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
841 @vindex scroll-bar-mode |
25829 | 842 You can enable or disable Scroll Bar mode with the command @kbd{M-x |
68542 | 843 scroll-bar-mode}. With no argument, it toggles the use of scroll |
844 bars. With an argument, it turns use of scroll bars on if and only if | |
845 the argument is positive. This command applies to all frames, | |
846 including frames yet to be created. Customize the variable | |
847 @code{scroll-bar-mode} to control the use of scroll bars at startup. | |
848 You can use it to specify that they are placed at the right of windows | |
849 if you prefer that. You have to set this variable through the | |
850 @samp{Customize} interface (@pxref{Easy Customization}), or it will | |
851 not work properly. | |
852 | |
853 You can also use the X resource @samp{verticalScrollBars} to control | |
854 the initial setting of Scroll Bar mode. @xref{Resources}. | |
25829 | 855 |
856 @findex toggle-scroll-bar | |
857 To enable or disable scroll bars for just the selected frame, use the | |
44326 | 858 command @kbd{M-x toggle-scroll-bar}. |
25829 | 859 |
36979
d6339c5b09f1
(Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents:
36864
diff
changeset
|
860 @vindex scroll-bar-width |
d6339c5b09f1
(Scroll Bars): Document the scroll-bar-width frame parameter.
Eli Zaretskii <eliz@gnu.org>
parents:
36864
diff
changeset
|
861 @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
|
862 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
|
863 @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
|
864 |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
865 @node Wheeled Mice |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
866 @section Scrolling With ``Wheeled'' Mice |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
867 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
868 @cindex mouse wheel |
36864 | 869 @cindex wheel, mouse |
870 @findex mouse-wheel-mode | |
871 @cindex Mouse Wheel minor mode | |
872 @cindex mode, Mouse Wheel | |
873 Some mice have a ``wheel'' instead of a third button. You can | |
874 usually click the wheel to act as either @kbd{Mouse-2} or | |
875 @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
|
876 scroll windows instead of using the scroll bar or keyboard commands. |
60793
de810f6e8193
(Wheeled Mice): Mouse wheel support on by default.
Richard M. Stallman <rms@gnu.org>
parents:
60254
diff
changeset
|
877 Mouse wheel support only works if the system generates appropriate |
de810f6e8193
(Wheeled Mice): Mouse wheel support on by default.
Richard M. Stallman <rms@gnu.org>
parents:
60254
diff
changeset
|
878 events; whenever possible, it is turned on by default. To toggle this |
de810f6e8193
(Wheeled Mice): Mouse wheel support on by default.
Richard M. Stallman <rms@gnu.org>
parents:
60254
diff
changeset
|
879 feature, use @kbd{M-x mouse-wheel-mode}. |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
880 |
35875 | 881 @vindex mouse-wheel-follow-mouse |
882 @vindex mouse-wheel-scroll-amount | |
60793
de810f6e8193
(Wheeled Mice): Mouse wheel support on by default.
Richard M. Stallman <rms@gnu.org>
parents:
60254
diff
changeset
|
883 @vindex mouse-wheel-progressive-speed |
77129 | 884 The two variables @code{mouse-wheel-follow-mouse} and |
35875 | 885 @code{mouse-wheel-scroll-amount} determine where and by how much |
60793
de810f6e8193
(Wheeled Mice): Mouse wheel support on by default.
Richard M. Stallman <rms@gnu.org>
parents:
60254
diff
changeset
|
886 buffers are scrolled. The variable |
64458
53ac34aeef7d
(Wheeled Mice): Delete duplicate words.
Juri Linkov <juri@jurta.org>
parents:
64419
diff
changeset
|
887 @code{mouse-wheel-progressive-speed} determines whether the scroll |
60793
de810f6e8193
(Wheeled Mice): Mouse wheel support on by default.
Richard M. Stallman <rms@gnu.org>
parents:
60254
diff
changeset
|
888 speed is linked to how fast you move the wheel. |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
889 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
890 @node Drag and Drop |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
891 @section Drag and Drop |
53792
139b571400ce
* frames.texi (Drag and drop): New section.
Jan Djärv <jan.h.d@swipnet.se>
parents:
53191
diff
changeset
|
892 @cindex drag and drop |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
893 |
59895
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
894 Emacs supports @dfn{drag and drop} using the mouse. For instance, |
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
895 dropping text onto an Emacs frame inserts the text where it is dropped. |
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
896 Dropping a file onto an Emacs frame visits that file. As a special |
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
897 case, dropping the file on a Dired buffer moves or copies the file |
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
898 (according to the conventions of the application it came from) into the |
cf9f0edc8d20
(Frames, Drag and Drop): Fix typos.
Lute Kamstra <lute@gnu.org>
parents:
59888
diff
changeset
|
899 directory displayed in that buffer. |
53792
139b571400ce
* frames.texi (Drag and drop): New section.
Jan Djärv <jan.h.d@swipnet.se>
parents:
53191
diff
changeset
|
900 |
65806
a9c074731be2
* frames.texi (Drag and Drop): Remove the x- from
Jan Djärv <jan.h.d@swipnet.se>
parents:
64890
diff
changeset
|
901 @vindex dnd-open-file-other-window |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
902 Dropping a file normally visits it in the window you drop it on. If |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
903 you prefer to visit the file in a new window in such cases, customize |
65806
a9c074731be2
* frames.texi (Drag and Drop): Remove the x- from
Jan Djärv <jan.h.d@swipnet.se>
parents:
64890
diff
changeset
|
904 the variable @code{dnd-open-file-other-window}. |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
905 |
68542 | 906 The XDND and Motif drag and drop protocols, and the old KDE 1.x |
907 protocol, are currently supported. | |
53792
139b571400ce
* frames.texi (Drag and drop): New section.
Jan Djärv <jan.h.d@swipnet.se>
parents:
53191
diff
changeset
|
908 |
25829 | 909 @node Menu Bars |
910 @section Menu Bars | |
911 @cindex Menu Bar mode | |
912 @cindex mode, Menu Bar | |
70838
7f097460654d
(Menu Bars, Tool Bars): Add index entries.
Reiner Steib <Reiner.Steib@gmx.de>
parents:
70483
diff
changeset
|
913 @findex menu-bar-mode |
7f097460654d
(Menu Bars, Tool Bars): Add index entries.
Reiner Steib <Reiner.Steib@gmx.de>
parents:
70483
diff
changeset
|
914 @vindex menu-bar-mode |
25829 | 915 |
916 You can turn display of menu bars on or off with @kbd{M-x | |
59798
0816b427495a
Don't say just "option" when talking about variables.
Richard M. Stallman <rms@gnu.org>
parents:
59153
diff
changeset
|
917 menu-bar-mode} or by customizing the variable @code{menu-bar-mode}. |
31609 | 918 With no argument, this command toggles Menu Bar mode, a |
25829 | 919 minor mode. With an argument, the command turns Menu Bar mode on if the |
920 argument is positive, off if the argument is not positive. You can use | |
921 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
|
922 Menu Bar mode. @xref{Resources}. |
31609 | 923 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
924 @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
|
925 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
|
926 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
|
927 If the menu bar is off, you can still pop up a menu of its contents |
39267 | 928 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
|
929 @xref{Menu Mouse Clicks}. |
25829 | 930 |
931 @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
|
932 menu bar. @xref{X Resources}, for how to customize the menu bar |
68542 | 933 menus' visual appearance. |
25829 | 934 |
31609 | 935 @node Tool Bars |
936 @section Tool Bars | |
937 @cindex Tool Bar mode | |
938 @cindex mode, Tool Bar | |
49917
4216caa0b2be
Use `toolbar' since we already have `Tool Bar'.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49600
diff
changeset
|
939 @cindex icons, toolbar |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
940 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
941 The @dfn{tool bar} is a line (or lines) of icons at the top of the |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
942 Emacs window, just below the menu bar. You can click on these icons |
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
943 with the mouse to do various jobs. |
31609 | 944 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
945 The global tool bar contains general commands. Some major modes |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
946 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
|
947 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
|
948 global tool bar. |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
949 |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
950 Tool bars work only on a graphical display. The tool bar uses colored |
36408 | 951 XPM icons if Emacs was built with XPM support. Otherwise, the tool |
952 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
|
953 |
70838
7f097460654d
(Menu Bars, Tool Bars): Add index entries.
Reiner Steib <Reiner.Steib@gmx.de>
parents:
70483
diff
changeset
|
954 @findex tool-bar-mode |
7f097460654d
(Menu Bars, Tool Bars): Add index entries.
Reiner Steib <Reiner.Steib@gmx.de>
parents:
70483
diff
changeset
|
955 @vindex tool-bar-mode |
59888
712b121904b3
(Frames): Delete unnecessary mention of Windows.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
956 You can turn display of tool bars on or off with @kbd{M-x |
67655
6cba278fc764
(Tool Bars): Shorten text of previous change.
Bill Wohler <wohler@newt.com>
parents:
67649
diff
changeset
|
957 tool-bar-mode} or by customizing the option @code{tool-bar-mode}. |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
958 |
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
959 @node Dialog Boxes |
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
960 @section Using Dialog Boxes |
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
961 @cindex dialog boxes |
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
962 |
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
963 @vindex use-dialog-box |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
964 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
|
965 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
|
966 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
|
967 invoke the command to begin with. |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
968 |
59798
0816b427495a
Don't say just "option" when talking about variables.
Richard M. Stallman <rms@gnu.org>
parents:
59153
diff
changeset
|
969 You can customize the variable @code{use-dialog-box} to suppress the |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
970 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
|
971 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
|
972 |
53191
119702bcc6c0
NEWS and documentation for use-file-dialog.
Jan Djärv <jan.h.d@swipnet.se>
parents:
52979
diff
changeset
|
973 @vindex use-file-dialog |
68542 | 974 A file selection window is a special kind of dialog box for asking |
975 for file names. You can customize the variable @code{use-file-dialog} | |
976 to suppress the use of file selection windows, even if you still want | |
977 other kinds of dialogs. This variable has no effect if you have | |
978 suppressed all dialog boxes with the variable @code{use-dialog-box}. | |
53191
119702bcc6c0
NEWS and documentation for use-file-dialog.
Jan Djärv <jan.h.d@swipnet.se>
parents:
52979
diff
changeset
|
979 |
68542 | 980 @vindex x-gtk-show-hidden-files |
981 For Gtk+ version 2.4 and newer, Emacs use the Gtk+ file chooser | |
982 dialog. Emacs adds a toggle button that enables and disables showing | |
983 of hidden files (files starting with a dot) in that dialog. The | |
984 variable @code{x-gtk-show-hidden-files} controls whether to show | |
985 hidden files by default. | |
53191
119702bcc6c0
NEWS and documentation for use-file-dialog.
Jan Djärv <jan.h.d@swipnet.se>
parents:
52979
diff
changeset
|
986 |
72961
eb822f6f8d06
* frames.texi (Dialog Boxes): Rename x-use-old-gtk-file-dialog
Jan Djärv <jan.h.d@swipnet.se>
parents:
72048
diff
changeset
|
987 @vindex x-gtk-use-old-file-dialog |
72996
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
988 For Gtk+ versions 2.4 through 2.10, you can select the old file |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
989 dialog (@code{gtk-file-selector}) by setting the variable |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
990 @code{x-gtk-use-old-file-dialog} to a non-@code{nil} value. If it is |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
991 @code{nil}, Emacs uses @code{gtk-file-chooser}. If Emacs is built |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
992 with a Gtk+ version that has only one file dialog, this variable has |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
993 no effect. |
53191
119702bcc6c0
NEWS and documentation for use-file-dialog.
Jan Djärv <jan.h.d@swipnet.se>
parents:
52979
diff
changeset
|
994 |
72971
2cb0784b791e
* frames.texi (Dialog Boxes): Document x-gtk-file-dialog-help-text.
Jan Djärv <jan.h.d@swipnet.se>
parents:
72961
diff
changeset
|
995 @vindex x-gtk-file-dialog-help-text |
72996
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
996 Emacs adds help text to the Gtk+ file chooser dialog. The variable |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
997 @code{x-gtk-file-dialog-help-text} specifies the text to add; if it is |
81a0345d360d
(Dialog Boxes): Clean up wording: avoid passive, stick to present tense.
Richard M. Stallman <rms@gnu.org>
parents:
72971
diff
changeset
|
998 @code{nil}, that disables the added text. |
72971
2cb0784b791e
* frames.texi (Dialog Boxes): Document x-gtk-file-dialog-help-text.
Jan Djärv <jan.h.d@swipnet.se>
parents:
72961
diff
changeset
|
999 |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
1000 @node Tooltips |
62172
517435a249bb
(Tooltips): Describe help tooltips and GUD tooltips
Nick Roberts <nickrob@snap.net.nz>
parents:
62161
diff
changeset
|
1001 @section Tooltips |
62219 | 1002 @cindex tooltips |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
1003 |
62219 | 1004 @dfn{Tooltips} are small windows that display text information at the |
1005 current mouse position. They activate when there is a pause in mouse | |
1006 movement. There are two types of tooltip: help tooltips and GUD | |
1007 tooltips. | |
62172
517435a249bb
(Tooltips): Describe help tooltips and GUD tooltips
Nick Roberts <nickrob@snap.net.nz>
parents:
62161
diff
changeset
|
1008 |
62220 | 1009 @dfn{Help tooltips} typically display over text---including the mode |
68542 | 1010 line---but are also available for other parts of the Emacs frame, such |
1011 as the tool bar and menu items. | |
28432 | 1012 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
1013 @findex tooltip-mode |
68542 | 1014 You can toggle display of help tooltips (Tooltip mode) with the |
1015 command @kbd{M-x tooltip-mode}. When Tooltip mode is disabled, the | |
1016 help text is displayed in the echo area instead. | |
62172
517435a249bb
(Tooltips): Describe help tooltips and GUD tooltips
Nick Roberts <nickrob@snap.net.nz>
parents:
62161
diff
changeset
|
1017 |
62219 | 1018 @dfn{GUD tooltips} show values of variables. They are useful when |
1019 you are debugging a program. @xref{Debugger Operation}. | |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
1020 |
46206
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
1021 @vindex tooltip-delay |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
1022 The variables @code{tooltip-delay} specifies how long Emacs should |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
1023 wait before displaying a tooltip. For additional customization |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
1024 options for displaying tooltips, use @kbd{M-x customize-group |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
1025 @key{RET} tooltip @key{RET}}. @xref{X Resources}, for information on |
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
parents:
45879
diff
changeset
|
1026 customizing the windows 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
|
1027 |
28124 | 1028 @node Mouse Avoidance |
1029 @section Mouse Avoidance | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
1030 @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
|
1031 @cindex mouse avoidance |
28124 | 1032 |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
1033 @vindex mouse-avoidance-mode |
68689
05a209d3a8c2
Minor cleanups. "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents:
68639
diff
changeset
|
1034 Mouse Avoidance mode keeps the mouse pointer away from point, to avoid |
05a209d3a8c2
Minor cleanups. "Graphical display", not window system.
Richard M. Stallman <rms@gnu.org>
parents:
68639
diff
changeset
|
1035 obscuring text you want to edit. Whenever it moves the mouse, it also |
59798
0816b427495a
Don't say just "option" when talking about variables.
Richard M. Stallman <rms@gnu.org>
parents:
59153
diff
changeset
|
1036 raises the frame. To use Mouse Avoidance mode, customize the variable |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
1037 @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
|
1038 move the mouse in several ways: |
28124 | 1039 |
1040 @table @code | |
1041 @item banish | |
39267 | 1042 Move the mouse to the upper-right corner on any key-press; |
28124 | 1043 @item exile |
1044 Move the mouse to the corner only if the cursor gets too close, | |
1045 and allow it to return once the cursor is out of the way; | |
1046 @item jump | |
1047 If the cursor gets too close to the mouse, displace the mouse | |
1048 a random distance & direction; | |
1049 @item animate | |
1050 As @code{jump}, but shows steps along the way for illusion of motion; | |
1051 @item cat-and-mouse | |
1052 The same as @code{animate}; | |
1053 @item proteus | |
1054 As @code{animate}, but changes the shape of the mouse pointer too. | |
1055 @end table | |
1056 | |
36156
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
1057 @findex mouse-avoidance-mode |
3a9de976b35c
Delete info on Font Lock Support Modes.
Richard M. Stallman <rms@gnu.org>
parents:
35954
diff
changeset
|
1058 You can also use the command @kbd{M-x mouse-avoidance-mode} to enable |
28124 | 1059 the mode. |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
1060 |
25829 | 1061 @node Non-Window Terminals |
1062 @section Non-Window Terminals | |
1063 @cindex non-window terminals | |
1064 @cindex single-frame terminals | |
1065 | |
68542 | 1066 On a text-only terminal, Emacs can display only one Emacs frame at a |
1067 time. However, you can still create multiple Emacs frames, and switch | |
1068 between them. Switching frames on these terminals is much like | |
1069 switching between different window configurations. | |
25829 | 1070 |
1071 Use @kbd{C-x 5 2} to create a new frame and switch to it; use @kbd{C-x | |
1072 5 o} to cycle through the existing frames; use @kbd{C-x 5 0} to delete | |
1073 the current frame. | |
1074 | |
1075 Each frame has a number to distinguish it. If your terminal can | |
1076 display only one frame at a time, the selected frame's number @var{n} | |
1077 appears near the beginning of the mode line, in the form | |
1078 @samp{F@var{n}}. | |
1079 | |
1080 @findex set-frame-name | |
1081 @findex select-frame-by-name | |
68542 | 1082 @samp{F@var{n}} is in fact the frame's initial name. You can give |
1083 frames more meaningful names if you wish, and you can select a frame | |
1084 by its name. Use the command @kbd{M-x set-frame-name @key{RET} | |
1085 @var{name} @key{RET}} to specify a new name for the selected frame, | |
1086 and use @kbd{M-x select-frame-by-name @key{RET} @var{name} @key{RET}} | |
1087 to select a frame according to its name. The name you specify appears | |
1088 in the mode line when the frame is selected. | |
25829 | 1089 |
71482
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1090 @node Text-Only Mouse |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
1091 @section Using a Mouse in Terminal Emulators |
71482
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1092 @cindex mouse support |
28124 | 1093 @cindex terminal emulators, mouse support |
27224
d9c8c29ec5c4
Features may work other than under X.
Dave Love <fx@gnu.org>
parents:
25829
diff
changeset
|
1094 |
71482
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1095 Some terminal emulators support mouse clicks in the terminal window. |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1096 |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1097 @cindex xterm |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1098 In a terminal emulator which is compatible with @code{xterm}, |
61612
d7a2e1c053eb
(XTerm Mouse): Xterm Mouse mode is no longer enabled by default in
Luc Teirlinck <teirllm@auburn.edu>
parents:
61516
diff
changeset
|
1099 you can use @kbd{M-x xterm-mouse-mode} to give Emacs control over |
d7a2e1c053eb
(XTerm Mouse): Xterm Mouse mode is no longer enabled by default in
Luc Teirlinck <teirllm@auburn.edu>
parents:
61516
diff
changeset
|
1100 simple use of the mouse---basically, only non-modified single clicks |
d7a2e1c053eb
(XTerm Mouse): Xterm Mouse mode is no longer enabled by default in
Luc Teirlinck <teirllm@auburn.edu>
parents:
61516
diff
changeset
|
1101 are supported. The normal @code{xterm} mouse functionality for such |
d7a2e1c053eb
(XTerm Mouse): Xterm Mouse mode is no longer enabled by default in
Luc Teirlinck <teirllm@auburn.edu>
parents:
61516
diff
changeset
|
1102 clicks is still available by holding down the @kbd{SHIFT} key when you |
71482
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1103 press the mouse button. Xterm Mouse mode is a global minor mode |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1104 (@pxref{Minor Modes}). Repeating the command turns the mode off |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1105 again. |
61516
836f6d9565fe
(XTerm Mouse): Xterm Mouse mode is now enabled by default.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61298
diff
changeset
|
1106 |
71482
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1107 In the console on GNU/Linux, you can use @kbd{M-x t-mouse-mode}. You |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1108 need to have the gpm package installed and running on your system in |
0ea8bb78bfdc
(XTerm Mouse) Rename to...
Nick Roberts <nickrob@snap.net.nz>
parents:
70838
diff
changeset
|
1109 order for this to work. |
52401 | 1110 |
1111 @ignore | |
1112 arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49 | |
1113 @end ignore |