Function: icomplete-mode

icomplete-mode is an autoloaded, interactive and byte-compiled function defined in icomplete.el.gz.

Signature

(icomplete-mode &optional ARG)

Documentation

Toggle incremental minibuffer completion (Icomplete mode).

When this global minor mode is enabled, typing in the minibuffer continuously displays a list of possible completions that match the string you have typed. See icomplete-completions for a description of how prospective completions are displayed.

For more information, see Info node (emacs)Icomplete. For options you can set, M-x customize-group (customize-group) icomplete.

You can use the following key bindings to navigate and select completions:

       icomplete-ret
C-, icomplete-backward-completions
C-. icomplete-forward-completions
C-M-i icomplete-force-complete
C-j icomplete-force-complete-and-exit

This is a global minor mode. If called interactively, toggle the Icomplete mode mode. If the prefix argument is positive, enable the mode, and if it is zero or negative, disable the mode.

If called from Lisp, toggle the mode if ARG is toggle. Enable the mode if ARG is nil, omitted, or is a positive number. Disable the mode if ARG is a negative number.

To check whether the minor mode is enabled in the current buffer, evaluate (default-value \=icomplete-mode)'.

The mode's hook is called both when the mode is enabled and when it is disabled.

View in manual

Probably introduced at or before Emacs version 19.29.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/icomplete.el.gz
;;;_ > icomplete-mode (&optional prefix)
;;;###autoload
(define-minor-mode icomplete-mode
  "Toggle incremental minibuffer completion (Icomplete mode).

When this global minor mode is enabled, typing in the minibuffer
continuously displays a list of possible completions that match
the string you have typed.  See `icomplete-completions' for a
description of how prospective completions are displayed.

For more information, see Info node `(emacs)Icomplete'.
For options you can set, `\\[customize-group] icomplete'.

You can use the following key bindings to navigate and select
completions:

\\{icomplete-minibuffer-map}"
  :global t
  (remove-hook 'minibuffer-setup-hook #'icomplete-minibuffer-setup)
  (remove-hook 'completion-in-region-mode-hook #'icomplete--in-region-setup)
  (when icomplete-mode
    (fido-mode -1)
    (when icomplete-in-buffer
      (add-hook 'completion-in-region-mode-hook #'icomplete--in-region-setup))
    (add-hook 'minibuffer-setup-hook #'icomplete-minibuffer-setup)))