1SVK::Log::Filter::Grep(U3s)er Contributed Perl DocumentatSiVoKn::Log::Filter::Grep(3)
2
3
4
6 SVK::Log::Filter::Grep - search log messages for a given pattern
7
9 The Grep filter requires a single Perl pattern (regular expression) as
10 its argument. The pattern is then applied to the svn:log property of
11 each revision it receives. If the pattern matches, the revision is
12 allowed to continue down the pipeline. If the pattern fails to match,
13 the pipeline immediately skips to the next revision.
14
15 The pattern is applied with the /i modifier (case insensitivity). If
16 you want case-sensitivity or other modifications to the behavior of
17 your pattern, you must use the "(?imsx-imsx)" extended pattern (see
18 "perldoc perlre" for details). For example, to search for log messages
19 that match exactly the characters "foo" you might use
20
21 svk log --filter "grep (?-i)foo"
22
23 However, to search for "foo" without regards for case, one might try
24
25 svk log --filter "grep foo"
26
27 The result of any capturing parentheses inside the pattern are not
28 available. If demand dictates, the Grep filter could be modified to
29 place the captured value somewhere in the stash for other filters to
30 access.
31
32 If the pattern contains a pipe character ('|'), it must be escaped by
33 preceding it with a '\' character. Otherwise, the portion of the
34 pattern after the pipe character is interpreted as the name of a log
35 filter.
36
38 Grep leaves all properties and the stash intact.
39
40
41
42perl v5.12.4 2008-08-05 SVK::Log::Filter::Grep(3)