Tag errors when using :h

user_7144521 0
Viewed 1771

I have ctags installed on my machine through Homebrew, but I haven't generated any tags files. However, when running the command :h word I get the following two errors:

E432: Tags file not sorted: /usr/local/share/vim/vim81/doc/tags
E426: tag not found: b:match_word@en

I'm not sure how to go about fixing this. Is there a default tags file included with Vim for the help system? I have the youcompleteme plugin installed, would that mess with tag functionality?

exuberant-ctags ctags vim
3 Answers

Upgrading to macOS Calatina gave me the same issue with the help in vim. To fix the problem, I just upgraded vim. 

brew upgrade vim

Output:

vim 8.1.2100 -> 8.1.2250

user_74143650

I assume you are using MacOS Catalina? In that case there seems to be a bug with the tags file sorting.

Open Vim Issues: 5061 5039

Fixed by by PR 955 in v8.2.0314

Check also similar bug reports for MacVim and Neovim.

MacOS Catalina ships with v8.1 which does not include the patch

$ vim --version
VIM - Vi IMproved 8.1 (2018 May 18, compiled Dec 13 2019 14:45:40)
Included patches: 1-503, 505-680, 682-1312
user_57100770

Is there a default tags file included with Vim for the help system?

Yes, it should work out-of-the-box. But you can always recreate them (note that write privilege is required):

:helptags $VIMRUNTIME/doc

Alternatively, you can recreate all tags at once, including all installed plugins, with :helptags ALL.

user_44198020
Related