From 38be9dbb6f9b1204cd0d36ad032fc8e7a7524ef1 Mon Sep 17 00:00:00 2001 From: David Ponce Date: Fri, 22 Oct 2004 11:20:12 +0000 Subject: [PATCH] (Resizing Windows): Document the `preserve-before' argument of the functions `enlarge-window' and `shrink-window'. --- lispref/ChangeLog | 5 +++++ lispref/windows.texi | 9 +++++++-- 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 + + * windows.texi (Resizing Windows): Document the `preserve-before' + argument of the functions `enlarge-window' and `shrink-window'. + 2004-10-19 Jason Rumney * 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 -- 2.39.5