From unknown Sun Aug 10 09:45:48 2025 X-Loop: don@donarmstrong.com Subject: bug#848: doc for recenter, redisplay Reply-To: "Drew Adams" , 848@debbugs.gnu.org Resent-From: "Drew Adams" Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Mon, 01 Sep 2008 07:35:03 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 848 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.122025407727613 (code B ref -1); Mon, 01 Sep 2008 07:35:03 +0000 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: 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 unknown Sun Aug 10 09:45:48 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: don@donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: "Drew Adams" Subject: bug#848 closed by Chong Yidong (Re: doc for recenter, redisplay) Message-ID: References: <87od37zr83.fsf@cyd.mit.edu> <008501c90c04$1388ba60$0200a8c0@us.oracle.com> X-Emacs-PR-Message: they-closed 848 X-Emacs-PR-Package: emacs Reply-To: 848@debbugs.gnu.org Content-Type: multipart/mixed; boundary="----------=_1220292003-15151-1" This is a multi-part message in MIME format... ------------=_1220292003-15151-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #848: doc for recenter, redisplay It has been closed by Chong Yidong . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Chong Yidong by replying to this email. --=20 848: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D848 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1220292003-15151-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit >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. ------------=_1220292003-15151-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit >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)' ------------=_1220292003-15151-1--