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