From: Juri Linkov <juri@linkov.net>
Date: Sat, 23 Nov 2024 18:27:39 +0000 (+0200)
Subject: ; Improve example of display-buffer-alist category in ELisp Reference
X-Git-Tag: archive/raspbian/1%30.1+1-3+rpi1^2~2^2~20^2~250
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=5339c6f69eef7aaccd0570a3b70fdf0066b678bc;p=emacs.git

; Improve example of display-buffer-alist category in ELisp Reference

* doc/lispref/windows.texi (Choosing Window): Use 'add-to-list'
and add an example how to override display-buffer-alist entries
such as 'inhibit-same-window' by matching the window
using the 'category' condition (bug#74457).
---

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index c7e575b0e4f..0c6367da057 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2646,10 +2646,10 @@ for example:
 
 @example
 @group
-(setopt
- display-buffer-alist
- (cons '((category . comint) (display-buffer-same-window))
-        display-buffer-alist))
+(add-to-list 'display-buffer-alist
+             '((category . comint)
+               (display-buffer-same-window)
+               (inhibit-same-window . nil)))
 
 (display-buffer (get-buffer-create "*my-shell*")
                 '(nil (category . comint)))