mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2026-05-23 21:30:11 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(pack): improve "Synchronize across machines" steps #39122

Browse Source 
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.
This commit is contained in:
Evgeni Chasnovski
2026-04-16 17:33:20 +03:00
committed by GitHub
parent 711f3cc299
commit 42e9d8dfd1
2 changed files with 6 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
runtime/doc/pack.txt
View File

@@ -334,7 +334,9 @@ Synchronize config across machines ~
• 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' })`. They

4
runtime/lua/vim/pack.lua
View File

@@ -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' })`.