summaryrefslogtreecommitdiffstatshomepage
path: root/runtime/lua/vim/pack.lua
diff options
context:
space:
mode:
authorEvgeni Chasnovski <evgeni.chasnovski@gmail.com>2026-04-16 17:33:20 +0300
committerGitHub <noreply@github.com>2026-04-16 10:33:20 -0400
commit42e9d8dfd1056e99713cb3f8a0155d1555cf896d (patch)
treec483454c228bad775a63a3891ff007f3f33d9314 /runtime/lua/vim/pack.lua
parent711f3cc299d8bedc46653a97d2b985aa18ec4925 (diff)
docs(pack): improve "Synchronize across machines" steps #39122
Problem: Sometimes automatic lockfile synchronization after `:restart` might fail, like due to bad/absent Internet connection. This would remove failed to install entries from the lockfile (since they are not on disk and lockfile is meant to lock the latest plugin version on disk). Solution: Document that this should be treated as an unwanted update and use steps similar to "Revert plugin after an update" use case.
Diffstat (limited to 'runtime/lua/vim/pack.lua')
-rw-r--r--runtime/lua/vim/pack.lua4
1 files changed, 3 insertions, 1 deletions
diff --git a/runtime/lua/vim/pack.lua b/runtime/lua/vim/pack.lua
index f69a096ace..60b1680f7f 100644
--- a/runtime/lua/vim/pack.lua
+++ b/runtime/lua/vim/pack.lua
@@ -138,7 +138,9 @@
---- On secondary machine:
--- - Pull from the server.
--- - |:restart|. New plugins (not present locally, but present in the lockfile)
---- are installed at proper revision.
+--- are installed at proper revision. If some installation has failed but
+--- you know it should not (like due to bad Internet connection),
+--- revert |vim.pack-lockfile| and |:restart| again.
--- - `vim.pack.update(nil, { target = 'lockfile' })`. Read and confirm.
--- - Manually delete outdated plugins (present locally, but were not present
--- in the lockfile prior to restart) with `vim.pack.del( { 'plugin' })`.