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'.

1 files changed, 8 insertions, 5 deletions

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