pax_global_header00006660000000000000000000000064126373550120014516gustar00rootroot0000000000000052 comment=4d584ea8c85408ca0d68b7b1693f3e2db8aa762a vim-pathogen-2.4/000077500000000000000000000000001263735501200137615ustar00rootroot00000000000000vim-pathogen-2.4/CONTRIBUTING.markdown000066400000000000000000000014731263735501200174410ustar00rootroot00000000000000If your [commit message sucks](http://stopwritingramblingcommitmessages.com/), I'm not going to accept your pull request. I've explained very politely dozens of times that [my general guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) are absolute rules on my own repositories, so I may lack the energy to explain it to you yet another time. And please, if I ask you to change something, `git commit --amend`. Beyond that, don't be shy about asking before patching. What takes you hours might take me minutes simply because I have both domain knowledge and a perverse knowledge of Vim script so vast that many would consider it a symptom of mental illness. On the flip side, some ideas I'll reject no matter how good the implementation is. "Send a patch" is an edge case answer in my book. vim-pathogen-2.4/README.markdown000066400000000000000000000114051263735501200164630ustar00rootroot00000000000000# pathogen.vim Manage your `'runtimepath'` with ease. In practical terms, pathogen.vim makes it super easy to install plugins and runtime files in their own private directories. ## Installation Install to `~/.vim/autoload/pathogen.vim`. Or copy and paste: mkdir -p ~/.vim/autoload ~/.vim/bundle && \ curl -LSso ~/.vim/autoload/pathogen.vim https://tpo.pe/pathogen.vim If you're using Windows, change all occurrences of `~/.vim` to `~\vimfiles`. ## Runtime Path Manipulation Add this to your vimrc: execute pathogen#infect() If you're brand new to Vim and lacking a vimrc, `vim ~/.vimrc` and paste in the following super-minimal example: execute pathogen#infect() syntax on filetype plugin indent on Now any plugins you wish to install can be extracted to a subdirectory under `~/.vim/bundle`, and they will be added to the `'runtimepath'`. Observe: cd ~/.vim/bundle && \ git clone git://github.com/tpope/vim-sensible.git Now [sensible.vim](https://github.com/tpope/vim-sensible) is installed. If you really want to get crazy, you could set it up as a submodule in whatever repository you keep your dot files in. I don't like to get crazy. If you don't like the directory name `bundle`, you can pass a runtime relative glob as an argument: execute pathogen#infect('stuff/{}') The `{}` indicates where the expansion should occur. You can also pass an absolute path instead. I keep the plugins I maintain under `~/src`, and this is how I add them: execute pathogen#infect('bundle/{}', '~/src/vim/bundle/{}') Normally to generate documentation, Vim expects you to run `:helptags` on each directory with documentation (e.g., `:helptags ~/.vim/doc`). Provided with pathogen.vim is a `:Helptags` command that does this on every directory in your `'runtimepath'`. If you really want to get crazy, you could even invoke `Helptags` in your vimrc. I don't like to get crazy. Finally, pathogen.vim has a rich API that can manipulate `'runtimepath'` and other comma-delimited path options in ways most people will never need to do. If you're one of those edge cases, look at the source. It's well documented. ## Runtime File Editing `:Vopen`, `:Vedit`, `:Vsplit`, `:Vvsplit`, `:Vtabedit`, `:Vpedit`, and `:Vread` have all moved to [scriptease.vim][]. [scriptease.vim]: https://github.com/tpope/vim-scriptease ## FAQ > Can I put pathogen.vim in a submodule like all my other plugins? Sure, stick it under `~/.vim/bundle`, and prepend the following to your vimrc: runtime bundle/vim-pathogen/autoload/pathogen.vim Or if your bundles are somewhere other than `~/.vim` (say, `~/src/vim`): source ~/src/vim/bundle/vim-pathogen/autoload/pathogen.vim > Will you accept these 14 pull requests adding a `.gitignore` for > `tags` so I don't see untracked changes in my dot files repository? No, but I'll teach you how to ignore `tags` globally: git config --global core.excludesfile '~/.cvsignore' echo tags >> ~/.cvsignore While any filename will work, I've chosen to follow the ancient tradition of `.cvsignore` because utilities like rsync use it, too. Clever, huh? > What about Vimballs? If you really must use one: :e name.vba :!mkdir ~/.vim/bundle/name :UseVimball ~/.vim/bundle/name > Why don't my plugins load when I use Vim sessions? Vim sessions default to capturing all global options, which includes the `'runtimepath'` that pathogen.vim manipulates. This can cause other problems too, so I recommend turning that behavior off: set sessionoptions-=options ## Contributing If your [commit message sucks](http://stopwritingramblingcommitmessages.com/), I'm not going to accept your pull request. I've explained very politely dozens of times that [my general guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) are absolute rules on my own repositories, so I may lack the energy to explain it to you yet another time. And please, if I ask you to change something, `git commit --amend`. Beyond that, don't be shy about asking before patching. What takes you hours might take me minutes simply because I have both domain knowledge and a perverse knowledge of Vim script so vast that many would consider it a symptom of mental illness. On the flip side, some ideas I'll reject no matter how good the implementation is. "Send a patch" is an edge case answer in my book. ## Self-Promotion Like pathogen.vim? Follow the repository on [GitHub](https://github.com/tpope/vim-pathogen) and vote for it on [vim.org](http://www.vim.org/scripts/script.php?script_id=2332). And if you're feeling especially charitable, follow [tpope](http://tpo.pe/) on [Twitter](http://twitter.com/tpope) and [GitHub](https://github.com/tpope). ## License Copyright (c) Tim Pope. Distributed under the same terms as Vim itself. See `:help license`. vim-pathogen-2.4/autoload/000077500000000000000000000000001263735501200155715ustar00rootroot00000000000000vim-pathogen-2.4/autoload/pathogen.vim000066400000000000000000000302251263735501200201150ustar00rootroot00000000000000" pathogen.vim - path option manipulation " Maintainer: Tim Pope " Version: 2.4 " Install in ~/.vim/autoload (or ~\vimfiles\autoload). " " For management of individually installed plugins in ~/.vim/bundle (or " ~\vimfiles\bundle), adding `execute pathogen#infect()` to the top of your " .vimrc is the only other setup necessary. " " The API is documented inline below. if exists("g:loaded_pathogen") || &cp finish endif let g:loaded_pathogen = 1 " Point of entry for basic default usage. Give a relative path to invoke " pathogen#interpose() (defaults to "bundle/{}"), or an absolute path to invoke " pathogen#surround(). Curly braces are expanded with pathogen#expand(): " "bundle/{}" finds all subdirectories inside "bundle" inside all directories " in the runtime path. function! pathogen#infect(...) abort for path in a:0 ? filter(reverse(copy(a:000)), 'type(v:val) == type("")') : ['bundle/{}'] if path =~# '^\%({\=[$~\\/]\|{\=\w:[\\/]\).*[{}*]' call pathogen#surround(path) elseif path =~# '^\%([$~\\/]\|\w:[\\/]\)' call s:warn('Change pathogen#infect('.string(path).') to pathogen#infect('.string(path.'/{}').')') call pathogen#surround(path . '/{}') elseif path =~# '[{}*]' call pathogen#interpose(path) else call s:warn('Change pathogen#infect('.string(path).') to pathogen#infect('.string(path.'/{}').')') call pathogen#interpose(path . '/{}') endif endfor call pathogen#cycle_filetype() if pathogen#is_disabled($MYVIMRC) return 'finish' endif return '' endfunction " Split a path into a list. function! pathogen#split(path) abort if type(a:path) == type([]) | return a:path | endif if empty(a:path) | return [] | endif let split = split(a:path,'\\\@]','\\&','') endif endfunction " Like findfile(), but hardcoded to use the runtimepath. function! pathogen#runtime_findfile(file,count) abort let rtp = pathogen#join(1,pathogen#split(&rtp)) let file = findfile(a:file,rtp,a:count) if file ==# '' return '' else return fnamemodify(file,':p') endif endfunction " Section: Deprecated function! s:warn(msg) abort echohl WarningMsg echomsg a:msg echohl NONE endfunction " Prepend all subdirectories of path to the rtp, and append all 'after' " directories in those subdirectories. Deprecated. function! pathogen#runtime_prepend_subdirectories(path) abort call s:warn('Change pathogen#runtime_prepend_subdirectories('.string(a:path).') to pathogen#infect('.string(a:path.'/{}').')') return pathogen#surround(a:path . pathogen#slash() . '{}') endfunction function! pathogen#incubate(...) abort let name = a:0 ? a:1 : 'bundle/{}' call s:warn('Change pathogen#incubate('.(a:0 ? string(a:1) : '').') to pathogen#infect('.string(name).')') return pathogen#interpose(name) endfunction " Deprecated alias for pathogen#interpose(). function! pathogen#runtime_append_all_bundles(...) abort if a:0 call s:warn('Change pathogen#runtime_append_all_bundles('.string(a:1).') to pathogen#infect('.string(a:1.'/{}').')') else call s:warn('Change pathogen#runtime_append_all_bundles() to pathogen#infect()') endif return pathogen#interpose(a:0 ? a:1 . '/{}' : 'bundle/{}') endfunction if exists(':Vedit') finish endif let s:vopen_warning = 0 function! s:find(count,cmd,file,lcd) let rtp = pathogen#join(1,pathogen#split(&runtimepath)) let file = pathogen#runtime_findfile(a:file,a:count) if file ==# '' return "echoerr 'E345: Can''t find file \"".a:file."\" in runtimepath'" endif if !s:vopen_warning let s:vopen_warning = 1 let warning = '|echohl WarningMsg|echo "Install scriptease.vim to continue using :V'.a:cmd.'"|echohl NONE' else let warning = '' endif if a:lcd let path = file[0:-strlen(a:file)-2] execute 'lcd `=path`' return a:cmd.' '.pathogen#fnameescape(a:file) . warning else return a:cmd.' '.pathogen#fnameescape(file) . warning endif endfunction function! s:Findcomplete(A,L,P) let sep = pathogen#slash() let cheats = { \'a': 'autoload', \'d': 'doc', \'f': 'ftplugin', \'i': 'indent', \'p': 'plugin', \'s': 'syntax'} if a:A =~# '^\w[\\/]' && has_key(cheats,a:A[0]) let request = cheats[a:A[0]].a:A[1:-1] else let request = a:A endif let pattern = substitute(request,'/\|\'.sep,'*'.sep,'g').'*' let found = {} for path in pathogen#split(&runtimepath) let path = expand(path, ':p') let matches = split(glob(path.sep.pattern),"\n") call map(matches,'isdirectory(v:val) ? v:val.sep : v:val') call map(matches,'expand(v:val, ":p")[strlen(path)+1:-1]') for match in matches let found[match] = 1 endfor endfor return sort(keys(found)) endfunction command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Ve :execute s:find(,'edit',,0) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vedit :execute s:find(,'edit',,0) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vopen :execute s:find(,'edit',,1) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vsplit :execute s:find(,'split',,1) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vvsplit :execute s:find(,'vsplit',,1) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vtabedit :execute s:find(,'tabedit',,1) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vpedit :execute s:find(,'pedit',,1) command! -bar -bang -range=1 -nargs=1 -complete=customlist,s:Findcomplete Vread :execute s:find(,'read',,1) " vim:set et sw=2 foldmethod=expr foldexpr=getline(v\:lnum)=~'^\"\ Section\:'?'>1'\:getline(v\:lnum)=~#'^fu'?'a1'\:getline(v\:lnum)=~#'^endf'?'s1'\:'=':