1SVK::Command::Log(3) User Contributed Perl Documentation SVK::Command::Log(3)
2
6 SVK::Command::Log - Show log messages for revisions
7
9 log DEPOTPATH
10 log PATH
11 log -r N[:M] [DEPOT]PATH
12
14 -r [--revision] ARG : ARG (some commands also take ARG1:ARG2 range)
15 A revision argument can be one of:
17 "HEAD" latest in repository
19 {DATE} revision at start of the date
20 NUMBER revision number
21 NUMBER@ interpret as remote revision number
22 NUM1:NUM2 revision range
23 Unlike other commands, negative NUMBER has no
25 meaning.
26 -l [--limit] REV : stop after displaying REV revisions
28 -q [--quiet] : Don't display the actual log message itself
29 -x [--cross] : track revisions copied from elsewhere
30 -v [--verbose] : print extra information
31 --xml : display the log messages in XML format
32 --filter FILTER : select revisions based on FILTER
33 --output FILTER : display logs using the given FILTER
34
36 Display the log messages and other meta-data associated with revisions.
37 SVK provides a flexible system allowing log messages and other revision
39 properties to be displayed and processed in many ways. This
40 flexibility comes through the use of "log filters." Log filters are of
41 two types: selection and output. Selection filters determine which
42 revisions are included in the output, while output filters determine
43 how the information about those revisions is displayed. Here's a
44 simple example. These two invocations produce equivalent output:
45 svk log -l 5 //local/project
47 svk log --filter "head 5" --output std //local/project
48 The "head" filter chooses only the first revisions that it encounters,
50 in this case, the first 5 revisions. The "std" filter displays the
51 revisions using SVK's default output format.
52 Selection filters can be connected together into pipelines. For
54 example, to see the first 3 revisions with log messages containing the
55 string 'needle', we might do this
56 svk log --filter "grep needle | head 3" //local/project
58 That example introduced the "grep" filter. The argument for the grep
60 filter is a valid Perl pattern (with any '|' characters as '\|' and '\'
61 as '\\'). A revision is allowed to continue to the next stage of the
62 pipeline if the revision's log message matches the pattern. If we
63 wanted to search only the first 10 revisions for 'needle' we could use
64 either of the following commands
65 svk log --filter "head 10 | grep needle" //local/project
67 svk log -l 10 --filter "grep needle" //local/project
68 You may change SVK's default output filter by setting the SVKLOGOUTPUT
70 environment. See svk help environment for details.
71 Standard Filters
73 The following log filters are included with the standard SVK
74 distribution:
75 Selection : grep, head, author
77 Output : std, xml
78 For detailed documentation about any of these filters, try "perldoc
80 SVK::Log::Filter::Name" where "Name" is "Grep", "Head", "XML", etc..
81 Other log filters are available from CPAN <http://search.cpan.org> by
82 searching for "SVK::Log::Filter". For details on writing log filters,
83 see the documentation for the SVK::Log::Filter module.
84perl v5.12.4 2010-03-09 SVK::Command::Log(3)