bug#45072: 28.0.50; Emacs switches other buffer back uncontrollably, if other window's buffer is changed by user during minibuffer editing

[Stefan Monnier]

>> But 'minibuffer-hide-completions' uses 'bury-buffer' which would delete
>> the completions window unconditionally even when it was only reused for
>> showing completions.  IMO 'bury-buffer' is practically always the wrong
>> choice for Lisp functions to call.
>
> Maybe 'quit-window' is better?

Part of the problem is one of documentation: it's hard to know which one
to call just by reading the docstrings.

Also the above quoted text sounds counter intuitive: "bury buffer"
sounds like it's mostly focused on hiding the *buffer*, potentially
hiding the window along the way if necessary, whereas "quit window"
sounds like it's mostly going to eliminate the *window*.

Of course, there's also the fact that `quit-window` is fairly new
(introduced in Emacs-24), whereas `bury-buffer` has been with us forever.


        Stefan