vertico.el - VERTical Interactive COmpletion
│ │ │ │ │Table of Contents
│ │ │ │ │-
│ │ │ │ │
- │ │ │ │ │ - 1. Features │ │ │ │ │ + 1. Features │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 2. Installation │ │ │ │ │ + 2. Installation │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 3. Key bindings │ │ │ │ │ + 3. Key bindings │ │ │ │ │ │ │ │ │ │
-
│ │ │ │ │ - 4. Configuration
│ │ │ │ │ + 4. Configuration
│ │ │ │ │
-
│ │ │ │ │
- │ │ │ │ │ - 4.1. Completion styles and TAB completion │ │ │ │ │ + 4.1. Completion styles and TAB completion │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 4.2. Completion-at-point and completion-in-region │ │ │ │ │ + 4.2. Completion-at-point and completion-in-region │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ 5. Extensions
│ │ │ │ │
-
│ │ │ │ │
- │ │ │ │ │ - 5.1. Configure Vertico per command or completion category │ │ │ │ │ + 5.1. Configure Vertico per command or completion category │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ - │ │ │ │ │ 6. Complementary packages │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 7. Child frames and Popups │ │ │ │ │ + 7. Child frames and Popups │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 8. Alternatives │ │ │ │ │ + 8. Alternatives │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 9. Resources │ │ │ │ │ + 9. Resources │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 10. Contributions │ │ │ │ │ + 10. Contributions │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 11. Debugging Vertico │ │ │ │ │ + 11. Debugging Vertico │ │ │ │ │ │ │ │ │ │
-
│ │ │ │ │ - 12. Problematic completion commands
│ │ │ │ │ + 12. Problematic completion commands
│ │ │ │ │
-
│ │ │ │ │
-
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │
org-refile
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │
org-agenda-filter
│ │ │ │ │ and │ │ │ │ │org-tags-view
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │
tmm-menubar
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │
ffap-menu
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │
completion-table-dynamic
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ - │ │ │ │ │ - 12.6. Submitting the empty string │ │ │ │ │ + 12.6. Submitting the empty string │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 12.7. Tramp hostname and username completion │ │ │ │ │ + 12.7. Tramp hostname and username completion │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │
│ │ │ │ │ @@ -313,107 +313,107 @@ │ │ │ │ │ without white space and comments. │ │ │ │ │
│ │ │ │ │Table of Contents
│ │ │ │ │-
│ │ │ │ │
- │ │ │ │ │ - 1. Features │ │ │ │ │ + 1. Features │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 2. Installation │ │ │ │ │ + 2. Installation │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 3. Key bindings │ │ │ │ │ + 3. Key bindings │ │ │ │ │ │ │ │ │ │
-
│ │ │ │ │ - 4. Configuration
│ │ │ │ │ + 4. Configuration
│ │ │ │ │
-
│ │ │ │ │
- │ │ │ │ │ - 4.1. Completion styles and TAB completion │ │ │ │ │ + 4.1. Completion styles and TAB completion │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 4.2. Completion-at-point and completion-in-region │ │ │ │ │ + 4.2. Completion-at-point and completion-in-region │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ 5. Extensions
│ │ │ │ │
-
│ │ │ │ │
- │ │ │ │ │ - 5.1. Configure Vertico per command or completion category │ │ │ │ │ + 5.1. Configure Vertico per command or completion category │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ - │ │ │ │ │ 6. Complementary packages │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 7. Child frames and Popups │ │ │ │ │ + 7. Child frames and Popups │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 8. Alternatives │ │ │ │ │ + 8. Alternatives │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 9. Resources │ │ │ │ │ + 9. Resources │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 10. Contributions │ │ │ │ │ + 10. Contributions │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 11. Debugging Vertico │ │ │ │ │ + 11. Debugging Vertico │ │ │ │ │ │ │ │ │ │
-
│ │ │ │ │ - 12. Problematic completion commands
│ │ │ │ │ + 12. Problematic completion commands
│ │ │ │ │
-
│ │ │ │ │
-
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │
org-refile
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │
org-agenda-filter
│ │ │ │ │ and │ │ │ │ │org-tags-view
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │
tmm-menubar
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │
ffap-menu
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │
completion-table-dynamic
│ │ │ │ │ │ │ │ │ │
│ │ │ │ │ - │ │ │ │ │ - 12.6. Submitting the empty string │ │ │ │ │ + 12.6. Submitting the empty string │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 12.7. Tramp hostname and username completion │ │ │ │ │ + 12.7. Tramp hostname and username completion │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 1.
│ │ │ │ │ Features
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ Vertical display with arrow key navigation. Many additional display modes are
│ │ │ │ │ @@ -448,29 +448,29 @@
│ │ │ │ │ Support for candidate grouping and group cycling commands (
│ │ │ │ │
group-function
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 2.
│ │ │ │ │ Installation
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ After installation, activate the global minor mode with
│ │ │ │ │ M-x vertico-mode RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 3.
│ │ │ │ │ Key bindings
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico defines its own local keymap in the minibuffer which is derived from
│ │ │ │ │ minibuffer-local-map
│ │ │ │ │ @@ -627,16 +627,16 @@
│ │ │ │ │ up
│ │ │ │ │ arrow key and then press
│ │ │ │ │ RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.
│ │ │ │ │ Configuration
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ In order to configure Vertico and other packages in your init.el, you may want
│ │ │ │ │ to take advantage of
│ │ │ │ │ @@ -788,16 +788,16 @@
│ │ │ │ │ . If you want
│ │ │ │ │ to create your own completion commands, you can find documentation about
│ │ │ │ │ completion in the
│ │ │ │ │ Elisp manual
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.1.
│ │ │ │ │ Completion styles and TAB completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The bindings of the
│ │ │ │ │ minibuffer-local-completion-map
│ │ │ │ │ @@ -904,16 +904,16 @@
│ │ │ │ │ read-file-name-completion-ignore-case t
│ │ │ │ │ read-buffer-completion-ignore-case t
│ │ │ │ │ completion-ignore-case t)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.2.
│ │ │ │ │ Completion-at-point and completion-in-region
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -1094,16 +1094,16 @@
│ │ │ │ │ ;;
│ │ │ │ │ Tidy shadowed file names
│ │ │ │ │ :hook
│ │ │ │ │ (rfn-eshadow-update-overlay . vertico-directory-tidy))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 5.1.
│ │ │ │ │ Configure Vertico per command or completion category
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 1. │ │ │ │ │ Features │ │ │ │ │
│ │ │ │ │-
│ │ │ │ │
-
│ │ │ │ │ Vertical display with arrow key navigation. Many additional display modes are
│ │ │ │ │ @@ -448,29 +448,29 @@
│ │ │ │ │ Support for candidate grouping and group cycling commands (
│ │ │ │ │
group-function
│ │ │ │ │ ). │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 2.
│ │ │ │ │ Installation
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ After installation, activate the global minor mode with
│ │ │ │ │ M-x vertico-mode RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 3.
│ │ │ │ │ Key bindings
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico defines its own local keymap in the minibuffer which is derived from
│ │ │ │ │ minibuffer-local-map
│ │ │ │ │ @@ -627,16 +627,16 @@
│ │ │ │ │ up
│ │ │ │ │ arrow key and then press
│ │ │ │ │ RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.
│ │ │ │ │ Configuration
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ In order to configure Vertico and other packages in your init.el, you may want
│ │ │ │ │ to take advantage of
│ │ │ │ │ @@ -788,16 +788,16 @@
│ │ │ │ │ . If you want
│ │ │ │ │ to create your own completion commands, you can find documentation about
│ │ │ │ │ completion in the
│ │ │ │ │ Elisp manual
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.1.
│ │ │ │ │ Completion styles and TAB completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The bindings of the
│ │ │ │ │ minibuffer-local-completion-map
│ │ │ │ │ @@ -904,16 +904,16 @@
│ │ │ │ │ read-file-name-completion-ignore-case t
│ │ │ │ │ read-buffer-completion-ignore-case t
│ │ │ │ │ completion-ignore-case t)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.2.
│ │ │ │ │ Completion-at-point and completion-in-region
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -1094,16 +1094,16 @@
│ │ │ │ │ ;;
│ │ │ │ │ Tidy shadowed file names
│ │ │ │ │ :hook
│ │ │ │ │ (rfn-eshadow-update-overlay . vertico-directory-tidy))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 5.1.
│ │ │ │ │ Configure Vertico per command or completion category
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 2. │ │ │ │ │ Installation │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ After installation, activate the global minor mode with
│ │ │ │ │ M-x vertico-mode RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 3.
│ │ │ │ │ Key bindings
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico defines its own local keymap in the minibuffer which is derived from
│ │ │ │ │ minibuffer-local-map
│ │ │ │ │ @@ -627,16 +627,16 @@
│ │ │ │ │ up
│ │ │ │ │ arrow key and then press
│ │ │ │ │ RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.
│ │ │ │ │ Configuration
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ In order to configure Vertico and other packages in your init.el, you may want
│ │ │ │ │ to take advantage of
│ │ │ │ │ @@ -788,16 +788,16 @@
│ │ │ │ │ . If you want
│ │ │ │ │ to create your own completion commands, you can find documentation about
│ │ │ │ │ completion in the
│ │ │ │ │ Elisp manual
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.1.
│ │ │ │ │ Completion styles and TAB completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The bindings of the
│ │ │ │ │ minibuffer-local-completion-map
│ │ │ │ │ @@ -904,16 +904,16 @@
│ │ │ │ │ read-file-name-completion-ignore-case t
│ │ │ │ │ read-buffer-completion-ignore-case t
│ │ │ │ │ completion-ignore-case t)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.2.
│ │ │ │ │ Completion-at-point and completion-in-region
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -1094,16 +1094,16 @@
│ │ │ │ │ ;;
│ │ │ │ │ Tidy shadowed file names
│ │ │ │ │ :hook
│ │ │ │ │ (rfn-eshadow-update-overlay . vertico-directory-tidy))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 5.1.
│ │ │ │ │ Configure Vertico per command or completion category
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 3. │ │ │ │ │ Key bindings │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico defines its own local keymap in the minibuffer which is derived from
│ │ │ │ │ minibuffer-local-map
│ │ │ │ │ @@ -627,16 +627,16 @@
│ │ │ │ │ up
│ │ │ │ │ arrow key and then press
│ │ │ │ │ RET
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.
│ │ │ │ │ Configuration
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ In order to configure Vertico and other packages in your init.el, you may want
│ │ │ │ │ to take advantage of
│ │ │ │ │ @@ -788,16 +788,16 @@
│ │ │ │ │ . If you want
│ │ │ │ │ to create your own completion commands, you can find documentation about
│ │ │ │ │ completion in the
│ │ │ │ │ Elisp manual
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.1.
│ │ │ │ │ Completion styles and TAB completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The bindings of the
│ │ │ │ │ minibuffer-local-completion-map
│ │ │ │ │ @@ -904,16 +904,16 @@
│ │ │ │ │ read-file-name-completion-ignore-case t
│ │ │ │ │ read-buffer-completion-ignore-case t
│ │ │ │ │ completion-ignore-case t)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.2.
│ │ │ │ │ Completion-at-point and completion-in-region
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -1094,16 +1094,16 @@
│ │ │ │ │ ;;
│ │ │ │ │ Tidy shadowed file names
│ │ │ │ │ :hook
│ │ │ │ │ (rfn-eshadow-update-overlay . vertico-directory-tidy))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 5.1.
│ │ │ │ │ Configure Vertico per command or completion category
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 4. │ │ │ │ │ Configuration │ │ │ │ │
│ │ │ │ ││ │ │ │ │ In order to configure Vertico and other packages in your init.el, you may want │ │ │ │ │ to take advantage of │ │ │ │ │ @@ -788,16 +788,16 @@ │ │ │ │ │ . If you want │ │ │ │ │ to create your own completion commands, you can find documentation about │ │ │ │ │ completion in the │ │ │ │ │ Elisp manual │ │ │ │ │ . │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.1.
│ │ │ │ │ Completion styles and TAB completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The bindings of the
│ │ │ │ │ minibuffer-local-completion-map
│ │ │ │ │ @@ -904,16 +904,16 @@
│ │ │ │ │ read-file-name-completion-ignore-case t
│ │ │ │ │ read-buffer-completion-ignore-case t
│ │ │ │ │ completion-ignore-case t)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 4.1. │ │ │ │ │ Completion styles and TAB completion │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The bindings of the
│ │ │ │ │ minibuffer-local-completion-map
│ │ │ │ │ @@ -904,16 +904,16 @@
│ │ │ │ │ read-file-name-completion-ignore-case t
│ │ │ │ │ read-buffer-completion-ignore-case t
│ │ │ │ │ completion-ignore-case t)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.2.
│ │ │ │ │ Completion-at-point and completion-in-region
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -1094,16 +1094,16 @@
│ │ │ │ │ ;;
│ │ │ │ │ Tidy shadowed file names
│ │ │ │ │ :hook
│ │ │ │ │ (rfn-eshadow-update-overlay . vertico-directory-tidy))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 5.1.
│ │ │ │ │ Configure Vertico per command or completion category
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 4.2. │ │ │ │ │ Completion-at-point and completion-in-region │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -1094,16 +1094,16 @@
│ │ │ │ │ ;;
│ │ │ │ │ Tidy shadowed file names
│ │ │ │ │ :hook
│ │ │ │ │ (rfn-eshadow-update-overlay . vertico-directory-tidy))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 5.1.
│ │ │ │ │ Configure Vertico per command or completion category
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 5.1. │ │ │ │ │ Configure Vertico per command or completion category │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1410,16 +1410,16 @@
│ │ │ │ │ consult-buffer
│ │ │ │ │ for
│ │ │ │ │ switch-to-buffer
│ │ │ │ │ ).
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 7.
│ │ │ │ │ Child frames and Popups
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ An often requested feature is the ability to display the completions in a child
│ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer
│ │ │ │ │ @@ -1450,16 +1450,16 @@
│ │ │ │ │ vertico-posframe
│ │ │ │ │ : Display only the Vertico minibuffer in a child frame using
│ │ │ │ │ the posframe library.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 7. │ │ │ │ │ Child frames and Popups │ │ │ │ │
│ │ │ │ ││ │ │ │ │ An often requested feature is the ability to display the completions in a child │ │ │ │ │ frame popup. Personally I am critical of using child frames for minibuffer │ │ │ │ │ @@ -1450,16 +1450,16 @@ │ │ │ │ │ vertico-posframe │ │ │ │ │ : Display only the Vertico minibuffer in a child frame using │ │ │ │ │ the posframe library. │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 8.
│ │ │ │ │ Alternatives
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ There are many alternative completion UIs, each UI with its own advantages and
│ │ │ │ │ disadvantages.
│ │ │ │ │
│ │ │ │ │ @@ -1515,16 +1515,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 8. │ │ │ │ │ Alternatives │ │ │ │ │
│ │ │ │ │There are many alternative completion UIs, each UI with its own advantages and │ │ │ │ │ disadvantages.
│ │ │ │ ││ │ │ │ │ @@ -1515,16 +1515,16 @@ │ │ │ │ │ its │ │ │ │ │ extensions │ │ │ │ │ . │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 9. │ │ │ │ │ Resources │ │ │ │ │
│ │ │ │ │If you want to learn more about Vertico and minibuffer completion, check out the │ │ │ │ │ following resources:
│ │ │ │ │-
│ │ │ │ │ @@ -1574,30 +1574,30 @@
│ │ │ │ │ (2024-03-06) by Marie-Hélène Burle.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 10.
│ │ │ │ │ Contributions
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Since this package is part of
│ │ │ │ │ GNU ELPA
│ │ │ │ │ contributions require a copyright
│ │ │ │ │ assignment to the FSF.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 10. │ │ │ │ │ Contributions │ │ │ │ │
│ │ │ │ ││ │ │ │ │ Since this package is part of │ │ │ │ │ GNU ELPA │ │ │ │ │ contributions require a copyright │ │ │ │ │ assignment to the FSF. │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 11.
│ │ │ │ │ Debugging Vertico
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 11. │ │ │ │ │ Debugging Vertico │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1631,27 +1631,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.
│ │ │ │ │ Problematic completion commands
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico is robust in most scenarios. However some completion commands make
│ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of
│ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor
│ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 12. │ │ │ │ │ Problematic completion commands │ │ │ │ │
│ │ │ │ │Vertico is robust in most scenarios. However some completion commands make │ │ │ │ │ certain assumptions about the completion styles and the completion UI. Some of │ │ │ │ │ these assumptions may not hold in Vertico or other UIs and require minor │ │ │ │ │ workarounds.
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1729,16 +1729,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1785,16 +1785,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │ │ │ │ │ │ @@ -1785,16 +1785,16 @@ │ │ │ │ │ (advice-add #'org-agenda-filter │ │ │ │ │ :around │ │ │ │ │ #'vertico-enforce-basic-completion) │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The text menu bar works well with Vertico but always shows a
│ │ │ │ │ *Completions*
│ │ │ │ │ @@ -1810,16 +1810,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The command
│ │ │ │ │ ffap-menu
│ │ │ │ │ @@ -1844,16 +1844,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1902,16 +1902,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 12.6. │ │ │ │ │ Submitting the empty string │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1980,16 +1980,16 @@
│ │ │ │ │ default value "" is specified and Vertico preselects the prompt, such that
│ │ │ │ │ exiting with the empty string is possible by pressing
│ │ │ │ │ RET
│ │ │ │ │ only.
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.7.
│ │ │ │ │ Tramp hostname and username completion
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE:
│ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this
│ │ │ │ │ 12.7. │ │ │ │ │ Tramp hostname and username completion │ │ │ │ │
│ │ │ │ ││ │ │ │ │ NOTE: │ │ │ │ │ On upcoming Emacs 29.2 and Tramp 2.6.1.5 the workarounds described in this