@c This is part of the Emacs manual.
-@c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 99, 2000, 2001, 2004
-@c Free Software Foundation, Inc.
+@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 1999, 2000,
+@c 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Frames, International, Windows, Top
@chapter Frames and X Windows
* Menu Bars:: Enabling and disabling the menu bar.
* Tool Bars:: Enabling and disabling the tool bar.
* Dialog Boxes:: Controlling use of dialog boxes.
-* Tooltips:: Showing "tooltips", AKA "balloon help" for active text.
+* Tooltips:: Displaying information at the current mouse position.
* Mouse Avoidance:: Moving the mouse pointer out of the way.
* Non-Window Terminals:: Multiple frames on terminals that show only one.
* XTerm Mouse:: Using the mouse in an XTerm terminal emulator.
@kbd{Mouse-2} on a completion in the @samp{*Completions*} buffer, you
choose that completion.
-@vindex mouse-1-click-follows-link
However, most applications use @kbd{Mouse-1} to do this sort of
thing, so Emacs implements this too. If you click @kbd{Mouse-1}
quickly on a reference or button, it follows or activates. If you
click slowly, it moves point as usual. Dragging, meaning moving the
mouse while it is held down, also has its usual behavior of setting
-the region. The variable @code{mouse-1-click-follows-link} controls
-whether @kbd{Mouse-1} has this behavior.
+the region.
-@vindex mouse-1-click-follows-link
+@vindex mouse-1-click-in-non-selected-windows
Normally, the @kbd{Mouse-1} click behavior is performed on links in
any window. The variable @code{mouse-1-click-in-non-selected-windows}
controls whether @kbd{Mouse-1} has this behavior even in non-selected
where the mouse already is), never, or only immediately after you move
the mouse.
+@vindex mouse-1-click-follows-link
+ In Emacs versions before 22, only @kbd{Mouse-2} follows links and
+@kbd{Mouse-1} always sets points. If you prefer this behavior, set
+the variable @code{mouse-1-click-follows-link} to @code{nil}. This
+variable also lets you choose various other alternatives for following
+links with the mouse. Type @kbd{C-h v mouse-1-click-follows-link @key{RET}}
+for more details.
+
@node Menu Mouse Clicks
@section Mouse Clicks for Menus
You can use mouse clicks on window mode lines to select and manipulate
windows.
+ Some areas of the mode line, such as the buffer name and the major
+mode name, have their own special mouse bindings. These areas are
+highlighted when you hold the mouse over them, and information about
+the special bindings will be displayed (@pxref{Tooltips}).
+
+ You can also click on areas of the mode line that do not have
+special mouse bindings of their own. This has the following effects:
+
@table @kbd
@item Mouse-1
@kindex Mouse-1 @r{(mode line)}
@kbd{C-Mouse-2} on a scroll bar splits the corresponding window
vertically. @xref{Split Window}.
- The commands above apply to areas of the mode line which do not have
-special mouse bindings of their own. Some areas, such as the buffer
-name and the major mode name, have their own special mouse bindings.
-Emacs displays information about these bindings when you hold the
-mouse over such a place (@pxref{Tooltips}).
-
@node Creating Frames
@section Creating Frames
@cindex creating frames
Here's a similar example for specifying a foreground color:
@example
-(add-to-list 'default-frame-alist '(background-color . "blue"))
+(add-to-list 'default-frame-alist '(foreground-color . "blue"))
@end example
-
@node Frame Commands
@section Frame Commands
the variable should be @code{nil}.
@node Speedbar
-@section Making and Using a Speedbar Frame
+@section Speedbar Frames
@cindex speedbar
- An Emacs frame can have a @dfn{speedbar}, which is a vertical window
-that serves as a scrollable menu of files you could visit and tags
-within those files. To create a speedbar, type @kbd{M-x speedbar}; this
-creates a speedbar window for the selected frame. From then on, you can
-click on a file name in the speedbar to visit that file in the
-corresponding Emacs frame, or click on a tag name to jump to that tag in
-the Emacs frame.
-
- Initially the speedbar lists the immediate contents of the current
-directory, one file per line. Each line also has a box, @samp{[+]} or
-@samp{<+>}, that you can click on with @kbd{Mouse-2} to ``open up'' the
-contents of that item. If the line names a directory, opening it adds
+@cindex attached frame (of speedbar)
+ The @dfn{speedbar} is a special frame for conveniently navigating in
+or operating on another frame. The speedbar, when it exists, is
+always associated with a specific frame, called its @dfn{attached
+frame}; all speedbar operations act on that frame.
+
+ Type @kbd{M-x speedbar} to create the speedbar and associate it with
+the current frame. To dismiss the speedbar, type @kbd{M-x speedbar}
+again, or select the speedbar and type @kbd{q}. (You can also delete
+the speedbar frame like any other Emacs frame.) If you wish to
+associate the speedbar with a different frame, dismiss it and call
+@kbd{M-x speedbar} from that frame.
+
+ The speedbar can operate in various modes. Its default mode is
+@dfn{File Display} mode, which shows the files in the current
+directory of the selected window of the attached frame, one file per
+line. Clicking on a file name visits that file in the selected window
+of the attached frame, and clicking on a directory name shows that
+directory in the speedbar (@pxref{Mouse References}). Each line also
+has a box, @samp{[+]} or @samp{<+>}, that you can click on to
+@dfn{expand} the contents of that item. Expanding a directory adds
the contents of that directory to the speedbar display, underneath the
-directory's own line. If the line lists an ordinary file, opening it up
-adds a list of the tags in that file to the speedbar display. When a
-file is opened up, the @samp{[+]} changes to @samp{[-]}; you can click
-on that box to ``close up'' that file (hide its contents).
+directory's own line. Expanding an ordinary file adds a list of the
+tags in that file to the speedbar display; you can click on a tag name
+to jump to that tag in the selected window of the attached frame.
+When a file or directory is expanded, the @samp{[+]} changes to
+@samp{[-]}; you can click on that box to @dfn{contract} the item,
+hiding its contents.
+
+ You navigate through the speedbar using the keyboard, too. Typing
+@kbd{RET} while point is on a line in the speedbar is equivalent to
+clicking the item on the current line, and @kbd{SPC} expands or
+contracts the item. @kbd{U} displays the parent directory of the
+current directory. To copy, delete, or rename the file on the current
+line, type @kbd{C}, @kbd{D}, and @kbd{R} respectively. To create a
+new directory, type @kbd{M}.
+
+ Another general-purpose speedbar mode is @dfn{Buffer Display} mode;
+in this mode, the speedbar displays a list of Emacs buffers. To
+switch to this mode, type @kbd{b} in the speedbar. To return to File
+Display mode, type @kbd{f}. You can also change the display mode by
+clicking @kbd{mouse-3} anywhere in the speedbar window (or
+@kbd{mouse-1} on the mode-line) and selecting @samp{Displays} in the
+pop-up menu.
Some major modes, including Rmail mode, Info, and GUD, have
specialized ways of putting useful items into the speedbar for you to
files, and lets you move the current message to another Rmail file by
clicking on its @samp{<M>} box.
- A speedbar belongs to one Emacs frame, and always operates on that
-frame. If you use multiple frames, you can make a speedbar for some or
-all of the frames; type @kbd{M-x speedbar} in any given frame to make a
-speedbar for it.
+ For more details on using and programming the speedbar, @xref{Top,
+Speedbar,,speedbar, Speedbar Manual}.
@node Multiple Displays
@section Multiple Displays
The variables @code{mouse-wheel-follow-mouse} and
@code{mouse-wheel-scroll-amount} determine where and by how much
buffers are scrolled. The variable
-@code{mouse-wheel-progressive-speed} determines whether the the scroll
+@code{mouse-wheel-progressive-speed} determines whether the scroll
speed is linked to how fast you move the wheel.
@node Drag and Drop
(according to the conventions of the application it came from) into the
directory displayed in that buffer.
-@vindex x-dnd-open-file-other-window
+@vindex dnd-open-file-other-window
Dropping a file normally visits it in the window you drop it on. If
you prefer to visit the file in a new window in such cases, customize
-the variable @code{x-dnd-open-file-other-window}.
+the variable @code{dnd-open-file-other-window}.
@ignore
@c ??? To Lisp manual
detailed knowledge of what types other applications use for drag and
drop.
-@vindex x-dnd-protocol-alist
+@vindex dnd-protocol-alist
When an URL is dropped on Emacs it may be a file, but it may also be
another URL type (ftp, http, etc.). Emacs first checks
-@code{x-dnd-protocol-alist} to determine what to do with the URL. If
+@code{dnd-protocol-alist} to determine what to do with the URL. If
there is no match there and if @code{browse-url-browser-function} is
an alist, Emacs looks for a match there. If no match is found the
text for the URL is inserted. If you want to alter Emacs behavior,
bar uses monochrome icons (PBM or XBM format).
You can turn display of tool bars on or off with @kbd{M-x
-tool-bar-mode}.
+tool-bar-mode} or by customizing the option @code{tool-bar-mode}.
@node Dialog Boxes
@section Using Dialog Boxes
the setting of this variable has no effect.
@node Tooltips
-@section Tooltips (or ``Balloon Help'')
+@section Tooltips
+@cindex tooltips
-@cindex balloon help
- Tooltips are small X windows displaying a help string at the current
-mouse position, typically over text---including the mode line---which
-can be activated with the mouse or other keys. (This facility is
-sometimes known as @dfn{balloon help}.) Help text may be available for
-menu items too.
+ @dfn{Tooltips} are small windows that display text information at the
+current mouse position. They activate when there is a pause in mouse
+movement. There are two types of tooltip: help tooltips and GUD
+tooltips.
+
+ @dfn{Help tooltips} typically display over text---including the mode
+line---but may be also available for many other parts of the Emacs
+frame such as the tool bar and menu items.
@findex tooltip-mode
- To use tooltips, enable Tooltip mode with the command @kbd{M-x
-tooltip-mode}. The customization group @code{tooltip} controls
-various aspects of how tooltips work. When Tooltip mode is disabled,
-the help text is displayed in the echo area instead.
+ You can toggle help tooltips (Tooltip mode) with the command
+ @kbd{M-x tooltip-mode}. When Tooltip mode is disabled, the help text
+is displayed in the echo area instead.
+
+ @dfn{GUD tooltips} show values of variables. They are useful when
+you are debugging a program. @xref{Debugger Operation}.
@vindex tooltip-delay
The variables @code{tooltip-delay} specifies how long Emacs should
clicks is still available by holding down the @kbd{SHIFT} key when you
press the mouse button.
- @code{xterm-mouse-mode} is a global minor mode (@pxref{Minor Modes}).
+ Xterm Mouse mode is a global minor mode (@pxref{Minor Modes}).
Repeating the command turns the mode off again.
@ignore