Variable: completion-category-overrides

completion-category-overrides is a customizable variable defined in minibuffer.el.gz.

Value

nil

Documentation

List of category-specific user overrides for completion styles.

Each override has the shape (CATEGORY . ALIST) where ALIST is an association list that can specify properties such as:
- styles: the list of completion-styles to use for that category.
- cycle: the completion-cycle-threshold to use for that category.
Categories are symbols such as buffer and file, used when completing buffer and file names, respectively.

If a property in a category is specified by this variable, it overrides the default specified in completion-category-defaults.

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

View in manual

Probably introduced at or before Emacs version 24.1.

Source Code

;; Defined in /usr/src/emacs/lisp/minibuffer.el.gz
(defcustom completion-category-overrides nil
  "List of category-specific user overrides for completion styles.
Each override has the shape (CATEGORY . ALIST) where ALIST is
an association list that can specify properties such as:
- `styles': the list of `completion-styles' to use for that category.
- `cycle': the `completion-cycle-threshold' to use for that category.
Categories are symbols such as `buffer' and `file', used when
completing buffer and file names, respectively.

If a property in a category is specified by this variable, it
overrides the default specified in `completion-category-defaults'."
  :version "25.1"
  :type `(alist :key-type (choice :tag "Category"
				  (const buffer)
                                  (const file)
                                  (const unicode-name)
				  (const bookmark)
                                  symbol)
          :value-type
          (set :tag "Properties to override"
	   (cons :tag "Completion Styles"
		 (const :tag "Select a style from the menu;" styles)
		 ,completion--styles-type)
           (cons :tag "Completion Cycling"
		 (const :tag "Select one value from the menu." cycle)
                 ,completion--cycling-threshold-type))))