From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#38026: [PATCH] Explain negative NABS in `goto-history-element'. Date: Sat, 02 Nov 2019 19:54:14 +0200 Message-ID: <83sgn6i2pl.fsf@gnu.org> References: <8736f7ccfd.fsf@topbug.net> <83h83mk8mw.fsf@gnu.org> <86065fb6-a830-a575-f5c4-7cae336a768d@topbug.net> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="139819"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 38026@debbugs.gnu.org To: Hong Xu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 02 18:55:14 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iQxcH-000a9I-1n for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Nov 2019 18:55:13 +0100 Original-Received: from localhost ([::1]:49608 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQxcF-0003fL-Rv for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Nov 2019 13:55:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50331) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQxc7-0003dQ-Oc for bug-gnu-emacs@gnu.org; Sat, 02 Nov 2019 13:55:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iQxc6-0001Ua-Q5 for bug-gnu-emacs@gnu.org; Sat, 02 Nov 2019 13:55:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52475) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iQxc6-0001Sc-Lh for bug-gnu-emacs@gnu.org; Sat, 02 Nov 2019 13:55:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iQxc6-0002U2-J4 for bug-gnu-emacs@gnu.org; Sat, 02 Nov 2019 13:55:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Nov 2019 17:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 38026 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 38026-submit@debbugs.gnu.org id=B38026.15727172739486 (code B ref 38026); Sat, 02 Nov 2019 17:55:02 +0000 Original-Received: (at 38026) by debbugs.gnu.org; 2 Nov 2019 17:54:33 +0000 Original-Received: from localhost ([127.0.0.1]:33061 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQxbc-0002Sw-MY for submit@debbugs.gnu.org; Sat, 02 Nov 2019 13:54:32 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:41113) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQxba-0002Sh-SV for 38026@debbugs.gnu.org; Sat, 02 Nov 2019 13:54:31 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:58590) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iQxbV-0006Ln-Gb; Sat, 02 Nov 2019 13:54:25 -0400 Original-Received: from [176.228.60.248] (port=4249 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iQxbS-0007m3-Q7; Sat, 02 Nov 2019 13:54:25 -0400 In-reply-to: <86065fb6-a830-a575-f5c4-7cae336a768d@topbug.net> (message from Hong Xu on Sat, 2 Nov 2019 10:07:03 -0700) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:170834 Archived-At: > Cc: 38026@debbugs.gnu.org > From: Hong Xu > Date: Sat, 2 Nov 2019 10:07:03 -0700 > > On 11/2/19 1:03 AM, Eli Zaretskii wrote: > > Thanks, but I don't see how this clarifies the issue. Can you tell > > more about your motivation? > > > > The motivation is to clarify what a negative NABS means. From the current document, it is unclear that NABS can be negative. In that case, the patch is insufficient. First, we don't document minibuffer-default in the manual, so referencing it will leave the reader wondering what it is, and how it is set and used. Second, the doc string of goto-history-element should also explain what is the meaning of negative values. And third, several functions bind minibuffer-default to certain values, and I'm not sure this variable can usefully be documented in a manual. So I think the text needs not reference minibuffer-default, but instead talk about "future history", like the Emacs manual does. Thanks.