@c This is part of the Emacs manual.
-@c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000 Free Software Foundation, Inc.
+@c Copyright (C) 1985,86,87,93,94,95,97,2000,2001,2004 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Windows, Frames, Buffers, Top
@chapter Multiple Windows
At any time, one of the windows is the @dfn{selected window}; the
buffer this window is displaying is the current buffer. The terminal's
cursor shows the location of point in this window. Each other window
-has a location of point as well, but since the terminal has only one
-cursor there is no way to show where those locations are. When multiple
-frames are visible in X Windows, each frame has a cursor which appears
-in the frame's selected window. The cursor in the selected frame is
-solid; the cursor in other frames is a hollow box.
+has a location of point as well. On text-only terminals, there is no
+way to show where those locations are, since the terminal has only one
+cursor. If you are using a window system, the location of point in a
+non-selected window is indicated by a hollow box. The cursor in the
+selected window is blinking or solid.
Commands to move point affect the value of point for the selected Emacs
window only. They do not change the value of point in any other Emacs
window, even one showing the same buffer. The same is true for commands
-such as @kbd{C-x b} to change the selected buffer in the selected window;
+such as @kbd{C-x b} to change the current buffer in the selected window;
they do not affect other windows at all. However, there are other commands
such as @kbd{C-x 4 b} that select a different window and switch buffers in
it. Also, all commands that display information in a window, including
@findex split-window-horizontally
@kbd{C-x 3} (@code{split-window-horizontally}) breaks the selected
window into two side-by-side windows. A numeric argument specifies how
-many columns to give the one on the left. A line of vertical bars
-separates the two windows. Windows that are not the full width of the
-screen have mode lines, but they are truncated. On terminals where
-Emacs does not support highlighting, truncated mode lines sometimes do
-not appear in inverse video.
+many columns to give the one on the left. If you are not using
+scrollbars, a line of vertical bars separates the two windows.
+Windows that are not the full width of the screen have mode lines, but
+they are truncated. On terminals where Emacs does not support
+highlighting, truncated mode lines sometimes do not appear in inverse
+video.
@kindex C-Mouse-2 @r{(scroll bar)}
You can split a window horizontally or vertically by clicking
@kbd{C-Mouse-2} in the mode line or the scroll bar. The line of
splitting goes through the place where you click: if you click on the
mode line, the new scroll bar goes above the spot; if you click in the
-scroll bar, the mode line of the split window is side by side with your
-click.
+scroll bar, the mode line of the split window is side by side with
+your click.
@vindex truncate-partial-width-windows
When a window is less than the full width, text lines too long to fit are
@xref{Display}.
@vindex split-window-keep-point
- If @code{split-window-keep-point} is non-@code{nil}, the default, both
-of the windows resulting from @kbd{C-x 2} inherit the value of point
-from the window that was split. This means that scrolling is
+ If @code{split-window-keep-point} is non-@code{nil}, the default,
+both of the windows resulting from @kbd{C-x 2} inherit the value of
+point from the window that was split. This means that scrolling is
inevitable. If this variable is @code{nil}, then @kbd{C-x 2} tries to
-avoid shifting any text the screen, by putting point in each window at a
-position already visible in the window. It also selects whichever
-window contain the screen line that the cursor was previously on. Some
-users prefer the latter mode on slow terminals.
+avoid scrolling the text currently visible on the screen, by putting
+point in each window at a position already visible in the window. It
+also selects whichever window contains the screen line that the cursor
+was previously on. Some users prefer the latter mode on slow
+terminals.
@node Other Window
@section Using Other Windows
@findex other-window
To select a different window, click with @kbd{Mouse-1} on its mode
line. With the keyboard, you can switch windows by typing @kbd{C-x o}
-(@code{other-window}). That is an @kbd{o}, for `other', not a zero.
+(@code{other-window}). That is an @kbd{o}, for ``other,'' not a zero.
When there are more than two windows, this command moves through all the
windows in a cyclic order, generally top to bottom and left to right.
After the rightmost and bottommost window, it goes back to the one at
buffers visible in two windows, by moving through them to the next
mismatch. @xref{Comparing Files}, for details.
+@vindex mouse-autoselect-window
+ If you set @code{mouse-autoselect-window} to a non-@code{nil} value,
+moving the mouse into a different window selects that window. This
+feature is off by default.
+
@node Pop Up Window
@section Displaying in Another Window
(@code{mouse-delete-other-windows}).
@item Mouse-3
@kbd{Mouse-3} in a window's mode line deletes that window
-(@code{mouse-delete-window}).
+(@code{mouse-delete-window}), unless the frame has only one window, in
+which case it buries the current buffer instead and switches to another
+buffer.
@end table
@kindex C-x 0
except for the echo area.
You can also delete a window by clicking on its mode line with
-@kbd{Mouse-2}, and delete all the windows in a frame except one window
-by clicking on that window's mode line with @kbd{Mouse-3}.
+@kbd{Mouse-3}, and delete all the windows in a frame except one window
+by clicking on that window's mode line with @kbd{Mouse-2}.
The easiest way to adjust window heights is with a mouse. If you
press @kbd{Mouse-1} on a mode line, you can drag that mode line up or
@cindex mode, Winner
@cindex undoing window configuration changes
@cindex window configuration changes, undoing
-@kbd{M-x winner-mode} provides a global minor mode that records the
-changes in the window configuration (i.e. how the frames are partitioned
-into windows) so that the changes can be `undone' using the command
-@kbd{M-x winner-undo}, bound to @kbd{C-x left} by default. If you
-change your mind (while undoing), you can use @kbd{M-x winner-redo}
-(@kbd{C-x right}). You can also turn on Winner mode by customizing
-@code{winner-mode}.
-
-@vindex scroll-all-mode
-@cindex scrolling windows together
-@cindex Scroll-all mode
-@cindex mode, Scroll-all
-@kbd{M-x scroll-all-mode} provides commands to scroll all visible
-windows together as in CRiSP/Brief emulation (@pxref{Emulation}). You
-can also turn it on by customizing @code{scroll-all-mode}. The commands
-provided are @kbd{M-x scroll-all-scroll-down-all}, @kbd{M-x
-scroll-all-page-down-all} and their `up' equivalents. You would
-probably want to bind these to appropriate keys.
+ @kbd{M-x winner-mode} is a global minor mode that records the
+changes in the window configuration (i.e. how the frames are
+partitioned into windows), so that you can ``undo'' them. To undo,
+use @kbd{C-c left} (@code{winner-undo}). If you change your mind
+while undoing, you can redo the changes you had undone using @kbd{C-c
+right} (@code{M-x winner-redo}). Another way to enable Winner mode is
+by customizing the variable @code{winner-mode}.
@cindex Windmove package
@cindex directional window selection
@findex windmove-right
@findex windmove-default-keybindings
-There are commands to move directionally between neighbouring windows in
+ The Windmove commands move directionally between neighboring windows in
a frame. @kbd{M-x windmove-right} selects the window immediately to the
-right of the currently-selected one and similarly for the `left', `up'
-and `down' counterparts. @kbd{M-x windmove-default-keybindings} binds
-these commands to @kbd{S-right} etc. (These bindings will only work if
-your terminal supports shifted arrow keys.)
-
-@cindex Follow mode
-@cindex mode, Follow
-@findex follow-mode
-@cindex windows, synchronizing
-@cindex synchronizing windows
-Follow minor mode (@kbd{M-x follow-mode}) synchronizes several windows
-on the same buffer so that they always display adjacent sections of that
-buffer. Also if point moves outside a window, another window displaying
-that point is selected if possible, so that you can move between windows
-with normal movement commands. You can use this facility, for instance,
-to operate effectively with double the number of lines of a file visible
-in a given screen height using side-by-side windows on the same buffer:
-split the window with @kbd{C-x 3} and then use @kbd{M-x follow-mode} to
-synchronize the windows.
+right of the currently selected one, and similarly for the ``left,'' ``up,''
+and ``down'' counterparts. @kbd{M-x windmove-default-keybindings} binds
+these commands to @kbd{S-right} etc. (Not all terminals support shifted
+arrow keys, however.)
+
+ Follow minor mode (@kbd{M-x follow-mode}) synchronizes several
+windows on the same buffer so that they always display adjacent
+sections of that buffer. @xref{Follow Mode}.
+
+@vindex scroll-all-mode
+@cindex scrolling windows together
+@cindex Scroll-all mode
+@cindex mode, Scroll-all
+ @kbd{M-x scroll-all-mode} provides commands to scroll all visible
+windows together. You can also turn it on by customizing the variable
+@code{scroll-all-mode}. The commands provided are @kbd{M-x
+scroll-all-scroll-down-all}, @kbd{M-x scroll-all-page-down-all} and
+their corresponding ``up'' equivalents. To make this mode useful,
+you should bind these commands to appropriate keys.
+
+@ignore
+ arch-tag: 8bea7453-d4b1-49b1-9bf4-cfe4383e1113
+@end ignore