@@ -5,13 +5,14 @@ This plugin is a front for the Perl module replacement for 99% of the uses of _grep_. This plugin will allow you to run ack from vim, and shows the results in a split window. +The *Official Version* of this plugin is available at [vim.org](http://www.vim.org/scripts/script.php?script_id=2572). ## Installation ## ### Ack -You have to install [ack](http://search.cpan.org/~petdance/ack/ack), of course. +You have to install [ack](http://search.cpan.org/~petdance/ack/ack), of course. Install on Ubuntu with: @@ -33,16 +34,12 @@ Otherwise, you are on your own. ### The Plugin -If you have "Rake":http://rake.rubyforge.org/ installed, you can just run: `rake install` +If you have [Rake](http://rake.rubyforge.org/) installed, you can just run: `rake install`. Otherwise, the file ack.vim goes in ~/.vim/plugin, and the ack.txt file belongs in ~/.vim/doc. Be sure to run :helptags ~/.vim/doc -or - - :helptags $VIMRUNTIME/doc - afterwards. @@ -62,13 +59,13 @@ Just like where you use :grep, :grepadd, :lgrep, and :lgrepadd, you can use **From the [ack docs](http://search.cpan.org/~petdance/ack/ack)** (my favorite feature): --type=TYPE, --type=noTYPE - + Specify the types of files to include or exclude from a search. TYPE is a filetype, like perl or xml. --type=perl can also be specified as --perl, and --type=noperl can be done as --noperl. - + If a file is of both type "foo" and "bar", specifying --foo and --nobar will exclude the file, because an exclusion takes precedence over an inclusion. - + Type specifications can be repeated and are ORed together. - + See ack --help=types for a list of valid types. This Vim plugin is derived (and by derived, I mean copied, essentially) from @@ -78,9 +75,3 @@ particular, the function at the bottom of the post). I added a help file that provides just enough reference to get you going. I also highly recommend you check out the docs for the Perl script 'ack', for obvious reasons: [ack - grep-like text finder](http://search.cpan.org/~petdance/ack/ack). - - -_I will not upload this to vim.org without ant0ine's permission. I have -attempted to contact him, but I have not recieved a response. Also, be aware -that if he asks me to remove this, I'll do so immediately. Grab it while it's -hot!_ README.md 1c6b8a25871cf324530b7dc73f0d2abd7ea05d52 Miles Z. Sterrett miles.sterrett@gmail.com http://github.com/mileszs/ack.vim/commit/b88c1929ed0d5b8e1205224c7edfadde74a4a203 b88c1929ed0d5b8e1205224c7edfadde74a4a203 2009-03-05T13:33:36-08:00 2009-03-05T13:33:36-08:00 Now available at vim.org 891e486ce253df24872a5da35a6c43c205db8ac3 Miles Z. Sterrett miles.sterrett@gmail.com