Mercurial > emacs
comparison lispref/minibuf.texi @ 70937:5817e6ec700c
(Text from Minibuffer): Undocument keep-all.
author | Juri Linkov <juri@jurta.org> |
---|---|
date | Thu, 25 May 2006 22:57:50 +0000 |
parents | c7b7ef478a35 |
children | f9586be49e8e |
comparison
equal
deleted
inserted
replaced
70936:83ce2ddffd16 | 70937:5817e6ec700c |
---|---|
108 In most cases, you should not call minibuffer input functions in the | 108 In most cases, you should not call minibuffer input functions in the |
109 middle of a Lisp function. Instead, do all minibuffer input as part of | 109 middle of a Lisp function. Instead, do all minibuffer input as part of |
110 reading the arguments for a command, in the @code{interactive} | 110 reading the arguments for a command, in the @code{interactive} |
111 specification. @xref{Defining Commands}. | 111 specification. @xref{Defining Commands}. |
112 | 112 |
113 @defun read-from-minibuffer prompt-string &optional initial-contents keymap read hist default inherit-input-method keep-all | 113 @defun read-from-minibuffer prompt-string &optional initial-contents keymap read hist default inherit-input-method |
114 This function is the most general way to get input through the | 114 This function is the most general way to get input through the |
115 minibuffer. By default, it accepts arbitrary text and returns it as a | 115 minibuffer. By default, it accepts arbitrary text and returns it as a |
116 string; however, if @var{read} is non-@code{nil}, then it uses | 116 string; however, if @var{read} is non-@code{nil}, then it uses |
117 @code{read} to convert the text into a Lisp object (@pxref{Input | 117 @code{read} to convert the text into a Lisp object (@pxref{Input |
118 Functions}). | 118 Functions}). |
160 minibuffer inherits the current input method (@pxref{Input Methods}) and | 160 minibuffer inherits the current input method (@pxref{Input Methods}) and |
161 the setting of @code{enable-multibyte-characters} (@pxref{Text | 161 the setting of @code{enable-multibyte-characters} (@pxref{Text |
162 Representations}) from whichever buffer was current before entering the | 162 Representations}) from whichever buffer was current before entering the |
163 minibuffer. | 163 minibuffer. |
164 | 164 |
165 If @var{keep-all} is non-@code{nil}, even empty and duplicate inputs | |
166 are added to the history list. | |
167 | |
168 Use of @var{initial-contents} is mostly deprecated; we recommend using | 165 Use of @var{initial-contents} is mostly deprecated; we recommend using |
169 a non-@code{nil} value only in conjunction with specifying a cons cell | 166 a non-@code{nil} value only in conjunction with specifying a cons cell |
170 for @var{hist}. @xref{Initial Input}. | 167 for @var{hist}. @xref{Initial Input}. |
171 @end defun | 168 @end defun |
172 | 169 |