diff options
| author | Philip Kaludercic <philipk@posteo.net> | 2022-04-15 21:12:56 +0200 |
|---|---|---|
| committer | Philip Kaludercic <philipk@posteo.net> | 2022-04-15 21:12:56 +0200 |
| commit | c3ab8f188ef801ba2a8227a0732a75adeea315ab (patch) | |
| tree | d63858b1b4294b80f63cc379ba92f4f0f0c38edc /lisp/window.el | |
| parent | fdd8b5913baa3a8f7cbb8b51ad6d092a41c04a90 (diff) | |
| download | emacs-c3ab8f188ef801ba2a8227a0732a75adeea315ab.tar.gz emacs-c3ab8f188ef801ba2a8227a0732a75adeea315ab.tar.bz2 emacs-c3ab8f188ef801ba2a8227a0732a75adeea315ab.zip | |
Improve buffer-match-p documentation
* doc/lispref/windows.texi (Choosing Window): Document that
buffer-match-p is used by display-buffer-alist.
* etc/NEWS: Mention buffer-match-p and match-buffers.
* lisp/window.el (display-buffer-alist): Update documentation as for
display-buffer-assq-regexp.
(display-buffer-assq-regexp): Rename buffer-name to buffer-or-name.
(display-buffer): Pass the buffer directly to
display-buffer-assq-regexp,.
Diffstat (limited to 'lisp/window.el')
| -rw-r--r-- | lisp/window.el | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/lisp/window.el b/lisp/window.el index 2da2f8bb2c8..ea909955414 100644 --- a/lisp/window.el +++ b/lisp/window.el @@ -7440,9 +7440,9 @@ Its value takes effect before processing the ACTION argument of If non-nil, this is an alist of elements (CONDITION . ACTION), where: - CONDITION is either a regexp matching buffer names, or a - function that takes two arguments - a buffer name and the - ACTION argument of `display-buffer' - and returns a boolean. + CONDITION is passed to `buffer-match-p', along with the buffer + that is to be displayed and the ACTION argument of + `display-buffer', to check if ACTION should be used. ACTION is a cons cell (FUNCTIONS . ALIST), where FUNCTIONS is an action function or a list of action functions and ALIST is an @@ -7495,14 +7495,14 @@ all fail. It should never be set by programs or users. See `display-buffer'.") (put 'display-buffer-fallback-action 'risky-local-variable t) -(defun display-buffer-assq-regexp (buffer-name alist action) +(defun display-buffer-assq-regexp (buffer-or-name alist action) "Retrieve ALIST entry corresponding to BUFFER-NAME. -This returns the cdr of the alist entry ALIST if either its key -satisfied a BUFFER-NAME per `buffer-match'. ACTION should have -the form of the action argument passed to `display-buffer'." +This returns the cdr of the alist entry ALIST if key and +buffer-or-name satisfy `buffer-match-p'. ACTION should have the +form of the action argument passed to `display-buffer'." (catch 'match (dolist (entry alist) - (when (buffer-match-p (car entry) buffer-name action) + (when (buffer-match-p (car entry) buffer-or-name action) (throw 'match (cdr entry)))))) (defvar display-buffer--same-window-action @@ -7672,7 +7672,7 @@ specified by the ACTION argument." ;; Otherwise, use the defined actions. (let* ((user-action (display-buffer-assq-regexp - (buffer-name buffer) display-buffer-alist action)) + buffer display-buffer-alist action)) (special-action (display-buffer--special-action buffer)) ;; Extra actions from the arguments to this function: (extra-action |