GrepTasks : Grep for tasks and TODO markers.
script karma |
Rating 3/3,
Downloaded by 1546 |
Comments, bugs, improvements
|
Vim wiki
|
created by |
Ingo Karkat |
|
script type |
utility |
|
description |
DESCRIPTION
This plugin defines commands to search for tasks and TODO markers embedded in
files, and populates the quickfix list with the resulting lines. Most IDEs
offer such a view, too.
HOW IT WORKS
The :vimgrep command is used with a predefined pattern. Search targets for
the current buffer, all arguments, listed buffers, windows in the current tab
page or all tab pages can be used (leveraging the GrepHere.vim and
GrepCommands.vim plugins).
SEE ALSO
- To move to individual tasks and TODO markers in the current buffer without
building and going through the quickfix list, you can use the companion
TaskMotions.vim plugin (vimscript #3990).
RELATED WORKS
- TaskList.vim (vimscript #2607) searches only the current file triggered by a
mapping, and displays in a scratch buffer.
USAGE
All commands search for case-sensitive occurrences of FIXME:, TODO:, and XXX:
in the files. (This is customizable via g:GrepTasks_PatternTemplate).
When the optional [{pattern}] is specified, only occurrences that contain the
{pattern} after the marker keyword are included.
:GrepHereTasks[!] [{pattern}]
Search for tasks and TODOs in the current buffer and
set the error list to the matches.
:ArgGrepTasks[!] [{pattern}]
Search for tasks and TODOs in all files from the
argument-list and set the error list to the matches.
:BufGrepTasks[!] [{pattern}]
Search for tasks and TODOs in all listed buffers and
set the error list to the matches.
:WinGrepTasks[!] [{pattern}]
Search for tasks and TODOs in all buffers visible in
the current tab and set the error list to the matches.
:TabGrepTasks[!] [{pattern}]
Search for tasks and TODOs in all buffers visible in
all tab pages and set the error list to the matches.
:VimGrepTasks[!] [/{pattern}/] {file} ...
Search for tasks and TODOs in the files {file} ... and
set the error list to the matches. |
|
install details |
INSTALLATION
This script is packaged as a vimball. If you have the "gunzip" decompressor
in your PATH, simply edit the *.vmb.gz package in Vim; otherwise, decompress
the archive first, e.g. using WinZip. Inside Vim, install by sourcing the
vimball or via the :UseVimball command.
vim GrepTasks*.vmb.gz
:so %
To uninstall, use the :RmVimball command.
DEPENDENCIES
- Requires Vim 7.0 or higher.
- Requires the ingo-library.vim plugin (vimscript #4433), version 1.008 or
higher.
- Requires the GrepCommands plugin (vimscript #4173).
- Requires the GrepHere plugin (vimscript #4191).
CONFIGURATION
For a permanent configuration, put the following commands into your vimrc:
Tasks and TODO markers are detected by a regular expression, which is built
from a printf()-style template, into which the optional filter pattern is
inserted at the %s keyword:
let g:GrepTasks_PatternTemplate = '\<TODO:\s\?.*%s'
By default, the quickfix list is filled with all found tasks; the first found
task isn't jumped to. You can adapt that by changing the :vimgrep flags:
let g:GrepTasks_GrepFlags = 'gj' |
|
script versions (upload new version)
Click on the package to download.
ip used for rating: 142.132.191.50
|