changeset 38158:a137fb27df08

Deprecate use of the INITIAL argument for completing-read.
author Richard M. Stallman <rms@gnu.org>
date Sat, 23 Jun 2001 16:06:49 +0000
parents b40aa3cc20cf
children 4c01e54e2ffd
files lispref/minibuf.texi
diffstat 1 files changed, 5 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- 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}