@cindex Scroll Bar mode
@cindex mode, Scroll Bar
- On graphical displays, Emacs normally makes a @dfn{scroll bar} at
-the left of each Emacs window, running the height of the
-window.@footnote{Placing it at the left is usually more useful with
-overlapping frames with text starting at the left margin.}
-
- When Emacs is compiled with GTK+ support on the X Window System, or
-in operating systems such as Microsoft Windows or Mac OS, you can use
-the scroll bar as you do in other graphical applications. If you
-click @kbd{Mouse-1} on the scroll bar's up and down buttons, that
-scrolls the window by one line at a time. Clicking @kbd{Mouse-1}
-above or below the scroll bar's inner box scrolls the window by nearly
-the entire height of the window, like @kbd{M-v} and @kbd{C-v}
-respectively (@pxref{Moving Point}). Dragging the inner box with
-@kbd{Mouse-1} scrolls the window continuously.
-
- If Emacs is compiled without GTK+ support on the X Window System,
-the scroll bar behaves differently. The scroll bar's inner box is
-drawn to represent the portion of the buffer currently displayed, with
-the entire height of the scroll bar representing the entire length of
-the buffer. @kbd{Mouse-1} anywhere on the scroll bar scrolls forward
-like @kbd{C-v}, and @kbd{Mouse-3} scrolls backward like @kbd{M-v}.
-Clicking @kbd{Mouse-2} in the scroll bar lets you move or drag the
-inner box up and down.
-
- You can also click @kbd{C-Mouse-2} in the scroll bar to split a
-window vertically. The split occurs on the line where you click.
+ On graphical displays, there is a @dfn{scroll bar} on the side of
+each Emacs window. Clicking @kbd{Mouse-1} on the scroll bar's up and
+down buttons scrolls the window by one line at a time. Clicking
+@kbd{Mouse-1} above or below the scroll bar's inner box scrolls the
+window by nearly the entire height of the window, like @kbd{M-v} and
+@kbd{C-v} respectively (@pxref{Moving Point}). Dragging the inner box
+scrolls continuously.
+
+ If Emacs is compiled on the X Window System without X toolkit
+support, the scroll bar behaves differently. Clicking @kbd{Mouse-1}
+anywhere on the scroll bar scrolls forward like @kbd{C-v}, while
+@kbd{Mouse-3} scrolls backward like @kbd{M-v}. Clicking @kbd{Mouse-2}
+in the scroll bar lets you drag the inner box up and down.
@findex scroll-bar-mode
-@vindex scroll-bar-mode
- You can toggle the use of the scroll bar with the command @kbd{M-x
-scroll-bar-mode}. With a prefix argument, this command turns use of
-scroll bars on if and only if the argument is positive. This command
-applies to all frames, including frames yet to be created. Customize
-the variable @code{scroll-bar-mode} to control the use of scroll bars
-at startup. You can use it to specify that they are placed at the
-right of windows if you prefer that. You have to set this variable
-through the @samp{Customize} interface (@pxref{Easy Customization}),
-or it will not work properly. You can also use the X resource
-@samp{verticalScrollBars} to control the initial setting of Scroll Bar
-mode. @xref{Resources}.
-
@findex toggle-scroll-bar
- To enable or disable scroll bars for just the selected frame, use the
+ To toggle the use of scroll bars, type @kbd{M-x scroll-bar-mode}.
+This command applies to all frames, including frames yet to be
+created. To toggle scroll bars for just the selected frame, use the
command @kbd{M-x toggle-scroll-bar}.
+@vindex scroll-bar-mode
+ To control the use of scroll bars at startup, customize the variable
+@code{scroll-bar-mode}. Its value should be either @code{right} (put
+scroll bars on the right side of windows), @code{left} (put them on
+the left), or @code{nil} (disable scroll bars). By default, Emacs
+puts scroll bars on the right if it was compiled with GTK+ support on
+the X Window System, and on MS-Windows or Mac OS; Emacs puts scroll
+bars on the left if compiled on the X Window system without GTK+
+support (following the old convention for X applications).
+
@vindex scroll-bar-width
@cindex width of the scroll bar
- You can control the scroll bar width by changing the value of the
-@code{scroll-bar-width} frame parameter.
+ You can also use the X resource @samp{verticalScrollBars} to enable
+or disable the scroll bars (@pxref{Resources}). To control the scroll
+bar width, change the @code{scroll-bar-width} frame parameter
+(@pxref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}).
@node Wheeled Mice
@section Scrolling With ``Wheeled'' Mice
@cindex mode, Tool Bar
@cindex icons, toolbar
- The @dfn{tool bar} is a line (or lines) of icons at the top of the
-Emacs window, just below the menu bar. You can click on these icons
-with the mouse to do various jobs.
-
- The global tool bar contains general commands. Some major modes
-define their own tool bars to replace it. A few ``special'' modes
-that are not designed for ordinary editing remove some items from the
-global tool bar.
+ On graphical displays, Emacs puts a @dfn{tool bar} at the top of
+each frame, just below the menu bar. This is a row of icons which you
+can click on with the mouse to invoke various commands.
- Tool bars work only on a graphical display. The tool bar uses colored
-XPM icons if Emacs was built with XPM support. Otherwise, the tool
-bar uses monochrome icons (PBM or XBM format).
+ The global (default) tool bar contains general commands. Some major
+modes define their own tool bars; whenever a buffer with such a major
+mode is current, the mode's tool bar replaces the global tool bar.
@findex tool-bar-mode
@vindex tool-bar-mode
- You can turn display of tool bars on or off with @kbd{M-x
-tool-bar-mode} or by customizing the option @code{tool-bar-mode}.
+ To toggle the use of tool bars, type @kbd{M-x tool-bar-mode}. This
+command applies to all frames, including frames yet to be created. To
+control the use of tool bars at startup, customize the variable
+@code{tool-bar-mode}.
@vindex tool-bar-style
@cindex Tool Bar style
- When Emacs is compiled with GTK+ support, tool bars can have text and images.
-Customize @code{tool-bar-style} to select style. The default style is
-the same as for the desktop in the Gnome case. If no default is found,
-the tool bar uses just images.
+ When Emacs is compiled with GTK+ support, each tool bar item can
+consist of an image, or a text label, or both. By default, Emacs
+follows the Gnome desktop's tool bar style setting; if none is
+defined, it displays tool bar items as just images. To impose a
+specific tool bar style, customize the variable @code{tool-bar-style}.
@cindex Tool Bar position
- You can also control the placement of the tool bar for the GTK+ tool bar
-with the frame parameter @code{tool-bar-position}.
-For a detailed description of frame parameters and customization,
-see @ref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}.
+ You can also control the placement of the tool bar for the GTK+ tool
+bar with the frame parameter @code{tool-bar-position}. @xref{Frame
+Parameters,,, elisp, The Emacs Lisp Reference Manual}.
@node Dialog Boxes
@section Using Dialog Boxes
customizing the windows that display tooltips.
@vindex x-gtk-use-system-tooltips
- If Emacs is built with GTK support, it displays tooltips via GTK,
-using the default appearance of GTK tooltips. To disable this, change
-the variable @code{x-gtk-use-system-tooltips} to @code{nil}. If you
-do this, or if Emacs is built without GTK support, the @code{tooltip}
-face specifies most attributes of the tooltip text.
+ If Emacs is built with GTK+ support, it displays tooltips via GTK+,
+using the default appearance of GTK+ tooltips. To disable this,
+change the variable @code{x-gtk-use-system-tooltips} to @code{nil}.
+If you do this, or if Emacs is built without GTK+ support, the
+@code{tooltip} face specifies most attributes of the tooltip text.
@node Mouse Avoidance
@section Mouse Avoidance
(U+2010 and U+2011).
** Improved GTK integration
-
++++
*** GTK scroll-bars are now placed on the right by default.
Use `set-scroll-bar-mode' to change this.
-
++++
*** GTK tool bars can have just text, just images or images and text.
Customize `tool-bar-style' to choose style. On a Gnome desktop, the default
is taken from the desktop settings.
-
+---
*** GTK tool bars can be placed on the left/right or top/bottom of the frame.
The frame-parameter tool-bar-position controls this. It takes the values
top, left, right or bottom. The Options => Show/Hide menu has entries
*** Tramp offers handlers for file-selinux-context and set-file-selinux-context
for remote machines which support SELinux.
-+++
-** The function format-time-string now supports the %N directive, for
-higher-resolution time stamps.
-
** Changes for exiting Emacs
+++
*** The function kill-emacs is now run upon receipt of the signals
(bound to C-v/[next] and M-v/[prior]) do not signal errors at top/bottom
of buffer at first key-press (instead move to top/bottom of buffer)
when `scroll-error-top-bottom' is non-nil.
-
+++
*** New variable `scroll-error-top-bottom' (see above).
*** New scrolling commands `scroll-up-line' and `scroll-down-line'
scroll a line instead of full screen.
-
+++
*** New property `scroll-command' should be set on a command's symbol to
define it as a scroll command affected by `scroll-preserve-screen-position'.
-
+++
*** If you customize `scroll-conservatively' to a value greater than 100,
Emacs will never recenter point in the window when it scrolls due to
cursor motion commands or commands that move point (e.f., `M-g M-g').
Previously, you needed to use `most-positive-fixnum' as the value of
`scroll-conservatively' to achieve the same effect.
-
---
*** ``Aggressive'' scrolling now honors the scroll margins.
If you customize `scroll-up-aggressively' or
adding "(diff-mode . ((mode . whitespace)))" to .dir-locals.el will
turn on `whitespace-mode' for *vc-diff* buffers. Modes should call
`hack-dir-local-variables-non-file-buffer' to support this.
-
+++
*** Using "mode: MINOR-MODE" to enable a minor mode is deprecated.
Instead, use "eval: (minor-mode 1)".
to the error handler as if the debugger had not been invoked instead of
jumping all the way to the top-level.
++++
+** The function format-time-string now supports the %N directive, for
+higher-resolution time stamps.
+
** New function `read-char-choice' reads a restricted set of characters,
discarding any inputs not inside the set.
projects / emacs.git / commitdiff