Add doc for goto-history-element

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

diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index dd51181db00984cd226a2724600ed1c83bcbba25..d5a16014053255ed1ab10aa5a37d51526f74a14b 100644 (file)
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2334,6 +2334,12 @@ This command replaces the minibuffer contents with the value of the
 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 184d4eccdb91832c896e622dcc423af8494bf3ff..fca90690a5f005e835f94736e400185783e99834 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -2128,7 +2128,9 @@ the end of the list of defaults just after the default value."
 
 (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)