emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/modules/completion/helm
History
Henrik Lissner 0e802f4653
bump: :completion 
abo-abo/swiper@1c6b3da377 -> abo-abo/swiper@c97ea72285
company-mode/company-mode@8b58e5895c -> company-mode/company-mode@073aef72dd
emacs-helm/helm@a246a9b278 -> emacs-helm/helm@5b17313011
ericdanan/counsel-projectile@e30150792a -> ericdanan/counsel-projectile@40d1e1d4bb
minad/consult@2106eee75f -> minad/consult@473e6585c5
minad/marginalia@e9540a7b80 -> minad/marginalia@e63d27e6fb
minad/vertico@509ca602c7 -> minad/vertico@a92b1e47ff
oantolin/embark@56e28c23d5 -> oantolin/embark@06d5caafd5
oantolin/orderless@ce462a63e3 -> oantolin/orderless@f2c78c4a60
raxod502/prescient.el@292ac9fe35 -> raxod502/prescient.el@c5295a9eec
tumashu/ivy-posframe@5d9420252c -> tumashu/ivy-posframe@533a8e368f
tumashu/posframe@3b1dc400d2 -> tumashu/posframe@c91d4d53fa
2022-03-30 17:32:47 +02:00
..
autoload Bump :ui doom 2021-05-21 23:13:14 -04:00
config.el Remove remaining Emacs27+ checks 2021-07-10 16:03:41 +03:00
packages.el bump: :completion 2022-03-30 17:32:47 +02:00
README.org remove ripgrep dependency from ivy and helm readmes 2021-07-09 22:26:02 +03:00

README.org

completion/helm

Description

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.

I prefer ivy over ido for its flexibility. I prefer ivy over helm because it's lighter, simpler and faster in many cases.

Ivy is considered a first-class citizen in Doom, however it is still possible to use Helm if you so desire.

Module Flags

  • +fuzzy Enables fuzzy completion for Helm searches.
  • +childframe Causes Helm to display in a floating child frame, above Emacs.
  • +icons Enables icons (supports both all-the-icons and treemacs icons)

Plugins

Prerequisites

This module has no prerequisites.

Features

Much like Ivy, Helm is a large framework and as such covering everything is not in scope, however a number of Doom-specific features are shown below:

Jump-to navigation

Similar to Ivy, this module provides an interface to navigate within a project using projectile:

Keybind Description
SPC p f, SPC SPC Jump to file in project
SPC f f, SPC . Jump to file from current directory
SPC s i Jump to symbol in file

Project search & replace

This module also provides interacetive 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

The swiper package provides an interactive buffer search powered by helm. It can be invoked with:

  • SPC s s (swiper-isearch)
  • SPC s S (swiper-isearch-thing-at-point)
  • SPC s b (swiper)
  • :sw[iper] [QUERY]

A wgrep buffer can be opened from swiper with C-c C-e.

Helm integration for various completing commands

Helm also has a number of overrides for built-in functionality:

General

Keybind Description
M-x, SPC : Smarter, smex-powered M-x
SPC ' Resume last ivy session

Jump to files, buffers or projects

Keybind Description
SPC RET Find bookmark
SPC f f, SPC . Browse from current directory
SPC p f, SPC SPC Find file in project
SPC f r Find recently opened file
SPC p p Open another project
SPC b b, SPC , Switch to buffer in current workspace
SPC b B, SPC < Switch to buffer

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)

Configuration

Icons

Icons are now included, and support 2 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))

Posframe

Troubleshooting