From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: What is normal these days (display.texi)? Date: Mon, 10 Jul 2006 10:56:06 +0200 Message-ID: <853bd9on2x.fsf@lola.goethe.zz> References: <85zmflu62p.fsf@lola.goethe.zz> <85lkr5qusn.fsf@lola.goethe.zz> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1152524893 14683 80.91.229.2 (10 Jul 2006 09:48:13 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 10 Jul 2006 09:48:13 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jul 10 11:48:11 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FzsMF-0007TV-Fv for ged-emacs-devel@m.gmane.org; Mon, 10 Jul 2006 11:47:15 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FzsME-0000SY-Ua for ged-emacs-devel@m.gmane.org; Mon, 10 Jul 2006 05:47:14 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FzsM4-0000SB-AP for emacs-devel@gnu.org; Mon, 10 Jul 2006 05:47:04 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FzsM3-0000Rz-44 for emacs-devel@gnu.org; Mon, 10 Jul 2006 05:47:03 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FzsM3-0000Rw-0S for emacs-devel@gnu.org; Mon, 10 Jul 2006 05:47:03 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FzsN6-0002nW-Qb for emacs-devel@gnu.org; Mon, 10 Jul 2006 05:48:08 -0400 Original-Received: from localhost ([127.0.0.1] helo=lola.goethe.zz) by fencepost.gnu.org with esmtp (Exim 4.34) id 1FzsM1-0001Cs-Fs; Mon, 10 Jul 2006 05:47:01 -0400 Original-Received: by lola.goethe.zz (Postfix, from userid 1002) id E74261C464E1; Mon, 10 Jul 2006 10:56:06 +0200 (CEST) Original-To: storm@cua.dk (Kim F. Storm) In-Reply-To: (Kim F. Storm's message of "Sun, 09 Jul 2006 00:19:37 +0200") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:56879 Archived-At: storm@cua.dk (Kim F. Storm) writes: > David Kastrup writes: > >> ! This function calls for redisplay of certain windows, the next time >> ! redisplay is done, but does not clear them first. >> >> @defun force-window-update &optional object >> This function forces redisplay of some or all windows. If >> --- 55,62 ---- >> This function clears and redisplays all visible frames. >> @end deffn >> >> ! The following function redisplays certain windows without clearing >> ! them first: >> >> @defun force-window-update &optional object >> This function forces redisplay of some or all windows. If > > IMO, the original text (calls for) is more correct. > > force-window-update does not force an immediate redisplay -- it simply > marks the window to be updated on the next redisplay (by clearing the > internal "up-to-date" state of the window). > > I will update the doc string and lispref to mention this. Well, if you take a look at the immediately preceding sentence, you'll find that this distinction is not made anywhere before: The function @code{redraw-frame} clears and redisplays the entire contents of a given frame (@pxref{Frames}). This is useful if the screen is corrupted. @c Emacs 19 feature @defun redraw-frame frame This function clears and redisplays frame @var{frame}. @end defun Even more powerful is @code{redraw-display}: @deffn Command redraw-display This function clears and redisplays all visible frames. @end deffn All of those functions work by _immediately_ clearing the respective frame or display, and then marking it for redisplay. So why change the language in the case that is much less conspicuous (by not clearing the frame) as it does not cause a large blank window to show while Emacs is busy? -- David Kastrup, Kriemhildstr. 15, 44793 Bochum