Variable: completion-eager-display

completion-eager-display is a customizable variable defined in minibuffer.el.gz.

Value

auto

Documentation

Whether completion commands should display *Completions* buffer eagerly.

If the variable is set to t, completion commands show the *Completions* buffer always immediately. Setting the variable to nil disables the eager *Completions* display for all commands.

For the value auto, completion commands show the *Completions* buffer immediately only if requested by the completion command. Completion tables can request eager display via the eager-display metadata.

See also the variables completion-category-overrides and completion-extra-properties for the eager-display completion metadata.

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

Probably introduced at or before Emacs version 31.1.

Source Code

;; Defined in /usr/src/emacs/lisp/minibuffer.el.gz
(defcustom completion-eager-display 'auto
  "Whether completion commands should display *Completions* buffer eagerly.

If the variable is set to t, completion commands show the *Completions*
buffer always immediately.  Setting the variable to nil disables the
eager *Completions* display for all commands.

For the value `auto', completion commands show the *Completions* buffer
immediately only if requested by the completion command.  Completion
tables can request eager display via the `eager-display' metadata.

See also the variables `completion-category-overrides' and
`completion-extra-properties' for the `eager-display' completion
metadata."
  :type '(choice (const :tag "Never show *Completions* eagerly" nil)
                 (const :tag "Always show *Completions* eagerly" t)
                 (const :tag "If requested by the completion command" auto))
  :version "31.1")