[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master fa1f411 1/2: Edit the display-buffer doc string slightly
From: |
Lars Ingebrigtsen |
Subject: |
master fa1f411 1/2: Edit the display-buffer doc string slightly |
Date: |
Thu, 7 Jan 2021 10:01:08 -0500 (EST) |
branch: master
commit fa1f41159ff10f5ae4adc51e28e051f8acd27181
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>
Edit the display-buffer doc string slightly
* lisp/window.el (display-buffer): Reword the start of the doc
string (bug#45688).
---
lisp/window.el | 48 +++++++++++++++++++++++++++++++-----------------
1 file changed, 31 insertions(+), 17 deletions(-)
diff --git a/lisp/window.el b/lisp/window.el
index cd13e66..9d16e29 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -7378,6 +7378,35 @@ 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:
+
+ `display-buffer-same-window' -- Use the selected window.
+ `display-buffer-reuse-window' -- Use a window already showing
+ the buffer.
+ `display-buffer-in-previous-window' -- Use a window that did
+ show the buffer before.
+ `display-buffer-use-some-window' -- Use some existing window.
+ `display-buffer-pop-up-window' -- Pop up a new window.
+ `display-buffer-below-selected' -- Use or pop up a window below
+ the selected one.
+ `display-buffer-at-bottom' -- Use or pop up a window at the
+ bottom of the selected frame.
+ `display-buffer-pop-up-frame' -- Show the buffer on a new frame.
+ `display-buffer-in-child-frame' -- Show the buffer in a
+ child frame.
+ `display-buffer-no-window' -- Do not display the buffer and
+ have `display-buffer' return nil immediately.
+
+For instance:
+
+ (setq display-buffer-below-selected '(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
+possibilities, and also see `(emacs)Window Choice' for more
+information.
+
BUFFER-OR-NAME must be a buffer or a string naming a live buffer.
Return the window chosen for displaying that buffer, or nil if no
such window is found.
@@ -7403,23 +7432,8 @@ function in the combined function list in turn, passing
the
buffer as the first argument and the combined action alist as the
second argument, until one of the functions returns non-nil.
-Action functions and the action they try to perform are:
- `display-buffer-same-window' -- Use the selected window.
- `display-buffer-reuse-window' -- Use a window already showing
- the buffer.
- `display-buffer-in-previous-window' -- Use a window that did
- show the buffer before.
- `display-buffer-use-some-window' -- Use some existing window.
- `display-buffer-pop-up-window' -- Pop up a new window.
- `display-buffer-below-selected' -- Use or pop up a window below
- the selected one.
- `display-buffer-at-bottom' -- Use or pop up a window at the
- bottom of the selected frame.
- `display-buffer-pop-up-frame' -- Show the buffer on a new frame.
- `display-buffer-in-child-frame' -- Show the buffer in a
- child frame.
- `display-buffer-no-window' -- Do not display the buffer and
- have `display-buffer' return nil immediately.
+See above for the action functions and the action they try to
+perform.
Action alist entries are:
`inhibit-same-window' -- A non-nil value prevents the same