------------------------------------------------------------ revno: 264 committer: Chong Yidong <c...@gnu.org> branch nick: elpa timestamp: Mon 2012-10-08 11:46:38 +0800 message: Convert packages/ack/README.rst to a package.el compatible README. Tweak the description of the ack package in packages/ack/ack-pkg.el. renamed: packages/ack/README.rst => packages/ack/README modified: packages/ack/ack-pkg.el packages/ack/README
=== renamed file 'packages/ack/README.rst' => 'packages/ack/README' --- a/packages/ack/README.rst 2012-10-04 14:12:53 +0000 +++ b/packages/ack/README 2012-10-08 03:46:38 +0000 @@ -1,93 +1,30 @@ -========================================== - Emacs Interface to command-line tool ack -========================================== - -From http://betterthangrep.com/ - - ack is a tool like grep, designed for programmers with large trees - of heterogeneous source code. - - ack is written purely in Perl, and takes advantage of the power of - Perl's regular expressions. - -This package is part of `GNU ELPA <http://elpa.gnu.org>`_. - -Feature requests and bug reports are welcome. Thanks. - -Features --------- - -- Neither ``--nogroup`` nor ``--noheading`` is required -- Handle colors using the standard library ``ansi-color.el`` -- Completion for ack options while reading from the minibuffer -- Support ``git grep``, ``hg grep`` and ``bzr grep`` -- Support both emacs 23 and 24 - -Screenshots ------------ - -.. figure:: http://i.imgur.com/mrk8k.png - :width: 400 px - :target: http://i.imgur.com/mrk8k.png - :alt: ack-git-grep.png - - ``git --no-pager grep -n --color 'hg grep'`` - -.. figure:: http://i.imgur.com/a72Ap.png - :width: 400 px - :target: http://i.imgur.com/a72Ap.png - :alt: ack-emacs23-1.png - - ``ack --column 'ack is.*tool'`` - -.. figure:: http://i.imgur.com/U2vFz.png - :width: 400 px - :target: http://i.imgur.com/U2vFz.png - :alt: ack-emacs23-2.png - - ``ack --column --nogroup --nocolor 'ack is.*tool'`` - -Install -------- - -Place ``ack.el`` in the ``load-path`` and add to your init file:: - - (require 'ack) - -or:: - - (autoload 'ack "ack" nil t) - -Completion (optional) -~~~~~~~~~~~~~~~~~~~~~ - -Place ``pcmpl-ack.el`` in the ``load-path`` and add:: - - (autoload 'pcomplete/ack "pcmpl-ack") - (autoload 'pcomplete/ack-grep "pcmpl-ack") - -to your init file. After this you will be able complete ``ack`` -options while ``M-x ack`` or in shell/eshell. - -Usage ------ - -- ``M-x ack`` and provide a pattern to search. -- ``C-u M-x ack`` like ``M-x ack`` but allow you to select a - directory to search. +This package provides an Emacs interface to the command-line tool ack. + +From <http://betterthangrep.com/>: ack is a tool like grep, designed +for programmers with large trees of heterogeneous source code. ack is +written purely in Perl, and takes advantage of the power of Perl's +regular expressions. + +Usage: +Type `M-x ack' and provide a pattern to search. +Type `C-u M-x ack' to also specify 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`` -- ``TAB`` => completion for ack options - -Bugs ----- - +- `M-I' inserts a template for case-insensitive file name search +- `M-G' inserts a template for `git grep', `hg grep' or `bzr grep' +- `TAB' completes ack options + +This package does not require `--nogroup' nor `--noheading'. +Coloring is performed using the standard library ansi-color.el. + +Screenshots: +http://i.imgur.com/mrk8k.png +http://i.imgur.com/a72Ap.png +http://i.imgur.com/U2vFz.png + +Bugs: https://github.com/leoliu/ack-el/issues -Contributors ------------- -Phillip Lord +ack.el was written by Leo Liu, with contributions from Phillip Lord.
=== modified file 'packages/ack/ack-pkg.el' --- a/packages/ack/ack-pkg.el 2012-10-04 14:21:10 +0000 +++ b/packages/ack/ack-pkg.el 2012-10-08 03:46:38 +0000 @@ -1,1 +1,1 @@ -(define-package "ack" "0.8" "Emacs interface to ack") +(define-package "ack" "0.8" "Interface to ack, a source code search tool")
