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

[Eli Zaretskii]

> From: Robert Weiner <address@hidden>
> Date: Sat, 16 Dec 2017 11:21:56 -0500
> Cc: Stefan Monnier <address@hidden>, martin rudalics <address@hidden>, 
>       emacs-devel <address@hidden>
> 
>  "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'.
> 
> ​I still think this is a clear and modest proposal.  select-window already
> mentions frames so I don't see an issue with cross-referencing more 
> frame-related
> behavior to make the needs clear with one additional sentence.  Are you guys
> still against this given the further explanations?

Yes.  You are proposing to add text about a completely unrelated
aspect of Emacs.  Selecting a window has nothing to do with focus, but
it's absurd to ask Emacs to mention in doc strings aspects that are
NOT related to the aspects the doc string describes: there are too
many of those.