# HG changeset patch # User Eli Zaretskii # Date 1224347597 0 # Node ID 4a504448eb9c5daa7fc2417a0bf0d6cd2850623c # Parent 6bec458afb554f7ddb256c3558992ee1cc2ddc44 (Choosing Window): Fix last change. diff -r 6bec458afb55 -r 4a504448eb9c doc/lispref/windows.texi --- a/doc/lispref/windows.texi Sat Oct 18 15:51:35 2008 +0000 +++ b/doc/lispref/windows.texi Sat Oct 18 16:33:17 2008 +0000 @@ -951,15 +951,19 @@ the variables described below. @end deffn -@defun split-window-preferred-function window +@defvar split-window-preferred-function This variable specifies how to split a window. Its value, if non-@code{nil}, should be a function of one argument, which is a window. If this variable specifies a function, @code{display-buffer} will call it with one or more candidate windows when it looks for a -window to split. If the argument @var{window} fits, the function is +window to split. If the argument window fits, the function is expected to split it and return a new window. If the function returns -@code{nil}, then @var{window} will not be split. -@end defun +@code{nil}, then this window will not be split. + +If the value of this variable is @code{nil}, @code{display-buffer} +uses the other variables described below to decide whether and which +window to split. +@end defvar @defopt display-buffer-reuse-frames If this variable is non-@code{nil}, @code{display-buffer} searches