GNU bug report logs - #37948
[PATCH] Add doc for goto-history-element.

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 37948 in the body.
You can then email your comments to 37948 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Hong Xu <hong <at> topbug.net>
To: bug-gnu-emacs <at> gnu.org
Subject: [PATCH] Add doc for goto-history-element.
Date: Sun, 27 Oct 2019 13:48:28 -0700

* lisp/simple.el (goto-history-element): Clarify NABS.

* doc/lispref/minibuf.texi (Minibuffer Commands): Add goto-history-element.
---
 doc/lispref/minibuf.texi | 6 ++++++
 lisp/simple.el           | 4 +++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index dd51181db009..d5a160140532 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2334,6 +2334,12 @@ Minibuffer Commands
 contents of the minibuffer before the point.
 @end deffn
 
+@deffn Command goto-history-element nabs
+Puts element of the minibuffer history in the minibuffer.  The
+argument @var{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.
+@end deffn
 
 @node Minibuffer Windows
 @section Minibuffer Windows
diff --git a/lisp/simple.el b/lisp/simple.el
index 5502cd49aa42..fcd271527075 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -2128,7 +2128,9 @@ minibuffer-default-add-completions
 
 (defun goto-history-element (nabs)
   "Puts element of the minibuffer history in the minibuffer.
-The argument NABS specifies the absolute history position."
+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."
   (interactive "p")
   (when (and (not minibuffer-default-add-done)
 	     (functionp minibuffer-default-add-function)
-- 
2.20.1

Message #8 received at 37948 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Hong Xu <hong <at> topbug.net>
Cc: 37948 <at> debbugs.gnu.org
Subject: Re: bug#37948: [PATCH] Add doc for goto-history-element.
Date: Mon, 28 Oct 2019 16:21:15 +0100

Hong Xu <hong <at> topbug.net> writes:

> * lisp/simple.el (goto-history-element): Clarify NABS.
>
> * doc/lispref/minibuf.texi (Minibuffer Commands): Add goto-history-element.

Makes sense; I've now applied this to Emacs 27.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.