mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-05 22:20:24 -08:00
Code Issues Projects Releases Wiki Activity

(display-buffer-overriding-action): Try and discourage abuse

Browse source 
* lisp/window.el (display-buffer-overriding-action): Document
the intended use in the deluded hope to reduce the current abuse.
This commit is contained in:
Stefan Monnier 2025-11-26 12:19:25 -05:00
parent 4b4b48d019
commit 43bcf3c43b
1 changed files with 7 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

9
lisp/window.el
View file

@ -8026,9 +8026,14 @@ See `display-buffer' for details.
This variable is not intended for user customization. Lisp This variable is not intended for user customization. Lisp
programs should never set this variable permanently but may bind programs should never set this variable permanently but may bind
it around calls of buffer display functions like `display-buffer' it around calls of buffer display functions like `display-buffer'
or `pop-to-buffer'. Since such a binding will affect any nested or `pop-to-buffer'.
Since such a binding will affect unconditionally any nested
buffer display requests, this variable should be used with utmost buffer display requests, this variable should be used with utmost
care.") care, typically in response to an explicit request by the user.
Also, any code that sets this variable needs to interact nicely with
other code that sets this variable.
See `other-frame-prefix' for an example of use.")
(put 'display-buffer-overriding-action 'risky-local-variable t) (put 'display-buffer-overriding-action 'risky-local-variable t)
(defcustom display-buffer-alist nil (defcustom display-buffer-alist nil