[Emacs-diffs] emacs-26 5ca093d: Fix doc of 'display-buffer-in-previous-window' (Bug#36161)

[Martin Rudalics]

branch: emacs-26
commit 5ca093d2814fe5574c720338fc64cba44357f9b3
Author: Martin Rudalics <address@hidden>
Commit: Martin Rudalics <address@hidden>

    Fix doc of 'display-buffer-in-previous-window' (Bug#36161)
    
    * 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).
---
 doc/lispref/windows.texi | 3 +++
 lisp/window.el           | 7 +++++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index b2dd3d9..3116659 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2597,6 +2597,9 @@ If @var{alist} has a @code{previous-window} entry and the 
window
 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
diff --git a/lisp/window.el b/lisp/window.el
index 58e22a2..c2d5b02 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -7473,8 +7473,11 @@ selected frame if `display-buffer-reuse-frames' and
 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)))