View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Chia-liang Kao (高嘉良) > SVK-v2.2.3 > SVK::Log::Filter::Grep



Annotate this POD


New  59
Open  12
View/Report Bugs


SVK::Log::Filter::Grep - search log messages for a given pattern


The Grep filter requires a single Perl pattern (regular expression) as its argument. The pattern is then applied to the svn:log property of each revision it receives. If the pattern matches, the revision is allowed to continue down the pipeline. If the pattern fails to match, the pipeline immediately skips to the next revision.

The pattern is applied with the /i modifier (case insensitivity). If you want case-sensitivity or other modifications to the behavior of your pattern, you must use the "(?imsx-imsx)" extended pattern (see "perldoc perlre" for details). For example, to search for log messages that match exactly the characters "foo" you might use

    svk log --filter "grep (?-i)foo"

However, to search for "foo" without regards for case, one might try

    svk log --filter "grep foo"

The result of any capturing parentheses inside the pattern are not available. If demand dictates, the Grep filter could be modified to place the captured value somewhere in the stash for other filters to access.

If the pattern contains a pipe character ('|'), it must be escaped by preceding it with a '\' character. Otherwise, the portion of the pattern after the pipe character is interpreted as the name of a log filter.


Grep leaves all properties and the stash intact.

syntax highlighting: