7.1 KiB
:completion corfu
Description unfold
This module provides code completion, powered by corfu.
It is recommended to enable either this or :completion company, in case you desire pre-configured auto-completion. Corfu is much lighter weight and focused, plus it's built on native Emacs functionality, whereas company is heavy and highly non-native, but has some extra features and more maturity.
Maintainers
Module flags
Packages
Hacks
No hacks documented for this module.
TODO Changelog
This module does not have a changelog yet.
Installation
Enable this module in your doom! block.
This module has no direct requirements, but some languages may have their own
requirements to fulfill before you get code completion in them (and some
languages may lack code completion support altogether). Run $ doom doctor to
find out if you're missing any dependencies. Note that corfu may have support
for completions in languages that have no development intelligence, since it
supports generic, context insensitive candidates such as file names or recurring
words.
TODO Usage
🔨 This module's usage documentation is incomplete. Complete it?
Code completion
By default, completion gets triggered after typing 2 non-space consecutive characters, or by means of the C-SPC keybinding at any moment. While the popup is visible, the following relevant keys are available:
| Keybind | Description |
|---|---|
| <down> | Go to next candidate |
| <up> | Go to previous candidate |
| C-n | Go to next candidate |
| C-p | Go to previous candidate |
| C-j | (evil) Go to next candidate |
| C-k | (evil) Go to previous candidate |
| C-<down> | Go to next doc line |
| C-<up> | Go to previous doc line |
| C-S-n | Go to next doc line |
| C-S-p | Go to previous doc line |
| C-S-j | (evil) Go to next doc line |
| C-S-k | (evil) Go to previous doc line |
| C-h | Toggle documentation (if available) |
| s-<down> | Export to minibuffer (if :completion vertico) |
| s-j | (evil) Export to minibuffer (if :completion vertico) |
| RET | Insert candidate |
| C-SPC | (when completing) Insert separator (see below) |
| C-SPC | Complete (unless :completion corfu +tng) |
If you prefer a TAB-centric completion style, enable the :completion corfu +tng flag so that, instead, you trigger completion with TAB, getting the following additional binds:
| Keybind | Description |
|---|---|
| TAB | Complete |
| TAB | (when completing) Go to next candidate |
| S-TAB | (when completing) Go to previous candidate |
Searching with multiple keywords
If the :completion vertico module is enabled, users can perform code completion with multiple search keywords by use of space as separator. More information can be found here. Pressing C-SPC again while completing inserts a space as separator. This allows searching with space-separated terms; each piece will match individually and in any order, with smart casing. Pressing just SPC acts as normal and restarts completion, so that when typing sentences it doesn't try to complete the whole sentence instead of just the word.
Without :completion vertico, it still works, just not as intelligently, due to the lack of orderless.
Exporting to the minibuffer (requires :completion vertico)
When using the :completion vertico module, which pulls in the consult package, the entries shown in the completion popup can be exported to a consult minibuffer, giving access to all the manipulations the vertico suite allows. For instance, one could use this to export with embark via C-c C-l and get a buffer with all candidates.
Ispell completion
Ispell completion is supported, so long as you point to the right .dic file in
ispell-alternate-dictionary. For selected text modes (see the configuration
section) it completes everywhere, for programming modes it can complete in
comments and strings.
Configuration
A few variables may be set to change behavior of this module:
- +corfu-auto-delay
- Number of seconds till completion occurs automatically. Defaults to 0.1.
- +corfu-auto-prefix
- Number of characters till auto-completion starts to happen. Defaults to 2.
- +corfu-want-multi-component
- Sets whether orderless-style matching should be supported with space as a separator.
- +corfu-ispell-completion-modes
-
Lists modes in which to add
cape-ispellas a capf. These show be majorly text modes, else you will get lots of bad suggestions, since when this matches it interrupts the flow of candidate selection. - +corfu-ispell-in-comments-and-strings
- Whether we should complete when point is inside a string or comment. If non-nil, works as in a text mode, else gives programming completions just like in the rest of the buffer.
Additionally, if you prefer to never stop completion on SPC, add the following
to your config.el:
(map! :map corfu-map
:desc "insert separator" "C-SPC" #'corfu-insert-separator)Troubleshooting
Frequently asked questions
This module has no FAQs yet. Ask one?
TODO Appendix
🔨 This module has no appendix yet. Write one?