mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-02 11:21:42 +00:00
Code Issues Releases Activity

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

Browse Source 
and `select-frame'.
This commit is contained in:
Luc Teirlinck 2004-07-07 22:43:05 +00:00
parent 339902ec4a
commit cb4f1287f8
2 changed files with 16 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
lispref/ChangeLog
View File

@ -1,3 +1,8 @@
2004-07-07 Luc Teirlinck <teirllm@auburn.edu>
* frames.texi (Input Focus): Clarify descriptions of
`select-frame-set-input-focus' and `select-frame'.
2004-07-06 Luc Teirlinck <teirllm@auburn.edu>
* os.texi: Various small changes in addition to:

19
lispref/frames.texi
View File

@ -1006,17 +1006,19 @@ 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}).
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 new frame gets displayed
on the entire terminal screen.
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.
@ -1026,7 +1028,8 @@ 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.
@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.