comparison lispref/frames.texi @ 56371:48a83b7f435a

(Input Focus): Clarify descriptions of `select-frame-set-input-focus' and `select-frame'.

56370:dce4aada3bd3

function @code{select-frame}.  This does not alter the window system's
concept of focus; rather, it escapes from the window manager's control
until that control is somehow reasserted.

When using a text-only terminal, only one frame can be displayed at a
time on the terminal, so @code{select-frame} actually displays the
newly selected frame.  This frame remains displayed until a subsequent
call to @code{select-frame} or @code{select-frame-set-input-focus}.
Each terminal frame has a number which appears in the mode line before
the buffer name (@pxref{Mode Line Variables}).

@defun select-frame-set-input-focus frame
This function makes @var{frame} the selected frame, raises it (should
it happen to be obscured by other frames) and tries to give it the X
server's focus.  On a text-only terminal, the new frame gets displayed
on the entire terminal screen.
@end defun

@c ??? This is not yet implemented properly.
@defun select-frame frame
This function selects frame @var{frame}, temporarily disregarding the
focus of the X server if any.  The selection of @var{frame} lasts until
the next time the user does something to select a different frame, or
until the next time this function is called.  The specified @var{frame}
becomes the selected frame, as explained above, and the terminal that
@var{frame} is on becomes the selected terminal.

In general, you should never use @code{select-frame} in a way that could
switch to a different terminal without switching back when you're done.
@end defun

56371:48a83b7f435a

function @code{select-frame}.  This does not alter the window system's
concept of focus; rather, it escapes from the window manager's control
until that control is somehow reasserted.

When using a text-only terminal, only one frame can be displayed at a
time on the terminal, so after a call to @code{select-frame}, the next
redisplay actually displays the newly selected frame.  This frame
remains displayed until a subsequent call to @code{select-frame} or
@code{select-frame-set-input-focus}.  Each terminal frame has a number
which appears in the mode line before the buffer name (@pxref{Mode
Line Variables}).

@defun select-frame-set-input-focus frame
This function makes @var{frame} the selected frame, raises it (should
it happen to be obscured by other frames) and tries to give it the X
server's focus.  On a text-only terminal, the next redisplay displays
the new frame on the entire terminal screen.  The return value of this
function is not significant.
@end defun

@c ??? This is not yet implemented properly.
@defun select-frame frame
This function selects frame @var{frame}, temporarily disregarding the
focus of the X server if any.  The selection of @var{frame} lasts until
the next time the user does something to select a different frame, or
until the next time this function is called.  The specified @var{frame}
becomes the selected frame, as explained above, and the terminal that
@var{frame} is on becomes the selected terminal.  This function
returns @var{frame}, or @code{nil} if @var{frame} has been deleted.

In general, you should never use @code{select-frame} in a way that could
switch to a different terminal without switching back when you're done.
@end defun