Add a WHAT YOU SHOULD KNOW section to the top of the man page #201

Closed
petdance opened this Issue Jan 21, 2013 · 1 comment

Projects

None yet

1 participant

@petdance
Owner

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.
@petdance petdance removed this from the Later milestone Mar 18, 2017
@petdance
Owner

This issue was moved to petdance/ack3#39

@petdance petdance closed this Mar 29, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment