diff man/lispref/frames.texi @ 290:c9fe270a4101 r21-0b43

Import from CVS: tag r21-0b43
author cvs
date Mon, 13 Aug 2007 10:36:47 +0200
parents e11d67e05968
children 2f8bb876ab1d
line wrap: on
line diff
--- a/man/lispref/frames.texi	Mon Aug 13 10:35:55 2007 +0200
+++ b/man/lispref/frames.texi	Mon Aug 13 10:36:47 2007 +0200
@@ -139,7 +139,7 @@
 the frame appear with the wrong ones and then change to the specified
 ones.  If that bothers you, you can specify the same geometry and
 appearance with X resources; those do take affect before the frame is
-created.  @xref{Resources X,, X Resources, emacs, The XEmacs User's Manual}.
+created.  @xref{Resources X,, X Resources, xemacs, The XEmacs User's Manual}.
 
 X resource settings typically apply to all frames.  If you want to
 specify some X resources solely for the sake of the initial frame, and
@@ -170,7 +170,7 @@
 If you use options that specify window appearance when you invoke XEmacs,
 they take effect by adding elements to @code{default-frame-plist}.  One
 exception is @samp{-geometry}, which adds the specified position to
-@code{initial-frame-plist} instead.  @xref{Command Arguments,,, emacs,
+@code{initial-frame-plist} instead.  @xref{Command Arguments,,, xemacs,
 The XEmacs User's Manual}.
 
 @node X Frame Properties
@@ -670,19 +670,39 @@
 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.
-@end defun
 
-Note that this does not actually cause the window-system focus to be set
-to this frame, or the @code{select-frame-hook} or
+Note that @code{select-frame} does not actually cause the window-system
+focus to be set to this frame, or the @code{select-frame-hook} or
 @code{deselect-frame-hook} to be run, until the next time that XEmacs is
 waiting for an event.
 
-Also note that when the variable @code{focus-follows-mouse} is non-nil,
-the frame selection is temporary and is reverted when the current
-command terminates, much like the buffer selected by @code{set-buffer}.
-In order to effect a permanent focus change use @code{focus-frame}.
+Also note that when the variable @code{focus-follows-mouse} is
+non-@code{nil}, the frame selection is temporary and is reverted when
+the current command terminates, much like the buffer selected by
+@code{set-buffer}.  In order to effect a permanent focus change use
+@code{focus-frame}.
+@end defun
+
+@defun focus-frame frame
+This function selects @var{frame} and gives it the window system focus.
+The operation of @code{focus-frame} is not affected by the value of
+@code{focus-follows-mouse}.
+@end defun
 
-@ignore (FSF Emacs)
+@defmac save-selected-frame forms@dots{}
+This macro records the selected frame, executes @var{forms} in sequence,
+then restores the earlier selected frame.  The value returned is the
+value of the last form.
+@end defmac
+
+@defmac with-selected-frame frame forms@dots{}
+This macro records the selected frame, then selects @var{frame} and
+executes @var{forms} in sequence.  After the last form is finished, the
+earlier selected frame is restored.  The value returned is the value of
+the last form.
+@end defmac
+
+@ignore (FSF Emacs, continued from defun select-frame)
 XEmacs cooperates with the X server and the window managers by arranging
 to select frames according to what the server and window manager ask
 for.  It does so by generating a special kind of input event, called a