On Wed, Dec 13, 2017 at 10:33 PM, Eli Zaretskii <eliz@gnu.org> wrote:

>
> My misunderstanding, sorry.
>
> But if the issue is documentation, why not show a proposed patch?
>

​I did with this suggested addition to select-window's doc string:

"Although this selects the window's frame, it does not alter the
frame's position in the window stack (see `raise-frame') nor does
it direct input focus to that frame.  To do both of those at once,
see `select-frame-set-input-focus'.

Bob​
​