> The doc string for select-window does not discuss the sometime need to also
> set input focus to the selected window's frame when one wants future input
> events to go there. I would suggest adding this along with a reference to
> select-frame-set-input-focus.
`select-window' is a function with immediate effect so we can give it a
self-contained doc-string and description.
`select-frame-set-input-focus' OTOH lumps together three things: It
selects a frame and thus implicitly its selected window and tells the
window manager to raise that frame and to give it input focus. The
latter two do not have immediate effect, they induce a delay and require
a cooperating window manager. (Raising the frame is a bad idea IMHO but
admittedly a compromise to accommodate the standard behavior of most
existing window managers.)
So the reference you suggest would have to be accompanied by an
explanation of delays and a reference to the window manager.