From unknown Thu Jun 19 14:03:27 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#13791 <13791@debbugs.gnu.org> To: bug#13791 <13791@debbugs.gnu.org> Subject: Status: 24.3.50; scroll-margin docstring says "recenter" Reply-To: bug#13791 <13791@debbugs.gnu.org> Date: Thu, 19 Jun 2025 21:03:27 +0000 retitle 13791 24.3.50; scroll-margin docstring says "recenter" reassign 13791 emacs submitter 13791 Dmitry Gutov severity 13791 minor tag 13791 fixed thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 22 19:29:03 2013 Received: (at submit) by debbugs.gnu.org; 23 Feb 2013 00:29:03 +0000 Received: from localhost ([127.0.0.1]:44893 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U92z5-0006Rg-26 for submit@debbugs.gnu.org; Fri, 22 Feb 2013 19:29:01 -0500 Received: from eggs.gnu.org ([208.118.235.92]:46914) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U92z1-0006RX-Uv for submit@debbugs.gnu.org; Fri, 22 Feb 2013 19:28:56 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U92xY-0005Hb-Fj for submit@debbugs.gnu.org; Fri, 22 Feb 2013 19:27:30 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:48324) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U92xY-0005HX-Cu for submit@debbugs.gnu.org; Fri, 22 Feb 2013 19:27:24 -0500 Received: from eggs.gnu.org ([208.118.235.92]:58209) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U92xN-0007gJ-Sr for bug-gnu-emacs@gnu.org; Fri, 22 Feb 2013 19:27:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U92xI-0005D3-V6 for bug-gnu-emacs@gnu.org; Fri, 22 Feb 2013 19:27:13 -0500 Received: from mail-lb0-f179.google.com ([209.85.217.179]:47193) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U92xI-0005Cr-Mi for bug-gnu-emacs@gnu.org; Fri, 22 Feb 2013 19:27:08 -0500 Received: by mail-lb0-f179.google.com with SMTP id j14so951971lbo.24 for ; Fri, 22 Feb 2013 16:27:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:from:to:subject:date:message-id:mime-version :content-type; bh=8fWQE9XsNsFqVpfe22PuFYHjA92a4BnPJcrFYKz9iH0=; b=DANACcRVcNm8syKt6tTk3BT3j7HCQTDLgNTa+wLsb8ahofl2dnMd89k9goHEaVAlV3 5zBmrrpNvxlg6bJATXaZrLV3xbWDgsfHvkcTvrsaDUvDZOBtm/AR6KkVCv/oJ0Iho6aD j/rgTh2yYoFC0yWhhjlUDnSdD7tIij5DpTKjed2BrbbfNb0GgCp5RS77Kf2vjmofg7rH 2NCyKtyVC0Xoc05kBVrYw+ygP+RNAzwFySGYYr2kN9B9PNdn0G4tXuuEzNJknbRXGFpy NxnVCzcN3awJhWbocQ5gl16Lh66UathdTmJX1kMf7s+mxHOY8H2LYrATHCAtOaLlodEk RdUA== X-Received: by 10.112.102.165 with SMTP id fp5mr1683747lbb.18.1361578888994; Fri, 22 Feb 2013 16:21:28 -0800 (PST) Received: from vbx ([178.252.98.87]) by mx.google.com with ESMTPS id pk1sm2168087lab.0.2013.02.22.16.21.27 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Fri, 22 Feb 2013 16:21:28 -0800 (PST) From: Dmitry Gutov To: bug-gnu-emacs@gnu.org Subject: 24.3.50; scroll-margin docstring says "recenter" Date: Sat, 23 Feb 2013 04:21:24 +0400 Message-ID: <87y5efj2wr.fsf@yandex.ru> MIME-Version: 1.0 Content-Type: text/plain 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.2 (----) 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 (------) The docstring says: "Recenter the window whenever point gets within this many lines of the top or bottom of the window." That's not entirely accurate. Depending on the value of `scroll-conservatively', the window may get scrolled instead. Bzr revision: 111828 michael.albinus@gmx.de-20130219151755-yklhdrlp26loxg2v From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 05:19:56 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 10:19:56 +0000 Received: from localhost ([127.0.0.1]:45111 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9CCy-0003Gc-4K for submit@debbugs.gnu.org; Sat, 23 Feb 2013 05:19:56 -0500 Received: from mtaout20.012.net.il ([80.179.55.166]:35368) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9CCv-0003GU-Sj for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 05:19:55 -0500 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MIO001004IEBQ00@a-mtaout20.012.net.il> for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 12:18:25 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIO001CA4MO9Q30@a-mtaout20.012.net.il>; Sat, 23 Feb 2013 12:18:25 +0200 (IST) Date: Sat, 23 Feb 2013 12:18:12 +0200 From: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" In-reply-to: <87y5efj2wr.fsf@yandex.ru> X-012-Sender: halo1@inter.net.il To: Dmitry Gutov Message-id: <83hal3l4ez.fsf@gnu.org> References: <87y5efj2wr.fsf@yandex.ru> X-Spam-Score: 1.5 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has identified this incoming email as possible spam. The original message has been attached to this so you can view it (if it isn't spam) or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: > From: Dmitry Gutov > Date: Sat, 23 Feb 2013 04:21:24 +0400 > > The docstring says: "Recenter the window whenever point gets within this > many lines of the top or bottom of the window." > > That's not entirely accurate. Depending on the value of > `scroll-conservatively', the window may get scrolled instead. [...] Content analysis details: (1.5 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at http://www.dnswl.org/, no trust [80.179.55.166 listed in list.dnswl.org] 0.7 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail) 0.8 BAYES_50 BODY: Bayes spam probability is 40 to 60% [score: 0.4313] X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: Eli Zaretskii 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.2 (/) > From: Dmitry Gutov > Date: Sat, 23 Feb 2013 04:21:24 +0400 > > The docstring says: "Recenter the window whenever point gets within this > many lines of the top or bottom of the window." > > That's not entirely accurate. Depending on the value of > `scroll-conservatively', the window may get scrolled instead. That's true. However, how to describe this in a manner that will not confuse the reader is less clear. "Recenter or scroll" is not very useful, IMO, as it doesn't say which will happen. Suggestions are welcome. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 08:10:07 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 13:10:07 +0000 Received: from localhost ([127.0.0.1]:45260 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9Erf-00081Y-95 for submit@debbugs.gnu.org; Sat, 23 Feb 2013 08:10:07 -0500 Received: from mail-la0-f46.google.com ([209.85.215.46]:64106) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9Erc-00081Q-EP for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 08:10:05 -0500 Received: by mail-la0-f46.google.com with SMTP id fq12so1420984lab.19 for <13791@debbugs.gnu.org>; Sat, 23 Feb 2013 05:08:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:message-id:date:from:user-agent:mime-version:to :cc:subject:references:in-reply-to:content-type :content-transfer-encoding; bh=QAj+Sgkbj+ewjVkYp0UtOqG8cPxYC/YC6yMq/aFBUMA=; b=Q7J7dg5e4MdCtAmB4l+ikbJR/BDMUsuqDJmh3rnYDSCmyxL0fbFZj1D8UTxrEZE6qO WRzEoy3a2eMYN9WzIeORIz+DegTzI1y2/LgYVRbrypUaaG5DdfahAzojXNr+VA2I2sqn jpAXDECb/68ACPZ2JEALk5ehsEj4htSvaBF9Qh0C6sK2xUpH5YR872HhdIZpmTq/eKC6 GQDiORzDdSMCRUYsFyuRZEmlA56zz9dWwNXkFmCzmOWhvhFswGEM7qrHeQ/BLxFM4d00 aqWk28w5aEoi+d4APBAlES6gCxMGXUnhMmUbd4v6Yexr3ZamP2MgAs74K7c8BHw0Qwap fneQ== X-Received: by 10.152.105.244 with SMTP id gp20mr4629774lab.34.1361624915417; Sat, 23 Feb 2013 05:08:35 -0800 (PST) Received: from [127.0.0.1] ([178.252.98.87]) by mx.google.com with ESMTPS id e9sm1942670lbz.1.2013.02.23.05.08.33 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 23 Feb 2013 05:08:34 -0800 (PST) Message-ID: <5128BF53.80402@yandex.ru> Date: Sat, 23 Feb 2013 17:08:35 +0400 From: Dmitry Gutov User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130215 Thunderbird/17.0.3 MIME-Version: 1.0 To: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> In-Reply-To: <83hal3l4ez.fsf@gnu.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@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: -1.2 (-) On 23.02.2013 14:18, Eli Zaretskii wrote: >> That's not entirely accurate. Depending on the value of >> `scroll-conservatively', the window may get scrolled instead. > > That's true. However, how to describe this in a manner that will not > confuse the reader is less clear. "Recenter or scroll" is not very > useful, IMO, as it doesn't say which will happen. Suggestions are > welcome. How about the following? """ Recenter or scroll the window whenever point gets within this many lines of the top or bottom of the window. If the value of `scroll-conservatively' is positive, the window is scrolled, otherwise it's recentered. """ Adjust for actual behavior. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 09:52:12 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 14:52:12 +0000 Received: from localhost ([127.0.0.1]:45328 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9GSR-0001rl-LV for submit@debbugs.gnu.org; Sat, 23 Feb 2013 09:52:12 -0500 Received: from mtaout20.012.net.il ([80.179.55.166]:60531) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9GSO-0001rb-2q for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 09:52:09 -0500 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MIO00300H14R000@a-mtaout20.012.net.il> for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 16:50:38 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIO003S8H8DMY60@a-mtaout20.012.net.il>; Sat, 23 Feb 2013 16:50:38 +0200 (IST) Date: Sat, 23 Feb 2013 16:50:25 +0200 From: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" In-reply-to: <5128BF53.80402@yandex.ru> X-012-Sender: halo1@inter.net.il To: Dmitry Gutov Message-id: <83a9qvkrta.fsf@gnu.org> References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <5128BF53.80402@yandex.ru> X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: Eli Zaretskii 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: -1.2 (-) > Date: Sat, 23 Feb 2013 17:08:35 +0400 > From: Dmitry Gutov > CC: 13791@debbugs.gnu.org > > If the value of `scroll-conservatively' is positive, the window is > scrolled, otherwise it's recentered. This is not true, because if scroll-conservatively is below 101, the window could still be recentered. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 13:10:27 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 18:10:27 +0000 Received: from localhost ([127.0.0.1]:45973 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9JYJ-0006R6-1X for submit@debbugs.gnu.org; Sat, 23 Feb 2013 13:10:27 -0500 Received: from mail-la0-f43.google.com ([209.85.215.43]:61920) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9JYH-0006Qv-9d for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 13:10:26 -0500 Received: by mail-la0-f43.google.com with SMTP id ek20so1553749lab.30 for <13791@debbugs.gnu.org>; Sat, 23 Feb 2013 10:08:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:message-id:date:from:user-agent:mime-version:to :cc:subject:references:in-reply-to:content-type :content-transfer-encoding; bh=9qD/F4c1H79kKGySkolTLee1hBUuT54k8UG0MGrs+q8=; b=ArmuWx5OapM7oErzrlB/vG8BYay3ij81Gj5lkarS49lfBo0dG+vNZeeA2Du7lUuCp6 1fbv2wmMBkOgCvdvCk1udkJBR393LTQ4WHRV+BHRFFOTILms8rJ+E5+mH/BisvewPgJM 2o2WqxXIAbE88uONGxSwbf6PewlqCzIwAt250acWJYbRzJ/cDG04gRE2t5l5eubRoUw6 ncm5xX4swmpNHwyzg7up1DeHKehArg6iExZP/vZFXKF9FybgjiZy8sWOpejXSswXWZMa 9c08YNms0B7YldSUhmcLSkbsDw8b6hiV7wRm9RrsuFqPTYgU1iU8ARsd+pSwjEhii51R 2Ibw== X-Received: by 10.152.148.195 with SMTP id tu3mr5215478lab.27.1361642935066; Sat, 23 Feb 2013 10:08:55 -0800 (PST) Received: from [127.0.0.1] ([178.252.98.87]) by mx.google.com with ESMTPS id gm20sm3503486lab.7.2013.02.23.10.08.53 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 23 Feb 2013 10:08:54 -0800 (PST) Message-ID: <512905B8.7020704@yandex.ru> Date: Sat, 23 Feb 2013 22:08:56 +0400 From: Dmitry Gutov User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130215 Thunderbird/17.0.3 MIME-Version: 1.0 To: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <5128BF53.80402@yandex.ru> <83a9qvkrta.fsf@gnu.org> In-Reply-To: <83a9qvkrta.fsf@gnu.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@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: -2.6 (--) On 23.02.2013 18:50, Eli Zaretskii wrote: >> Date: Sat, 23 Feb 2013 17:08:35 +0400 >> From: Dmitry Gutov >> CC: 13791@debbugs.gnu.org >> >> If the value of `scroll-conservatively' is positive, the window is >> scrolled, otherwise it's recentered. > > This is not true, because if scroll-conservatively is below 101, the > window could still be recentered. Like I said, you can adjust the description with how things actually work. But I'm not sure we're talking about the same thing. I meant to describe what will happen to the window when point "gets within this many lines of the top or bottom of the window", not when it moves outside the visible area. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 13:49:07 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 18:49:07 +0000 Received: from localhost ([127.0.0.1]:45999 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9K9i-0007IA-Tm for submit@debbugs.gnu.org; Sat, 23 Feb 2013 13:49:07 -0500 Received: from mtaout20.012.net.il ([80.179.55.166]:48698) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9K9h-0007I3-25 for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 13:49:06 -0500 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MIO00500S14UQ00@a-mtaout20.012.net.il> for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 20:47:30 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIO0052QS76JC90@a-mtaout20.012.net.il>; Sat, 23 Feb 2013 20:47:30 +0200 (IST) Date: Sat, 23 Feb 2013 20:47:18 +0200 From: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" In-reply-to: <512905B8.7020704@yandex.ru> X-012-Sender: halo1@inter.net.il To: Dmitry Gutov Message-id: <834nh2lvex.fsf@gnu.org> References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <5128BF53.80402@yandex.ru> <83a9qvkrta.fsf@gnu.org> <512905B8.7020704@yandex.ru> X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: Eli Zaretskii 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.2 (/) > Date: Sat, 23 Feb 2013 22:08:56 +0400 > From: Dmitry Gutov > CC: 13791@debbugs.gnu.org > > But I'm not sure we're talking about the same thing. I think we are. > I meant to describe what will happen to the window when point "gets > within this many lines of the top or bottom of the window", not when > it moves outside the visible area. That's how I understood it. But if you lean on the up or down key, you can easily cause point go off the screen before Emacs enters redisplay. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 14:21:04 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 19:21:04 +0000 Received: from localhost ([127.0.0.1]:46066 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9Ked-0000X5-QV for submit@debbugs.gnu.org; Sat, 23 Feb 2013 14:21:04 -0500 Received: from mail-lb0-f179.google.com ([209.85.217.179]:33284) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9Keb-0000Wg-3R for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 14:21:02 -0500 Received: by mail-lb0-f179.google.com with SMTP id j14so1340908lbo.38 for <13791@debbugs.gnu.org>; Sat, 23 Feb 2013 11:19:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:message-id:date:from:user-agent:mime-version:to :cc:subject:references:in-reply-to:content-type :content-transfer-encoding; bh=EkCfhXWj158oyYQxz1/TwJ4BgffYUwzXfGvmqYMWrfw=; b=xHPeuylugUte2wwFtyJIEpePerLznpB8ViPEQSIKAqVU0vnaCQff7+afPmZ9cO+S1P VPyCYp56KNzov1quhPQGiRjk00QZ8tDjwwklu0T49jkZBWXy5cNI6njoJM2aD3A1aVoT xIvAzhE9+HEWijPjrm5gR6x2Ug6JBGXOR/YE4p9nXOxO/QWy4cJ4V7B3mUVNx3w0YJGa DGsEUe8yP/FLZMXWW3MwSx9JfGCccEg79+y7E7jvL9F1pfJNTiSV6FxfrGxY4bFHDNiv 1KjhAUxE9UuETt8i+qOqU1g6Wjtv+VH5pKXjDT5CPo2mRyXJlaoKpXVP/xPp/McS2Jxu W1qA== X-Received: by 10.112.104.103 with SMTP id gd7mr2499294lbb.54.1361647170670; Sat, 23 Feb 2013 11:19:30 -0800 (PST) Received: from [127.0.0.1] ([178.252.98.87]) by mx.google.com with ESMTPS id oy10sm3604478lab.8.2013.02.23.11.19.28 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 23 Feb 2013 11:19:29 -0800 (PST) Message-ID: <51291644.3010407@yandex.ru> Date: Sat, 23 Feb 2013 23:19:32 +0400 From: Dmitry Gutov User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130215 Thunderbird/17.0.3 MIME-Version: 1.0 To: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <5128BF53.80402@yandex.ru> <83a9qvkrta.fsf@gnu.org> <512905B8.7020704@yandex.ru> <834nh2lvex.fsf@gnu.org> In-Reply-To: <834nh2lvex.fsf@gnu.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@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: -2.6 (--) On 23.02.2013 22:47, Eli Zaretskii wrote: >> Date: Sat, 23 Feb 2013 22:08:56 +0400 >> From: Dmitry Gutov >> CC: 13791@debbugs.gnu.org >> >> But I'm not sure we're talking about the same thing. > > I think we are. > >> I meant to describe what will happen to the window when point "gets >> within this many lines of the top or bottom of the window", not when >> it moves outside the visible area. > > That's how I understood it. But if you lean on the up or down key, > you can easily cause point go off the screen before Emacs enters > redisplay. Yes, but in this case point is not "within this many lines of the top or bottom of the window" anymore technically. Or maybe it is, if you interpret "top" and "bottom" as just buffer lines and "gets within" as "within absolute distance". In this case we can additionally qualify the conditions: "whenever point gets within this many lines of the top or bottom of the window without going off screen." Either way, this description is more accurate than what we have currently. Alternatively, we can mention the "off screen" situation in the second paragraph, where the values of `scroll-conservatively' are considered. From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 23 15:22:52 2013 Received: (at 13791) by debbugs.gnu.org; 23 Feb 2013 20:22:52 +0000 Received: from localhost ([127.0.0.1]:46097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9LcS-0001x6-HD for submit@debbugs.gnu.org; Sat, 23 Feb 2013 15:22:52 -0500 Received: from mtaout20.012.net.il ([80.179.55.166]:38415) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9LcP-0001wx-K2 for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 15:22:50 -0500 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MIO00600WD0P400@a-mtaout20.012.net.il> for 13791@debbugs.gnu.org; Sat, 23 Feb 2013 22:20:09 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIO0066LWHKEC90@a-mtaout20.012.net.il>; Sat, 23 Feb 2013 22:20:08 +0200 (IST) Date: Sat, 23 Feb 2013 22:19:56 +0200 From: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" In-reply-to: <51291644.3010407@yandex.ru> X-012-Sender: halo1@inter.net.il To: Dmitry Gutov Message-id: <83vc9ikck3.fsf@gnu.org> References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <5128BF53.80402@yandex.ru> <83a9qvkrta.fsf@gnu.org> <512905B8.7020704@yandex.ru> <834nh2lvex.fsf@gnu.org> <51291644.3010407@yandex.ru> X-Spam-Score: 0.7 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: Eli Zaretskii 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.2 (/) > Date: Sat, 23 Feb 2013 23:19:32 +0400 > From: Dmitry Gutov > CC: 13791@debbugs.gnu.org > > On 23.02.2013 22:47, Eli Zaretskii wrote: > >> Date: Sat, 23 Feb 2013 22:08:56 +0400 > >> From: Dmitry Gutov > >> CC: 13791@debbugs.gnu.org > >> > >> But I'm not sure we're talking about the same thing. > > > > I think we are. > > > >> I meant to describe what will happen to the window when point "gets > >> within this many lines of the top or bottom of the window", not when > >> it moves outside the visible area. > > > > That's how I understood it. But if you lean on the up or down key, > > you can easily cause point go off the screen before Emacs enters > > redisplay. > > Yes, but in this case point is not "within this many lines of the top or > bottom of the window" anymore technically. "Within this many lines of top" actually means higher than top + this many lines (and similarly for bottom). From debbugs-submit-bounces@debbugs.gnu.org Mon Jan 29 18:28:34 2018 Received: (at 13791) by debbugs.gnu.org; 29 Jan 2018 23:28:34 +0000 Received: from localhost ([127.0.0.1]:48352 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1egIqn-00025R-SK for submit@debbugs.gnu.org; Mon, 29 Jan 2018 18:28:34 -0500 Received: from mail-it0-f50.google.com ([209.85.214.50]:32982) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1egIqm-00025F-PI for 13791@debbugs.gnu.org; Mon, 29 Jan 2018 18:28:33 -0500 Received: by mail-it0-f50.google.com with SMTP id u12so813260ite.0 for <13791@debbugs.gnu.org>; Mon, 29 Jan 2018 15:28:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=zong12UeU/Os1G2wfWd5rcUmnsqt17wjOOJCmU0R25A=; b=IuBqcMVOFzXHf7tVwlEl0B0ukS/XqdDR6FQDXru8mzx5KuN8lbWva6Zp7TCHCzyKfC JXan8iZcqLtVIVhta+2h89PNJwnOa49nAijrXN6touoUHjAizNp2bd6MIBbQ6kCKvulG yhADsohH8M6j45ro7+mykoPx7AKl5FDwrkSambugppZtUYl4rmYvCPqEUtlNlg/ekqBu stTJpJ0qNhw4zmOpHO6aA4DTZ80hRNsykgOPGPVqshRAvtgsCmL6UD1I3BmL8vij6D4b +qoytF0/GBF4T3/jjslK0lhpkf4QCxz49LrY628IZVRN7mbZTMwiSHNPuvfO5s7QGW55 K/iQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=zong12UeU/Os1G2wfWd5rcUmnsqt17wjOOJCmU0R25A=; b=jXeaM955UPfw2YG5c6AzZ32a+/SXIhBCE1smZ+Hs/KygoOHTDJgHlGACaw2af5t9Fr GxDz9tAZ5LU/MogqnZQJvoSLDn/HSw1Po+gEhMM5SAXQWWX652k4ZpguZ2ajheaiJfs+ TV6FuTMO5Gns/1E4cdCk+eDtotMkO6dkaT05SVT0OTXmP/+aKU7WhUKUksPuo3I2ZGQA WPaCibf0fRFBrSsuXluA4wCKYs7PatfKD/eGUpSIEAFQsRJM2KgnGqwCvtRqZ8is4i4/ RVjFEPuNsVvSqQPBJehkC6tgLEQK2sKIH8SnumvocPprqgnx13+e3M1izp6k1TPApYVJ qqvg== X-Gm-Message-State: AKwxytfA0teQO62/p1Zuu6O5bYTNbEzSiMtSD424yqSsq6APxpuInWgf SXb4Mi+XteZjZb9DnpUVz2hdBg== X-Google-Smtp-Source: AH8x226Ksr5FhqxYN2Wlq6CtQCmHaLO0dcQkDfJgqdEJDiICpNFEYoN+efe4j3SiA+aZ2tV7smOfOw== X-Received: by 10.36.87.83 with SMTP id u80mr30299406ita.140.1517268507086; Mon, 29 Jan 2018 15:28:27 -0800 (PST) Received: from zebian ([45.2.119.34]) by smtp.googlemail.com with ESMTPSA id s70sm406340itb.0.2018.01.29.15.28.25 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 29 Jan 2018 15:28:26 -0800 (PST) From: Noam Postavsky To: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> Date: Mon, 29 Jan 2018 18:28:24 -0500 In-Reply-To: <83hal3l4ez.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 23 Feb 2013 12:18:12 +0200") Message-ID: <87shaoi6sn.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.2 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org, Dmitry Gutov X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.2 (/) Eli Zaretskii writes: >> From: Dmitry Gutov >> Date: Sat, 23 Feb 2013 04:21:24 +0400 >> >> The docstring says: "Recenter the window whenever point gets within this >> many lines of the top or bottom of the window." >> >> That's not entirely accurate. Depending on the value of >> `scroll-conservatively', the window may get scrolled instead. > > That's true. However, how to describe this in a manner that will not > confuse the reader is less clear. "Recenter or scroll" is not very > useful, IMO, as it doesn't say which will happen. Suggestions are > welcome. Can't we just add a sentence? "Depending the value of `scroll-conservatively', the window may be scrolled instead of recentered." The details in `scroll-conservatively's docstring should give sufficient accuracy. From debbugs-submit-bounces@debbugs.gnu.org Tue Jan 30 08:56:28 2018 Received: (at 13791) by debbugs.gnu.org; 30 Jan 2018 13:56:29 +0000 Received: from localhost ([127.0.0.1]:48688 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1egWOi-0001M0-N7 for submit@debbugs.gnu.org; Tue, 30 Jan 2018 08:56:28 -0500 Received: from eggs.gnu.org ([208.118.235.92]:42721) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1egWOh-0001Ln-DB for 13791@debbugs.gnu.org; Tue, 30 Jan 2018 08:56:27 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1egWOU-0002Yu-LY for 13791@debbugs.gnu.org; Tue, 30 Jan 2018 08:56:22 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60181) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1egWOU-0002Yo-HX; Tue, 30 Jan 2018 08:56:14 -0500 Received: from [176.228.60.248] (port=2914 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1egWOT-0007tG-UW; Tue, 30 Jan 2018 08:56:14 -0500 Date: Tue, 30 Jan 2018 15:56:24 +0200 Message-Id: <83h8r3h2lz.fsf@gnu.org> From: Eli Zaretskii To: Noam Postavsky In-reply-to: <87shaoi6sn.fsf@users.sourceforge.net> (message from Noam Postavsky on Mon, 29 Jan 2018 18:28:24 -0500) Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <87shaoi6sn.fsf@users.sourceforge.net> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org, dgutov@yandex.ru X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Noam Postavsky > Cc: Dmitry Gutov , 13791@debbugs.gnu.org > Date: Mon, 29 Jan 2018 18:28:24 -0500 > > Eli Zaretskii writes: > > >> From: Dmitry Gutov > >> Date: Sat, 23 Feb 2013 04:21:24 +0400 > >> > >> The docstring says: "Recenter the window whenever point gets within this > >> many lines of the top or bottom of the window." > >> > >> That's not entirely accurate. Depending on the value of > >> `scroll-conservatively', the window may get scrolled instead. > > > > That's true. However, how to describe this in a manner that will not > > confuse the reader is less clear. "Recenter or scroll" is not very > > useful, IMO, as it doesn't say which will happen. Suggestions are > > welcome. > > Can't we just add a sentence? "Depending the value of > `scroll-conservatively', the window may be scrolled instead of > recentered." The details in `scroll-conservatively's docstring should > give sufficient accuracy. It's not just scroll-conservatively, AFAIR. I actually like what the manual says better: The variable ‘scroll-margin’ restricts how close point can come to the top or bottom of a window (even if aggressive scrolling specifies a fraction F that is larger than the window portion between the top and the bottom margins). Its value is a number of screen lines; if point comes within that many lines of the top or bottom of the window, Emacs performs automatic scrolling. Note the last sentence: it leaves the exact manner of scrolling vague. Would it be okay to say the same in the doc string? From debbugs-submit-bounces@debbugs.gnu.org Tue Jan 30 22:42:30 2018 Received: (at 13791) by debbugs.gnu.org; 31 Jan 2018 03:42:31 +0000 Received: from localhost ([127.0.0.1]:50155 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1egjI6-0003oJ-Jo for submit@debbugs.gnu.org; Tue, 30 Jan 2018 22:42:30 -0500 Received: from mail-it0-f48.google.com ([209.85.214.48]:52105) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1egjI5-0003o0-Af; Tue, 30 Jan 2018 22:42:29 -0500 Received: by mail-it0-f48.google.com with SMTP id p139so3545523itb.1; Tue, 30 Jan 2018 19:42:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=MomDel+TM7r/1ttgzGONUXFFQA+azBunSSrTOt6Lv0M=; b=klUzCIJYWqFgX74N4dk71TDGv1CAXaBlq6siV030tW5eYcDWhvbV9PQMj8wgB/GDJn Q5PXiGgUye5qr2VKSIvHnntyjw4pkjG5HvBhK81JIGGRpJi9ouRxgSKMEpPfpCPmTilS S2iSlp+dDjnayyq1Rhrvy+UDROIMfBHJwdCeZeCdDNpNXE4DqGqPosk7+6UTpQvUJ5zT wJq5LfzFYG4fGvfHdES3qnN41i0zch1W4c5Lsns7gOE8Kv77qqqYY3CVACskakYvRA+s +hJN9VSUy0HCAu1//8nWXkEecXipwg+BHPbWrg0D2cVqXGIzh7t6amED3a7JQh+600Wv dIMw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version :content-transfer-encoding; bh=MomDel+TM7r/1ttgzGONUXFFQA+azBunSSrTOt6Lv0M=; b=KHhe6LBiHKYygqOQxPCgyllZXvpySW66XwUBiAzJ1617KD0q2Q8pe4nAPj5Itsu1su 7hq7bGfWSLV5EeQpCul3rXBbLpkWExPld0GXdLKQ4FGOd7Hrbo03pzitq7IImudcB3aM RWG/a+VGR/NccmDM0BZ8dcgsBd13usU7XLsjgcGD6r2mQzOS3iuujaWy0oKcbWKqm2Mj eTrIWI1t5mmj4M1chEUx5uAdLRSvneMUwXlzFfayeUHABg+93zxEw5qkB0zliu5W/Opl d7CreJhpx5BeOsMCi2MDJspk9d4YS9F8kIWwlYL+gprHszDjqJKnTESaURKBvlUNEvtr 0+DQ== X-Gm-Message-State: AKwxytdiBvvlOmOYNaMbvk13kM/C7/ZG2ieHBbpRNe3668ednyOHNbqp 2qDmMS0dqWgmowKj/T5uKnPrmw== X-Google-Smtp-Source: AH8x226jnvld/1Je7AenWRWL8e9enFC9A4lcqKGeWe36cmRdmD1ZuYTCbHO7bVS+EOYGYRg1+YU4dA== X-Received: by 10.36.240.72 with SMTP id p8mr11439921iti.104.1517370143706; Tue, 30 Jan 2018 19:42:23 -0800 (PST) Received: from zebian ([45.2.119.34]) by smtp.googlemail.com with ESMTPSA id c9sm6675792iod.5.2018.01.30.19.42.22 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 30 Jan 2018 19:42:22 -0800 (PST) From: Noam Postavsky To: Eli Zaretskii Subject: Re: bug#13791: 24.3.50; scroll-margin docstring says "recenter" References: <87y5efj2wr.fsf@yandex.ru> <83hal3l4ez.fsf@gnu.org> <87shaoi6sn.fsf@users.sourceforge.net> <83h8r3h2lz.fsf@gnu.org> Date: Tue, 30 Jan 2018 22:42:21 -0500 In-Reply-To: <83h8r3h2lz.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 30 Jan 2018 15:56:24 +0200") Message-ID: <87shamhexu.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 13791 Cc: 13791@debbugs.gnu.org, dgutov@yandex.ru X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.5 (/) tags 13791 fixed close 13791 26.1 quit Eli Zaretskii writes: > It's not just scroll-conservatively, AFAIR. > > I actually like what the manual says better: > > The variable =E2=80=98scroll-margin=E2=80=99 restricts how close poi= nt can come to > the top or bottom of a window (even if aggressive scrolling specifies a > fraction F that is larger than the window portion between the top and > the bottom margins). Its value is a number of screen lines; if point > comes within that many lines of the top or bottom of the window, Emacs > performs automatic scrolling. > > Note the last sentence: it leaves the exact manner of scrolling vague. > > Would it be okay to say the same in the doc string? Makes sense, I added a similar note, with a link to the auto scrolling manual page in emacs-26. [1: db6564cde0]: 2018-01-30 22:29:13 -0500 Fix scroll-margin docstring (Bug#13791) https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=3Ddb6564cde0a90013= 11c38600d61f503e9d32bf0b From unknown Thu Jun 19 14:03:27 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 28 Feb 2018 12:24:05 +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