Variable: completion-auto-select

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

Value

nil

Documentation

Non-nil means to automatically select 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 switch to 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
  "Non-nil means to automatically select 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
switch to 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)