ad6a3d0f33
featurep! will be renamed modulep! in the future, so it's been deprecated. They have identical interfaces, and can be replaced without issue. featurep! was never quite the right name for this macro. It implied that it had some connection to featurep, which it doesn't (only that it was similar in purpose; still, Doom modules are not features). To undo such implications and be consistent with its namespace (and since we're heading into a storm of breaking changes with the v3 release anyway), now was the best opportunity to begin the transition. |
||
|---|---|---|
| .. | ||
| autoload | ||
| config.el | ||
| packages.el | ||
| README.org | ||
:completion helm
Description unfold
This module provides Helm integration for a variety of Emacs commands, as well as a unified interface for project search and replace, powered by Ripgrep.
Maintainers
This module has no dedicated maintainers. Become a maintainer?
Module flags
- +childframe
- Display Helm windows in a child frame rather than an popup buffer. Requires GUI Emacs.
- +fuzzy
- Enable fuzzy completion for Helm searches.
- +icons
- Display icons on completion results (where possible) using either all-the-icons or treemacs iconsets.
Packages
TODO Hacks
🔨 This module's hacks haven't been documented yet. Document them?
TODO Changelog
This module does not have a changelog yet.
Installation
Enable this module in your doom! block.
This module has only one requirement: Ripgrep, which is a hard dependency of Doom itself, so you should already have it installed.
Otherwise, Helm provides many commands to interface with a variety of programs from fzf to Dash docsets to pass and much more. These programs are optional for this module, but must be installed if you intend to use their associated Helm command or plugin.
TODO Usage
🔨 This module's usage documentation is incomplete. Complete it?
Much like ivy and vertico, helm is a large framework. Covering all its features is not within the scope of this module's documentation, so only its highlights will be covered here.
Jump-to navigation
Project search & replace
This module also provides interactive text search and replace using ripgrep.
Search
| Keybind | Description |
|---|---|
| SPC s p | Search project |
| SPC s P | Search another project |
| SPC s d | Search this directory |
| SPC s D | Search another directory |
Prefixing these keys with the universal argument (SPC u for evil users; C-u otherwise) changes the behavior of these commands, instructing the underlying search engine to include ignored files.
This module also provides Ex Commands for evil users:
| Ex command | Description |
|---|---|
:pg[rep][!] [QUERY] |
Search project (if !, include hidden files) |
:pg[rep]d[!] [QUERY] |
Search from current directory (if !, don't search recursively) |
The optional ! is equivalent to the universal argument for the previous
commands.
Replace
These keybindings are available while a search is active:
| Keybind | Description |
|---|---|
| C-c C-o | Open a buffer with your search results |
| C-c C-e | Open a writable buffer of your search results |
| C-SPC | Preview the current candidate |
| C-RET | Open the selected candidate in other-window |
Changes to the resulting wgrep buffer (opened by C-c C-e) can be committed with C-c C-c and aborted with C-c C-k (alternatively ZZ and ZQ, for evil users).
In-buffer searching
Helm integration for various completing commands
Helm also has a number of overrides for built-in functionality:
Jump to files, buffers or projects
Search
| Keybind | Description |
|---|---|
| SPC p t | List all TODO/FIXMEs in project |
| SPC s b | Search the current buffer |
| SPC s d | Search this directory |
| SPC s D | Search another directory |
| SPC s i | Search for symbol in current buffer |
| SPC s p | Search project |
| SPC s P | Search another project |
| SPC s s | Search the current buffer (incrementally) |
TODO Configuration
🔨 This module's configuration documentation is incomplete. Complete it?
Icons
Icon support is now included, through one of two providers: all-the-icons and treemacs. By default, to maintain consistency we use all-the-icons; however if you wish to modify this you can do so using the below snippet:
(after! helm
(setq helm-icons-provider 'treemacs))TODO Posframe
Troubleshooting
There are no known problems with this module. Report one?
Frequently asked questions
Helm vs Ivy vs Ido vs Vertico
See this answer.
TODO Appendix
🔨 This module has no appendix yet. Write one?