Mercurial > emacs
diff lisp/subr.el @ 10828:0ecc478ed305
(walk-windows): Doc fix.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Sat, 25 Feb 1995 07:35:09 +0000 |
parents | bd0ab0601489 |
children | e3c06f791fd8 |
line wrap: on
line diff
--- a/lisp/subr.el Sat Feb 25 07:13:09 1995 +0000 +++ b/lisp/subr.el Sat Feb 25 07:35:09 1995 +0000 @@ -73,15 +73,24 @@ (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 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. -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." +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))