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 │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 4.3. Completing-read-multiple │ │ │ │ │ + 4.3. Completing-read-multiple │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ 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.
│ │ │ │ │
│ │ │ │ │ @@ -316,110 +316,110 @@ │ │ │ │ │ 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 │ │ │ │ │ │ │ │ │ │
- │ │ │ │ │ - 4.3. Completing-read-multiple │ │ │ │ │ + 4.3. Completing-read-multiple │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ 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
│ │ │ │ │ @@ -454,29 +454,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
│ │ │ │ │ @@ -633,16 +633,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
│ │ │ │ │ @@ -762,16 +762,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
│ │ │ │ │ @@ -864,16 +864,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
│ │ │ │ │ @@ -909,16 +909,16 @@
│ │ │ │ │ completion-in-region
│ │ │ │ │ in a child frame popup. Corfu is a
│ │ │ │ │ narrowly focused package and developed in the same spirit as Vertico. You can
│ │ │ │ │ even use Corfu in the minibuffer.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.3.
│ │ │ │ │ Completing-read-multiple
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 1. │ │ │ │ │ Features │ │ │ │ │
│ │ │ │ │-
│ │ │ │ │
-
│ │ │ │ │ Vertical display with arrow key navigation. Many additional display modes are
│ │ │ │ │ @@ -454,29 +454,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
│ │ │ │ │ @@ -633,16 +633,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
│ │ │ │ │ @@ -762,16 +762,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
│ │ │ │ │ @@ -864,16 +864,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
│ │ │ │ │ @@ -909,16 +909,16 @@
│ │ │ │ │ completion-in-region
│ │ │ │ │ in a child frame popup. Corfu is a
│ │ │ │ │ narrowly focused package and developed in the same spirit as Vertico. You can
│ │ │ │ │ even use Corfu in the minibuffer.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.3.
│ │ │ │ │ Completing-read-multiple
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 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
│ │ │ │ │ @@ -633,16 +633,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
│ │ │ │ │ @@ -762,16 +762,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
│ │ │ │ │ @@ -864,16 +864,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
│ │ │ │ │ @@ -909,16 +909,16 @@
│ │ │ │ │ completion-in-region
│ │ │ │ │ in a child frame popup. Corfu is a
│ │ │ │ │ narrowly focused package and developed in the same spirit as Vertico. You can
│ │ │ │ │ even use Corfu in the minibuffer.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.3.
│ │ │ │ │ Completing-read-multiple
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 3. │ │ │ │ │ Key bindings │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico defines its own local keymap in the minibuffer which is derived from
│ │ │ │ │ minibuffer-local-map
│ │ │ │ │ @@ -633,16 +633,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
│ │ │ │ │ @@ -762,16 +762,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
│ │ │ │ │ @@ -864,16 +864,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
│ │ │ │ │ @@ -909,16 +909,16 @@
│ │ │ │ │ completion-in-region
│ │ │ │ │ in a child frame popup. Corfu is a
│ │ │ │ │ narrowly focused package and developed in the same spirit as Vertico. You can
│ │ │ │ │ even use Corfu in the minibuffer.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.3.
│ │ │ │ │ Completing-read-multiple
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 4. │ │ │ │ │ Configuration │ │ │ │ │
│ │ │ │ ││ │ │ │ │ In order to configure Vertico and other packages in your init.el, you may want │ │ │ │ │ to take advantage of │ │ │ │ │ @@ -762,16 +762,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
│ │ │ │ │ @@ -864,16 +864,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
│ │ │ │ │ @@ -864,16 +864,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
│ │ │ │ │ @@ -909,16 +909,16 @@
│ │ │ │ │ completion-in-region
│ │ │ │ │ in a child frame popup. Corfu is a
│ │ │ │ │ narrowly focused package and developed in the same spirit as Vertico. You can
│ │ │ │ │ even use Corfu in the minibuffer.
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.3.
│ │ │ │ │ Completing-read-multiple
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 4.2. │ │ │ │ │ Completion-at-point and completion-in-region │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The tab completion command
│ │ │ │ │ completion-at-point
│ │ │ │ │ @@ -909,16 +909,16 @@
│ │ │ │ │ completion-in-region
│ │ │ │ │ in a child frame popup. Corfu is a
│ │ │ │ │ narrowly focused package and developed in the same spirit as Vertico. You can
│ │ │ │ │ even use Corfu in the minibuffer.
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 4.3.
│ │ │ │ │ Completing-read-multiple
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 4.3. │ │ │ │ │ Completing-read-multiple │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The function
│ │ │ │ │ completing-read-multiple
│ │ │ │ │ @@ -1087,16 +1087,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
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 5.1. │ │ │ │ │ Configure Vertico per command or completion category │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Vertico offers the
│ │ │ │ │ vertico-multiform-mode
│ │ │ │ │ @@ -1403,16 +1403,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
│ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 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 │ │ │ │ │ @@ -1443,16 +1443,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.
│ │ │ │ │
│ │ │ │ │ @@ -1508,16 +1508,16 @@
│ │ │ │ │ its
│ │ │ │ │ extensions
│ │ │ │ │ .
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 8. │ │ │ │ │ Alternatives │ │ │ │ │
│ │ │ │ │There are many alternative completion UIs, each UI with its own advantages and │ │ │ │ │ disadvantages.
│ │ │ │ ││ │ │ │ │ @@ -1508,16 +1508,16 @@ │ │ │ │ │ its │ │ │ │ │ extensions │ │ │ │ │ . │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 9.
│ │ │ │ │ Resources
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ If you want to learn more about Vertico and minibuffer completion, check out the
│ │ │ │ │ following resources:
│ │ │ │ │
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 9. │ │ │ │ │ Resources │ │ │ │ │
│ │ │ │ │If you want to learn more about Vertico and minibuffer completion, check out the │ │ │ │ │ following resources:
│ │ │ │ │-
│ │ │ │ │ @@ -1567,30 +1567,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
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 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
│ │ │ │ │ @@ -1624,27 +1624,27 @@
│ │ │ │ │ (advice-add #'vertico--exhibit
│ │ │ │ │ :around
│ │ │ │ │ #'force-debug)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 11. │ │ │ │ │ Debugging Vertico │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ When you observe an error in the
│ │ │ │ │ vertico--exhibit
│ │ │ │ │ @@ -1624,27 +1624,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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ -
│ │ │ │ │ -
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 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
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.1.
│ │ │ │ │ org-refile
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ org-refile
│ │ │ │ │ uses
│ │ │ │ │ @@ -1722,16 +1722,16 @@
│ │ │ │ │ setq
│ │ │ │ │ org-refile-use-outline-path 'file
│ │ │ │ │ org-outline-path-complete-in-steps nil)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ @@ -1778,16 +1778,16 @@
│ │ │ │ │ (advice-add #'org-agenda-filter
│ │ │ │ │ :around
│ │ │ │ │ #'vertico-enforce-basic-completion)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.2.
│ │ │ │ │ org-agenda-filter
│ │ │ │ │ and
│ │ │ │ │ org-tags-view
│ │ │ │ │
│ │ │ │ │ │ │ │ │ │ @@ -1778,16 +1778,16 @@ │ │ │ │ │ (advice-add #'org-agenda-filter │ │ │ │ │ :around │ │ │ │ │ #'vertico-enforce-basic-completion) │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1815,16 +1815,16 @@
│ │ │ │ │ (advice-add #'tmm-add-prompt
│ │ │ │ │ :after
│ │ │ │ │ #'minibuffer-hide-completions)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.3.
│ │ │ │ │ tmm-menubar
│ │ │ │ │
│ │ │ │ │ │ │ │ │ │ NOTE │ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You │ │ │ │ │ @@ -1815,16 +1815,16 @@ │ │ │ │ │ (advice-add #'tmm-add-prompt │ │ │ │ │ :after │ │ │ │ │ #'minibuffer-hide-completions) │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ NOTE
│ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You
│ │ │ │ │ @@ -1861,16 +1861,16 @@
│ │ │ │ │ (((symbol-function #'minibuffer-completion-help)
│ │ │ │ │ #'ignore))
│ │ │ │ │ (apply args))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.4.
│ │ │ │ │ ffap-menu
│ │ │ │ │
│ │ │ │ │ │ │ │ │ │ NOTE │ │ │ │ │ : I have implemented a fix for this problem which is part of Emacs 31. You │ │ │ │ │ @@ -1861,16 +1861,16 @@ │ │ │ │ │ (((symbol-function #'minibuffer-completion-help) │ │ │ │ │ #'ignore)) │ │ │ │ │ (apply args)))) │ │ │ │ │ │ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ 12.5.
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ Dynamic completion tables (
│ │ │ │ │ completion-table-dynamic
│ │ │ │ │ @@ -1919,16 +1919,16 @@
│ │ │ │ │ (concat str
│ │ │ │ │ "3"
│ │ │ │ │ )))))
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ +
│ │ │ │ │ +
│ │ │ │ │ 12.6.
│ │ │ │ │ Submitting the empty string
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 12.6. │ │ │ │ │ Submitting the empty string │ │ │ │ │
│ │ │ │ │
│ │ │ │ │ The commands
│ │ │ │ │ multi-occur
│ │ │ │ │ @@ -1997,16 +1997,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 Emacs 29.2 and Tramp 2.7 the workarounds described in this section are
│ │ │ │ │ 12.7. │ │ │ │ │ Tramp hostname and username completion │ │ │ │ │
│ │ │ │ ││ │ │ │ │ NOTE: │ │ │ │ │ On Emacs 29.2 and Tramp 2.7 the workarounds described in this section are