snacks.nvim/docs/words.md
Folke Lemaitre 276f8ad673
docs: docgen
2024-12-10 13:54:33 +01:00

71 lines
1.2 KiB
Markdown

# 🍿 words
Auto-show LSP references and quickly navigate between them
<!-- docgen -->
## 📦 Setup
```lua
-- lazy.nvim
{
"folke/snacks.nvim",
opts = {
words = {
-- your words configuration comes here
-- or leave it empty to use the default settings
-- refer to the configuration section below
}
}
}
```
## ⚙️ Config
```lua
---@class snacks.words.Config
---@field enabled? boolean
{
debounce = 200, -- time in ms to wait before updating
notify_jump = false, -- show a notification when jumping
notify_end = true, -- show a notification when reaching the end
foldopen = true, -- open folds after jumping
jumplist = true, -- set jump point before jumping
modes = { "n", "i", "c" }, -- modes to show references
}
```
## 📦 Module
### `Snacks.words.clear()`
```lua
Snacks.words.clear()
```
### `Snacks.words.disable()`
```lua
Snacks.words.disable()
```
### `Snacks.words.enable()`
```lua
Snacks.words.enable()
```
### `Snacks.words.is_enabled()`
```lua
---@param buf number?
Snacks.words.is_enabled(buf)
```
### `Snacks.words.jump()`
```lua
---@param count number
---@param cycle? boolean
Snacks.words.jump(count, cycle)
```