search

mileszs / ack.vim

Vim plugin for the Perl module / CLI script 'ack'
Other
3.08k stars 396 forks source link

Added documentation for the ack-grep tool itself. #71

Closed amouravski closed 10 years ago

amouravski commented 11 years ago

Straight copy of https://github.com/petdance/ack/blob/master/ack-help.txt

losingkeys commented 11 years ago

Shouldn't this be a link instead? That way if it changes we don't have to do anything :). It's be foot to put a tip like "try 'man ack' for more info in your terminal" too

amouravski commented 11 years ago

As I work more in vim, I find it is much, much easier to keep working if I have fewer context switches. I like reading docs in vim because it's right there and I can search and scan and keep an eye on what's going on in the editor. I can reference immediately.

In a perfect world, :Ack would have better completion for all the flags and options that ack-grep provides, but I don't have the time to figure out how to do that.

Second best option would be to directly inject the latest documentation from petdance/ack . This might actually be doable, though a hook or something like that.

In either case, I would rather have the documentation available to me than open up a new man viewer or a web browser (which I end up doing all the time and it bugs the crap out of me.)

aymericbeaumet commented 11 years ago

I do not agree this pull request, you didn't consider the different versions of ack. We can't just write it in the stone as the man page changes on each version.

kassio commented 10 years ago

I do not agree to, I guess just a :!man ack is enough.