Mercurial > emacs

--- a/src/ChangeLog	Sat Oct 31 02:38:34 2009 +0000
+++ b/src/ChangeLog	Sat Oct 31 17:12:13 2009 +0000
@@ -1,3 +1,8 @@
+2009-10-31  Chong Yidong  <cyd@stupidchicken.com>
+
+	* frame.c (Fmake_frame_invisible, Fframe_visible_p): Doc fix
+	(Bug#4827).
+
 2009-10-30  Eli Zaretskii  <eliz@gnu.org>

 	* s/msdos.h (SYSTEM_PURESIZE_EXTRA): Redefine to waste less pure
--- a/src/frame.c	Sat Oct 31 02:38:34 2009 +0000
+++ b/src/frame.c	Sat Oct 31 17:12:13 2009 +0000
@@ -1880,10 +1880,17 @@

 DEFUN ("make-frame-invisible", Fmake_frame_invisible, Smake_frame_invisible,
        0, 2, "",
-       doc: /* Make the frame FRAME invisible (assuming it is an X window).
+       doc: /* Make the frame FRAME invisible.
 If omitted, FRAME defaults to the currently selected frame.
+On graphical displays, invisible frames are not updated and are
+usually not displayed at all, even in a window system's \"taskbar\".
+
 Normally you may not make FRAME invisible if all other frames are invisible,
-but if the second optional argument FORCE is non-nil, you may do so.  */)
+but if the second optional argument FORCE is non-nil, you may do so.
+
+This function has no effect on text-only terminal frames.  Such frames
+are always considered visible, whether or not they are currently being
+displayed in the terminal.  */)
   (frame, force)
      Lisp_Object frame, force;
 {
@@ -1963,14 +1970,15 @@

 DEFUN ("frame-visible-p", Fframe_visible_p, Sframe_visible_p,
        1, 1, 0,
-       doc: /* Return t if FRAME is now \"visible\" (actually in use for display).
-A frame that is not \"visible\" is not updated and, if it works through
-a window system, it may not show at all.
-Return the symbol `icon' if frame is visible only as an icon.
-
-On a text-only terminal, all frames are considered visible, whether
-they are currently being displayed or not, and this function returns t
-for all frames.  */)
+       doc: /* Return t if FRAME is \"visible\" (actually in use for display).
+Return the symbol `icon' if FRAME is iconified or \"minimized\".
+Return nil if FRAME was made invisible, via `make-frame-invisible'.
+On graphical displays, invisible frames are not updated and are
+usually not displayed at all, even in a window system's \"taskbar\".
+
+If FRAME is a text-only terminal frame, this always returns t.
+Such frames are always considered visible, whether or not they are
+currently being displayed on the terminal.  */)
      (frame)
      Lisp_Object frame;
 {