Improve Completion Example section in the Emacs manual

This can be a useful substitute for full-on fuzzy completion, as
provided by other completion styles and completion packages.
* doc/emacs/mini.texi (Completion Example): Give an example of
completion with point not at end of minibuffer.  Also, use
@kbd{@key{TAB}} when telling the user to hit TAB.  (Bug#62836)
This commit is contained in:
Spencer Baugh 2023-04-18 18:03:36 -04:00 committed by Eli Zaretskii
parent 626e1ac62b
commit ecdd3a9efa

View file

@ -313,19 +313,27 @@ may be defined in your Emacs session. For example, if a command
called @code{authorize-me} was defined, Emacs could only complete called @code{authorize-me} was defined, Emacs could only complete
as far as @samp{aut}.) as far as @samp{aut}.)
If you type @key{TAB} again immediately, it cannot determine the If you type @kbd{@key{TAB}} again immediately, it cannot determine
next character; it could be @samp{-}, @samp{a}, or @samp{c}. So it the next character; it could be @samp{-}, @samp{a}, or @samp{c}. So
does not add any characters; instead, @key{TAB} displays a list of all it does not add any characters; instead, @key{TAB} displays a list of
possible completions in another window. all possible completions in another window.
Next, type @kbd{-f}. The minibuffer now contains @samp{auto-f}, and Next, type @kbd{-f}. The minibuffer now contains @samp{auto-f}, and
the only command name that starts with this is @code{auto-fill-mode}. the only command name that starts with this is @code{auto-fill-mode}.
If you now type @key{TAB}, completion fills in the rest of the If you now type @kbd{@key{TAB}}, completion fills in the rest of the
argument @samp{auto-fill-mode} into the minibuffer. argument @samp{auto-fill-mode} into the minibuffer.
Hence, typing just @kbd{a u @key{TAB} - f @key{TAB}} allows you to Hence, typing just @kbd{a u @key{TAB} - f @key{TAB}} allows you to
enter @samp{auto-fill-mode}. enter @samp{auto-fill-mode}.
@key{TAB} also works while point is not at the end of the
minibuffer. In that case, it will fill in text both at point and at
the end of the minibuffer. If you type @kbd{M-x autocm}, then press
@kbd{C-b} to move point before the @samp{m}, you can type
@kbd{@key{TAB}} to insert the text @samp{onf-} at point and @samp{ode}
at the end of the minibuffer, so that the minibuffer contains
@samp{autoconf-mode}.
@node Completion Commands @node Completion Commands
@subsection Completion Commands @subsection Completion Commands