vundle/README.md

About

Vundle is a short cut for Vimbundle and is a Vim plugin manager.

Quick start

1. Setup Vundle:

    git clone http://github.com/gmarik/vundle.git ~/.vim/vundle.git
   

2. Configure bundles:

   Put into your ~/.vimrc:

    set rtp+=~/.vim/vundle.git/ 
    call vundle#rc()
   
    " original repos on github
    Bundle 'tpope/vim-fugitive'
    Bundle 'lokaltog/vim-easymotion'
    Bundle 'rstacruz/sparkup', {'rtp': 'vim/'}
    " vim-scripts repos
    Bundle 'L9'
    Bundle 'FuzzyFinder'
    Bundle 'rails.vim'
    " non github repos
    Bundle 'git://git.wincent.com/command-t.git'
    " ...
   
    " NOTE: if some plugins fail to work, put the config *between* lines:
    " filetype off
    "
    " Vundle stuff here...
    "
    " filetype plugin indent on 
   

3. Install configured bundles:

   Launch vim, run :BundleInstall.

   Windows users see Vundle for Windows

   Installing requires Git and triggers Git clone for each configured repo to ~/.vim/bundle/.

Why Vundle

Vundle allows to:

• keep track and configure your scripts right in .vimrc
• install configured scripts (aka bundle)
• update configured scripts
• search by name all available vim scripts
• clean unused scripts up
• run above actions in a single keypress with interactive mode

Also Vundle:

• manages runtime path of your installed scripts
• regenerates helptag atomatically

Docs

see :h vundle vimdoc for more details.

Examples

See gmarik's vimrc for working example.

Contributors

• Brad Anderson (windows support)
• Ryan W
• gmarik
• and others

Thank you!

Inspiration and ideas from

• pathogen
• bundler
• Scott Bronson

Also

• Vundle was developed and tested with Vim 7.3 on OSX, Linux and Windows
• Vundle tries to be as KISS as possible

TODO:

Vundle is a work in progress so any ideas/patches appreciated

• √ activate newly added bundles on .vimrc reload or after :BundleInstall
• √ use preview window for search results
• √ vim documentation
• tests
• improve error handling
• put vundle to bundles/ too(will fix vundle help)
• :VundleUpdate - self.update
• handle dependencies
• allow specify revision/version?
• search by description aswell
• show descrption in search results
• instead sourcing .vimrc before installation come up with another solution
• make it rock!