From: Richard M. Stallman <rms@gnu.org>
Date: Sat, 23 Jun 2001 16:06:49 +0000 (+0000)
Subject: Deprecate use of the INITIAL argument for completing-read.
X-Git-Tag: emacs-pretest-21.0.104~177
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=70c750c0e8e54947399245af6c8b49f908c8939c;p=emacs.git

Deprecate use of the INITIAL argument for completing-read.
---

diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi
index 5d8dc146bb6..0f15e02acd2 100644
--- a/lispref/minibuf.texi
+++ b/lispref/minibuf.texi
@@ -697,6 +697,11 @@ into the minibuffer as part of the input.  Then it allows the user to
 edit the input, providing several commands to attempt completion.
 In most cases, we recommend using @var{default}, and not @var{initial}.
 
+@strong{We discourage use of a non-@code{nil} value for
+@var{initial}}, because it is an intrusive interface.  The history
+list (which did not exist when we introduced @var{initial}) is a far
+more convenient way for the user to get the default and edit it.
+
 If the argument @var{inherit-input-method} is non-@code{nil}, then the
 minibuffer inherits the current input method (@pxref{Input
 Methods}) and the setting of @code{enable-multibyte-characters}