From unknown Sat Sep 13 20:35:54 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#12865 <12865@debbugs.gnu.org> To: bug#12865 <12865@debbugs.gnu.org> Subject: Status: 24.3.50; Doc fix for the Emacs Manual (scrolling) Reply-To: bug#12865 <12865@debbugs.gnu.org> Date: Sun, 14 Sep 2025 03:35:54 +0000 retitle 12865 24.3.50; Doc fix for the Emacs Manual (scrolling) reassign 12865 emacs submitter 12865 Dani Moncayo severity 12865 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 11 16:12:28 2012 Received: (at submit) by debbugs.gnu.org; 11 Nov 2012 21:12:28 +0000 Received: from localhost ([127.0.0.1]:33687 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TXepP-0002n4-EF for submit@debbugs.gnu.org; Sun, 11 Nov 2012 16:12:28 -0500 Received: from eggs.gnu.org ([208.118.235.92]:46163) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TXepL-0002mw-V7 for submit@debbugs.gnu.org; Sun, 11 Nov 2012 16:12:25 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TXeoy-0000pA-Al for submit@debbugs.gnu.org; Sun, 11 Nov 2012 16:12:03 -0500 Received: from lists.gnu.org ([208.118.235.17]:37752) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXeoy-0000p6-7q for submit@debbugs.gnu.org; Sun, 11 Nov 2012 16:12:00 -0500 Received: from eggs.gnu.org ([208.118.235.92]:60116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXeov-0000Tr-1l for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:12:00 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TXeor-0000oK-Vd for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:11:56 -0500 Received: from mail-ob0-f169.google.com ([209.85.214.169]:48759) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXeor-0000oG-NY for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:11:53 -0500 Received: by mail-ob0-f169.google.com with SMTP id lz20so1505662obb.0 for ; Sun, 11 Nov 2012 13:11:53 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=bvsrkIDIyvLFtfz8cYZINOeodF0u8mCa/GsgTvfXNXs=; b=q2qDNHZPCDUXTp4+mbopxHXltlOSbELoA/PZBn4E9CQ2OafeYwB8iesPYuheiJ3aWi 6CipgQL2z+Nxwq6n/+7kj09qFE1MLrIszqkCi8kil/Ee8LVxKn5GNdYdADnGAtJUzjaC XdjPq2CXLJIxx/EdlJydocd7IkxkxEWs5k+hi+XTaHzhxbHb8ohhIGeOd9UsnXjtcMOW zbFyBG94XdpQftXRy+ZWE+fwT5+Kc+0qjeiko1+xb4El/WlOsBxlCkaJ3oG2+0VcD82o WwzWzcxlteqAM+ppAYHSlZtWlv7B08wg5NzaVUZ6Mlzd7DkcQuk7OOeM9qgsBEsrf47D tmuw== MIME-Version: 1.0 Received: by 10.60.19.202 with SMTP id h10mr12788299oee.99.1352668313092; Sun, 11 Nov 2012 13:11:53 -0800 (PST) Received: by 10.60.131.168 with HTTP; Sun, 11 Nov 2012 13:11:52 -0800 (PST) Date: Sun, 11 Nov 2012 22:11:52 +0100 Message-ID: Subject: 24.3.50; Doc fix for the Emacs Manual (scrolling) From: Dani Moncayo To: bug-gnu-emacs@gnu.org Content-Type: text/plain; charset=ISO-8859-1 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -4.7 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) Hello, I want to propose some corrections to the info node "(emacs) Auto Scrolling": * "(less than N lines)" isn't correct. It should be "(no more than N lines)". * There are two paragraphs (4th and 7th) that explain the priority for deciding which variable is obeyed in case the user sets more than one. It would be clearer to merge these two paragraph in one. * The 5th paragraph states that `scroll-up/down-aggressively' take effect "When the window does scroll by a distance longer than `scroll-step'", but the 7th paragraph says that "These two variables are ignored if either `scroll-step' or `scroll-conservatively' are set to a non-zero value". Therefore, the 5th paragraph can be simplified; there is no need to mention `scroll-step' there (cause it must be zero). Also, a minor clarification for the info node "(emacs) Horizontal Scrolling": * The 2nd paragraph should refer to "the window's edges" as "left/right edges", to avoid ambiguity with the top/bottom edges. The following patch is an attempt to make the above corrections (plus some minor tweaks). Feel free to use it, as is or with adjustments, or to make the changes in your own way. TIA === modified file 'doc/emacs/display.texi' --- doc/emacs/display.texi 2012-11-07 20:43:38 +0000 +++ doc/emacs/display.texi 2012-11-11 20:57:35 +0000 @@ -214,58 +214,53 @@ @section Automatic Scrolling Emacs performs @dfn{automatic scrolling} when point moves out of the -visible portion of the text. +visible portion of the text. By default, this centers point +vertically within the window, but you have several alternatives to +customize this behavior. @vindex scroll-conservatively - Normally, this centers point vertically within the window. However, -if you set @code{scroll-conservatively} to a small number @var{n}, -then if you move point just a little off the screen (less than @var{n} -lines), Emacs scrolls the text just far enough to bring point back on -screen. If doing so fails to make point visible, Emacs centers point -in the window. By default, @code{scroll-conservatively} is@tie{}0. -If you set @code{scroll-conservatively} to a large number (larger than -100), Emacs will never center point as result of scrolling, even if -point moves far away from the text previously displayed in the window. -With such a large value, Emacs will always scroll text just enough for -bringing point into view, so point will end up at the top or bottom of -the window, depending on the scroll direction. + If you set @code{scroll-conservatively} to a small number @var{n}, +then moving point just a little off the screen (no more than @var{n} +lines), makes Emacs scroll the text just far enough to bring point +back on screen. If doing so fails to make point visible, Emacs +centers point in the window. By default, @code{scroll-conservatively} +is@tie{}0. If you set @code{scroll-conservatively} to a large number +(larger than 100), Emacs will never center point as result of +scrolling, even if point moves far away from the text previously +displayed in the window. With such a large value, Emacs will always +scroll text just enough for bringing point into view, so point will +end up at the top or bottom of the window, depending on the scroll +direction. @vindex scroll-step - An alternative way of controlling how Emacs scrolls text is by -customizing the variable @code{scroll-step}. Its value determines how -many lines to scroll the window when point moves off the screen. If -moving by that number of lines fails to bring point back into view, -point is centered instead. The default value is zero, which causes -point to always be centered after scrolling. - - Since both @code{scroll-conservatively} and @code{scroll-step} -control automatic scrolling in contradicting ways, you should set only -one of them. If you customize both, the value of -@code{scroll-conservatively} takes precedence. + The variable @code{scroll-step} determines how many lines to scroll +the window when point moves off the screen. If moving by that number +of lines fails to bring point back into view, point is centered +instead. The default value is zero, which causes point to always be +centered after scrolling. @cindex aggressive scrolling @vindex scroll-up-aggressively @vindex scroll-down-aggressively - When the window does scroll by a distance longer than -@code{scroll-step}, you can control how aggressively it scrolls by -setting the variables @code{scroll-up-aggressively} and -@code{scroll-down-aggressively}. The value of -@code{scroll-up-aggressively} should be either @code{nil}, or a -fraction @var{f} between 0 and 1. A fraction specifies where on the -screen to put point when scrolling upward, i.e.@: forward. When point -goes off the window end, the new start position is chosen to put point -@var{f} parts of the window height from the bottom margin. Thus, -larger @var{f} means more aggressive scrolling: more new text is -brought into view. The default value, @code{nil}, is equivalent to -0.5. + You can specify where on the screen to put point when scrolling +upward by setting the variable @code{scroll-up-aggressively} to a +fraction @var{f} between 0 and 1. When point goes off the window end, +the new start position is chosen to put point @var{f} parts of the +window height from the bottom margin. Thus, larger @var{f} means more +aggressive scrolling: more new text is brought into view. The default +value, @code{nil}, is equivalent to 0.5. Likewise, @code{scroll-down-aggressively} is used for scrolling down, i.e.@: backward. The value specifies how far point should be placed from the top margin of the window; thus, as with @code{scroll-up-aggressively}, a larger value is more aggressive. - These two variables are ignored if either @code{scroll-step} or -@code{scroll-conservatively} are set to a non-zero value. + Since these variables (@code{scroll-conservatively}, +@code{scroll-step} and @code{scroll-up/down-aggressively} control +automatic scrolling in contradicting ways, you should set only one of +them, because only one will be obeyed. The order of priority is: +@code{scroll-conservatively} first, then @code{scroll-step} and +finally @code{scroll-up/down-aggressively}. @vindex scroll-margin The variable @code{scroll-margin} restricts how close point can come @@ -295,10 +290,10 @@ @vindex hscroll-margin The variable @code{hscroll-margin} controls how close point can get -to the window's edges before automatic scrolling occurs. It is -measured in columns. For example, if the value is 5, then moving -point within 5 columns of an edge causes horizontal scrolling away -from that edge. +to the window's left/right edges before automatic scrolling occurs. +It is measured in columns. For example, if the value is 5, then +moving point within 5 columns of an edge causes horizontal scrolling +away from that edge. @vindex hscroll-step The variable @code{hscroll-step} determines how many columns to -- Dani Moncayo In GNU Emacs 24.3.50.1 (i386-mingw-nt6.1.7601) of 2012-11-11 on MS-W7-DANI Bzr revision: 110867 eggert@cs.ucla.edu-20121111183929-513iyuqggsacgftv Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libXpm-3.5.10/include -I../../libs/libXpm-3.5.10/src -I../../libs/libpng-1.2.37-lib/include -I../../libs/zlib-1.2.5 -I../../libs/giflib-4.1.4-1-lib/include -I../../libs/jpeg-6b-4-lib/include -I../../libs/tiff-3.8.2-1-lib/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.9-w32-bin/include -I../../libs/libiconv-1.9.2-1-lib/include' Important settings: value of $LANG: ESN locale-coding-system: cp1252 default enable-multibyte-characters: t From debbugs-submit-bounces@debbugs.gnu.org Sun Nov 18 01:29:29 2012 Received: (at 12865-done) by debbugs.gnu.org; 18 Nov 2012 06:29:29 +0000 Received: from localhost ([127.0.0.1]:51943 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZyNh-0001o2-Dj for submit@debbugs.gnu.org; Sun, 18 Nov 2012 01:29:28 -0500 Received: from mail-da0-f44.google.com ([209.85.210.44]:41103) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TZyNd-0001np-Co for 12865-done@debbugs.gnu.org; Sun, 18 Nov 2012 01:29:23 -0500 Received: by mail-da0-f44.google.com with SMTP id h15so1684099dan.3 for <12865-done@debbugs.gnu.org>; Sat, 17 Nov 2012 22:28:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=l17cQQetdtQGnfO/VPQr76xZ6Y1/SFFQ7lL52JFn+xs=; b=BJ+X9WvpQGeSUaa6rMD6tmAI3PqxJ4kmSovAyyQolcZ31/NzBROxQarlgKDq66KJGP +VaaEfvT2vPNIdizalJXMIgf/Ltd7hW6/bZPHr/KTDTENIeHcyXb0n66a3cbQ9hnau1k /2OxnOWQpRzGzRRymWPvQef1b4FQbVNPhOyuxGML1zsJMUj2ZiQUFmhGikxmyQe91u2H oeIawkDCOOYauHc126c1yDZ1xvKIE1vaCt0IUdRJvkyysKSpQNzMdKujsEdx5LFP07D2 xUmAEHUI/GRK+OIqzXDJsRTh/8nfvssL9RPKEdxmRmUITHFAk3VMZ6kQjKaMZ07OHXgd b00Q== Received: by 10.66.87.167 with SMTP id az7mr26412962pab.69.1353220104428; Sat, 17 Nov 2012 22:28:24 -0800 (PST) Received: from ulysses (cm198.gamma83.maxonline.com.sg. [202.156.83.198]) by mx.google.com with ESMTPS id vk5sm4047527pbc.34.2012.11.17.22.28.19 (version=SSLv3 cipher=OTHER); Sat, 17 Nov 2012 22:28:22 -0800 (PST) From: Chong Yidong To: Dani Moncayo Subject: Re: bug#12865: 24.3.50; Doc fix for the Emacs Manual (scrolling) References: Date: Sun, 18 Nov 2012 14:28:15 +0800 In-Reply-To: (Dani Moncayo's message of "Sun, 11 Nov 2012 22:11:52 +0100") Message-ID: <8739071l34.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: 12865-done Cc: 12865-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -0.7 (/) Dani Moncayo writes: > The following patch is an attempt to make the above corrections (plus > some minor tweaks). Feel free to use it, as is or with adjustments, > or to make the changes in your own way. TIA Thanks. I've committed the patch, with some tweaks. From unknown Sat Sep 13 20:35:54 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 16 Dec 2012 12:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator