; 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).

(cherry picked from commit 5339c6f69eef7aaccd0570a3b70fdf0066b678bc)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 595ac0c2fae863d8ddc4f463e0c50d128c5b8a20..adc294e4c992d4baf308d6e8d940e1addf61f591 100644 (file)
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2736,10 +2736,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)))