From ad93dad7b9e126301706c1f36158c4c0fab414cd Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Sat, 25 Feb 1995 07:35:09 +0000 Subject: [PATCH] (walk-windows): Doc fix. --- lisp/subr.el | 27 ++++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/lisp/subr.el b/lisp/subr.el index e0a8e0177ff..f7bbad7b405 100644 --- a/lisp/subr.el +++ b/lisp/subr.el @@ -73,15 +73,24 @@ If ALL-FRAMES is neither nil nor t, count only the selected frame." (defun walk-windows (proc &optional minibuf all-frames) "Cycle through all visible windows, calling PROC for each one. PROC is called with a window as argument. -Optional second arg MINIBUF t means count the minibuffer window -even if not active. If MINIBUF is neither t nor nil it means -not to count the minibuffer even if it is active. - -Optional third arg ALL-FRAMES, if t, means include all frames. -ALL-FRAMES nil or omitted means cycle within the selected frame, -but include the minibuffer window (if MINIBUF says so) that that -frame uses, even if it is on another frame. -If ALL-FRAMES is neither nil nor t, stick strictly to the selected frame." + +Optional second arg MINIBUF t means count the minibuffer window even +if not active. MINIBUF nil or omitted means count the minibuffer iff +it is active. MINIBUF neither t nor nil means not to count the +minibuffer even if it is active. + +Several frames may share a single minibuffer; if the minibuffer +counts, all windows on all frames that share that minibuffer count +too. Therefore, when a separate minibuffer frame is active, +`walk-windows' includes the windows in the frame from which you +entered the minibuffer, as well as the minibuffer window. But if the +minibuffer does not count, only windows from WINDOW's frame count. + +Optional third arg ALL-FRAMES t means include windows on all frames. +ALL-FRAMES nil or omitted means cycle within the frames as specified +above. ALL-FRAMES = `visible' means include windows on all visible frames. +ALL-FRAMES = 0 means include windows on all visible and iconified frames. +Anything else means restrict to WINDOW's frame." ;; If we start from the minibuffer window, don't fail to come back to it. (if (window-minibuffer-p (selected-window)) (setq minibuf t)) -- 2.39.5