; 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 c7e575b0e4f8fb64edbfee14df3ba0de96120b53..0c6367da057176949d52a2ee3de30a145d322a97 100644 (file)
--- 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)))