; Document 'filtered-frame-list'

* doc/lispref/frames.texi (Finding All Frames): Document
'filtered-frame-list'.

(cherry picked from commit e3aae5fd385bd5512f614d2273a2d6d8e95a7ce6)

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 65d7cf063c5e5f43a09dd2f8d20b74f09af1708d..b79879063fbe9532d5663e110d341965bc454f39 100644 (file)
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2824,6 +2824,18 @@ direction.
   See also @code{next-window} and @code{previous-window}, in @ref{Cyclic
 Window Ordering}.
 
+  Some Lisp programs need to find one or more frames that satisfy a
+given criteria.  The function @code{filtered-frame-list} is provided for
+this purpose.
+
+@defun filtered-frame-list predicate
+This function returns the list of all the live frames which satisfy the
+specified @var{predicate}.  The argument @var{predicate} must be a
+function of one argument, a frame to be tested against the filtering
+criteria, and should return non-@code{nil} if the frame satisfies the
+criteria.
+@end defun
+
 @node Minibuffers and Frames
 @section Minibuffers and Frames