8.4.3 Completion Exit
When a command reads an argument using the minibuffer with
completion, it also controls what happens when you type RET
minibuffer-complete-and-exit) to submit the argument. There
are four types of behavior:
- Strict completion accepts only exact completion matches. Typing
RET exits the minibuffer only if the minibuffer text is an exact
match, or completes to one. Otherwise, Emacs refuses to exit the
minibuffer; instead it tries to complete, and if no completion can be
done it momentarily displays ‘[No match]’ after the minibuffer
text. (You can still leave the minibuffer by typing C-g to
cancel the command.)
An example of a command that uses this behavior is M-x, since it
is meaningless for it to accept a non-existent command name.
- Cautious completion is like strict completion, except RET
exits only if the text is already an exact match. If the text
completes to an exact match, RET performs that completion but
does not exit yet; you must type a second RET to exit.
Cautious completion is used for reading file names for files that must
already exist, for example.
- Permissive completion allows any input; the completion
candidates are just suggestions. Typing RET does not complete,
it just submits the argument as you have entered it.
Permissive completion with confirmation is like permissive
completion, with an exception: if you typed TAB and this
completed the text up to some intermediate state (i.e., one that is not
yet an exact completion match), typing RET right afterward does
not submit the argument. Instead, Emacs asks for confirmation by
momentarily displaying ‘[Confirm]’ after the text; type RET
again to confirm and submit the text. This catches a common mistake,
in which one types RET before realizing that TAB did not
complete as far as desired.
You can tweak the confirmation behavior by customizing the variable
confirm-nonexistent-file-or-buffer. The default value,
after-completion, gives the behavior we have just described.
If you change it to
nil, Emacs does not ask for confirmation,
falling back on permissive completion. If you change it to any other
nil value, Emacs asks for confirmation whether or not the
preceding command was TAB.
This behavior is used by most commands that read file names, like
C-x C-f, and commands that read buffer names, like C-x b.