diff options
| author | Evgeni Chasnovski <evgeni.chasnovski@gmail.com> | 2026-01-29 16:24:33 +0200 |
|---|---|---|
| committer | Evgeni Chasnovski <evgeni.chasnovski@gmail.com> | 2026-01-29 16:24:33 +0200 |
| commit | 1aa81290a4116f9e15039ee10c4bfa2ae76f0d31 (patch) | |
| tree | 340afb95b9a113f8ed13a0469a5b8bc9f8ce6c3d /runtime/lua/vim/pack.lua | |
| parent | 19a3b6778979e0b328f9a791a9f92296fd406690 (diff) | |
| download | rneovim-1aa81290a4116f9e15039ee10c4bfa2ae76f0d31.tar.gz rneovim-1aa81290a4116f9e15039ee10c4bfa2ae76f0d31.tar.bz2 rneovim-1aa81290a4116f9e15039ee10c4bfa2ae76f0d31.zip | |
docs(pack): clarify caveats about installing based on the lockfile
Diffstat (limited to 'runtime/lua/vim/pack.lua')
| -rw-r--r-- | runtime/lua/vim/pack.lua | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/runtime/lua/vim/pack.lua b/runtime/lua/vim/pack.lua index 780e5f278a..b68856a0a6 100644 --- a/runtime/lua/vim/pack.lua +++ b/runtime/lua/vim/pack.lua @@ -18,9 +18,10 @@ ---located at `$XDG_CONFIG_HOME/nvim/nvim-pack-lock.json`. It is a JSON file that ---is used to persistently track data about plugins. ---For a more robust config treat lockfile like its part: put under version control, etc. ----In this case all plugins from the lockfile will be installed at once and ----at lockfile's revision (instead of inferring from `version`). ----Should not be edited by hand. Corrupted data for installed plugins is repaired +---In this case all plugins from the lockfile will be installed at once and at lockfile's revision +---(instead of inferring from `version`). This is done on the very first `vim.pack` function call +---to ensure that lockfile is aligned with what is actually on the disk. +---Lockfile should not be edited by hand. Corrupted data for installed plugins is repaired ---(including after deleting whole file), but `version` fields will be missing ---for not yet added plugins. --- @@ -160,6 +161,7 @@ --- ---[vim.pack-events]() --- +---Performing actions via `vim.pack` functions can trigger these events: ---- [PackChangedPre]() - before trying to change plugin's state. ---- [PackChanged]() - after plugin's state has changed. --- @@ -195,6 +197,7 @@ ---end --- ----- If hooks need to run on install, run this before `vim.pack.add()` +----- To act on install from lockfile, run before very first `vim.pack.add()` ---vim.api.nvim_create_autocmd('PackChanged', { callback = hooks }) ---``` |