From c38eb0274c8fedeb0b4470943f44ba274037eae2 Mon Sep 17 00:00:00 2001 From: Chong Yidong Date: Sat, 31 Oct 2009 17:12:13 +0000 Subject: [PATCH] * frame.c (Fmake_frame_invisible, Fframe_visible_p): Doc fix (Bug#4827). --- src/ChangeLog | 5 +++++ src/frame.c | 28 ++++++++++++++++++---------- 2 files changed, 23 insertions(+), 10 deletions(-) diff --git a/src/ChangeLog b/src/ChangeLog index a291d8c1e9c..3c82211c553 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -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 --git a/src/frame.c b/src/frame.c index 90309a33d8b..2884c16c551 100644 --- a/src/frame.c +++ b/src/frame.c @@ -1880,10 +1880,17 @@ make_frame_visible_1 (window) 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 @@ If omitted, FRAME defaults to the currently selected frame. */) 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; { -- 2.39.5