Add documentation entries for completion-auto-select user option.feature/completions-customs

2 files changed, 12 insertions, 2 deletions

diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index ff0fa505a8e..181cade80b3 100644
--- a/doc/emacs/mini.texi
+++ b/doc/emacs/mini.texi
@@ -642,6 +642,14 @@ the completion.  The value @code{visible} is a hybrid: it behaves like
 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 pops up the
+completions list buffer and the second one will switch to it.
+
 @vindex completion-cycle-threshold
   If @code{completion-cycle-threshold} is non-@code{nil}, completion
 commands can cycle through completion alternatives.  Normally, if
diff --git a/etc/NEWS b/etc/NEWS
index ad0f7f1c055..d743488b68c 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -575,8 +575,10 @@ value.
 
 *** The "*Completions*" buffer can now be automatically selected.
 To enable this behavior, customize the user option
-'completion-auto-select' to t.  Then pressing 'TAB' will switch to the
-"*Completions*" buffer when it pops up that buffer.
+'completion-auto-select' to t and pressing 'TAB' will switch to the
+"*Completions*" buffer when it pops up that buffer. If the value is
+'second-tab', then the first tab will display "*Completions*" and the
+second one will switch to the "*Completions*" buffer.
 
 *** New user option 'completion-wrap-movement'.
 When non-nil, the commands 'next-completion' and 'previous-completion'