1SVK::Command::Log(3)  User Contributed Perl Documentation SVK::Command::Log(3)
2
3
4

NAME

6       SVK::Command::Log - Show log messages for revisions
7

SYNOPSIS

9        log DEPOTPATH
10        log PATH
11        log -r N[:M] [DEPOT]PATH
12

OPTIONS

14        -r [--revision] ARG      : ARG (some commands also take ARG1:ARG2 range)
15
16                                 A revision argument can be one of:
17
18                                 "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
24                                 Unlike other commands,  negative NUMBER has no
25                                 meaning.
26
27        -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

DESCRIPTION

36       Display the log messages and other meta-data associated with revisions.
37
38       SVK provides a flexible system allowing log messages and other revision
39       properties to be displayed and processed in many ways.  This flexibil‐
40       ity comes through the use of "log filters."  Log filters are of two
41       types: selection and output.  Selection filters determine which revi‐
42       sions are included in the output, while output filters determine how
43       the information about those revisions is displayed.  Here's a simple
44       example.  These two invocations produce equivalent output:
45
46           svk log -l 5 //local/project
47           svk log --filter "head 5" --output std //local/project
48
49       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
53       Selection filters can be connected together into pipelines.  For exam‐
54       ple, to see the first 3 revisions with log messages containing the
55       string 'needle', we might do this
56
57           svk log --filter "grep needle ⎪ head 3" //local/project
58
59       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
66           svk log --filter "head 10 ⎪ grep needle" //local/project
67           svk log -l 10 --filter "grep needle" //local/project
68
69       You may change SVK's default output filter by setting the SVKLOGOUTPUT
70       environment.  See svk help environment for details.
71
72       Standard Filters
73
74       The following log filters are included with the standard SVK distribu‐
75       tion:
76
77           Selection : grep, head, author
78           Output    : std, xml
79
80       For detailed documentation about any of these filters, try "perldoc
81       SVK::Log::Filter::Name" where "Name" is "Grep", "Head", "XML", etc..
82       Other log filters are available from CPAN <http://search.cpan.org> by
83       searching for "SVK::Log::Filter".  For details on writing log filters,
84       see the documentation for the SVK::Log::Filter module.
85
86
87
88perl v5.8.8                       2006-12-28              SVK::Command::Log(3)