Next: Displaying non-editable buffers., Up: Displaying a Buffer in a Window [Contents][Index]
22.6.1 Howdisplay-buffer
works
The display-buffer
command (as well as commands that call it internally) chooses a window to display by following the steps given below. See Choosing a Window for Displaying a Buffer in The Emacs Lisp Reference Manual, for details about how to alter this sequence of steps.
display-buffer-same-window
action function (see Action Functions for Buffer Display in The Emacs Lisp Reference Manual) to the option display-buffer-alist
(see Choosing a Window for Displaying a Buffer in The Emacs Lisp Reference Manual). For example, to display the buffer *scratch* preferably in the selected window write:
(setopt display-buffer-alist '(("\\*scratch\\*" (display-buffer-same-window))))
By default, display-buffer-alist
is nil
.
reusable-frames
action alist entry (see Action Alists for Buffer Display in The Emacs Lisp Reference Manual). See the next step for an example of how to do that.display-buffer-base-action
(see Choosing a Window for Displaying a Buffer in The Emacs Lisp Reference Manual) as follows:
(setopt display-buffer-base-action '((display-buffer-reuse-window display-buffer-pop-up-frame) (reusable-frames . 0)))
This customization will also try to make the preceding step search for a reusable window on all visible or iconified frames.
The split can be either vertical or horizontal, depending on the variables split-height-threshold
and split-width-threshold
. These variables should have integer values. If split-height-threshold
is smaller than the chosen window’s height, the split puts the new window below. Otherwise, if split-width-threshold
is smaller than the window’s width, the split puts the new window on the right. If neither condition holds, Emacs tries to split so that the new window is below—but only if the window was not split before (to avoid excessive splitting).
reusable-frames
action alist entry (see above) the window may be also on another frame.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4