From: Jimmy Aguilar Mena Date: Thu, 24 Mar 2022 10:05:26 +0000 (+0100) Subject: Add documentation entries for completion-auto-select user option. X-Git-Tag: emacs-29.0.90~1931^2~938^2 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=acde5252d37cf241a445da2eca509760727d9df6;p=emacs.git Add documentation entries for completion-auto-select user option. --- 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 d979c625fd3..68eeee69cc3 100644 --- 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'