Re: Suggestion: Add discussion of input focus handling to select-window; add select-frame-window

[martin rudalics <rudalics@gmx.at>]

 > 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.  Such
explanation would make the doc-string quite complex (and we're not even
talking about redirected frame focus yet).

So I think that people who need information about how to raise a frame
or giving it input focus should look into the Elisp manual.

 > Even better might be to add select-frame-window which would combine
 > select-window and select-frame-set-input-focus for those times where you
 > want to both select the frame and change its selected window.

But `select-window' does select the window's frame.

martin