84 lines
3.3 KiB
Text
84 lines
3.3 KiB
Text
*ack.txt* Plugin that integrates ack with Vim
|
|
|
|
==============================================================================
|
|
Author: Antoine Imbert <antoine.imbert+ackvim@gmail.com> *ack-author*
|
|
License: Same terms as Vim itself (see |license|)
|
|
|
|
==============================================================================
|
|
INTRODUCTION *ack*
|
|
|
|
This plugin is a front for the Perl module App::Ack. Ack can be used as a
|
|
replacement for grep. This plugin will allow you to run ack from vim, and
|
|
shows the results in a split window.
|
|
|
|
:Ack[!] [options] {pattern} [{directory}] *:Ack*
|
|
|
|
Search recursively in {directory} (which defaults to the current
|
|
directory) for the {pattern}. Behaves just like the |:grep| command, but
|
|
will open the |Quickfix| window for you. If [!] is not given the first
|
|
error is jumped to.
|
|
|
|
:AckAdd [options] {pattern} [{directory}] *:AckAdd*
|
|
|
|
Just like |:Ack|, but instead of making a new list, the matches are
|
|
appended to the current |quickfix| list.
|
|
|
|
:AckFromSearch [{directory}] *:AckFromSearch*
|
|
|
|
Just like |:Ack| but the pattern is from previous search.
|
|
|
|
:LAck [options] {pattern} [{directory}] *:LAck*
|
|
|
|
Just like |:Ack| but instead of the |quickfix| list, matches are placed in
|
|
the current |location-list|.
|
|
|
|
:LAckAdd [options] {pattern} [{directory}] *:LAckAdd*
|
|
|
|
Just like |:AckAdd| but instead of the |quickfix| list, matches are added
|
|
to the current |location-list|
|
|
|
|
:AckFile [options] {pattern} [{directory}] *:AckFile*
|
|
|
|
Search recursively in {directory} (which defaults to the current
|
|
directory) for filenames matching the {pattern}. Behaves just like the
|
|
|:grep| command, but will open the |Quickfix| window for you.
|
|
|
|
:AckHelp[!] [options] {pattern} *:AckHelp*
|
|
|
|
Search vim documentation files for the {pattern}. Behaves just like the
|
|
|:Ack| command, but searches only vim documentation .txt files
|
|
|
|
:LAckHelp [options] {pattern} *:LAckHelp*
|
|
|
|
Just like |:AckHelp| but instead of the |quickfix| list, matches are placed
|
|
in the current |location-list|.
|
|
|
|
Files containing the search term will be listed in the split window, along
|
|
with the line number of the occurrence, once for each occurrence. <Enter> on
|
|
a line in this window will open the file, and place the cursor on the matching
|
|
line.
|
|
|
|
See http://betterthangrep.com/ for more information.
|
|
|
|
==============================================================================
|
|
MAPPINGS *ack-mappings*
|
|
|
|
The following keyboard shortcuts are available in the quickfix window:
|
|
|
|
o open file (same as enter).
|
|
|
|
go preview file (open but maintain focus on ack.vim results).
|
|
|
|
t open in a new tab.
|
|
|
|
T open in new tab silently.
|
|
|
|
h open in horizontal split.
|
|
|
|
H open in horizontal split silently.
|
|
|
|
v open in vertical split.
|
|
|
|
gv open in vertical split silently.
|
|
|
|
q close the quickfix window.
|