Re: New package `outline-occur'
Karthik Chikmagalur <[email protected]> Wed, 05 Aug 2026 12:40:49 -0700
| Newsgroups | gmane.emacs.devel |
|---|---|
| Message-ID | <[email protected]> |
> So, with this patch, the list of action functions built by
> `display-buffer' would look as follows (by order of precedence):
>
> - `display-buffer-overriding-action' [ set by programs WITH UTMOST CARE ]
> - `display-buffer-alist' [ set by users ]
> - `special-action' [ depends on the `special-display-function' variable
> and the return value of `special-display-p' for the
> BUFFER-OR-NAME argument passed to `display-buffer' ]
> - `display-buffer-bound-alist' [ introduced by this patch and let-bound ]
> - ACTION argument passed to `display-buffer'
> - extra-action [ depends on the FRAME argument passed to
> `display-buffer' ]
> - `display-buffer-base-action' [ set by users ]
> - `display-buffer-fallback-action' [ it should never be set by programs
> or users ]
>
In the Elisp manual in Emacs 30.2 (info "(elisp) Choosing Window"), this
list reads
• The variable ‘display-buffer-overriding-action’.
• The user option ‘display-buffer-alist’.
• The ACTION argument.
• The user option ‘display-buffer-base-action’.
• The constant ‘display-buffer-fallback-action’.
It doesn't look like the manual was updated in
https://cgit.git.savannah.gnu.org/cgit/emacs.git/commit/?id=8a88f3ed5aeece4a7c8edbebc83ed52479fbbfab
It should be udpated to
• The variable ‘display-buffer-overriding-action’.
• The user option ‘display-buffer-alist’.
• The variable ‘display-buffer-default-alist’, intended to be let-bound
by applications.
• The ACTION argument.
• The user option ‘display-buffer-base-action’.
• The constant ‘display-buffer-fallback-action’.
It might be worth mentioning special-action and extra-action in this list too?
Karthik