beyondgrep
Create an introductory page to give a crash course in ack
We need something that aggregates usage tips into an introductory document.
Things to cover include:
- Filename selection and not using *
- Setting up .ackrc and how filetypes work
Also, all the new Docs need to be put onto beyondgrep.com as separate pages for all the people who only read docs online.
From #36
From @petdance on June 16, 2012 3:17
ack 1.x has an Intro.pod file https://github.com/petdance/ack/blob/master/Intro.pod
There's also this ack tutorial project that started big and went quiet. https://github.com/djanowski/ack-tutorial
Let's use these in ack 2.0
Copied from original issue: petdance/ack2#117
From #39
From @petdance on January 21, 2013 16:5
We need a crash course in ack at the top of the man page. This should include:
- ack is intended for searching large trees of source code.
- ack does smart things for you, so let it
- Don't specify filenames on the command line unless you have specific files to mention.
ack foo *is an anti-pattern. - ack searches all text files by default, but as soon as you specify a file type, then file types rule the selection process.
- ack uses actual Perl regular expressions, not PCRE
- ack has many command-line switches that are the same as grep's, but they are not compatible.
- ack includes advanced facilities for only searching files that match a particular pattern (ex.
--perl) Let ack do the work for you! - ack may be customized by putting options in an ackrc file.
Copied from original issue: petdance/ack2#201