README.md

This commit is contained in:
gmarik 2011-02-18 21:35:58 -06:00
parent 10cdcdfbd4
commit 54825a51af

View File

@ -2,23 +2,7 @@
[Vundle] is a short cut for **V**imb**undle** and is a [Vim] plugin manager. [Vundle] is a short cut for **V**imb**undle** and is a [Vim] plugin manager.
## Why ## Quick start
[Vundle] allows to:
- keep track and configure your scripts right in `.vimrc`
- install configured scripts (aka bundle)
- search [all available vim scripts] by name
- clean unused scripts up
Also as a bonus [Vundle]:
- manages runtime path of your installed scripts
- regenerates helptag atomatically
[Vundle] takes advantage of [vim-scripts.org](http://vim-scripts.org)
in order to install/search [all available vim scripts]
## How
1. Setup [Vundle]: 1. Setup [Vundle]:
@ -45,34 +29,25 @@ in order to install/search [all available vim scripts]
Installing requires [Git] and triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`. Installing requires [Git] and triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`.
## Script installation ## Why Vundle
`BundleInstall` installs script only if it hasn't been already installed. [Vundle] allows to:
`BundleInstall` is faster than `BundleInstall!` (note bang at the end) because latter fetches scripts without any checks.
Use `BundleInstall` to install new scripts. Use `BundleInstall!` to update scripts.
## Searching - keep track and configure your scripts right in `.vimrc`
- install configured scripts (aka bundle)
- update configured scripts
- search [all available vim scripts] by name
- clean unused scripts up
:BundleSearch foo Also as a bonus [Vundle]:
lists search results in new split window, ie: - manages runtime path of your installed scripts
- regenerates helptag atomatically
Bundle "VimFootnotes"
Bundle "foo.vim"
so you can just copy ones you need to `.vimrc`. ## Docs
:BundleSearch! foo see [documentation](doc/vundle.txt) for more details.
refreshes script list before performing actual search.
Searching requires [`curl`](http://curl.haxx.se/)
## Cleaning up
:BundleClean
confirms removal of unused script dirs from your `.vim/bundle`. `BundleClean!` does that silently.
## Examples ## Examples
@ -95,7 +70,7 @@ confirms removal of unused script dirs from your `.vim/bundle`. `BundleClean!` d
* √ activate newly added bundles on .vimrc reload or after :BundleInstall * √ activate newly added bundles on .vimrc reload or after :BundleInstall
* √ use preview window for search results * √ use preview window for search results
* Vim documentation * √ vim documentation
* improve error handling * improve error handling
* allow specify revision/version? * allow specify revision/version?
* search by description aswell * search by description aswell