# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 993312409 0
# Node ID a137fb27df08df592a7e014a6f16927aa0e12de0
# Parent  b40aa3cc20cff7c061d1aa5d5ea32b58ae358c5b
Deprecate use of the INITIAL argument for completing-read.

diff -r b40aa3cc20cf -r a137fb27df08 lispref/minibuf.texi
--- a/lispref/minibuf.texi	Sat Jun 23 07:51:03 2001 +0000
+++ b/lispref/minibuf.texi	Sat Jun 23 16:06:49 2001 +0000
@@ -697,6 +697,11 @@
 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}