(Windows): Rewrite description of

fit-window-to-buffer.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 55cf4851b98bf0719937c106dc9d485a66d269bc..9b1b646f7f7a100dc8086fe659f9602ac00e0a11 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2008-12-19  Martin Rudalics  <rudalics@gmx.at>
+
+       * windows.texi (Windows): Rewrite description of
+       fit-window-to-buffer.
+
 2008-12-13  Glenn Morris  <rgm@gnu.org>
 
        * modes.texi (Font Lock Basics): Fix level description.  (Bug#1534)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index dc49c40db5c9856b069691b8e984116c3853e4b6..8dd874f09b28e7b52cdb7c5d0def988b8aff4198 100644 (file)
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2167,14 +2167,18 @@ function returns @code{nil}.
 
 @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