[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 43a9c3f 3/4: Document `with-selected-frame'
From: |
Lars Ingebrigtsen |
Subject: |
master 43a9c3f 3/4: Document `with-selected-frame' |
Date: |
Tue, 1 Jun 2021 04:24:41 -0400 (EDT) |
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