master 43a9c3f 3/4: Document `with-selected-frame'

[Lars Ingebrigtsen]

branch: master
commit 43a9c3f725967001cfbcb9e85525f035d628bf36
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Document `with-selected-frame'
    
    * doc/lispref/windows.texi (Selecting Windows): Document
    `with-selected-frame' (bug#12075).
---
 doc/lispref/windows.texi | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 82d2ce4..44656c0 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -1838,6 +1838,14 @@ with @var{window} as the selected window without 
needlessly running
 @code{buffer-list-update-hook}.
 @end defmac
 
+@defmac with-selected-frame frame forms@dots{}
+This macro executes @var{forms} with @var{frame} as the selected
+frame.  The value returned is the value of the last form in
+@var{forms}.  This macro saves and restores the selected frame, and
+changes the order of neither the recently selected windows nor the
+buffers in the buffer list.
+@end defmac
+
 @defun frame-selected-window &optional frame
 This function returns the window on @var{frame} that is selected
 within that frame.  @var{frame} should be a live frame; if omitted or