the variable should be @code{nil}.
@node Speedbar
-@section Making and Using a Speedbar Frame
+@section Speedbar Frames
@cindex speedbar
- The @dfn{Speedbar} is a special frame that is used to summarize
-information related to other buffers. Normally, it displays a menu of
-files you could visit and tags within those files. Type @kbd{M-x
-speedbar} to enable the speedbar and associate it with the current
-frame (which is called the speedbar's @dfn{attached frame}).
-
- Currently, only one speedbar is supported at a time. To dismiss the
-speedbar, select it and type @kbd{q} or @kbd{M-x speedbar}, or delete
-the frame or window normally. You can then attach the speedbar to a
-different frame by calling @kbd{M-x speedbar} from that frame.
-
- When you initially launch the speedbar, it starts in @dfn{File
-Display Mode}, showing 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 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
+@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. 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 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 can also use the keyboard to navigate the speedbar. Typing
-@kbd{RET} 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}.
-
- The speedbar is not limited to showing files. Type @kbd{b} to enter
-@dfn{Buffer Display Mode}, in which the speedbar displays a list of
-Emacs buffers. 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.
+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
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
value. If Emacs is built with a Gtk+ version that has only one file dialog,
the setting of this variable has no effect.
+@vindex x-gtk-show-hidden-files
+ For Gtk+ version 2.4 and newer, Emacs use the Gtk+ file chooser dialog.
+Emacs adds a toggle button that enables and disables showing of hidden files
+(files starting with a dot) in that dialog. This variable controls if
+hidden files should be shown by default or not.
+
@node Tooltips
@section Tooltips
@cindex tooltips