]> code.delx.au - gnu-emacs-elpa/blob - packages/ack/README
* ack: doc fix and release 1.01
[gnu-emacs-elpa] / packages / ack / README
1 This package provides an interface to ack http://beyondgrep.com -- a
2 tool like grep, designed for programmers with large trees of
3 heterogeneous source code. It builds on standard packages `compile.el'
4 and `ansi-color.el' and lets you seamlessly run `ack' with its large
5 set of options.
6
7 Ack-like tools such as the silver search (ag) and git/hg/bzr grep are
8 well supported too.
9
10 Usage:
11 Type `M-x ack' and provide a pattern to search.
12 Type `C-u M-x ack' to search from current project root.
13 Type `C-u C-u M-x ack' to interactively choose a directory to search.
14
15 While reading ack command and args from the minibuffer, the following
16 key bindings may be useful:
17
18 - `M-I' inserts a template for case-insensitive file name search
19 - `M-G' inserts a template for `git grep', `hg grep' or `bzr grep'
20 - `M-Y' inserts the symbol at point from the window before entering
21 the minibuffer
22 - `TAB' completes ack options
23
24 This package does not require `--nogroup' nor `--noheading'.
25 Coloring is performed using the standard library ansi-color.el.
26
27 Screenshots:
28 http://i.imgur.com/VwWyzAe.png
29 http://i.imgur.com/rwjC4pa.png
30
31 Bugs:
32 https://github.com/leoliu/ack-el/issues
33
34 ack.el was written by Leo Liu, with contributions from Phillip Lord.