From: Kim F. Storm <storm@cua.dk>
Date: Tue, 16 May 2006 10:52:14 +0000 (+0000)
Subject: (Minibuffer History): Update add-to-history.
X-Git-Tag: emacs-pretest-22.0.90~2546
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e6966ef0a771f0afe79b22767b3a6ed81dadf252;p=emacs.git

(Minibuffer History): Update add-to-history.
---

diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi
index b5bcc3a77dc..73cc0817d9b 100644
--- a/lispref/minibuf.texi
+++ b/lispref/minibuf.texi
@@ -449,17 +449,20 @@ list, put the length in the @code{history-length} property of the
 history list symbol.  The variable @code{history-delete-duplicates}
 specifies whether to delete duplicates in history.
 
-@defun add-to-history history-var newelt &optional maxelt
-This function adds a new element @var{newelt} to the history list
-stored in the variable @var{history-var}, and returns the updated
-history list.  By default, the list length is limited by the value
-specified by @code{history-length} (described below), but the optional
-argument @var{maxelt} overrides that.  The possible values of
+@defun add-to-history history-var newelt &optional maxelt keep-all
+This function adds a new element @var{newelt}, if non-empty, to the
+history list stored in the variable @var{history-var}, and returns the
+updated history list.  By default, the list length is limited by the
+value specified by @code{history-length} (described below), but the
+optional argument @var{maxelt} overrides that.  The possible values of
 @var{maxelt} have the same meaning as the values of
 @code{history-length}.
 
-Duplicate members are removed from the history list, unless
-@code{history-delete-duplicates} is @code{nil}.
+Duplicate members are removed from the history list, if
+@code{history-delete-duplicates} is non-@code{nil}.
+
+If @var{keep-all} is non-@code{nil}, even an empty or duplicate
+@var{newelt} element is added to the history list.
 @end defun
 
 @defvar history-length