@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001,
-@c 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
+@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@setfilename ../../info/windows
@node Windows, Frames, Buffers, Top
for the described features.
@deffn Command switch-to-buffer-other-window buffer-or-name &optional norecord
-This function makes @var{buffer-or-name} the current buffer, displays it
-in a window not currently selected, and selects that window. The
-handling of the buffer is the same as in @code{switch-to-buffer}.
+This function makes the buffer specified by @var{buffer-or-name} current
+and displays it in a window not currently selected. It then selects
+that window. The handling of the buffer is the same as in
+@code{switch-to-buffer}.
The currently selected window is absolutely never used to do the job.
If it is the only window, then it is split to make a distinct window for
@defopt pop-up-windows
This variable specifies whether @code{display-buffer} is allowed to
split (@pxref{Splitting Windows}) an existing window . If it is
-non-@code{nil}, @code{display-buffer} tries to the split the largest or
-least recently used window on the selected frame. (If the selected
-frame is a minibuffer-only frame, it tries to split a window on another
-frame instead.) If @code{pop-up-windows} is nil or the variable
-@code{pop-up-frames} (see below) is non-@code{nil},
+non-@code{nil}, @code{display-buffer} tries to the split the largest
+or least recently used window on the selected frame. (If the selected
+frame is a minibuffer-only frame, it tries to split a window on
+another frame instead.) If @code{pop-up-windows} is @code{nil} or the
+variable @code{pop-up-frames} (see below) is non-@code{nil},
@code{display-buffer} does not split any window.
@end defopt
@end defopt
@defopt pop-up-frame-alist
-This variable holds an alist specifying frame parameters used when
-@code{display-buffer} makes a new frame. @xref{Frame Parameters}, for
-more information about frame parameters.
+This variable holds an alist specifying frame parameters used by the
+default value of @code{pop-up-frame-function} for making new frames.
+@xref{Frame Parameters}, for more information about frame parameters.
@end defopt
@defopt special-display-buffer-names
@end itemize
@cindex cursor
-As far as the user is concerned, point is where the cursor is, and
+ As far as the user is concerned, point is where the cursor is, and
when the user switches to another buffer, the cursor jumps to the
position of point in that buffer.
@cindex vertical fractional scrolling
@cindex vertical scroll position
-@dfn{Vertical fractional scrolling} means shifting text in a window up
-or down by a specified multiple or fraction of a line. Each window has
-a @dfn{vertical scroll position}, which is a number, never less than
+ @dfn{Vertical fractional scrolling} means shifting text in a window
+up or down by a specified multiple or fraction of a line. Each window
+has a @dfn{vertical scroll position}, which is a number, never less than
zero. It specifies how far to raise the contents of the window.
Raising the window contents generally makes all or part of some lines
disappear off the top, and all or part of some other lines appear at the
bottom. The usual value is zero.
-The vertical scroll position is measured in units of the normal line
+ The vertical scroll position is measured in units of the normal line
height, which is the height of the default font. Thus, if the value is
.5, that means the window contents are scrolled up half the normal line
height. If it is 3.3, that means the window contents are scrolled up
somewhat over three times the normal line height.
-What fraction of a line the vertical scrolling covers, or how many
+ What fraction of a line the vertical scrolling covers, or how many
lines, depends on what the lines contain. A value of .5 could scroll a
line whose height is very short off the screen, while a value of 3.3
could scroll just part of the way through a tall line or an image.
@end example
@end defun
-Here is how you can determine whether a given position @var{position} is
-off the screen due to horizontal scrolling:
+ Here is how you can determine whether a given position @var{position}
+is off the screen due to horizontal scrolling:
@example
@group
@cindex changing window size
@cindex window size, changing
-The window size functions fall into two classes: high-level commands
+ The window size functions fall into two classes: high-level commands
that change the size of windows and low-level functions that access
window size. Emacs does not permit overlapping windows or gaps between
windows, so resizing a window always affects at least one other window.
@defun fit-window-to-buffer &optional window max-height min-height
This function makes @var{window} the right height to display its
-contents exactly. The default for @var{window} is the selected
-window.
-
-The argument @var{max-height} specifies the maximum height the window
-is allowed to be; @code{nil} means use the frame height. The argument
-@var{min-height} specifies the minimum height for the window;
-@code{nil} means use @code{window-min-height}. All these height
-values include the mode line and/or header line.
+contents exactly. The default for @var{window} is the selected window.
+
+The optional argument @var{max-height} specifies the maximum height the
+window is allowed to be; @code{nil} means use the maximum permissible
+height of a window on @var{window}'s frame. The optional argument
+@var{min-height} specifies the minimum height for the window; @code{nil}
+means use @code{window-min-height}. All these height values include the
+mode line and/or header line.
+
+This function can delete windows when their height shrinks below
+@var{min-height}. It returns non-@code{nil} if it orderly resized
+@var{window}, and @code{nil} otherwise.
@end defun
@deffn Command shrink-window-if-larger-than-buffer &optional window