I'm curious, then, why would what I've done in Test 2 nor corral it?

(add-to-list 'display-buffer-alist '("\\*CAPTURE*" (display-buffer-same-window)))

On Sun, Sep 22, 2024 at 12:00 PM Ihor Radchenko <yantar92@posteo.net> wrote:
Amol Vaidya <amolvaidya06@gmail.com> writes:

> Thank you for your clarification. Just a minor point: my concern is that
> org-capture is not adhering to general display-buffer settings rather than
> specifically display-buffer-alist. In my case display-buffer-alist is nil
> when I run emacs -q, but according to section 29.13.1 of the Elisp manual,
> if display-buffer-alist is nil, then display-buffer should consult the
> display-buffer-base-action user option to decide where to display a buffer.

I see.
I think that you misunderstood what `display-buffer-base-action' is for.
It is only used when the Emacs package that is displaying the buffer
does not specify how to display it (in other words, calling
`display-buffer' without specifying ACTION argument)

That's not what Org capture do. Org capture does tell Emacs how to
display the buffer. Only when the user explicitly overrides Org capture
display settings (via `display-buffer-alist' or
`display-buffer-overriding-action'), the default behavior is changed.

If you look into the docstring of `display-buffer', you will see that
there are a number of user settings with different priorities:

    display-buffer builds a list of action functions and an action
    alist by combining any action functions and alists specified by
    display-buffer-overriding-action, display-buffer-alist, the
    ACTION argument, display-buffer-base-action, and
    display-buffer-fallback-action (in order).  Then it calls each
    function in the combined function list in turn, passing the
    buffer as the first argument and the combined action alist as the
    second argument, until one of the functions returns non-nil.

There is no bug in Org capture that we provide ACTION argument to hint
Emacs using what we believe is a better default compared to generic
buffer popups.

For you, as a user, the right way to configure how Org capture window is
displayed is customizing `display-buffer-alist'.

--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>