From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dani Moncayo Newsgroups: gmane.emacs.bugs Subject: bug#12865: 24.3.50; Doc fix for the Emacs Manual (scrolling) Date: Sun, 11 Nov 2012 22:11:52 +0100 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: ger.gmane.org 1352668371 31080 80.91.229.3 (11 Nov 2012 21:12:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 11 Nov 2012 21:12:51 +0000 (UTC) To: 12865@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Nov 11 22:13:01 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TXepv-0003om-Vg for geb-bug-gnu-emacs@m.gmane.org; Sun, 11 Nov 2012 22:13:00 +0100 Original-Received: from localhost ([::1]:57010 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXepm-0000rr-GX for geb-bug-gnu-emacs@m.gmane.org; Sun, 11 Nov 2012 16:12:50 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:60251) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXeph-0000rV-Sv for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:12:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TXepe-0000uN-Qw for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:12:45 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:51670) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TXepe-0000uJ-NA for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:12:42 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TXepy-0002nv-Jm for bug-gnu-emacs@gnu.org; Sun, 11 Nov 2012 16:13:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Dani Moncayo Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 11 Nov 2012 21:13:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12865 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.135266834810736 (code B ref -1); Sun, 11 Nov 2012 21:13:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Nov 2012 21:12:28 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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== Original-Received: by 10.60.19.202 with SMTP id h10mr12788299oee.99.1352668313092; Sun, 11 Nov 2012 13:11:53 -0800 (PST) Original-Received: by 10.60.131.168 with HTTP; Sun, 11 Nov 2012 13:11:52 -0800 (PST) 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-Spam-Score: -4.7 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-Spam-Score: -6.1 (------) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:66775 Archived-At: 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