summaryrefslogtreecommitdiff
path: root/lispref/windows.texi
diff options
context:
space:
mode:
authorDavid Ponce <david@dponce.com>2004-10-22 11:20:12 +0000
committerDavid Ponce <david@dponce.com>2004-10-22 11:20:12 +0000
commit38be9dbb6f9b1204cd0d36ad032fc8e7a7524ef1 (patch)
tree42123f05abcc28d181cc500cc40930c63d1bee76 /lispref/windows.texi
parentd5ddd795bdab373fe62ccfd099c270fd97da0964 (diff)
downloademacs-38be9dbb6f9b1204cd0d36ad032fc8e7a7524ef1.tar.gz
(Resizing Windows): Document the `preserve-before' argument of the
functions `enlarge-window' and `shrink-window'.
Diffstat (limited to 'lispref/windows.texi')
-rw-r--r--lispref/windows.texi9
1 files changed, 7 insertions, 2 deletions
diff --git a/lispref/windows.texi b/lispref/windows.texi
index 0fdc6734181..0bf3a9ed211 100644
--- a/lispref/windows.texi
+++ b/lispref/windows.texi
@@ -1922,7 +1922,7 @@ 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 one window affects other windows.
-@deffn Command enlarge-window size &optional horizontal
+@deffn Command enlarge-window size &optional horizontal preserve-before
This function makes the selected window @var{size} lines taller,
stealing lines from neighboring windows. It takes the lines from one
window at a time until that window is used up, then takes from another.
@@ -1945,6 +1945,11 @@ other windows are ``robbed.'' If it would be necessary to alter the
size of a fixed-size window, @code{enlarge-window} gets an error
instead.
+If @var{preserve-before} is non-@code{nil}, this function does not
+change the size of the siblings above or to the left of the selected
+window. Only the size of the siblings below or to the right of the
+selected window are changed.
+
If @var{size} is negative, this function shrinks the window by
@minus{}@var{size} lines or columns. If that makes the window smaller
than the minimum size (@code{window-min-height} and
@@ -1965,7 +1970,7 @@ It could be defined as follows:
@end example
@end deffn
-@deffn Command shrink-window size &optional horizontal
+@deffn Command shrink-window size &optional horizontal preserve-before
This function is like @code{enlarge-window} but negates the argument
@var{size}, making the selected window smaller by giving lines (or
columns) to the other windows. If the window shrinks below