Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

svk::command::log(3) [osx man page]

SVK::Command::Log(3)					User Contributed Perl Documentation				      SVK::Command::Log(3)

SVK::Command::Log - Show log messages for revisions SYNOPSIS
-r [--revision] ARG : ARG (some commands also take ARG1:ARG2 range) A revision argument can be one of: "HEAD" latest in repository {DATE} revision at start of the date NUMBER revision number NUMBER@ interpret as remote revision number NUM1:NUM2 revision range Unlike other commands, negative NUMBER has no meaning. -l [--limit] REV : stop after displaying REV revisions -q [--quiet] : Don't display the actual log message itself -x [--cross] : track revisions copied from elsewhere -v [--verbose] : print extra information --xml : display the log messages in XML format --filter FILTER : select revisions based on FILTER --output FILTER : display logs using the given FILTER DESCRIPTION
Display the log messages and other meta-data associated with revisions. SVK provides a flexible system allowing log messages and other revision properties to be displayed and processed in many ways. This flexibility comes through the use of "log filters." Log filters are of two types: selection and output. Selection filters determine which revisions are included in the output, while output filters determine how the information about those revisions is displayed. Here's a simple example. These two invocations produce equivalent output: svk log -l 5 //local/project svk log --filter "head 5" --output std //local/project The "head" filter chooses only the first revisions that it encounters, in this case, the first 5 revisions. The "std" filter displays the revisions using SVK's default output format. Selection filters can be connected together into pipelines. For example, to see the first 3 revisions with log messages containing the string 'needle', we might do this svk log --filter "grep needle | head 3" //local/project That example introduced the "grep" filter. The argument for the grep filter is a valid Perl pattern (with any '|' characters as '|' and '' as '\'). A revision is allowed to continue to the next stage of the pipeline if the revision's log message matches the pattern. If we wanted to search only the first 10 revisions for 'needle' we could use either of the following commands svk log --filter "head 10 | grep needle" //local/project svk log -l 10 --filter "grep needle" //local/project You may change SVK's default output filter by setting the SVKLOGOUTPUT environment. See svk help environment for details. Standard Filters The following log filters are included with the standard SVK distribution: Selection : grep, head, author Output : std, xml For detailed documentation about any of these filters, try "perldoc SVK::Log::Filter::Name" where "Name" is "Grep", "Head", "XML", etc.. Other log filters are available from CPAN <> by searching for "SVK::Log::Filter". For details on writing log filters, see the documentation for the SVK::Log::Filter module. perl v5.10.0 2008-08-04 SVK::Command::Log(3)

Check Out this Related Man Page

SVK::Log::Filter::XML(3)				User Contributed Perl Documentation				  SVK::Log::Filter::XML(3)

SVK::Log::Filter::XML - display log messages in XML format SYNOPSIS
> svk log --xml <?xml version="1.0" encoding="utf-8"?> <log> <logentry revision="1234" original="456"> <author>author</author> <date>2006-05-16T15:43:28.889532Z</date> <msg>This is the commit message for the revision.</msg> </logentry> </log> > svk log --output xml ... DESCRIPTION
The XML filter is an output filter for displaying log messages in XML format. The organization of the XML format should be self- explanatory after a little experimentation. The format is designed to be compatible with Subversion's XML output, so you should be able to use tools like <> without any modification. However, since SVK supports arbitary log filters (see SVK::Log::Filter for details on writing one), it may be easier to write your own output format than to process the XML. This filter is invoked implicitly when you specify the "--xml" argument to SVK's log command. Two arguments to the log command modify XML's behavior. quiet Providing this command-line option to the log command prevents the XML filter from displaying the contents of the log message. All other information is displayed as usual. verbose Providing this command-line option to the log command makes the XML filter display history information for each revision. The history includes the kind of modification (modify, add, delete) and any copy history for each path that was modified in the revision. STASH
/PROPERTY MODIFICATIONS XML leaves all properties and the stash intact. perl v5.10.0 2008-08-04 SVK::Log::Filter::XML(3)
Man Page

Featured Tech Videos