From 6bb55a25fa77ce0f92401aa9945a506e9343aad5 Mon Sep 17 00:00:00 2001 From: Martin Rudalics Date: Sat, 13 Aug 2016 09:59:14 +0200 Subject: Fix docs on `display-buffer-below-selected' (Bug#24213) * lisp/window.el (display-buffer-below-selected): Fix doc-string (Bug#24213). * doc/lispref/windows.texi (Display Action Functions): Fix documentation of `display-buffer-below-selected'. --- doc/lispref/windows.texi | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi index ad0c3237e6..7a5d1bbf16 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi @@ -2524,10 +2524,17 @@ parameter; @pxref{Buffer Parameters}). @defun display-buffer-below-selected buffer alist This function tries to display @var{buffer} in a window below the -selected window. This means to either split the selected window or use -the window below the selected one. If it does create a new window, it -will also adjust its size provided @var{alist} contains a suitable +selected window. If there is a window below the selected one and that +window already displays @var{buffer}, it reuses that window. + +If there is no such window, this function tries to create a new window +by splitting the selected one and display @var{buffer} there. It will +also adjust that window's size provided @var{alist} contains a suitable @code{window-height} or @code{window-width} entry, see above. + +If splitting the selected window fails and there is a non-dedicated +window below the selected one showing some other buffer, it uses that +window for showing @var{buffer}. @end defun @defun display-buffer-in-previous-window buffer alist -- cgit v1.2.3