procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Mention future history in history-related minibuffer commands

Browse source 
* lisp/simple.el (goto-history-element):
* doc/lispref/minibuf.texi (Minibuffer Commands): Explain
negative NABS.
* lisp/simple.el (next-history-element):
* doc/lispref/minibuf.texi (Minibuffer Commands): Mention
"future history."  (Bug#38026)
This commit is contained in:
Hong Xu 2019-11-01 18:06:44 -07:00 • committed by Eli Zaretskii
parent f8284f1e40
commit 15f4c4156c
2 changed files with 10 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
doc/lispref/minibuf.texi
View file

@ -2307,7 +2307,8 @@ This command replaces the minibuffer contents with the value of the
@deffn Command next-history-element n
This command replaces the minibuffer contents with the value of the
@var{n}th more recent history element.
@var{n}th more recent history element. The position in the history
can go beyond the current position and invoke ``future history.''
@end deffn
@deffn Command previous-matching-history-element pattern n
@ -2338,7 +2339,9 @@ contents of the minibuffer before the point.
This function 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 @var{n} means the @var{n}th previous element.
positive number @var{n} means the @var{n}th previous element. NABS
being a negative number -@var{n} means the @var{n}th entry of ``future
history.''
@end deffn
@node Minibuffer Windows

7
lisp/simple.el
View file

@ -2130,7 +2130,8 @@ the end of the list of defaults just after the default value."
"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 Nth entry of ``future history.''"
(interactive "p")
(when (and (not minibuffer-default-add-done)
(functionp minibuffer-default-add-function)
@ -2187,7 +2188,9 @@ positive number N means the Nth previous element."
(defun next-history-element (n)
"Puts next element of the minibuffer history in the minibuffer.
With argument N, it uses the Nth following element."
With argument N, it uses the Nth following element. The position
in the history can go beyond the current position and invoke
``future history.''"
(interactive "p")
(or (zerop n)
(goto-history-element (- minibuffer-history-position n))))