Document `with-selected-frame'

* doc/lispref/windows.texi (Selecting Windows): Document
`with-selected-frame' (bug#12075).
This commit is contained in:
Lars Ingebrigtsen 2021-06-01 09:41:40 +02:00
parent 0a7ca6fc3f
commit 43a9c3f725

View file

@ -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