annotate man/frames.texi @ 82923:ef5d155a2ee3

*** empty log message ***
author Glenn Morris <rgm@gnu.org>
date Tue, 28 Aug 2007 02:49:36 +0000
parents 588363d97121
children 02b9a9aa5b0c dc002877ce12 e6fdae9180d4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
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
3d45362f1d38 Add 2007 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 74899
diff changeset
3 @c 2001, 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @node Frames, International, Windows, Top
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
6 @chapter Frames and Graphical Displays
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @cindex frames
Dave Love <fx@gnu.org>
parents:
diff changeset
8
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
9 When using a graphical display, you can create multiple windows at
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
10 the system in a single Emacs session. Each system-level window that
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
11 belongs to Emacs displays a @dfn{frame} which can contain one or
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
12 several Emacs windows. A frame initially contains a single
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
13 general-purpose Emacs window which you can subdivide vertically or
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
14 horizontally into smaller windows. A frame normally contains its own
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
15 echo area and minibuffer, but you can make frames that don't have
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
16 these---they use the echo area and minibuffer of another frame.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
17
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
18 To avoid confusion, we reserve the word ``window'' for the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
19 subdivisions that Emacs implements, and never use it to refer to a
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
20 frame.
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
21
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
22 Editing you do in one frame affects the other frames. For
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
23 instance, if you put text in the kill ring in one frame, you can yank it
Dave Love <fx@gnu.org>
parents:
diff changeset
24 in another frame. If you exit Emacs through @kbd{C-x C-c} in one frame,
Dave Love <fx@gnu.org>
parents:
diff changeset
25 it terminates all the frames. To delete just one frame, use @kbd{C-x 5
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
26 0} (that is zero, not @kbd{o}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
27
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
28 Emacs compiled for MS-DOS emulates some windowing functionality,
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
39 * Mouse References:: Using the mouse to select an item from a list.
Dave Love <fx@gnu.org>
parents:
diff changeset
40 * Menu Mouse Clicks:: Mouse clicks that bring up menus.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
44 * Speedbar:: How to make and use a speedbar frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
45 * Multiple Displays:: How one Emacs job can talk to several displays.
Dave Love <fx@gnu.org>
parents:
diff changeset
46 * Special Buffer Frames:: You can make certain buffers have their own frames.
Dave Love <fx@gnu.org>
parents:
diff changeset
47 * Frame Parameters:: Changing the colors and other modes of frames.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
51 * Menu Bars:: Enabling and disabling the menu bar.
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
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
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
55 * Mouse Avoidance:: Moving the mouse pointer out of the way.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
58 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
76 @cindex mouse buttons (what they do)
Dave Love <fx@gnu.org>
parents:
diff changeset
77
Dave Love <fx@gnu.org>
parents:
diff changeset
78 The mouse commands for selecting and copying a region are mostly
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
85 If you select a region with any of these mouse commands, and then
Dave Love <fx@gnu.org>
parents:
diff changeset
86 immediately afterward type the @key{DELETE} function key, it deletes the
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
89 in between the mouse command and @key{DELETE}, it does not do this.
Dave Love <fx@gnu.org>
parents:
diff changeset
90
Dave Love <fx@gnu.org>
parents:
diff changeset
91 @findex mouse-set-region
Dave Love <fx@gnu.org>
parents:
diff changeset
92 @findex mouse-set-point
Dave Love <fx@gnu.org>
parents:
diff changeset
93 @findex mouse-yank-at-click
Dave Love <fx@gnu.org>
parents:
diff changeset
94 @findex mouse-save-then-click
Dave Love <fx@gnu.org>
parents:
diff changeset
95 @kindex Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
96 @kindex Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
97 @kindex Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
98 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
99 @item Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
100 Move point to where you click (@code{mouse-set-point}).
Dave Love <fx@gnu.org>
parents:
diff changeset
101 This is normally the left button.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
115 @item Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
116 Set the region to the text you select by dragging, and copy it to the
Dave Love <fx@gnu.org>
parents:
diff changeset
117 kill ring (@code{mouse-set-region}). You can specify both ends of the
Dave Love <fx@gnu.org>
parents:
diff changeset
118 region with this single command.
Dave Love <fx@gnu.org>
parents:
diff changeset
119
Dave Love <fx@gnu.org>
parents:
diff changeset
120 @vindex mouse-scroll-min-lines
Dave Love <fx@gnu.org>
parents:
diff changeset
121 If you move the mouse off the top or bottom of the window while
Dave Love <fx@gnu.org>
parents:
diff changeset
122 dragging, the window scrolls at a steady rate until you move the mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
123 back into the window. This way, you can select regions that don't fit
Dave Love <fx@gnu.org>
parents:
diff changeset
124 entirely on the screen. The number of lines scrolled per step depends
Dave Love <fx@gnu.org>
parents:
diff changeset
125 on how far away from the window edge the mouse has gone; the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
126 @code{mouse-scroll-min-lines} specifies a minimum step size.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
132 @item Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
133 Yank the last killed text, where you click (@code{mouse-yank-at-click}).
Dave Love <fx@gnu.org>
parents:
diff changeset
134 This is normally the middle button.
Dave Love <fx@gnu.org>
parents:
diff changeset
135
Dave Love <fx@gnu.org>
parents:
diff changeset
136 @item Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
137 This command, @code{mouse-save-then-kill}, has several functions
Dave Love <fx@gnu.org>
parents:
diff changeset
138 depending on where you click and the status of the region.
Dave Love <fx@gnu.org>
parents:
diff changeset
139
Dave Love <fx@gnu.org>
parents:
diff changeset
140 The most basic case is when you click @kbd{Mouse-1} in one place and
Dave Love <fx@gnu.org>
parents:
diff changeset
141 then @kbd{Mouse-3} in another. This selects the text between those two
Dave Love <fx@gnu.org>
parents:
diff changeset
142 positions as the region. It also copies the new region to the kill
Dave Love <fx@gnu.org>
parents:
diff changeset
143 ring, so that you can copy it to someplace else.
Dave Love <fx@gnu.org>
parents:
diff changeset
144
Dave Love <fx@gnu.org>
parents:
diff changeset
145 If you click @kbd{Mouse-1} in the text, scroll with the scroll bar, and
Dave Love <fx@gnu.org>
parents:
diff changeset
146 then click @kbd{Mouse-3}, it remembers where point was before scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
147 (where you put it with @kbd{Mouse-1}), and uses that position as the
Dave Love <fx@gnu.org>
parents:
diff changeset
148 other end of the region. This is so that you can select a region that
Dave Love <fx@gnu.org>
parents:
diff changeset
149 doesn't fit entirely on the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
150
Dave Love <fx@gnu.org>
parents:
diff changeset
151 More generally, if you do not have a highlighted region, @kbd{Mouse-3}
Dave Love <fx@gnu.org>
parents:
diff changeset
152 selects the text between point and the click position as the region. It
Dave Love <fx@gnu.org>
parents:
diff changeset
153 does this by setting the mark where point was, and moving point to where
Dave Love <fx@gnu.org>
parents:
diff changeset
154 you click.
Dave Love <fx@gnu.org>
parents:
diff changeset
155
Dave Love <fx@gnu.org>
parents:
diff changeset
156 If you have a highlighted region, or if the region was set just before
Dave Love <fx@gnu.org>
parents:
diff changeset
157 by dragging button 1, @kbd{Mouse-3} adjusts the nearer end of the region
Dave Love <fx@gnu.org>
parents:
diff changeset
158 by moving it to where you click. The adjusted region's text also
Dave Love <fx@gnu.org>
parents:
diff changeset
159 replaces the old region's text in the kill ring.
Dave Love <fx@gnu.org>
parents:
diff changeset
160
Dave Love <fx@gnu.org>
parents:
diff changeset
161 If you originally specified the region using a double or triple
Dave Love <fx@gnu.org>
parents:
diff changeset
162 @kbd{Mouse-1}, so that the region is defined to consist of entire words
Dave Love <fx@gnu.org>
parents:
diff changeset
163 or lines, then adjusting the region with @kbd{Mouse-3} also proceeds by
Dave Love <fx@gnu.org>
parents:
diff changeset
164 entire words or lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
165
Dave Love <fx@gnu.org>
parents:
diff changeset
166 If you use @kbd{Mouse-3} a second time consecutively, at the same place,
Dave Love <fx@gnu.org>
parents:
diff changeset
167 that kills the region already selected.
Dave Love <fx@gnu.org>
parents:
diff changeset
168 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
169
Dave Love <fx@gnu.org>
parents:
diff changeset
170 The simplest way to kill text with the mouse is to press @kbd{Mouse-1}
Dave Love <fx@gnu.org>
parents:
diff changeset
171 at one end, then press @kbd{Mouse-3} twice at the other end.
Dave Love <fx@gnu.org>
parents:
diff changeset
172 @xref{Killing}. To copy the text into the kill ring without deleting it
Dave Love <fx@gnu.org>
parents:
diff changeset
173 from the buffer, press @kbd{Mouse-3} just once---or just drag across the
Dave Love <fx@gnu.org>
parents:
diff changeset
174 text with @kbd{Mouse-1}. Then you can copy it elsewhere by yanking it.
Dave Love <fx@gnu.org>
parents:
diff changeset
175
Dave Love <fx@gnu.org>
parents:
diff changeset
176 @vindex mouse-yank-at-point
Dave Love <fx@gnu.org>
parents:
diff changeset
177 To yank the killed or copied text somewhere else, move the mouse there
Dave Love <fx@gnu.org>
parents:
diff changeset
178 and press @kbd{Mouse-2}. @xref{Yanking}. However, if
Dave Love <fx@gnu.org>
parents:
diff changeset
179 @code{mouse-yank-at-point} is non-@code{nil}, @kbd{Mouse-2} yanks at
Dave Love <fx@gnu.org>
parents:
diff changeset
180 point. Then it does not matter where you click, or even which of the
Dave Love <fx@gnu.org>
parents:
diff changeset
181 frame's windows you click on. The default value is @code{nil}. This
Dave Love <fx@gnu.org>
parents:
diff changeset
182 variable also affects yanking the secondary selection.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
198 @cindex cutting
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
199 @cindex pasting
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
200 @cindex X cutting and pasting
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
201 To copy text to another windowing application, kill it or save it in
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
202 the kill ring. Then use the ``paste'' or ``yank'' command of the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
203 other application to insert the text.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
204
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
205 To copy text from another windowing application, use its ``cut'' or
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
206 ``copy'' command to select the text you want. Then yank it in Emacs
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
207 with @kbd{C-y} or @kbd{Mouse-2}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
208
Dave Love <fx@gnu.org>
parents:
diff changeset
209 @cindex primary selection
Dave Love <fx@gnu.org>
parents:
diff changeset
210 @cindex cut buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
211 @cindex selection, primary
Dave Love <fx@gnu.org>
parents:
diff changeset
212 @vindex x-cut-buffer-max
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
213 When Emacs puts text into the kill ring, or rotates text to the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
214 front of the kill ring, it sets the @dfn{primary selection} in the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
215 window system. This is how other windowing applications can access
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
216 the text. On the X Window System, emacs also stores the text in the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
217 cut buffer, but only if the text is short enough (the value of
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
218 @code{x-cut-buffer-max} specifies the maximum number of characters);
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
219 putting long strings in the cut buffer can be slow.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
220
Dave Love <fx@gnu.org>
parents:
diff changeset
221 The commands to yank the first entry in the kill ring actually check
Dave Love <fx@gnu.org>
parents:
diff changeset
222 first for a primary selection in another program; after that, they check
Dave Love <fx@gnu.org>
parents:
diff changeset
223 for text in the cut buffer. If neither of those sources provides text
Dave Love <fx@gnu.org>
parents:
diff changeset
224 to yank, the kill ring contents are used.
Dave Love <fx@gnu.org>
parents:
diff changeset
225
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
226 The standard coding system for X Window System selections is
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
227 @code{compound-text-with-extensions}. To specify another coding
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
228 system for selections, use @kbd{C-x @key{RET} x} or @kbd{C-x @key{RET}
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
229 X}. @xref{Communication Coding}.
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
261 @cindex secondary selection
Dave Love <fx@gnu.org>
parents:
diff changeset
262
Dave Love <fx@gnu.org>
parents:
diff changeset
263 The @dfn{secondary selection} is another way of selecting text using
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
264 the X Window System. It does not use point or the mark, so you can
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
265 use it to kill text without setting point or the mark.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
266
Dave Love <fx@gnu.org>
parents:
diff changeset
267 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
268 @findex mouse-set-secondary
Dave Love <fx@gnu.org>
parents:
diff changeset
269 @kindex M-Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
270 @item M-Drag-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
271 Set the secondary selection, with one end at the place where you press
Dave Love <fx@gnu.org>
parents:
diff changeset
272 down the button, and the other end at the place where you release it
Dave Love <fx@gnu.org>
parents:
diff changeset
273 (@code{mouse-set-secondary}). The highlighting appears and changes as
37121
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
274 you drag. You can control the appearance of the highlighting by
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
275 customizing the @code{secondary-selection} face (@pxref{Face
f9bd7ef13ddb Minor changes.
Richard M. Stallman <rms@gnu.org>
parents: 36979
diff changeset
276 Customization}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
277
Dave Love <fx@gnu.org>
parents:
diff changeset
278 If you move the mouse off the top or bottom of the window while
Dave Love <fx@gnu.org>
parents:
diff changeset
279 dragging, the window scrolls at a steady rate until you move the mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
280 back into the window. This way, you can mark regions that don't fit
Dave Love <fx@gnu.org>
parents:
diff changeset
281 entirely on the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
285 @findex mouse-start-secondary
Dave Love <fx@gnu.org>
parents:
diff changeset
286 @kindex M-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
287 @item M-Mouse-1
Dave Love <fx@gnu.org>
parents:
diff changeset
288 Set one endpoint for the @dfn{secondary selection}
Dave Love <fx@gnu.org>
parents:
diff changeset
289 (@code{mouse-start-secondary}).
Dave Love <fx@gnu.org>
parents:
diff changeset
290
Dave Love <fx@gnu.org>
parents:
diff changeset
291 @findex mouse-secondary-save-then-kill
Dave Love <fx@gnu.org>
parents:
diff changeset
292 @kindex M-Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
293 @item M-Mouse-3
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
298
Dave Love <fx@gnu.org>
parents:
diff changeset
299 @findex mouse-yank-secondary
Dave Love <fx@gnu.org>
parents:
diff changeset
300 @kindex M-Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
301 @item M-Mouse-2
Dave Love <fx@gnu.org>
parents:
diff changeset
302 Insert the secondary selection where you click
Dave Love <fx@gnu.org>
parents:
diff changeset
303 (@code{mouse-yank-secondary}). This places point at the end of the
Dave Love <fx@gnu.org>
parents:
diff changeset
304 yanked text.
Dave Love <fx@gnu.org>
parents:
diff changeset
305 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
306
Dave Love <fx@gnu.org>
parents:
diff changeset
307 Double or triple clicking of @kbd{M-Mouse-1} operates on words and
Dave Love <fx@gnu.org>
parents:
diff changeset
308 lines, much like @kbd{Mouse-1}.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
313
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
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
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
316 @cindex clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
317 @vindex x-select-enable-clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
318 @findex menu-bar-enable-clipboard
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
319 @cindex OpenWindows
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
320 @cindex Gnome
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
321
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
322 Apart from the primary and secondary selection types, Emacs can
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
323 handle the @dfn{clipboard} selection type which is used by some
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
324 applications, particularly under OpenWindows and Gnome.
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
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
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
327 @code{Paste} and @code{Copy} menu items, as well as the keys of the same
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
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
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
331 the Emacs yank functions consult the clipboard before the primary
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
332 selection, and to make the kill functions to store in the clipboard as
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
335 but not on other systems.
33920
9fd4e6727f6b (Clipboard): New.
Dave Love <fx@gnu.org>
parents: 32274
diff changeset
336
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
337 @node Mouse References
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
340 @kindex Mouse-2 @r{(selection)}
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
382 @kbd{Mouse-1} always sets point. If you prefer this older behavior,
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
383 set the variable @code{mouse-1-click-follows-link} to @code{nil}.
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
384 This variable also lets you choose various other alternatives for
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
385 following links with the mouse. Type @kbd{C-h v
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
388 @node Menu Mouse Clicks
Dave Love <fx@gnu.org>
parents:
diff changeset
389 @section Mouse Clicks for Menus
Dave Love <fx@gnu.org>
parents:
diff changeset
390
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
391 Several mouse clicks with the @key{CTRL} and @key{SHIFT} modifiers
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
392 bring up menus.
Dave Love <fx@gnu.org>
parents:
diff changeset
393
Dave Love <fx@gnu.org>
parents:
diff changeset
394 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
395 @item C-Mouse-1
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
396 @kindex C-Mouse-1
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
397 This menu is for selecting a buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
401
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
402 @item C-Mouse-2
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
403 @kindex C-Mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
404 This menu is for specifying faces and other text properties
Dave Love <fx@gnu.org>
parents:
diff changeset
405 for editing formatted text. @xref{Formatted Text}.
Dave Love <fx@gnu.org>
parents:
diff changeset
406
Dave Love <fx@gnu.org>
parents:
diff changeset
407 @item C-Mouse-3
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
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
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
412 button.@footnote{Some systems use @kbd{Mouse-3} for a mode-specific
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
422 This menu is for specifying the frame's default font.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
423 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
424
Dave Love <fx@gnu.org>
parents:
diff changeset
425 @node Mode Line Mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
426 @section Mode Line Mouse Commands
30872
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
427 @cindex mode line, mouse
ddf00eb5fb12 C-Mouse-3.
Dave Love <fx@gnu.org>
parents: 30583
diff changeset
428 @cindex mouse on mode line
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
429
Dave Love <fx@gnu.org>
parents:
diff changeset
430 You can use mouse clicks on window mode lines to select and manipulate
Dave Love <fx@gnu.org>
parents:
diff changeset
431 windows.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
436 the special bindings will be displayed (@pxref{Tooltips}). This
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
439 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
444 changing the height of the windows above and below. Changing heights
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
445 with the mouse in this way never deletes windows, it just refuses to
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
446 make any window smaller than the minimum height.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
447
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
450 @kbd{Mouse-2} on a mode line expands that window to fill its frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
451
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
457
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
460 @kbd{C-Mouse-2} on a mode line splits the window above
Dave Love <fx@gnu.org>
parents:
diff changeset
461 horizontally, above the place in the mode line where you click.
Dave Love <fx@gnu.org>
parents:
diff changeset
462 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
465 @kindex Mouse-1 @r{(scroll bar)}
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
466 Using @kbd{Mouse-1} on the divider between two side-by-side mode
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
467 lines, you can move the vertical boundary left or right. Using
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
470
Dave Love <fx@gnu.org>
parents:
diff changeset
471 @node Creating Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
472 @section Creating Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
473 @cindex creating frames
Dave Love <fx@gnu.org>
parents:
diff changeset
474
Dave Love <fx@gnu.org>
parents:
diff changeset
475 @kindex C-x 5
Dave Love <fx@gnu.org>
parents:
diff changeset
476 The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}, with parallel
Dave Love <fx@gnu.org>
parents:
diff changeset
477 subcommands. The difference is that @kbd{C-x 5} commands create a new
Dave Love <fx@gnu.org>
parents:
diff changeset
478 frame rather than just a new window in the selected frame (@pxref{Pop
Dave Love <fx@gnu.org>
parents:
diff changeset
479 Up Window}). If an existing visible or iconified frame already displays
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
482
Dave Love <fx@gnu.org>
parents:
diff changeset
483 The various @kbd{C-x 5} commands differ in how they find or create the
Dave Love <fx@gnu.org>
parents:
diff changeset
484 buffer to select:
Dave Love <fx@gnu.org>
parents:
diff changeset
485
Dave Love <fx@gnu.org>
parents:
diff changeset
486 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
487 @item C-x 5 2
Dave Love <fx@gnu.org>
parents:
diff changeset
488 @kindex C-x 5 2
Dave Love <fx@gnu.org>
parents:
diff changeset
489 @findex make-frame-command
Dave Love <fx@gnu.org>
parents:
diff changeset
490 Create a new frame (@code{make-frame-command}).
Dave Love <fx@gnu.org>
parents:
diff changeset
491 @item C-x 5 b @var{bufname} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
492 Select buffer @var{bufname} in another frame. This runs
Dave Love <fx@gnu.org>
parents:
diff changeset
493 @code{switch-to-buffer-other-frame}.
Dave Love <fx@gnu.org>
parents:
diff changeset
494 @item C-x 5 f @var{filename} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
495 Visit file @var{filename} and select its buffer in another frame. This
Dave Love <fx@gnu.org>
parents:
diff changeset
496 runs @code{find-file-other-frame}. @xref{Visiting}.
Dave Love <fx@gnu.org>
parents:
diff changeset
497 @item C-x 5 d @var{directory} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
498 Select a Dired buffer for directory @var{directory} in another frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
499 This runs @code{dired-other-frame}. @xref{Dired}.
Dave Love <fx@gnu.org>
parents:
diff changeset
500 @item C-x 5 m
Dave Love <fx@gnu.org>
parents:
diff changeset
501 Start composing a mail message in another frame. This runs
Dave Love <fx@gnu.org>
parents:
diff changeset
502 @code{mail-other-frame}. It is the other-frame variant of @kbd{C-x m}.
Dave Love <fx@gnu.org>
parents:
diff changeset
503 @xref{Sending Mail}.
Dave Love <fx@gnu.org>
parents:
diff changeset
504 @item C-x 5 .
Dave Love <fx@gnu.org>
parents:
diff changeset
505 Find a tag in the current tag table in another frame. This runs
Dave Love <fx@gnu.org>
parents:
diff changeset
506 @code{find-tag-other-frame}, the multiple-frame variant of @kbd{M-.}.
Dave Love <fx@gnu.org>
parents:
diff changeset
507 @xref{Tags}.
Dave Love <fx@gnu.org>
parents:
diff changeset
508 @item C-x 5 r @var{filename} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
509 @kindex C-x 5 r
Dave Love <fx@gnu.org>
parents:
diff changeset
510 @findex find-file-read-only-other-frame
Dave Love <fx@gnu.org>
parents:
diff changeset
511 Visit file @var{filename} read-only, and select its buffer in another
Dave Love <fx@gnu.org>
parents:
diff changeset
512 frame. This runs @code{find-file-read-only-other-frame}.
Dave Love <fx@gnu.org>
parents:
diff changeset
513 @xref{Visiting}.
Dave Love <fx@gnu.org>
parents:
diff changeset
514 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
515
Dave Love <fx@gnu.org>
parents:
diff changeset
516 @cindex default-frame-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
520 You can control the appearance of new frames you create by setting the
Dave Love <fx@gnu.org>
parents:
diff changeset
521 frame parameters in @code{default-frame-alist}. You can use the
Dave Love <fx@gnu.org>
parents:
diff changeset
522 variable @code{initial-frame-alist} to specify parameters that affect
Dave Love <fx@gnu.org>
parents:
diff changeset
523 only the initial frame. @xref{Initial Parameters,,, elisp, The Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
524 Lisp Reference Manual}, for more information.
Dave Love <fx@gnu.org>
parents:
diff changeset
525
Dave Love <fx@gnu.org>
parents:
diff changeset
526 @cindex font (default)
Dave Love <fx@gnu.org>
parents:
diff changeset
527 The easiest way to specify the principal font for all your Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
528 frames is with an X resource (@pxref{Font X}), but you can also do it by
Dave Love <fx@gnu.org>
parents:
diff changeset
529 modifying @code{default-frame-alist} to specify the @code{font}
Dave Love <fx@gnu.org>
parents:
diff changeset
530 parameter, as shown here:
Dave Love <fx@gnu.org>
parents:
diff changeset
531
Dave Love <fx@gnu.org>
parents:
diff changeset
532 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
533 (add-to-list 'default-frame-alist '(font . "10x20"))
Dave Love <fx@gnu.org>
parents:
diff changeset
534 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
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
99698449f84d improve page/line breaks
Karl Berry <karl@gnu.org>
parents: 72996
diff changeset
558 When typed on an Emacs frame's icon, deiconify instead.
99698449f84d improve page/line breaks
Karl Berry <karl@gnu.org>
parents: 72996
diff changeset
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
1673f96b0b2d Fix spelling errors.
Eli Zaretskii <eliz@gnu.org>
parents: 70444
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
602 @node Speedbar
65955
982867e0921a (Speedbar): Clarify the text.
Richard M. Stallman <rms@gnu.org>
parents: 65947
diff changeset
603 @section Speedbar Frames
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
604 @cindex speedbar
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
650
Dave Love <fx@gnu.org>
parents:
diff changeset
651 Some major modes, including Rmail mode, Info, and GUD, have
Dave Love <fx@gnu.org>
parents:
diff changeset
652 specialized ways of putting useful items into the speedbar for you to
Dave Love <fx@gnu.org>
parents:
diff changeset
653 select. For example, in Rmail mode, the speedbar shows a list of Rmail
Dave Love <fx@gnu.org>
parents:
diff changeset
654 files, and lets you move the current message to another Rmail file by
Dave Love <fx@gnu.org>
parents:
diff changeset
655 clicking on its @samp{<M>} box.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
659
Dave Love <fx@gnu.org>
parents:
diff changeset
660 @node Multiple Displays
Dave Love <fx@gnu.org>
parents:
diff changeset
661 @section Multiple Displays
Dave Love <fx@gnu.org>
parents:
diff changeset
662 @cindex multiple displays
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
669
Dave Love <fx@gnu.org>
parents:
diff changeset
670 @findex make-frame-on-display
Dave Love <fx@gnu.org>
parents:
diff changeset
671 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
672 @item M-x make-frame-on-display @key{RET} @var{display} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
673 Create a new frame on display @var{display}.
Dave Love <fx@gnu.org>
parents:
diff changeset
674 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
675
Dave Love <fx@gnu.org>
parents:
diff changeset
676 A single X server can handle more than one screen. When you open
Dave Love <fx@gnu.org>
parents:
diff changeset
677 frames on two screens belonging to one server, Emacs knows they share a
Dave Love <fx@gnu.org>
parents:
diff changeset
678 single keyboard, and it treats all the commands arriving from these
Dave Love <fx@gnu.org>
parents:
diff changeset
679 screens as a single stream of input.
Dave Love <fx@gnu.org>
parents:
diff changeset
680
Dave Love <fx@gnu.org>
parents:
diff changeset
681 When you open frames on different X servers, Emacs makes a separate
Dave Love <fx@gnu.org>
parents:
diff changeset
682 input stream for each server. This way, two users can type
Dave Love <fx@gnu.org>
parents:
diff changeset
683 simultaneously on the two displays, and Emacs will not garble their
Dave Love <fx@gnu.org>
parents:
diff changeset
684 input. Each server also has its own selected frame. The commands you
Dave Love <fx@gnu.org>
parents:
diff changeset
685 enter with a particular X server apply to that server's selected frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
686
Dave Love <fx@gnu.org>
parents:
diff changeset
687 Despite these features, people using the same Emacs job from different
Dave Love <fx@gnu.org>
parents:
diff changeset
688 displays can still interfere with each other if they are not careful.
Dave Love <fx@gnu.org>
parents:
diff changeset
689 For example, if any one types @kbd{C-x C-c}, that exits the Emacs job
Dave Love <fx@gnu.org>
parents:
diff changeset
690 for all of them!
Dave Love <fx@gnu.org>
parents:
diff changeset
691
Dave Love <fx@gnu.org>
parents:
diff changeset
692 @node Special Buffer Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
693 @section Special Buffer Frames
Dave Love <fx@gnu.org>
parents:
diff changeset
694
Dave Love <fx@gnu.org>
parents:
diff changeset
695 @vindex special-display-buffer-names
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
696 You can make certain chosen buffers, which Emacs normally displays
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
697 in ``another window,'' appear in special frames of their own. To do
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
698 this, set the variable @code{special-display-buffer-names} to a list
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
699 of buffer names; any buffer whose name is in that list automatically
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
700 gets a special frame, when an Emacs command wants to display it ``in
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
701 another window.''
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
702
Dave Love <fx@gnu.org>
parents:
diff changeset
703 For example, if you set the variable this way,
Dave Love <fx@gnu.org>
parents:
diff changeset
704
Dave Love <fx@gnu.org>
parents:
diff changeset
705 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
706 (setq special-display-buffer-names
Dave Love <fx@gnu.org>
parents:
diff changeset
707 '("*Completions*" "*grep*" "*tex-shell*"))
Dave Love <fx@gnu.org>
parents:
diff changeset
708 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
709
Dave Love <fx@gnu.org>
parents:
diff changeset
710 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
711 then completion lists, @code{grep} output and the @TeX{} mode shell
Dave Love <fx@gnu.org>
parents:
diff changeset
712 buffer get individual frames of their own. These frames, and the
Dave Love <fx@gnu.org>
parents:
diff changeset
713 windows in them, are never automatically split or reused for any other
Dave Love <fx@gnu.org>
parents:
diff changeset
714 buffers. They continue to show the buffers they were created for,
Dave Love <fx@gnu.org>
parents:
diff changeset
715 unless you alter them by hand. Killing the special buffer deletes its
Dave Love <fx@gnu.org>
parents:
diff changeset
716 frame automatically.
Dave Love <fx@gnu.org>
parents:
diff changeset
717
Dave Love <fx@gnu.org>
parents:
diff changeset
718 @vindex special-display-regexps
Dave Love <fx@gnu.org>
parents:
diff changeset
719 More generally, you can set @code{special-display-regexps} to a list
Dave Love <fx@gnu.org>
parents:
diff changeset
720 of regular expressions; then a buffer gets its own frame if its name
Dave Love <fx@gnu.org>
parents:
diff changeset
721 matches any of those regular expressions. (Once again, this applies only
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
722 to buffers that normally get displayed for you in ``another window.'')
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
723
Dave Love <fx@gnu.org>
parents:
diff changeset
724 @vindex special-display-frame-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
725 The variable @code{special-display-frame-alist} specifies the frame
Dave Love <fx@gnu.org>
parents:
diff changeset
726 parameters for these frames. It has a default value, so you don't need
Dave Love <fx@gnu.org>
parents:
diff changeset
727 to set it.
Dave Love <fx@gnu.org>
parents:
diff changeset
728
Dave Love <fx@gnu.org>
parents:
diff changeset
729 For those who know Lisp, an element of
Dave Love <fx@gnu.org>
parents:
diff changeset
730 @code{special-display-buffer-names} or @code{special-display-regexps}
Dave Love <fx@gnu.org>
parents:
diff changeset
731 can also be a list. Then the first element is the buffer name or
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
743
Dave Love <fx@gnu.org>
parents:
diff changeset
744 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
745 (@var{function} @var{args}...)
Dave Love <fx@gnu.org>
parents:
diff changeset
746 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
747
Dave Love <fx@gnu.org>
parents:
diff changeset
748 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
749 where @var{function} is a symbol. Then the frame is constructed by
Dave Love <fx@gnu.org>
parents:
diff changeset
750 calling @var{function}; its first argument is the buffer, and its
Dave Love <fx@gnu.org>
parents:
diff changeset
751 remaining arguments are @var{args}.
Dave Love <fx@gnu.org>
parents:
diff changeset
752
Dave Love <fx@gnu.org>
parents:
diff changeset
753 An analogous feature lets you specify buffers which should be
Dave Love <fx@gnu.org>
parents:
diff changeset
754 displayed in the selected window. @xref{Force Same Window}. The
Dave Love <fx@gnu.org>
parents:
diff changeset
755 same-window feature takes precedence over the special-frame feature;
Dave Love <fx@gnu.org>
parents:
diff changeset
756 therefore, if you add a buffer name to
Dave Love <fx@gnu.org>
parents:
diff changeset
757 @code{special-display-buffer-names} and it has no effect, check to see
Dave Love <fx@gnu.org>
parents:
diff changeset
758 whether that feature is also in use for the same buffer name.
Dave Love <fx@gnu.org>
parents:
diff changeset
759
Dave Love <fx@gnu.org>
parents:
diff changeset
760 @node Frame Parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
761 @section Setting Frame Parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
762 @cindex Auto-Raise mode
Dave Love <fx@gnu.org>
parents:
diff changeset
763 @cindex Auto-Lower mode
Dave Love <fx@gnu.org>
parents:
diff changeset
764
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
765 @kindex S-Mouse-1
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
766 You can specify the font and colors used for text display, and the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
767 colors for the frame borders, the cursor, and the mouse cursor, by
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
768 customizing the faces @code{default}, @code{border}, @code{cursor} and
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
769 @code{mouse}. @xref{Face Customization}. You can also set a frame's
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
770 default font through a pop-up menu. Press @kbd{S-Mouse-1} to activate
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
771 this menu.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
772
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
773 These commands are available for controlling the window management
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
774 behavior of the selected frame.
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
775
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
776 @table @kbd
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
777 @findex auto-raise-mode
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
778 @item M-x auto-raise-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
779 Toggle whether or not the selected frame should auto-raise. Auto-raise
Dave Love <fx@gnu.org>
parents:
diff changeset
780 means that every time you move the mouse onto the frame, it raises the
Dave Love <fx@gnu.org>
parents:
diff changeset
781 frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
782
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
783 Some window managers also implement auto-raise. If you enable
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
784 auto-raise for Emacs frames in your window manager, it will work, but
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
785 it is beyond Emacs' control, so @code{auto-raise-mode} has no effect
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
786 on it.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
787
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
788 @findex auto-lower-mode
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
789 @item M-x auto-lower-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
790 Toggle whether or not the selected frame should auto-lower.
Dave Love <fx@gnu.org>
parents:
diff changeset
791 Auto-lower means that every time you move the mouse off the frame,
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
792 the frame moves to the bottom of the stack on the screen.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
793
Dave Love <fx@gnu.org>
parents:
diff changeset
794 The command @code{auto-lower-mode} has no effect on auto-lower
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
795 implemented by the window manager. To control that, you must use the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
796 appropriate window manager features.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
797 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
798
Dave Love <fx@gnu.org>
parents:
diff changeset
799 In Emacs versions that use an X toolkit, the color-setting and
Dave Love <fx@gnu.org>
parents:
diff changeset
800 font-setting functions don't affect menus and the menu bar, since they
Dave Love <fx@gnu.org>
parents:
diff changeset
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
eb194a8d11de "Colors X" -> "Colors".
Eli Zaretskii <eliz@gnu.org>
parents: 41486
diff changeset
803 @xref{Colors}, regarding colors. @xref{Font X}, regarding choice of
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
804 font.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
810 Parameters,,, elisp, The Emacs Lisp Reference Manual}.
Dave Love <fx@gnu.org>
parents:
diff changeset
811
Dave Love <fx@gnu.org>
parents:
diff changeset
812 @node Scroll Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
813 @section Scroll Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
814 @cindex Scroll Bar mode
Dave Love <fx@gnu.org>
parents:
diff changeset
815 @cindex mode, Scroll Bar
Dave Love <fx@gnu.org>
parents:
diff changeset
816
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
817 On graphical displays, Emacs normally makes a @dfn{scroll bar} at
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
818 the left of each Emacs window.@footnote{Placing it at the left is
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
819 usually more useful with overlapping frames with text starting at the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
820 left margin.} The scroll bar runs the height of the window, and shows
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
821 a moving rectangular inner box which represents the portion of the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
822 buffer currently displayed. The entire height of the scroll bar
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
823 represents the entire length of the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
824
Dave Love <fx@gnu.org>
parents:
diff changeset
825 You can use @kbd{Mouse-2} (normally, the middle button) in the scroll
Dave Love <fx@gnu.org>
parents:
diff changeset
826 bar to move or drag the inner box up and down. If you move it to the
Dave Love <fx@gnu.org>
parents:
diff changeset
827 top of the scroll bar, you see the top of the buffer. If you move it to
Dave Love <fx@gnu.org>
parents:
diff changeset
828 the bottom of the scroll bar, you see the bottom of the buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
829
Dave Love <fx@gnu.org>
parents:
diff changeset
830 The left and right buttons in the scroll bar scroll by controlled
Dave Love <fx@gnu.org>
parents:
diff changeset
831 increments. @kbd{Mouse-1} (normally, the left button) moves the line at
Dave Love <fx@gnu.org>
parents:
diff changeset
832 the level where you click up to the top of the window. @kbd{Mouse-3}
Dave Love <fx@gnu.org>
parents:
diff changeset
833 (normally, the right button) moves the line at the top of the window
Dave Love <fx@gnu.org>
parents:
diff changeset
834 down to the level where you click. By clicking repeatedly in the same
Dave Love <fx@gnu.org>
parents:
diff changeset
835 place, you can scroll by the same distance over and over.
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
839
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
842 You can enable or disable Scroll Bar mode with the command @kbd{M-x
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
843 scroll-bar-mode}. With no argument, it toggles the use of scroll
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
844 bars. With an argument, it turns use of scroll bars on if and only if
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
845 the argument is positive. This command applies to all frames,
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
846 including frames yet to be created. Customize the variable
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
847 @code{scroll-bar-mode} to control the use of scroll bars at startup.
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
848 You can use it to specify that they are placed at the right of windows
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
849 if you prefer that. You have to set this variable through the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
850 @samp{Customize} interface (@pxref{Easy Customization}), or it will
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
851 not work properly.
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
852
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
853 You can also use the X resource @samp{verticalScrollBars} to control
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
854 the initial setting of Scroll Bar mode. @xref{Resources}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
855
Dave Love <fx@gnu.org>
parents:
diff changeset
856 @findex toggle-scroll-bar
Dave Love <fx@gnu.org>
parents:
diff changeset
857 To enable or disable scroll bars for just the selected frame, use the
44326
c69907b4eb03 Minor cleanup.
Richard M. Stallman <rms@gnu.org>
parents: 43561
diff changeset
858 command @kbd{M-x toggle-scroll-bar}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
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
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
869 @cindex wheel, mouse
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
870 @findex mouse-wheel-mode
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
871 @cindex Mouse Wheel minor mode
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
872 @cindex mode, Mouse Wheel
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
873 Some mice have a ``wheel'' instead of a third button. You can
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
874 usually click the wheel to act as either @kbd{Mouse-2} or
f9e2a2533bef mouse-wheel-mode
Dave Love <fx@gnu.org>
parents: 36729
diff changeset
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
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
881 @vindex mouse-wheel-follow-mouse
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
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
4805684e0b00 wording for 8.5x11
Karl Berry <karl@gnu.org>
parents: 75529
diff changeset
884 The two variables @code{mouse-wheel-follow-mouse} and
35875
348cbace7a4f Update mouse-wheel section.
Miles Bader <miles@gnu.org>
parents: 35730
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
906 The XDND and Motif drag and drop protocols, and the old KDE 1.x
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
909 @node Menu Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
910 @section Menu Bars
Dave Love <fx@gnu.org>
parents:
diff changeset
911 @cindex Menu Bar mode
Dave Love <fx@gnu.org>
parents:
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
915
Dave Love <fx@gnu.org>
parents:
diff changeset
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
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
918 With no argument, this command toggles Menu Bar mode, a
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
919 minor mode. With an argument, the command turns Menu Bar mode on if the
Dave Love <fx@gnu.org>
parents:
diff changeset
920 argument is positive, off if the argument is not positive. You can use
Dave Love <fx@gnu.org>
parents:
diff changeset
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
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
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
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38670
diff changeset
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
Dave Love <fx@gnu.org>
parents:
diff changeset
930
Dave Love <fx@gnu.org>
parents:
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
933 menus' visual appearance.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
934
31609
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
935 @node Tool Bars
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
936 @section Tool Bars
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
937 @cindex Tool Bar mode
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
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
f5c313af6821 Tool bar, mention c-mouse-3.
Dave Love <fx@gnu.org>
parents: 31187
diff changeset
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
f6cf1681b74a Fix tool bar caveat.
Dave Love <fx@gnu.org>
parents: 36384
diff changeset
951 XPM icons if Emacs was built with XPM support. Otherwise, the tool
f6cf1681b74a Fix tool bar caveat.
Dave Love <fx@gnu.org>
parents: 36384
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
974 A file selection window is a special kind of dialog box for asking
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
975 for file names. You can customize the variable @code{use-file-dialog}
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
976 to suppress the use of file selection windows, even if you still want
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
977 other kinds of dialogs. This variable has no effect if you have
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
980 @vindex x-gtk-show-hidden-files
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
981 For Gtk+ version 2.4 and newer, Emacs use the Gtk+ file chooser
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
982 dialog. Emacs adds a toggle button that enables and disables showing
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
983 of hidden files (files starting with a dot) in that dialog. The
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
984 variable @code{x-gtk-show-hidden-files} controls whether to show
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
1002 @cindex tooltips
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1003
62219
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
1004 @dfn{Tooltips} are small windows that display text information at the
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
1005 current mouse position. They activate when there is a pause in mouse
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
1006 movement. There are two types of tooltip: help tooltips and GUD
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
1007 tooltips.
62172
517435a249bb (Tooltips): Describe help tooltips and GUD tooltips
Nick Roberts <nickrob@snap.net.nz>
parents: 62161
diff changeset
1008
62220
896651c6cfa5 (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62219
diff changeset
1009 @dfn{Help tooltips} typically display over text---including the mode
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1010 line---but are also available for other parts of the Emacs frame, such
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1011 as the tool bar and menu items.
28432
a232089b2eea Tooltips extra. C-x 5 1.
Dave Love <fx@gnu.org>
parents: 28126
diff changeset
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
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1014 You can toggle display of help tooltips (Tooltip mode) with the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1015 command @kbd{M-x tooltip-mode}. When Tooltip mode is disabled, the
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
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
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
1018 @dfn{GUD tooltips} show values of variables. They are useful when
62f428aa09ca (Tooltips): Cleanups.
Richard M. Stallman <rms@gnu.org>
parents: 62172
diff changeset
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
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1028 @node Mouse Avoidance
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
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
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
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
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1039
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1040 @table @code
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1041 @item banish
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38670
diff changeset
1042 Move the mouse to the upper-right corner on any key-press;
28124
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1043 @item exile
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1044 Move the mouse to the corner only if the cursor gets too close,
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1045 and allow it to return once the cursor is out of the way;
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1046 @item jump
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1047 If the cursor gets too close to the mouse, displace the mouse
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1048 a random distance & direction;
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1049 @item animate
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1050 As @code{jump}, but shows steps along the way for illusion of motion;
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1051 @item cat-and-mouse
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1052 The same as @code{animate};
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1053 @item proteus
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1054 As @code{animate}, but changes the shape of the mouse pointer too.
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1055 @end table
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
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
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
1059 the mode.
27224
d9c8c29ec5c4 Features may work other than under X.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1060
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1061 @node Non-Window Terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1062 @section Non-Window Terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1063 @cindex non-window terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1064 @cindex single-frame terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1065
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1066 On a text-only terminal, Emacs can display only one Emacs frame at a
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1067 time. However, you can still create multiple Emacs frames, and switch
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1068 between them. Switching frames on these terminals is much like
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1069 switching between different window configurations.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1070
Dave Love <fx@gnu.org>
parents:
diff changeset
1071 Use @kbd{C-x 5 2} to create a new frame and switch to it; use @kbd{C-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1072 5 o} to cycle through the existing frames; use @kbd{C-x 5 0} to delete
Dave Love <fx@gnu.org>
parents:
diff changeset
1073 the current frame.
Dave Love <fx@gnu.org>
parents:
diff changeset
1074
Dave Love <fx@gnu.org>
parents:
diff changeset
1075 Each frame has a number to distinguish it. If your terminal can
Dave Love <fx@gnu.org>
parents:
diff changeset
1076 display only one frame at a time, the selected frame's number @var{n}
Dave Love <fx@gnu.org>
parents:
diff changeset
1077 appears near the beginning of the mode line, in the form
Dave Love <fx@gnu.org>
parents:
diff changeset
1078 @samp{F@var{n}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1079
Dave Love <fx@gnu.org>
parents:
diff changeset
1080 @findex set-frame-name
Dave Love <fx@gnu.org>
parents:
diff changeset
1081 @findex select-frame-by-name
68542
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1082 @samp{F@var{n}} is in fact the frame's initial name. You can give
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1083 frames more meaningful names if you wish, and you can select a frame
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1084 by its name. Use the command @kbd{M-x set-frame-name @key{RET}
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1085 @var{name} @key{RET}} to specify a new name for the selected frame,
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1086 and use @kbd{M-x select-frame-by-name @key{RET} @var{name} @key{RET}}
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1087 to select a frame according to its name. The name you specify appears
bb47b41ef429 Minor clarifications.
Richard M. Stallman <rms@gnu.org>
parents: 67848
diff changeset
1088 in the mode line when the frame is selected.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
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
eef598a6a330 (Mouse Avoidance): New section.
Dave Love <fx@gnu.org>
parents: 27224
diff changeset
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
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49917
diff changeset
1110
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49917
diff changeset
1111 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49917
diff changeset
1112 arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49917
diff changeset
1113 @end ignore