Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
vinegar.vim: combine with netrw to create a delicious salad dressing
VimL
branch: master

Merge pull request #52 from h3xx/master

Respect existing setting for g:netrw_banner
latest commit ebd2239edb
@tpope authored
Failed to load latest commit information.
plugin Respect existing setting for g:netrw_banner
CONTRIBUTING.markdown Initial commit
README.markdown Change cd to cg

README.markdown

vinegar.vim

Split windows and the project drawer go together like oil and vinegar. I don't mean to say that you can combine them to create a delicious salad dressing. I mean that they don't mix well!

  • Drew Neil

You know what netrw is, right? The built in directory browser? Well, vinegar.vim enhances netrw, partially in an attempt to mitigate the need for more disruptive "project drawer" style plugins.

Some of the behaviors added by vinegar.vim would make excellent upstream additions. Many, the author would probably reject. Others are a bit too wild to even consider.

  • Press - in any buffer to hop up to the directory listing and seek to the file you just came from. Keep bouncing to go up, up, up. Having rapid directory access available changes everything.
  • All that annoying crap at the top is turned off, leaving you with nothing but a list of files. This is surprisingly disorienting, but ultimately very liberating. Press I to toggle until you adapt.
  • The oddly C-biased default sort order and file hiding is replaced with a sensible application of 'suffixes' and 'wildignore'.
  • Press . on a file to pre-populate it at the end of a : command line. This is great, for example, to quickly initiate a :grep of the file or directory under the cursor. There's also !, which starts the line off with a bang. Type !chmod +x and get :!chmod +x path/to/file.
  • Press cg or cl to :cd or :lcd to the currently edited directory.
  • Press ~ to go home.

Installation

If you don't have a preferred installation method, I recommend installing pathogen.vim, and then simply copy and paste:

cd ~/.vim/bundle
git clone git://github.com/tpope/vim-vinegar.git

License

Copyright © Tim Pope. Distributed under the same terms as Vim itself. See :help license.

Something went wrong with that request. Please try again.