diff options
Diffstat (limited to 'doc/emacs/mini.texi')
| -rw-r--r-- | doc/emacs/mini.texi | 34 |
1 files changed, 25 insertions, 9 deletions
diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi index f81e64bdf9b..6dcee3fa824 100644 --- a/doc/emacs/mini.texi +++ b/doc/emacs/mini.texi @@ -64,10 +64,10 @@ minibuffer-electric-default-mode}. Since the minibuffer appears in the echo area, it can conflict with other uses of the echo area. If an error message or an informative -message is emitted while the minibuffer is active, the message hides -the minibuffer for a few seconds, or until you type something; then -the minibuffer comes back. While the minibuffer is in use, Emacs does -not echo keystrokes. +message is emitted while the minibuffer is active, the message is +displayed in brackets after the minibuffer text for a few seconds, or +until you type something; then the message disappears. While the +minibuffer is in use, Emacs does not echo keystrokes. @vindex minibuffer-follows-selected-frame While using the minibuffer, you can switch to a different frame, @@ -82,7 +82,9 @@ after a recursive minibuffer has been opened in the current command (@pxref{Recursive Mini,,, elisp}). This option is mainly to retain (approximately) the behavior prior to Emacs 28.1. Note that the effect of the command, when you finally finish using the minibuffer, -always takes place in the frame where you first opened it. +always takes place in the frame where you first opened it. The sole +exception is that when that frame no longer exists, the action takes +place in the currently selected frame. @node Minibuffer File @section Minibuffers for File Names @@ -245,6 +247,9 @@ You might need also to enable @code{minibuffer-depth-indicate-mode} to show the current recursion depth in the minibuffer prompt on recursive use of the minibuffer. + When active, the minibuffer is usually in @code{minibuffer-mode}. +This is an internal Emacs mode without any special features. + @findex minibuffer-inactive-mode When not active, the minibuffer is in @code{minibuffer-inactive-mode}, and clicking @kbd{mouse-1} there shows the @file{*Messages*} buffer. @@ -369,9 +374,9 @@ used with the completion list: @itemx @key{prior} Typing @kbd{M-v}, while in the minibuffer, selects the window showing the completion list (@code{switch-to-completions}). This paves the -way for using the commands below. @key{PageUp} or @key{prior} does -the same. You can also select the window in other ways -(@pxref{Windows}). +way for using the commands below. @key{PageUp}, @key{prior} and +@kbd{M-g M-c} does the same. You can also select the window in other +ways (@pxref{Windows}). @findex choose-completion @item @key{RET} @@ -383,12 +388,14 @@ point (@code{choose-completion}). @findex next-completion @item @key{TAB} @item @key{RIGHT} +@item @key{n} While in the completion list buffer, these keys move point to the following completion alternative (@code{next-completion}). @findex previous-completion @item @key{S-TAB} @item @key{LEFT} +@item @key{p} While in the completion list buffer, these keys move point to the previous completion alternative (@code{previous-completion}). @@ -623,6 +630,14 @@ in a cyclic manner. If you give @code{completion-cycle-threshold} a numeric value @var{n}, completion commands switch to this cycling behavior only when there are @var{n} or fewer alternatives. +@vindex completions-format + When displaying completions, Emacs will normally pop up a new buffer +to display the completions. The completions will (by default) be +sorted in columns horizontally in alphabetical order, but this can be +changed by changing the @code{completions-format} user option. If +@code{vertical}, sort the completions vertically in columns instead, +and if @code{one-column}, just use a single column. + @node Minibuffer History @section Minibuffer History @cindex minibuffer history @@ -800,6 +815,7 @@ can re-execute a command by calling @code{eval} with the @node Passwords @section Entering passwords +@cindex entering passwords Sometimes, you may need to enter a password into Emacs. For instance, when you tell Emacs to visit a file on another machine via a network @@ -810,7 +826,7 @@ access to the machine (@pxref{Remote Files}). displays a prompt in the echo area (such as @samp{Password: }); after you type the required password, press @key{RET} to submit it. To prevent others from seeing your password, every character you type is -displayed as a dot (@samp{.}) instead of its usual form. +displayed as an asterisk (@samp{*}) instead of its usual form. Most of the features and commands associated with the minibuffer @emph{cannot} be used when entering a password. There is no history |