chore(build): auto-generate vimdoc

This commit is contained in:
github-actions[bot] 2023-09-27 10:40:28 +00:00
parent 24f6b6f1c7
commit fe9f93692e
1 changed files with 44 additions and 44 deletions

View File

@ -1,4 +1,4 @@
*lazy.nvim.txt* For Neovim >= 0.8.0 Last change: 2023 August 26
*lazy.nvim.txt* For Neovim >= 0.8.0 Last change: 2023 September 27
==============================================================================
Table of Contents *lazy.nvim-table-of-contents*
@ -160,7 +160,7 @@ PLUGIN SPEC *lazy.nvim-lazy.nvim-plugin-spec*
build fun(LazyPlugin) or string or a list of build commands build is executed when a plugin is installed or
updated. Before running build, a plugin is first
loaded. If its a string it will be ran as a shell
command. When prefixed with it is a Neovim command.
command. When prefixed with : it is a Neovim command.
You can also specify a list to executed multiple build
commands. Some plugins provide their own build.lua
which is automatically used by lazy. So no need to
@ -181,7 +181,7 @@ PLUGIN SPEC *lazy.nvim-lazy.nvim-plugin-spec*
Defaults to true
event string? or string[] or Lazy-load on event. Events can be specified as
fun(self:LazyPlugin, event:string[]):string[] BufEnter or with a pattern like BufEnter .lua
fun(self:LazyPlugin, event:string[]):string[] BufEnter or with a pattern like BufEnter *.lua
cmd string? or string[] or Lazy-load on command
fun(self:LazyPlugin, cmd:string[]):string[]
@ -281,7 +281,7 @@ The `version` property supports Semver <https://semver.org/> ranges.
Click to see some examples ~
- latest stable version (this excludes pre-release versions)
- `*`latest stable version (this excludes pre-release versions)
- `1.2.x`any version that starts with `1.2`, such as `1.2.0`, `1.2.3`, etc.
- `^1.2.3`any version that is compatible with `1.2.3`, such as `1.3.0`, `1.4.5`, etc., but not `2.0.0`.
- `~1.2.3`any version that is compatible with `1.2.3`, such as `1.2.4`, `1.2.5`, but not `1.3.0`.
@ -290,8 +290,8 @@ Click to see some examples ~
- `<1.2.3`any version that is less than `1.2.3`, such as `1.1.0`, `1.0.5`, etc.
- `<=1.2.3`any version that is less than or equal to `1.2.3`, such as `1.2.3`, `1.1.0`, `1.0.5`, etc
You can set `config.defaults.version = ""` to install the latest stable version
of plugins that support Semver.
You can set `config.defaults.version = "*"` to install the latest stable
version of plugins that support Semver.
EXAMPLES ~
@ -400,12 +400,12 @@ CONFIGURATION *lazy.nvim-lazy.nvim-configuration*
-- default `cond` you can use to globally disable a lot of plugins
-- when running inside vscode for example
cond = nil, ---@type boolean|fun(self:LazyPlugin):boolean|nil
-- version = "", -- enable this to try installing the latest stable versions of plugins
-- version = "*", -- enable this to try installing the latest stable versions of plugins
},
-- leave nil when passing the spec as the first argument to setup()
spec = nil, ---@type LazySpec
lockfile = vim.fn.stdpath("config") .. "/lazy-lock.json", -- lockfile generated after running update.
concurrency = jit.os:find("Windows") and (vim.loop.available_parallelism() 2) or nil, ---@type number limit the maximum amount of concurrent tasks
concurrency = jit.os:find("Windows") and (vim.loop.available_parallelism() * 2) or nil, ---@type number limit the maximum amount of concurrent tasks
git = {
-- defaults for the `Lazy log` command
-- log = { "-10" }, -- show the last 10 commits
@ -441,25 +441,25 @@ CONFIGURATION *lazy.nvim-lazy.nvim-configuration*
-- Show pills on top of the Lazy window
pills = true, ---@type boolean
icons = {
cmd = " ",
config = "",
event = "",
ft = " ",
init = " ",
import = " ",
keys = " ",
cmd = " ",
config = "",
event = "",
ft = " ",
init = " ",
import = " ",
keys = " ",
lazy = "󰒲 ",
loaded = "",
not_loaded = "",
plugin = " ",
runtime = " ",
source = " ",
start = "",
task = " ",
loaded = "",
not_loaded = "",
plugin = " ",
runtime = " ",
source = " ",
start = "",
task = " ",
list = {
"",
"",
"",
"",
"",
"",
"",
},
},
@ -488,11 +488,11 @@ CONFIGURATION *lazy.nvim-lazy.nvim-configuration*
},
diff = {
-- diff command <d> can be one of:
-- browser: opens the github compare view. Note that this is always mapped to <K> as well,
-- * browser: opens the github compare view. Note that this is always mapped to <K> as well,
-- so you can have a different command for diff <d>
-- git: will run git diff and open a buffer with filetype git
-- terminal_git: will open a pseudo terminal with git diff
-- diffview.nvim: will open Diffview to show the diff
-- * git: will run git diff and open a buffer with filetype git
-- * terminal_git: will open a pseudo terminal with git diff
-- * diffview.nvim: will open Diffview to show the diff
cmd = "git",
},
checker = {
@ -535,7 +535,7 @@ CONFIGURATION *lazy.nvim-lazy.nvim-configuration*
readme = {
enabled = true,
root = vim.fn.stdpath("state") .. "/lazy/readme",
files = { "README.md", "lua//README.md" },
files = { "README.md", "lua/**/README.md" },
-- only generate markdown helptags for plugins that dont have docs
skip_if_doc_exists = true,
},
@ -556,17 +556,17 @@ If you dont want to use a Nerd Font, you can replace the icons with Unicode s
ui = {
icons = {
cmd = "⌘",
config = "",
event = "",
ft = "",
init = "",
keys = "",
plugin = "",
runtime = "",
source = "",
start = "",
task = "",
lazy = " ",
config = "🛠",
event = "📅",
ft = "📂",
init = "",
keys = "🗝",
plugin = "🔌",
runtime = "💻",
source = "📄",
start = "🚀",
task = "📌",
lazy = "💤 ",
},
},
}
@ -671,7 +671,7 @@ Example of configuring lualine.nvim ~
{
require("lazy.status").updates,
cond = require("lazy.status").has_updates,
color = { fg = "ff9e64" },
color = { fg = "#ff9e64" },
},
},
},
@ -784,7 +784,7 @@ Example:
}
<
- Any lua file in `~/.config/nvim/lua/plugins/.lua` will be automatically merged in the main plugin spec
- Any lua file in `~/.config/nvim/lua/plugins/*.lua` will be automatically merged in the main plugin spec
For a real-life example, you can check LazyVim
<https://github.com/LazyVim/LazyVim> and more specifically:
@ -836,7 +836,7 @@ PACKER.NVIM ~
- `run` `build`
- `lock` `pin`
- `disable=true` `enabled = false`
- `tag=''` `version=""`
- `tag='*'` `version="*"`
- `after` **not needed** for most use-cases. Use `dependencies` otherwise.
- `wants` **not needed** for most use-cases. Use `dependencies` otherwise.
- `config` dont support string type, use `fun(LazyPlugin)` instead.