VimCompletesMe
A super simple, super minimal, super light-weight tab-completion plugin for Vim.
Without any configuration, the Tab key will, depending on the context, offer:
- Vim's local keyword completion (Ctrl-X_Ctrl-N)
- File path completion when typing a path (Ctrl-X_Ctrl-F)
- Omni-completion after typing a character specified by
g:vcm_omni_pattern
(Ctrl-X_Ctrl-O)
With a b:vcm_tab_complete
variable, you can set the Tab key to use the
following type of completions:
- Dictionary words (Ctrl-X_Ctrl-K)
- User-defined completion (Ctrl-X_Ctrl-U)
- Tags (Ctrl-X_Ctrl-])
- Vim command line (Ctrl-X_Ctrl-V)
- Omni completion (Ctrl-X_Ctrl-O)
If any of above types of completions fails to return any results, hitting Tab again will switch back to Vim's local keyword completion. VimCompletesMe will go back to trying the special completion for the next tab completion.
You can set the b:vcm_tab_complete
variable interactively, or in an
autocmd
. For instance, the autocmd
below will use Vim Command Line
completion for all vim filetypes:
autocmd FileType vim let b:vcm_tab_complete = 'vim'
Installation
If you use Vim 8 or better, simply copy and paste:
git clone git://github.com/ajh17/VimCompletesMe.git ~/.vim/pack/vendor/start/VimCompletesMe
Once the helptags have been generated (:helptags ALL
), see :h VimCompletesMe
for usage.
Thanks
- bairui for helping me with this plugin, and for the kickass name.
- You for using it!
License
Copyright (c) Akshay Hegde. Distributed under the same terms as Vim itself. See
:help license