# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1164812861 0
# Node ID b9b794014fe1c99a050201b2b312a1b545cdfa54
# Parent  e54dcc927a3ea2aa1a661a0a0f5ac0bab152b6ae
(Visibility of Frames): Explain visible windows
can be covered by others.  Add xref for raise-frame.

diff -r e54dcc927a3e -r b9b794014fe1 lispref/frames.texi
--- a/lispref/frames.texi	Wed Nov 29 13:18:32 2006 +0000
+++ b/lispref/frames.texi	Wed Nov 29 15:07:41 2006 +0000
@@ -1203,17 +1203,19 @@
 @cindex frame visibility
 
 A window frame may be @dfn{visible}, @dfn{invisible}, or
-@dfn{iconified}.  If it is visible, you can see its contents.  If it is
-iconified, the frame's contents do not appear on the screen, but an icon
-does.  If the frame is invisible, it doesn't show on the screen, not
-even as an icon.
+@dfn{iconified}.  If it is visible, you can see its contents, unless
+other windows cover it.  If it is iconified, the frame's contents do
+not appear on the screen, but an icon does.  If the frame is
+invisible, it doesn't show on the screen, not even as an icon.
 
 Visibility is meaningless for terminal frames, since only the selected
 one is actually displayed in any case.
 
 @deffn Command make-frame-visible &optional frame
-This function makes frame @var{frame} visible.  If you omit @var{frame},
-it makes the selected frame visible.
+This function makes frame @var{frame} visible.  If you omit
+@var{frame}, it makes the selected frame visible.  This does not raise
+the frame, but you can do that with @code{raise-frame} if you wish
+(@pxref{Raising and Lowering}).
 @end deffn
 
 @deffn Command make-frame-invisible &optional frame force