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 theframe's position in the window stack (see `raise-frame') nor doesit direct input focus to that frame. To do both of those at once,see `select-frame-set-input-focus'.