From ab414c5661cc4db23f05f017ef81add2e502171f Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 25 Mar 2022 15:39:44 +0300 Subject: Improve documentation of 'completion-auto-select' * lisp/simple.el (completion-auto-select): * doc/emacs/mini.texi (Completion Options): Improve documentation and description of customization options of 'completion-auto-select'. --- doc/emacs/mini.texi | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'doc/emacs') diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi index dd78262aeb8..eeb87972cc3 100644 --- a/doc/emacs/mini.texi +++ b/doc/emacs/mini.texi @@ -643,11 +643,14 @@ completion list buffer, and like @code{always} when it decides whether to pop it down. @vindex completion-auto-select - The completions window can be automatically selected. To enable -this behavior, customize the user option @code{completion-auto-select} -to @code{t} and pressing @key{TAB} will switch to the completion list -buffer when it pops up that buffer. If the value is -@code{second-tab}, then the first @key{TAB} will pop up the + Emacs can optionally select the window showing the completions when +it shows that window. To enable this behavior, customize the user +option @code{completion-auto-select} to @code{t}, which changes the +behavior of @key{TAB} when Emacs pops up the completions: pressing +@kbd{@key{TAB}} will switch to the completion list buffer, and you can +then move to a candidate by cursor motion commands and select it with +@kbd{@key{RET}}. If the value of @code{completion-auto-select} is +@code{second-tab}, then the first @kbd{@key{TAB}} will pop up the completions list buffer, and the second one will switch to it. @vindex completion-cycle-threshold -- cgit v1.2.3