important!!!!! This Repo is forked from https://github.com/craigemery/vim-autotag, the original repo will generate tags via 'ctags -a' which means appending tags to tags files.
I modified it to regenerate tags for the whole project, while the edited file is saved. This maybe very slow for big projects.
If you use ctags to make tags files of your source, it's nice to be able to re-run ctags on a source file when you save it.
However, using ctags -a will only change existing entries in a tags file or add new ones. It doesn't delete entries that no longer exist. Should you delete an entity from your source file that's represented by an entry in a tags file, that entry will remain after calling ctags -a.
This python function will do two things:
-
It will search for a tags file starting in the directory where your source file resides and moving up a directory at a time until it either finds one or runs out of directories to try.
-
Should it find a tags file, it will then delete all entries in said tags file referencing the source file you've just saved and then execute ctags -a on that source file using the relative path to the source file from the tags file.
This way, every time you save a file, your tags file will be seamlessly updated.
Currently I suggest you use Vundle and install as a normal Bundle
From the Vim command-line
: BundleInstall 'craigemery/vim-autotag'
And add to your ~/.vimrc
Bundle 'craigemery/vim-autotag'
Or you can manually install cd git clone git://github.com/craigemery/vim-autotag.git cd ~/.vim/ mkdir -p plugin cp ~/vim-autotag.git/plugin/autotag.vim plugin/
git clone git://github.com/craigemery/vim-autotag.git ~/.vim/bundle/vim-autotag
Autotag can be configured using the following global variables:
Name | Purpose |
---|---|
g:autotagmaxTagsFileSize | a cap on what size tag file to strip etc |
g:autotagExcludeSuffixes | suffixes to not ctags on |
g:autotagVerbosityLevel | logging verbosity (as in Python logging module) |
g:autotagCtagsCmd | name of ctags command |
g:autotagTagsFile | name of tags file to look for |
g:autotagDisabled | Disable autotag (enable by setting to any non-blank value) |
g:autotagStopAt | stop looking for a tags file (and make one) at this directory (defaults to $HOME) |
Example:
let g:autotagTagsFile=".tags"
Like autotag.vim? Follow the repository on GitHub and vote for it on vim.org. And if you're feeling especially charitable, follow [craigemery] on GitHub.
Copyright (c) Craig Emery. Distributed under the same terms as Vim itself.
See :help license
.