Mercurial > emacs
diff lispref/minibuf.texi @ 22138:d4ac295a98b3
*** empty log message ***
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Tue, 19 May 1998 03:45:57 +0000 |
parents | 90da2489c498 |
children | 40089afa2b1d |
line wrap: on
line diff
--- a/lispref/minibuf.texi Tue May 19 03:41:25 1998 +0000 +++ b/lispref/minibuf.texi Tue May 19 03:45:57 1998 +0000 @@ -90,8 +90,8 @@ In most cases, you should not call minibuffer input functions in the middle of a Lisp function. Instead, do all minibuffer input as part of -reading the arguments for a command, in the @code{interactive} spec. -@xref{Defining Commands}. +reading the arguments for a command, in the @code{interactive} +specification. @xref{Defining Commands}. @defun read-from-minibuffer prompt-string &optional initial-contents keymap read hist default inherit-input-method This function is the most general way to get input through the @@ -115,7 +115,7 @@ through the history commands. It should be a string, or @code{nil}. If @var{read} is non-@code{nil}, then @var{default} is also used as the input to @code{read}, if the user enters empty input. However, in the -usual case (where @var{read} is @code{nil}, @code{read-from-minibuffer} +usual case (where @var{read} is @code{nil}), @code{read-from-minibuffer} does not return @var{default} when the user enters empty input; it returns an empty string, @code{""}. In this respect, it is different from all the other minibuffer input functions in this chapter. @@ -136,9 +136,10 @@ properties are stripped when the value is returned. If the argument @var{inherit-input-method} is non-@code{nil}, then the -minibuffer inherits the current input method and the setting of -@code{enable-multibyte-characters} from whichever buffer was current -before entering the minibuffer. +minibuffer inherits the current buffer's input method (@pxref{Input +Methods}) and the setting of @code{enable-multibyte-characters} +(@pxref{Text Representations}) from whichever buffer was current before +entering the minibuffer. If @var{initial-contents} is a string, @code{read-from-minibuffer} inserts it into the minibuffer, leaving point at the end, before the @@ -425,7 +426,12 @@ @end defvar @defvar file-name-history -A history list for file name arguments. +A history list for file-name arguments. +@end defvar + +@defvar buffer-name-history +@tindex buffer-name-history +A history list for buffer-name arguments. @end defvar @defvar regexp-history @@ -673,10 +679,10 @@ In most cases, we recommend using @var{default}, and not @var{initial}. If the argument @var{inherit-input-method} is non-@code{nil}, then the -minibuffer inherits the current input method and the setting of -@code{enable-multibyte-characters} from whichever buffer was current -before entering the minibuffer. @xref{Input Methods,,, emacs, The GNU -Emacs Manual}. +minibuffer inherits the current buffer's input method (@pxref{Input +Methods}) and the setting of @code{enable-multibyte-characters} +(@pxref{Text Representations}) from whichever buffer was current before +entering the minibuffer. Completion ignores case when comparing the input against the possible matches, if the built-in variable @code{completion-ignore-case} is @@ -853,8 +859,8 @@ In most cases, you should not call these functions in the middle of a Lisp function. When possible, do all minibuffer input as part of -reading the arguments for a command, in the @code{interactive} spec. -@xref{Defining Commands}. +reading the arguments for a command, in the @code{interactive} +specification. @xref{Defining Commands}. @defun read-buffer prompt &optional default existing This function reads the name of a buffer and returns it as a string. @@ -1412,8 +1418,8 @@ This function is useful for reading passwords. +@defun read-password prompt default @tindex read-password -@defun read-password prompt default This function reads a password, echoing @samp{.} in the echo area for each character entered, and returns it as a string. It prompts with @var{prompt}, and returns @var{default} if the user enters the