From cb4f1287f80e09dab8455312f6bf4f71aaf37307 Mon Sep 17 00:00:00 2001 From: Luc Teirlinck Date: Wed, 7 Jul 2004 22:43:05 +0000 Subject: [PATCH] (Input Focus): Clarify descriptions of `select-frame-set-input-focus' and `select-frame'. --- lispref/ChangeLog | 5 +++++ lispref/frames.texi | 19 +++++++++++-------- 2 files changed, 16 insertions(+), 8 deletions(-) diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 145aea753cc..cfe47c3ea5d 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,8 @@ +2004-07-07 Luc Teirlinck + + * frames.texi (Input Focus): Clarify descriptions of + `select-frame-set-input-focus' and `select-frame'. + 2004-07-06 Luc Teirlinck * os.texi: Various small changes in addition to: diff --git a/lispref/frames.texi b/lispref/frames.texi index 8bf157335ca..7188b4f8b97 100644 --- a/lispref/frames.texi +++ b/lispref/frames.texi @@ -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. -- 2.39.2