From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Tue, 1 Jun 2021 07:41:40 +0000 (+0200)
Subject: Document `with-selected-frame'
X-Git-Tag: emacs-28.0.90~2237
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=43a9c3f725967001cfbcb9e85525f035d628bf36;p=emacs.git

Document `with-selected-frame'

* doc/lispref/windows.texi (Selecting Windows): Document
`with-selected-frame' (bug#12075).
---

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 82d2ce4757b..44656c057a3 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