Create an introductory page to give a crash course in ack

[petdance]

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.

[petdance]

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

[petdance]

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