From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Hong Xu Newsgroups: gmane.emacs.bugs Subject: bug#38026: [PATCH] Explain negative NABS in `goto-history-element'. Date: Fri, 01 Nov 2019 18:08:38 -0700 Message-ID: <8736f7ccfd.fsf@topbug.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="225017"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: 38026@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 02 02:09:24 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 1iQhuu-000wSu-5x for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Nov 2019 02:09:24 +0100 Original-Received: from localhost ([::1]:44296 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQhus-0005Dd-Mx for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Nov 2019 21:09:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33528) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQhuh-0005DR-J4 for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:09:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iQhuf-0007VL-W4 for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:09:11 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48881) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iQhuf-0007Uj-NN for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:09:09 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iQhue-0004zn-Q5 for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:09:09 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Hong Xu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 02 Nov 2019 01:09:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 38026 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.157265693019166 (code B ref -1); Sat, 02 Nov 2019 01:09:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 2 Nov 2019 01:08:50 +0000 Original-Received: from localhost ([127.0.0.1]:57702 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQhuM-0004z4-3k for submit@debbugs.gnu.org; Fri, 01 Nov 2019 21:08:50 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:45968) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iQhuL-0004yv-1B for submit@debbugs.gnu.org; Fri, 01 Nov 2019 21:08:49 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33337) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQhuJ-0005Cx-3v for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:08:48 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iQhuH-000754-Pw for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:08:46 -0400 Original-Received: from sender4-of-o54.zoho.com ([136.143.188.54]:21458) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iQhuH-0006yy-5W for bug-gnu-emacs@gnu.org; Fri, 01 Nov 2019 21:08:45 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1572656920; cv=none; d=zohomail.com; s=zohoarc; b=KhGpitgCb1ILmK5mvGG3MQBDaNEhihT18zUDy96pd5J0FsJyiGWXdt0+EIuLglBUWVpUBGwBJWHaRQazGkf5M82cY+eGLg1jmnavabF/6KyoL1k6B+Mn9dQM3ogryhSmm7yIeCiKVQPorHS/8rmfXS9WsEIA3DTzin8gv8eDIn4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1572656920; h=Content-Type:Date:From:MIME-Version:Message-ID:Subject:To; bh=uyYuLTnRg3hZZqGJV0Oi4D6ZNqy965PTxv5whFk8kO0=; b=crtAAG5JaN6lZ4OoHfWRS2g36TkVYPeyZ5dOyr2n2QJqGk0SRTwhmTyk7AouTxvgRpCdifeGH368Vnsrg+cxqtQfFPzcgwfeEBE7b3664X2SjZrJ8PyGl/y2yBeWiNPYyZxgG4x/2/ezOUPiqDy895OP2qU+ufQJyH+I+PyiskM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=topbug.net; spf=pass smtp.mailfrom=hong@topbug.net; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1572656920; s=zoho; d=topbug.net; i=hong@topbug.net; h=From:To:Subject:Date:Message-ID:MIME-Version:Content-Type; l=1802; bh=uyYuLTnRg3hZZqGJV0Oi4D6ZNqy965PTxv5whFk8kO0=; b=AJnNz9qDvi7lDyu7/JCzijASO1WGIZ37uW87VbXNE+GeMbL2Q0xF7nA2hkEO/0IF 7An48OhiSE5JZahHbL+LT4Xcqje6POBIttxHS9eaHyRDIzGKIXSEW65Y7xlBInYebCl KJFro3KwMjIJRABZKUSEfX0FnfWhmSlwE1J501SE= Original-Received: from home (69-215-149-151.lightspeed.sntcca.sbcglobal.net [69.215.149.151]) by mx.zohomail.com with SMTPS id 1572656918820630.791776761643; Fri, 1 Nov 2019 18:08:38 -0700 (PDT) X-ZohoMailClient: External X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] 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:170732 Archived-At: * doc/lispref/minibuf.texi (Minibuffer Commands): Explain negative NABS. * lisp/simple.el (goto-history-element): Explain negative NABS. --- doc/lispref/minibuf.texi | 5 +++++ lisp/simple.el | 7 ++++++- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index d36babd69873..a9bb3aec9583 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -2339,6 +2339,11 @@ Minibuffer Commands minibuffer. The argument @var{nabs} specifies the absolute history position in descending order, where 0 means the current element and a positive number @var{n} means the @var{n}th previous element. + +@{nabs} being a negative number @var{n} means the @var{n-1}th element +of @code{minibuffer-default} if it is a list, or otherwise the value +of @code{minibuffer-default}. This is usually an intelligent guess of +what the user intends to input." @end deffn @node Minibuffer Windows diff --git a/lisp/simple.el b/lisp/simple.el index 10aecd651f39..e95e2bc22972 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -2130,7 +2130,12 @@ goto-history-element "Puts element of the minibuffer history in the minibuffer. The argument NABS specifies the absolute history position in descending order, where 0 means the current element and a -positive number N means the Nth previous element." +positive number N means the Nth previous element. + +NABS being a negative number N means the (N-1)th element of +`minibuffer-default' if it is a list, or otherwise the value of +`minibuffer-default'. This is usually an intelligent guess of +what the user intends to input." (interactive "p") (when (and (not minibuffer-default-add-done) (functionp minibuffer-default-add-function) -- 2.20.1