pt/vundle
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

edit README

Browse Source 
fix code formatting, fix grammar and capitalization, update links, and much more
This commit is contained in:
Rory O’Kane 2013-08-14 14:09:17 -04:00
parent c3ec879694
commit f8fdaebb8a
1 changed files with 80 additions and 79 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

151
README.md
View File

@ -6,139 +6,140 @@
## Quick start ## Quick start
1. Setup [Vundle]: 1. Set up [Vundle]:
``` ```
$ git clone https://github.com/gmarik/vundle.git ~/.vim/bundle/vundle $ git clone https://github.com/gmarik/vundle.git ~/.vim/bundle/vundle
``` ```
2. Configure bundles: 2. Configure bundles:
Sample `.vimrc`: Sample `.vimrc`:
```vim ```vim
set nocompatible " be iMproved set nocompatible " be iMproved
filetype off " required! filetype off " required!
set rtp+=~/.vim/bundle/vundle/ set rtp+=~/.vim/bundle/vundle/
call vundle#rc() call vundle#rc()
" let Vundle manage Vundle " let Vundle manage Vundle
" required! " required!
Bundle 'gmarik/vundle' Bundle 'gmarik/vundle'
" My Bundles here: " My bundles here:
" "
" original repos on github " original repos on GitHub
Bundle 'tpope/vim-fugitive' Bundle 'tpope/vim-fugitive'
Bundle 'Lokaltog/vim-easymotion' Bundle 'Lokaltog/vim-easymotion'
Bundle 'rstacruz/sparkup', {'rtp': 'vim/'} Bundle 'rstacruz/sparkup', {'rtp': 'vim/'}
Bundle 'tpope/vim-rails.git' Bundle 'tpope/vim-rails.git'
" vim-scripts repos " vim-scripts repos
Bundle 'L9' Bundle 'L9'
Bundle 'FuzzyFinder' Bundle 'FuzzyFinder'
" non github repos " non-GitHub repos
Bundle 'git://git.wincent.com/command-t.git' Bundle 'git://git.wincent.com/command-t.git'
" git repos on your local machine (ie. when working on your own plugin) " Git repos on your local machine (i.e. when working on your own plugin)
Bundle 'file:///Users/gmarik/path/to/plugin' Bundle 'file:///Users/gmarik/path/to/plugin'
" ... " ...
filetype plugin indent on " required! filetype plugin indent on " required!
" "
" Brief help " Brief help
" :BundleList - list configured bundles " :BundleList - list configured bundles
" :BundleInstall(!) - install(update) bundles " :BundleInstall(!) - install (update) bundles
" :BundleSearch(!) foo - search(or refresh cache first) for foo " :BundleSearch(!) foo - search (or refresh cache first) for foo
" :BundleClean(!) - confirm(or auto-approve) removal of unused bundles " :BundleClean(!) - confirm (or auto-approve) removal of unused bundles
" "
" see :h vundle for more details or wiki for FAQ " see :h vundle for more details or wiki for FAQ
" NOTE: comments after Bundle command are not allowed.. " NOTE: comments after Bundle commands are not allowed.
```
```
3. Install configured bundles: 3. Install configured bundles:
Launch `vim`, run `:BundleInstall` Launch `vim`, run `:BundleInstall`
(or `vim +BundleInstall +qall` for CLI lovers) (or `vim +BundleInstall +qall` for CLI lovers)
*Windows users* see [Vundle for Windows](https://github.com/gmarik/vundle/wiki/Vundle-for-Windows) *Windows users*: see [Vundle for Windows](https://github.com/gmarik/vundle/wiki/Vundle-for-Windows)
Installing requires [Git] and triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`. Installation requires [Git] and triggers [`git clone`](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`.
4. Consider [donating](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=T44EJZX8RBUWY) 4. Consider [donating](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=T44EJZX8RBUWY)
[*Thank you*](http://j.mp/rSbm01) for supporting this project! ) [*Thank you*](http://j.mp/rSbm01) for supporting this project!
## Why Vundle ## Why Vundle
[Vundle] allows to: [Vundle] allows you to:
- keep track and configure your scripts right in `.vimrc` - keep track of and configure your scripts right in `.vimrc`
- [install] configured scripts (aka bundle) - [install] configured scripts (a.k.a. bundle)
- [update] configured scripts - [update] configured scripts
- [search] by name [all available vim scripts] - [search] by name [all available Vim scripts]
- [clean] unused scripts up - [clean] unused scripts up
- run above actions in a *single keypress* with [interactive mode] - run the above actions in a *single keypress* with [interactive mode]
Also [Vundle]: [Vundle] also:
- manages runtime path of your installed scripts - manages the [runtime path] of your installed scripts
- regenerates helptag automatically - [regenerates help tags][helptags] automatically
## Docs ## Docs
see [`:h vundle`](vundle/blob/master/doc/vundle.txt#L1) vimdoc for more details. See the [`:h vundle`](https://github.com/gmarik/vundle/blob/master/doc/vundle.txt) Vimdoc for more details.
## People Using Vundle ## People using Vundle
see [Examples](https://github.com/gmarik/vundle/wiki/Examples) see [Examples](https://github.com/gmarik/vundle/wiki/Examples)
## FAQ ## FAQ
see [wiki](https://github.com/gmarik/vundle/wiki) see [the wiki](https://github.com/gmarik/vundle/wiki#faq)
## Contributors ## Contributors
see [vundle contributors](https://github.com/gmarik/vundle/graphs/contributors) see [Vundle contributors](https://github.com/gmarik/vundle/graphs/contributors)
*Thank you!* *Thank you!*
## Inspiration and ideas from ## Inspiration and ideas from
* [pathogen] * [pathogen.vim]
* [bundler] * [Bundler]
* [Scott Bronson](http://github.com/bronson) * [Scott Bronson](http://github.com/bronson)
## Also ## Also
* Vundle was developed and tested with [Vim] 7.3 on `OSX`, `Linux` and `Windows` * Vundle was developed and tested with [Vim] 7.3 on OS X, Linux and Windows
* Vundle tries to be as [KISS](http://en.wikipedia.org/wiki/KISS_principle) as possible * Vundle tries to be as [KISS](http://en.wikipedia.org/wiki/KISS_principle) as possible
## TODO: ## TODO:
[Vundle] is a work in progress so any ideas/patches appreciated [Vundle] is a work in progress, so any ideas and patches are appreciated.
* √ 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
* √ put vundle to bundles/ too(will fix vundle help) * ✓ put Vundle in `bundles/` too (will fix Vundle help)
* √ tests * ✓ tests
* √ improve error handling * ✓ improve error handling
* allow specify revision/version? * allow specifying revision/version?
* handle dependencies * handle dependencies
* show description in search results * show description in search results
* search by description as well * search by description as well
* make it rock! * make it rock!
[Vundle]:http://github.com/gmarik/vundle [Vundle]:http://github.com/gmarik/vundle
[Pathogen]:http://github.com/tpope/vim-pathogen/ [pathogen.vim]:http://github.com/tpope/vim-pathogen/
[Bundler]:https://github.com/bundler/bundler [Bundler]:https://github.com/bundler/bundler
[Vim]:http://www.vim.org [Vim]:http://www.vim.org
[Git]:http://git-scm.com [Git]:http://git-scm.com
[all available vim scripts]:http://vim-scripts.org/vim/scripts.html [all available Vim scripts]:http://vim-scripts.org/vim/scripts.html
[helptags]:http://vimdoc.sourceforge.net/htmldoc/helphelp.html#:helptags
[runtime path]:http://vimdoc.sourceforge.net/htmldoc/options.html#%27runtimepath%27
[install]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L110-124 [install]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L115-129
[update]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L128-134 [update]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L131-137
[search]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L136-158 [search]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L139-161
[clean]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L168-180 [clean]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L171-L183
[interactive mode]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L184-210 [interactive mode]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L186-213