From drew.adams@oracle.com Mon Sep 1 00:27:57 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-5.1 required=4.0 tests=AWL,BAYES_00, RCVD_IN_DNSWL_LOW,UNPARSEABLE_RELAY autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at submit) by emacsbugs.donarmstrong.com; 1 Sep 2008 07:27:57 +0000 Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m817RsF4027607 for ; Mon, 1 Sep 2008 00:27:55 -0700 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Ka3pJ-0001bz-Ou for bug-gnu-emacs@gnu.org; Mon, 01 Sep 2008 03:27:53 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Ka3pG-0001Z5-Au for bug-gnu-emacs@gnu.org; Mon, 01 Sep 2008 03:27:53 -0400 Received: from [199.232.76.173] (port=49463 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ka3pF-0001Yr-OG for bug-gnu-emacs@gnu.org; Mon, 01 Sep 2008 03:27:49 -0400 Received: from mx20.gnu.org ([199.232.41.8]:9483) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Ka3pF-0002DU-KW for bug-gnu-emacs@gnu.org; Mon, 01 Sep 2008 03:27:49 -0400 Received: from agminet01.oracle.com ([141.146.126.228]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Ka3pA-0007jC-0U for bug-gnu-emacs@gnu.org; Mon, 01 Sep 2008 03:27:47 -0400 Received: from rgmgw1.us.oracle.com (rgmgw1.us.oracle.com [138.1.186.110]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m817Qder022168 for ; Mon, 1 Sep 2008 02:26:39 -0500 Received: from acsmt702.oracle.com (acsmt702.oracle.com [141.146.40.80]) by rgmgw1.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m817Qc6K014452 for ; Mon, 1 Sep 2008 01:26:38 -0600 Received: from dradamslap1 (/69.181.100.12) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 01 Sep 2008 00:26:38 -0700 From: "Drew Adams" To: Subject: doc for recenter, redisplay Date: Mon, 1 Sep 2008 00:26:38 -0700 Message-ID: <008501c90c04$1388ba60$0200a8c0@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AckMBBI9vfBtiMAERR+Mu9dkmtzAVg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by mx20.gnu.org: Linux 2.4-2.6 X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) I notice that `recenter' has the effect of calling (redisplay t); that is, it seems to force a redisplay. I don't see this mentioned anywhere. It might be helpful to mention it. We might want to mention it in the Elisp manual node Textual Scrolling, where `recenter' is covered, and also in node Forcing Redisplay, where redisplay is covered (with an xref to Textual Scrolling). Users who want to both recenter and redisplay might want to know that `recenter' alone suffices. Users who do not want to force a redisplay might want to know that `recenter' does that. In GNU Emacs 22.2.1 (i386-mingw-nt5.1.2600) of 2008-03-26 on RELEASE Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)' From cyd@stupidchicken.com Mon Sep 1 10:52:39 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-3.7 required=4.0 tests=AWL,BAYES_00 autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 848-done) by emacsbugs.donarmstrong.com; 1 Sep 2008 17:52:39 +0000 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m81Hqa3Z013146 for <848-done@emacsbugs.donarmstrong.com>; Mon, 1 Sep 2008 10:52:37 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id 2FFE757E337; Mon, 1 Sep 2008 13:54:52 -0400 (EDT) To: "Drew Adams" Cc: 848-done@debbugs.gnu.org Subject: Re: doc for recenter, redisplay From: Chong Yidong Date: Mon, 01 Sep 2008 13:54:52 -0400 Message-ID: <87od37zr83.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > I notice that `recenter' has the effect of calling (redisplay t); that > is, it seems to force a redisplay. I don't see this mentioned > anywhere. It might be helpful to mention it. We might want to mention > it in the Elisp manual node Textual Scrolling, where `recenter' is > covered, and also in node Forcing Redisplay, where redisplay is > covered (with an xref to Textual Scrolling). In the docstring: If arg is omitted or nil, erase the entire frame and then redraw with point in the center of the current window. In the Emacs manual: It also clears the screen and redisplays all windows; this is useful in case the screen becomes garbled for any reason (*note Screen Garbled::). In the Elisp manual: If @var{count} is @code{nil}, @code{recenter} puts the line containing point in the middle of the window, then clears and redisplays the entire selected frame. However, the docstring for recenter-top-bottom (new to Emacs 23) did not mention this; I've updated it accordingly. From drew.adams@oracle.com Mon Sep 1 11:13:57 2008 X-Spam-Checker-Version: SpamAssassin 3.2.3-bugs.debian.org_2005_01_02 (2007-08-08) on rzlab.ucr.edu X-Spam-Level: X-Spam-Status: No, score=-6.3 required=4.0 tests=AWL,BAYES_00,MDO_CABLE_TV3, RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham version=3.2.3-bugs.debian.org_2005_01_02 Received: (at 848-done) by emacsbugs.donarmstrong.com; 1 Sep 2008 18:13:57 +0000 Received: from agminet01.oracle.com (agminet01.oracle.com [141.146.126.228]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m81IDsbN020693 for <848-done@emacsbugs.donarmstrong.com>; Mon, 1 Sep 2008 11:13:55 -0700 Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m81IDmCk022247; Mon, 1 Sep 2008 13:13:48 -0500 Received: from acsmt707.oracle.com (acsmt707.oracle.com [141.146.40.85]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m81IDkuP004041; Mon, 1 Sep 2008 12:13:46 -0600 Received: from dradamslap1 (/69.181.100.12) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 01 Sep 2008 11:13:46 -0700 From: "Drew Adams" To: "'Chong Yidong'" Cc: <848-done@debbugs.gnu.org> References: <87od37zr83.fsf@cyd.mit.edu> Subject: RE: doc for recenter, redisplay Date: Mon, 1 Sep 2008 11:13:52 -0700 Message-ID: <000301c90c5e$7d7d42b0$0200a8c0@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 In-Reply-To: <87od37zr83.fsf@cyd.mit.edu> Thread-Index: AckMW6vCKOngV870ToyTlnixRdIwrgAAJKiQ X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE > > I notice that `recenter' has the effect of calling > > (redisplay t); that is, it seems to force a redisplay. I don't > > see this mentioned anywhere. It might be helpful to mention it. > > We might want to mention it in the Elisp manual node Textual > > Scrolling, where `recenter' is covered, and also in node > > Forcing Redisplay, where redisplay is > > covered (with an xref to Textual Scrolling). > > > Users who want to both recenter and redisplay might want to > > know that `recenter' alone suffices. > > > Users who do not want to force a redisplay might want to > > know that `recenter' does that. > > > In the docstring: > > If arg is omitted or nil, erase the entire frame and then > redraw with point in the center of the current window. > > In the Emacs manual: > > It also clears the screen and redisplays all windows; this is useful > in case the screen becomes garbled for any reason (*note Screen > Garbled::). > > In the Elisp manual: > > If @var{count} is @code{nil}, @code{recenter} puts the line > containing point in the middle of the window, then clears and > redisplays the entire selected frame. > > However, the docstring for recenter-top-bottom (new to Emacs > 23) did not mention this; I've updated it accordingly. OK, thanks. I was mainly concerned about the redisplay doc in the Elisp manual, where I was looking for info about functions that can cause redisplay. Could you please also mention this effect in node Forcing Redisplay (and cross-reference node Textual Scrolling for more info about `recenter'). Thx. Reasons (again): 1. You might have a (recenter) in your code and not be able to figure out why or where redisplay is occurring. Knowing this redisplay effect would help debugging. 2. You might want to both recenter and redisplay. Looking up `redisplay' in the manual should let you know that recentering will also cause redisplay. Also, the Emacs manual (node Scrolling) says that `C-l' redisplays "on a text terminal". I don't think that restriction is applicable anymore; I think it redisplays always and everywhere. Perhaps what gets redisplayed is different for a text terminal? Not sure just what was meant here. The Scrolling node passage also sends you to node Screen Garbled, which also speaks only of text terminals. Dunno if that restriction is appropriate there either, but it is certainly true that `C-l' redisplay can be important for text terminals (or at least it used to be important). From unknown Sun Aug 10 11:49:56 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: $requester Subject: Internal Control Message-Id: bug archived. Date: Tue, 30 Sep 2008 14:24:03 +0000 User-Agent: Fakemail v42.6.9 # A New Hope # A log time ago, in a galaxy far, far away # something happened. # # Magically this resulted in the following # action being taken, but this fake control # message doesn't tell you why it happened # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator