NAME

Bash::Completion::Plugins::VimTag - Bash completion plugin for vim tags

DESCRIPTION

This is a Bash::Completion plugin that can complete on tags generated by ctags. My setup places all tags files from different projects in a ~/.ctagsdir directory so vim can know about them regardless of the current directory:

    ~/.ctagsdir
    ├── project1
    │   └── tags
    ├── project2
    │   └── tags
    └── perlbrew
        └── tags

My <.vimrc> then contains:

    set tags+=~/.ctagsdir/*/tags

And <.bashrc> contains:

    alias vit='vi -t'

If you keep your tags in a different directory - for example, your main repository directory -, you can set the CTAGSDIR environment variable to that directory and this plugin will scan the tags files in that directory.

The reason for the perlbrew/tags file shown in the tree above is that I want to have tags for all installed modules, so I generate them with:

    find $PERLBREW_ROOT/perls/$PERLBREW_PERL/lib -name \*.pm | \
        ctags -f ~/.ctagsdir/perlbrew/tags --recurse --languages=Perl -L -;