changeset 57641:41d89cffddca

(Resizing Windows): Document the `preserve-before' argument of the functions `enlarge-window' and `shrink-window'.
author David Ponce <david@dponce.com>
date Fri, 22 Oct 2004 11:19:51 +0000
parents c660fc46d193
children 1cffc97af4c6
files lispref/windows.texi
diffstat 1 files changed, 7 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/windows.texi	Thu Oct 21 23:10:28 2004 +0000
+++ b/lispref/windows.texi	Fri Oct 22 11:19:51 2004 +0000
@@ -1922,7 +1922,7 @@
 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 @@
 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 @@
 @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