aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLars Ingebrigtsen2021-06-01 09:41:40 +0200
committerLars Ingebrigtsen2021-06-01 09:41:40 +0200
commit43a9c3f725967001cfbcb9e85525f035d628bf36 (patch)
treef92b6ca978ccd1611a45dda2ad63aea930ec3eb9
parent0a7ca6fc3f4c22c9efc809fcd08e866734c6c981 (diff)
downloademacs-43a9c3f725967001cfbcb9e85525f035d628bf36.tar.gz
emacs-43a9c3f725967001cfbcb9e85525f035d628bf36.zip
Document `with-selected-frame'
* doc/lispref/windows.texi (Selecting Windows): Document `with-selected-frame' (bug#12075).
-rw-r--r--doc/lispref/windows.texi8
1 files changed, 8 insertions, 0 deletions
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
1838@code{buffer-list-update-hook}. 1838@code{buffer-list-update-hook}.
1839@end defmac 1839@end defmac
1840 1840
1841@defmac with-selected-frame frame forms@dots{}
1842This macro executes @var{forms} with @var{frame} as the selected
1843frame. The value returned is the value of the last form in
1844@var{forms}. This macro saves and restores the selected frame, and
1845changes the order of neither the recently selected windows nor the
1846buffers in the buffer list.
1847@end defmac
1848
1841@defun frame-selected-window &optional frame 1849@defun frame-selected-window &optional frame
1842This function returns the window on @var{frame} that is selected 1850This function returns the window on @var{frame} that is selected
1843within that frame. @var{frame} should be a live frame; if omitted or 1851within that frame. @var{frame} should be a live frame; if omitted or