# HG changeset patch # User Chong Yidong # Date 1257009133 0 # Node ID d3531eb1d0d55f22e098782b168f7fa993bccf29 # Parent df4934f25eefd1c7dad7eff13f9a5b001797a4ef * frame.c (Fmake_frame_invisible, Fframe_visible_p): Doc fix (Bug#4827). diff -r df4934f25eef -r d3531eb1d0d5 src/ChangeLog --- 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 + + * frame.c (Fmake_frame_invisible, Fframe_visible_p): Doc fix + (Bug#4827). + 2009-10-30 Eli Zaretskii * s/msdos.h (SYSTEM_PURESIZE_EXTRA): Redefine to waste less pure diff -r df4934f25eef -r d3531eb1d0d5 src/frame.c --- 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; {