[Emacs-diffs] /srv/bzr/emacs/trunk r106969: * doc/emacs/frames.texi (Input Focus): Fix doc for select-frame-set-input-focus.

[Chong Yidong]

------------------------------------------------------------
revno: 106969
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2012-01-28 12:26:33 +0800
message:
  * doc/emacs/frames.texi (Input Focus): Fix doc for 
select-frame-set-input-focus.
  Clarify role of NORECORD arg to select-frame.
modified:
  doc/lispref/ChangeLog
  doc/lispref/frames.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-01-28 03:56:20 +0000
+++ b/doc/lispref/ChangeLog     2012-01-28 04:26:33 +0000
@@ -1,5 +1,8 @@
 2012-01-28  Chong Yidong  <address@hidden>
 
+       * frames.texi (Input Focus): Add NORECORD arg to
+       select-frame-set-input-focus.  Clarify its role in select-frame.
+
        * text.texi (Transposition): We don't use transpose-region as an
        internal subroutine (Bug#3249).
 

=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi   2012-01-19 07:21:25 +0000
+++ b/doc/lispref/frames.texi   2012-01-28 04:26:33 +0000
@@ -1377,15 +1377,15 @@
 terminal frame has a number which appears in the mode line before the
 buffer name (@pxref{Mode Line Variables}).
 
address@hidden select-frame-set-input-focus frame
address@hidden select-frame-set-input-focus frame &optional norecord
 This function selects @var{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.
+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 optional argument @var{norecord} has
+the same meaning as for @code{select-frame} (see below).  The return
+value of this function is not significant.
 @end defun
 
address@hidden ??? This is not yet implemented properly.
 @defun select-frame frame &optional norecord
 This function selects frame @var{frame}, temporarily disregarding the
 focus of the X server if any.  The selection of @var{frame} lasts until
@@ -1395,18 +1395,20 @@
 selected frame after return to the command loop, because it still may
 have the window system's input focus.)
 
-The specified @var{frame} becomes the selected frame, as explained
-above, and the terminal that @var{frame} is on becomes the selected
-terminal.  The window selected within @var{frame} becomes the selected
-window.  This function returns @var{frame}, or @code{nil} if @var{frame}
-has been deleted.
-
-Optional argument @var{norecord} address@hidden means to neither change
-the order of recently selected windows nor the buffer list.  @xref{The
-Buffer List}.
-
-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.
+The specified @var{frame} becomes the selected frame, and its terminal
+becomes the selected terminal.  This function then calls
address@hidden as a subroutine, passing the window selected
+within @var{frame} as its first argument and @var{norecord} as its
+second argument (hence, if @var{norecord} is address@hidden, this
+avoids changing the order of recently selected windows nor the buffer
+list).  @xref{Selecting Windows}.
+
+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
 
 Emacs cooperates with the window system by arranging to select frames as