diff options
| author | Martin Rudalics <rudalics@gmx.at> | 2016-08-13 09:59:14 +0200 |
|---|---|---|
| committer | Martin Rudalics <rudalics@gmx.at> | 2016-08-13 09:59:14 +0200 |
| commit | 6bb55a25fa77ce0f92401aa9945a506e9343aad5 (patch) | |
| tree | 2e4f15e6575c626c10674649b3370b7f367df3b6 /doc | |
| parent | 50548fd9afe70c43b3a0c0869f8e889b307ee917 (diff) | |
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'.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/lispref/windows.texi | 13 |
1 files changed, 10 insertions, 3 deletions
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 |