--- Begin Message ---
Subject: |
[PATCH] Explain negative NABS in `goto-history-element'. |
Date: |
Fri, 01 Nov 2019 18:08:38 -0700 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) |
* 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
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#38026: [PATCH] Explain negative NABS in `goto-history-element'. |
Date: |
Sat, 09 Nov 2019 11:46:04 +0200 |
> Cc: address@hidden
> From: Hong Xu <address@hidden>
> Date: Sat, 2 Nov 2019 22:11:53 -0700
>
> > So I think the text needs not reference minibuffer-default, but
> > instead talk about "future history", like the Emacs manual does.
> >
>
> Thanks. Sounds like a good idea. I've attached an update.
Thanks, I pushed this, but please see how I fixed the log message, and
also the additional fixes in my following commit. In particular,
please always mention the bug number in the commit log message.
--- End Message ---