Mercurial > emacs
comparison lispref/minibuf.texi @ 67499:91703011b252
(Completion Commands): Add mention of read-file-name
for filename completion keymaps.
(Reading File Names): Add mention of filename completion keymaps
for read-file-name and xref to `Completion Commands'.
| author | Juri Linkov <juri@jurta.org> |
|---|---|
| date | Sun, 11 Dec 2005 09:56:45 +0000 |
| parents | ba853fd4880c |
| children | 8ae5d2f218aa |
comparison
equal
deleted
inserted
replaced
| 67498:30baecf371f9 | 67499:91703011b252 |
|---|---|
| 1021 with other characters bound as in @code{minibuffer-local-map}. | 1021 with other characters bound as in @code{minibuffer-local-map}. |
| 1022 @end defvar | 1022 @end defvar |
| 1023 | 1023 |
| 1024 @defvar minibuffer-local-filename-completion-map | 1024 @defvar minibuffer-local-filename-completion-map |
| 1025 This is like @code{minibuffer-local-completion-map} | 1025 This is like @code{minibuffer-local-completion-map} |
| 1026 except that it does not bind @key{SPC}. | 1026 except that it does not bind @key{SPC}. This keymap is used by the |
| 1027 function @code{read-file-name}. | |
| 1027 @end defvar | 1028 @end defvar |
| 1028 | 1029 |
| 1029 @defvar minibuffer-local-must-match-filename-map | 1030 @defvar minibuffer-local-must-match-filename-map |
| 1030 This is like @code{minibuffer-local-must-match-map} | 1031 This is like @code{minibuffer-local-must-match-map} |
| 1031 except that it does not bind @key{SPC}. | 1032 except that it does not bind @key{SPC}. This keymap is used by the |
| 1033 function @code{read-file-name}. | |
| 1032 @end defvar | 1034 @end defvar |
| 1033 | 1035 |
| 1034 @node High-Level Completion | 1036 @node High-Level Completion |
| 1035 @subsection High-Level Completion Functions | 1037 @subsection High-Level Completion Functions |
| 1036 | 1038 |
| 1209 valid if possible, and then refuses to exit if it is not valid. If the | 1211 valid if possible, and then refuses to exit if it is not valid. If the |
| 1210 value of @var{existing} is neither @code{nil} nor @code{t}, then | 1212 value of @var{existing} is neither @code{nil} nor @code{t}, then |
| 1211 @key{RET} also requires confirmation after completion. If | 1213 @key{RET} also requires confirmation after completion. If |
| 1212 @var{existing} is @code{nil}, then the name of a nonexistent file is | 1214 @var{existing} is @code{nil}, then the name of a nonexistent file is |
| 1213 acceptable. | 1215 acceptable. |
| 1216 | |
| 1217 The function @code{read-file-name} uses | |
| 1218 @code{minibuffer-local-filename-completion-map} as the keymap if | |
| 1219 @var{existing} is @code{nil}, and uses | |
| 1220 @code{minibuffer-local-must-match-filename-map} if @var{existing} is | |
| 1221 non-@code{nil}. @xref{Completion Commands}. | |
| 1214 | 1222 |
| 1215 The argument @var{directory} specifies the directory to use for | 1223 The argument @var{directory} specifies the directory to use for |
| 1216 completion of relative file names. It should be an absolute directory | 1224 completion of relative file names. It should be an absolute directory |
| 1217 name. If @code{insert-default-directory} is non-@code{nil}, | 1225 name. If @code{insert-default-directory} is non-@code{nil}, |
| 1218 @var{directory} is also inserted in the minibuffer as initial input. | 1226 @var{directory} is also inserted in the minibuffer as initial input. |