Mercurial > emacs

--- a/doc/misc/ChangeLog	Wed Dec 01 20:06:52 2010 -0800
+++ b/doc/misc/ChangeLog	Wed Dec 01 20:09:20 2010 -0800
@@ -1,3 +1,7 @@
+2010-12-02  Glenn Morris  <rgm@gnu.org>
+
+	* cl.texi (For Clauses): Small fixes for frames and windows.
+
 2010-11-23  Glenn Morris  <rgm@gnu.org>
 	    James Clark  <none@example.com>
--- a/doc/misc/cl.texi	Wed Dec 01 20:06:52 2010 -0800
+++ b/doc/misc/cl.texi	Wed Dec 01 20:09:20 2010 -0800
@@ -2494,15 +2494,18 @@
 @code{of} term may specify either a buffer or a string.

 @item for @var{var} being the frames
-This clause iterates over all frames, i.e., X window system windows
-open on Emacs files.  The
-clause @code{screens} is a synonym for @code{frames}.  The frames
-are visited in @code{next-frame} order starting from
-@code{selected-frame}.
+This clause iterates over all Emacs frames. The clause @code{screens} is
+a synonym for @code{frames}.  The frames are visited in
+@code{next-frame} order starting from @code{selected-frame}.

 @item for @var{var} being the windows [of @var{frame}]
 This clause iterates over the windows (in the Emacs sense) of
-the current frame, or of the specified @var{frame}.
+the current frame, or of the specified @var{frame}.  It visits windows
+in @code{next-window} order starting from @code{selected-window}
+(or @code{frame-selected-window} if you specify @var{frame}).
+This clause treats the minibuffer window in the same way as
+@code{next-window} does.  For greater flexibility, consider using
+@code{walk-windows} instead.

 @item for @var{var} being the buffers
 This clause iterates over all buffers in Emacs.  It is equivalent
@@ -5322,6 +5325,3 @@

 @bye

-@ignore
-   arch-tag: b61e7200-3bfa-4a70-a9d3-095e152696f8
-@end ignore