Mercurial > emacs
comparison lispref/minibuf.texi @ 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 | d2e5f1b7d8e2 |
| children | 4c01e54e2ffd |
comparison
equal
deleted
inserted
replaced
| 38157:b40aa3cc20cf | 38158:a137fb27df08 |
|---|---|
| 695 If @var{initial} is non-@code{nil}, @code{completing-read} inserts it | 695 If @var{initial} is non-@code{nil}, @code{completing-read} inserts it |
| 696 into the minibuffer as part of the input. Then it allows the user to | 696 into the minibuffer as part of the input. Then it allows the user to |
| 697 edit the input, providing several commands to attempt completion. | 697 edit the input, providing several commands to attempt completion. |
| 698 In most cases, we recommend using @var{default}, and not @var{initial}. | 698 In most cases, we recommend using @var{default}, and not @var{initial}. |
| 699 | 699 |
| 700 @strong{We discourage use of a non-@code{nil} value for | |
| 701 @var{initial}}, because it is an intrusive interface. The history | |
| 702 list (which did not exist when we introduced @var{initial}) is a far | |
| 703 more convenient way for the user to get the default and edit it. | |
| 704 | |
| 700 If the argument @var{inherit-input-method} is non-@code{nil}, then the | 705 If the argument @var{inherit-input-method} is non-@code{nil}, then the |
| 701 minibuffer inherits the current input method (@pxref{Input | 706 minibuffer inherits the current input method (@pxref{Input |
| 702 Methods}) and the setting of @code{enable-multibyte-characters} | 707 Methods}) and the setting of @code{enable-multibyte-characters} |
| 703 (@pxref{Text Representations}) from whichever buffer was current before | 708 (@pxref{Text Representations}) from whichever buffer was current before |
| 704 entering the minibuffer. | 709 entering the minibuffer. |