(Resizing Windows): Document the `preserve-before' argument of the

functions `enlarge-window' and `shrink-window'.

2 files changed, 12 insertions, 2 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 6c9d83edb17..8f5544fb0fe 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2004-10-22  David Ponce  <david@dponce.com>
+
+        * windows.texi (Resizing Windows): Document the `preserve-before'
+        argument of the functions `enlarge-window' and `shrink-window'.
+
 2004-10-19  Jason Rumney  <jasonr@gnu.org>
 
         * makefile.w32-in (elisp): Change order of arguments to makeinfo.
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