From 43a9c3f725967001cfbcb9e85525f035d628bf36 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Tue, 1 Jun 2021 09:41:40 +0200 Subject: [PATCH] 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 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 -- 2.39.2