Docs!
This commit is contained in:
parent
a999d93fd2
commit
39bbfb3512
15
README.md
15
README.md
@ -39,10 +39,11 @@
|
|||||||
[Vundle] allows to:
|
[Vundle] allows to:
|
||||||
|
|
||||||
- keep track and configure your scripts right in `.vimrc`
|
- keep track and configure your scripts right in `.vimrc`
|
||||||
- install configured scripts (aka bundle)
|
- [install] configured scripts (aka bundle)
|
||||||
- update configured scripts
|
- [update] configured scripts
|
||||||
- search [all available vim scripts] by name
|
- [search] [all available vim scripts] by name
|
||||||
- clean unused scripts up
|
- [clean] unused scripts up
|
||||||
|
- provides [interface] to run install|update|search scripts with single keypress
|
||||||
|
|
||||||
Also as a bonus [Vundle]:
|
Also as a bonus [Vundle]:
|
||||||
|
|
||||||
@ -90,3 +91,9 @@ see [`:h vundle`](vundle/blob/master/doc/vundle.txt) vimdoc for more details.
|
|||||||
[Vim]:http://vim.org
|
[Vim]:http://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
|
||||||
|
|
||||||
|
[install]:(https://github.com/gmarik/vundle/blob/master/doc/vundle.txt:L96G)
|
||||||
|
[update]:(https://github.com/gmarik/vundle/blob/master/doc/vundle.txt:L115G)
|
||||||
|
[search]:(https://github.com/gmarik/vundle/blob/master/doc/vundle.txt:L122G)
|
||||||
|
[clean]:(https://github.com/gmarik/vundle/blob/master/doc/vundle.txt:L142G)
|
||||||
|
[interface]:(https://github.com/gmarik/vundle/blob/master/doc/vundle.txt:L155G)
|
||||||
|
@ -13,6 +13,7 @@ CONTENTS ~
|
|||||||
4.3. Updating scripts |vundle-scripts-update|
|
4.3. Updating scripts |vundle-scripts-update|
|
||||||
4.4. Searching scripts |vundle-scripts-search|
|
4.4. Searching scripts |vundle-scripts-search|
|
||||||
4.5. Cleanup |vundle-scripts-cleanup|
|
4.5. Cleanup |vundle-scripts-cleanup|
|
||||||
|
5. Interactive mode |vundle-interactive|
|
||||||
|
|
||||||
===========================================================================
|
===========================================================================
|
||||||
|
|
||||||
@ -30,7 +31,7 @@ Vundle allows to:
|
|||||||
- search [all available vim scripts] by name
|
- search [all available vim scripts] by name
|
||||||
- clean up from unused scripts
|
- clean up from unused scripts
|
||||||
|
|
||||||
Also as *Vundle* :
|
Also *Vundle* :
|
||||||
|
|
||||||
- manages runtime path of your installed scripts
|
- manages runtime path of your installed scripts
|
||||||
- regenerates helptag atomatically
|
- regenerates helptag atomatically
|
||||||
@ -83,6 +84,15 @@ command in `.vimrc`: >
|
|||||||
or >
|
or >
|
||||||
Bundle 'script_name' " 'script-name' should be an official script name (see |vundle-scripts-search| )
|
Bundle 'script_name' " 'script-name' should be an official script name (see |vundle-scripts-search| )
|
||||||
|
|
||||||
|
Vundle loves Github, that's why short uris can be used to configure bundles: >
|
||||||
|
|
||||||
|
Bundle 'tpope/fugitive'
|
||||||
|
|
||||||
|
equals full uri >
|
||||||
|
|
||||||
|
Bundle 'http://github.com/tpope/fugitive.git'
|
||||||
|
|
||||||
|
|
||||||
4.2 INSTALL SCRIPTS ~
|
4.2 INSTALL SCRIPTS ~
|
||||||
*vundle-scripts-install* *BundleInstall*
|
*vundle-scripts-install* *BundleInstall*
|
||||||
run >
|
run >
|
||||||
@ -91,6 +101,17 @@ run >
|
|||||||
installs configured scripts. Newly installed scripts will be automatically
|
installs configured scripts. Newly installed scripts will be automatically
|
||||||
enabled. Except special cases requiring compilation or preconfiguration.
|
enabled. Except special cases requiring compilation or preconfiguration.
|
||||||
|
|
||||||
|
BundleInstall allows to install scripts by name:>
|
||||||
|
|
||||||
|
:BundleIntall unite.vim
|
||||||
|
|
||||||
|
installs and activates unite.vim. You can use Tab to autocomplete known script names.
|
||||||
|
NOTE: installation, as just described, doesn't automatically configure scripts;
|
||||||
|
you have to configure them manually.
|
||||||
|
Some scripts may require additional manipulation(ie CommandT requires compilation).
|
||||||
|
That's why those scripts cannot be automatically activated right after installation
|
||||||
|
|
||||||
|
|
||||||
4.3 UPDATE SCRIPTS ~
|
4.3 UPDATE SCRIPTS ~
|
||||||
*vundle-scripts-update* *BundleInstall!*
|
*vundle-scripts-update* *BundleInstall!*
|
||||||
run >
|
run >
|
||||||
@ -101,31 +122,59 @@ installs or updates configured scripts.
|
|||||||
4.4 SEARCHING ~
|
4.4 SEARCHING ~
|
||||||
*vundle-scripts-search* *BundleSearch*
|
*vundle-scripts-search* *BundleSearch*
|
||||||
run >
|
run >
|
||||||
:BundleSearch foo
|
:Bundles foo
|
||||||
|
|
||||||
lists search results in new split window, ie:
|
lists search results in new split window, ie:
|
||||||
>
|
>
|
||||||
Bundle "VimFootnotes"
|
Bundle "VimFootnotes"
|
||||||
Bundle "foo.vim"
|
Bundle "foo.vim"
|
||||||
|
|
||||||
so you can just copy ones you need to `.vimrc`. *BundleSearch!*
|
|
||||||
>
|
>
|
||||||
:BundleSearch! foo " note bang(!)
|
and >
|
||||||
|
|
||||||
|
:Bundles! foo
|
||||||
|
|
||||||
refreshes script list before performing actual search.
|
refreshes script list before performing actual search.
|
||||||
|
|
||||||
|
If command is run without argument it displays all known scripts.
|
||||||
|
|
||||||
Searching requires [`curl`](http://curl.haxx.se/)
|
Searching requires [`curl`](http://curl.haxx.se/)
|
||||||
|
|
||||||
4.5 CLEANING UP ~
|
4.5 CLEANING UP ~
|
||||||
*vundle-scripts-cleanup* *BundleClean*
|
*vundle-scripts-cleanup* *BundleClean*
|
||||||
run >
|
run >
|
||||||
|
|
||||||
:BundleClean
|
:BundleClean
|
||||||
|
|
||||||
confirms removal of unused script dirs from your `.vim/bundle`.
|
requires confirmation before removal of unused script-dirs from your `.vim/bundle`.
|
||||||
*BundleClean!*
|
|
||||||
>
|
*BundleClean!* >
|
||||||
:BundleClean!
|
:BundleClean!
|
||||||
|
|
||||||
removes unused scripts with no questions.
|
removes unused scripts with no questions.
|
||||||
|
|
||||||
|
5. INTERACTIVE MODE ~
|
||||||
|
*vundle-interactive*
|
||||||
|
Vundle provides simple interactive mode to help you explore new scripts easily.
|
||||||
|
Interactive mode is available as result of :Bundles command. For instance running >
|
||||||
|
|
||||||
|
:Bundle unite
|
||||||
|
|
||||||
|
displays: >
|
||||||
|
|
||||||
|
"Keymap: i - Install bundle; c - Cleanup; r - Refine list; R - Reload list
|
||||||
|
"Search results for: unite
|
||||||
|
Bundle 'unite.vim'
|
||||||
|
Bundle 'unite-yarm'
|
||||||
|
Bundle 'unite-gem'
|
||||||
|
Bundle 'unite-locate'
|
||||||
|
Bundle 'unite-font'
|
||||||
|
Bundle 'unite-colorscheme'
|
||||||
|
|
||||||
|
allows running certain commands with single keypress:
|
||||||
|
>
|
||||||
|
*i* - runs BundleInstall with name taken from line cursor is positioned on
|
||||||
|
*c* - runs BundleCleanup
|
||||||
|
*r* - alows to refine list. requires a string to refine list with
|
||||||
|
*R* - fetches fresh script list from server
|
||||||
|
|
||||||
vim:tw=78:ts=8:ft=help:norl:
|
vim:tw=78:ts=8:ft=help:norl:
|
||||||
|
Loading…
Reference in New Issue
Block a user