Variable: completion-auto-select

completion-auto-select is a customizable variable defined in simple.el.gz.

Value

nil

Documentation

If non-nil, automatically select the window showing the *Completions* buffer.

When the value is t, pressing TAB will switch to the completion list buffer when Emacs pops up a window showing that buffer. If the value is second-tab, then the first TAB will pop up the window showing the completions list buffer, and the next TAB will select that window. See completion-auto-help for controlling when the window showing the completions is popped up and down.

This variable was added, or its default value changed, in Emacs 29.1.

View in manual

Probably introduced at or before Emacs version 29.1.

Source Code

;; Defined in /usr/src/emacs/lisp/simple.el.gz
(defcustom completion-auto-select nil
  "If non-nil, automatically select the window showing the *Completions* buffer.
When the value is t, pressing TAB will switch to the completion list
buffer when Emacs pops up a window showing that buffer.
If the value is `second-tab', then the first TAB will pop up the
window showing the completions list buffer, and the next TAB will
select that window.
See `completion-auto-help' for controlling when the window showing
the completions is popped up and down."
  :type '(choice (const :tag "Don't auto-select completions window" nil)
                 (const :tag "Select completions window on first TAB" t)
                 (const :tag "Select completions window on second TAB"
                        second-tab))
  :version "29.1"
  :group 'completion)