aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorConstantine Vetoshev <gepardcv@gmail.com>2021-07-09 17:10:58 -0700
committerConstantine Vetoshev <gepardcv@gmail.com>2021-07-09 17:10:58 -0700
commitb55aec612db791a1720232df0e2df0d3597d850b (patch)
treea10a5a0c3434aacb6e4b20113f6bb896dc383b88
parent5ad026545b47f85eec53b680b4803497b03f2a1e (diff)
Update window splitting hint to use display-buffer-base-action.
-rw-r--r--README.md14
1 files changed, 9 insertions, 5 deletions
diff --git a/README.md b/README.md
index 898c979..767621a 100644
--- a/README.md
+++ b/README.md
@@ -362,14 +362,18 @@ carefully preserving window layouts if Emacs just throws them away on a `M-x
compile`? The answer is to fix the broken defaults. This is fairly easy:
```emacs-lisp
-(setq display-buffer-alist
- '((".*"
- (display-buffer-reuse-window display-buffer-same-window)
- (reusable-frames . t))))
+(customize-set-variable 'display-buffer-base-action
+ '((display-buffer-reuse-window display-buffer-same-window)
+ (reusable-frames . t)))
-(setq even-window-sizes nil) ; display-buffer hint: avoid resizing
+(customize-set-variable 'even-window-sizes nil) ; avoid resizing
```
+(An earlier version of this hint modified `display-buffer-alist` instead of
+`display-buffer-base-action`. This was [too
+aggressive](https://debbugs.gnu.org/cgi/bugreport.cgi?bug=49069#25) and can
+impact packages which may legitimately want to split windows.)
+
The Emacs framework responsible for "pop-up" windows is `display-buffer`. The
relevant [section of the Emacs
manual](https://www.gnu.org/software/emacs/manual/html_node/elisp/Displaying-Buffers.html#Displaying-Buffers)