bug: updating with lazy.nvim does not work

[laytan]

Neovim version (nvim -v)

v0.9.0-dev-1326+g7c8c15507

Operating system/version

MacOS 13.0.1

Output of :AerialInfo

Aerial Info

Filetype:
Configured backends:
treesitter (not supported) [No treesitter parser for ]
lsp (not supported) [No LSP client found]
markdown (not supported) [Filetype is not markdown]
man (not supported) [Filetype is not man]
Show symbols: Class, Constructor, Enum, Function, Interface, Module, Method, Struct

Describe the bug

Lazy prompts to update, when updating, it fails because of changes to doc/tags.
Double checked that there are no local changes.

Steps To Reproduce

1. nvim -u repro.lua
2. :Lazy
3. U

Expected Behavior

Update successfully

Minimal example file

n/a

Minimal init.lua

-- DO NOT change the paths and don't remove the colorscheme
local root = vim.fn.fnamemodify("./.repro", ":p")

-- set stdpaths to use .repro
for _, name in ipairs({ "config", "data", "state", "cache" }) do
  vim.env[("XDG_%s_HOME"):format(name:upper())] = root .. "/" .. name
end

-- bootstrap lazy
local lazypath = root .. "/plugins/lazy.nvim"
if not vim.loop.fs_stat(lazypath) then
  vim.fn.system({
    "git",
    "clone",
    "--filter=blob:none",
    "--single-branch",
    "https://github.com/folke/lazy.nvim.git",
    lazypath,
  })
end
vim.opt.runtimepath:prepend(lazypath)

-- install plugins
local plugins = {
  "folke/tokyonight.nvim",
  {
    "stevearc/aerial.nvim",
    config = function()
      require("aerial").setup({
        -- add your aerial config here
      })
    end,
  },
  {
    "nvim-treesitter/nvim-treesitter",
    build = ":TSUpdate",
    config = function()
      require("nvim-treesitter.configs").setup({
        ensure_installed = { "c", "lua" },
        auto_install = true,
        highlight = { enable = true },
      })
    end,
  },
  -- add any other plugins here
}
require("lazy").setup(plugins, {
  root = root .. "/plugins",
})

vim.cmd.colorscheme("tokyonight")
-- add anything else here

Additional context

No response

[kiyoon]

I have the same issue.

[stevearc]

Not sure how this could have happened, as I use a CI script to keep the tags file in sync with the help docs. Regardless, I've decided to put doc/tags in gitignore and stop checking it in. All the modern package managers (lazy, packer, paq) will autogenerate helptags for you, and if you're managing packages yourself you hopefully know enough to call :helptags ALL.

That said, that will prevent this sort of issue moving forward, but your current install will still refuse to update. You need to go to the repo (by default installed in ~/.local/share/nvim/lazy/aerial.nvim) and clear the changes (a git checkout . will work). It's probably best to also pull latest yourself (git pull) so that lazy won't regenerate the changes in that file when you next open vim. After that, updating via lazy should work.

If you think that the repo doesn't have any changes, then you are looking in the wrong place. If you can't find the repo, you can always mark aerial as disabled in lazy, then clean (which removes the repo and deletes the lockfile entry), then re-enable it.

[laytan]

Thanks, works great again!

[olimorris]

Came to this late but thanks for fixing.

@stevearc - might be worth pinning this solution to the issues tab as a lot of users may experience this and be unable to update without your workaround above