* doc/lispref/windows.texi (Buffer Display Action Functions):
* lisp/window.el (display-buffer-in-previous-window): Tell
that 'display-buffer-in-previous-window' prefers
non-selected windows (Bug#36161).
specified by that entry is live and not dedicated to another buffer,
that window will be preferred, even if it never showed @var{buffer}
before.
+
+This function will not choose the selected window if it finds another
+eligible window that has shown @var{buffer} previously.
@end defun
@defun display-buffer-use-some-window buffer alist
terminal if either of those variables is non-nil.
If ALIST has a `previous-window' entry, the window specified by
-that entry will override any other window found by the methods
-above, even if that window never showed BUFFER before."
+that entry may override any other window found by the methods
+above, even if that window never showed BUFFER before.
+
+Avoid using the selected window if another eligible window has
+shown BUFFER before."
(let* ((alist-entry (assq 'reusable-frames alist))
(inhibit-same-window
(cdr (assq 'inhibit-same-window alist)))