Add documentation entries for completion-auto-select user option.

diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index ff0fa505a8e25be0a8c457d43e7801fd1f510559..181cade80b31ae3b43c9d1752e98d875d6215a76 100644 (file)
--- 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 d979c625fd3110095a2703fbb11cd09456dc9738..68eeee69cc3e980d412fab0ddc3cd2897fc04d2a 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -584,8 +584,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'