aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/frames.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lispref/frames.texi')
-rw-r--r--doc/lispref/frames.texi16
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index d57d643e922..c50619a2de0 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -89,6 +89,20 @@ displayed on that terminal; the list of possible values is the same as
89for @code{framep} above. 89for @code{framep} above.
90@end defun 90@end defun
91 91
92@defun frame-initial-p &optional frame
93This predicate returns non-@code{nil} if @var{frame} is or holds the
94initial text frame that is used internally during daemon mode
95(@pxref{Initial Options, daemon,, emacs, The GNU Emacs Manual}), batch
96mode (@pxref{Batch Mode}), and the early stages of startup
97(@pxref{Startup Summary}). Interactive and graphical programs, for
98instance, can use this predicate to avoid operating on the initial
99frame, which is never displayed.
100
101If @var{frame} is a terminal, this function returns non-@code{nil} if
102@var{frame} holds the initial frame. If @var{frame} is omitted or
103@code{nil}, it defaults to the selected one.
104@end defun
105
92@cindex top-level frame 106@cindex top-level frame
93On a graphical terminal we distinguish two types of frames: A normal 107On a graphical terminal we distinguish two types of frames: A normal
94@dfn{top-level frame} is a frame whose window-system window is a child 108@dfn{top-level frame} is a frame whose window-system window is a child
@@ -3029,7 +3043,7 @@ direction.
3029 See also @code{next-window} and @code{previous-window}, in @ref{Cyclic 3043 See also @code{next-window} and @code{previous-window}, in @ref{Cyclic
3030Window Ordering}. 3044Window Ordering}.
3031 3045
3032 Some Lisp programs need to find one or more frames that satisfy a 3046 Some Lisp programs need to find one or more frames that satisfy
3033given criteria. The function @code{filtered-frame-list} is provided for 3047given criteria. The function @code{filtered-frame-list} is provided for
3034this purpose. 3048this purpose.
3035 3049