From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Thu, 7 Jan 2021 15:47:26 +0000 (+0100)
Subject: Further display-buffer doc changes
X-Git-Tag: emacs-28.0.90~4349
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3dc3874c768060e720aecc1c4ac0e87eea44d073;p=emacs.git

Further display-buffer doc changes

* lisp/window.el (display-buffer): `display-buffer-alist' is
apparently the variable the user should be directed towards.
---

diff --git a/lisp/window.el b/lisp/window.el
index 37e1800ad11..38be7789062 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -7379,8 +7379,8 @@ fails, call `display-buffer-pop-up-frame'.")
 
 (defun display-buffer (buffer-or-name &optional action frame)
   "Display BUFFER-OR-NAME in some window, without selecting it.
-To change which window is used, set `display-buffer-base-action'
-to a list containing one of these \"action\" functions:
+To change which window is used, set `display-buffer-alist'
+to an expression containing one of these \"action\" functions:
 
  `display-buffer-same-window' -- Use the selected window.
  `display-buffer-reuse-window' -- Use a window already showing
@@ -7403,7 +7403,7 @@ to a list containing one of these \"action\" functions:
 
 For instance:
 
-   (setq display-buffer-base-action '(display-buffer-at-bottom))
+   (setq display-buffer-alist '((\".*\" display-buffer-at-bottom)))
 
 Buffer display can be further customized to a very high degree;
 the rest of this docstring explains some of the many