bug#37840: Missing in the Emacs manuals:

[Juri Linkov]

>> Then maybe switch-to-buffer-obey-display-actions should be replaced
>> by another variable switch-to-buffer-display-function that could be
>> customized to possible options #'pop-to-buffer-same-window,
>> #'pop-to-buffer or any other custom function (and nil by default).
>
> We can do whatever we think best as long as Emacs 27 is not out yet.
>
> If we leave things as they are we should probably mention explicitly
> that 'display-buffer-base-action' gets overridden when this option is
> set.  We should also say how 'switch-to-buffer-preserve-window-point'
> is or is not respected in that case (I'm slightly confused about how
> it works now).
>
> Otherwise, I see no need for renaming the option.  We could simply
> allow its value to be an ordinary display action with functions and an
> alist and have 'switch-to-buffer' act accordingly.  Or am I missing
> something?

I agree.  Adding support for display actions with functions to the
existing variable seems the best solution that would cover more use cases.