ack-readme.txt

==============================================================
 The Simple Emacs Interface to `Ack <http://beyondgrep.com>`_-like Tools
==============================================================
 
This package integrates `ack <http://beyondgrep.com>`_ and its large
set of options with `emacs <http://www.gnu.org/software/emacs>`_.  The
resulting ``*ack*`` buffer is just like vanilla ``*grep*`` buffer but
the results come from your tool of choice.

Ack-like tools such as `the silver searcher (ag)
<https://github.com/ggreer/the_silver_searcher>`_, `ripgrep (rg)
<https://github.com/BurntSushi/ripgrep>`_ are well supported, as are
``git grep``, ``hg grep``.

The program guesses good defaults, but lets you give ``C-u`` to
customize directory to search in, as well as the give special commands
and switches.

Just ``M-x ack`` or do something like ``(global-set-key (kbd "C-c
C-g") 'ack)``.

It is part of `GNU ELPA <http://elpa.gnu.org>`_ - the official package
archive for `emacs <http://www.gnu.org/software/emacs>`_. Patches,
feature requests and bug reports are welcome.

Colors are handled using the standard library ``ansi-color.el``

Install
-------

``M-x package-install RET ack RET``

Screenshots
-----------

* ack

.. figure:: http://i.imgur.com/VwWyzAe.png
   :target: http://i.imgur.com/VwWyzAe.png
   :alt: ack.png

* git grep

.. figure:: http://i.imgur.com/rwjC4pa.png
   :target: http://i.imgur.com/rwjC4pa.png
   :alt: ack-git-grep.png

Usage
-----

- Type ``M-x ack`` and provide a pattern to search.
- Type ``C-u M-x ack`` to search from current project root.
- Type ``C-u C-u M-x ack`` to interactively choose a directory to search.

While reading ack command and args from the minibuffer, the following
key bindings may be useful:

- ``M-I`` => insert a template for case-insensitive file name search
- ``M-G`` => insert a template for ``git grep``, ``hg grep`` or ``bzr grep``
- ``M-Y`` => grab the symbol at point from the window before entering
  the minibuffer
- ``TAB`` => completion for ack options

If you use the above keybindings very often, stick the corresponding
command names in ``ack-minibuffer-setup-hook``. The following snippet
makes ``M-x ack`` insert a ``git|hg|bzr grep`` template if searching
from a project root. Then it will try to insert the symbol at point.

.. code-block:: lisp

  (add-hook 'ack-minibuffer-setup-hook 'ack-skel-vc-grep t)
  (add-hook 'ack-minibuffer-setup-hook 'ack-yank-symbol-at-point t)

Emacs23
-------

Check out the `emacs23
<https://github.com/leoliu/ack-el/tree/emacs23>`_ branch.

Bugs
----

https://github.com/leoliu/ack-el/issues

Contributors
------------
Phillip Lord. The original author and previous mantainer is Leo Liu.