]> git.eshelyaron.com Git - emacs.git/commitdiff
Fix doc of 'display-buffer-in-previous-window' (Bug#36161)
authorMartin Rudalics <rudalics@gmx.at>
Tue, 11 Jun 2019 07:28:29 +0000 (09:28 +0200)
committerMartin Rudalics <rudalics@gmx.at>
Tue, 11 Jun 2019 07:28:29 +0000 (09:28 +0200)
* 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
lisp/window.el

index b2dd3d99583221cc4ced7619774fed918f7644fb..3116659cd0384f8191e6a21694264e774afb36f3 100644 (file)
@@ -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
index 58e22a2306af4ace79279ec30bd5637dfc9916ab..c2d5b02be059d153aa6c82acced3e868f2adff9f 100644 (file)
@@ -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)))