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

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

NAME

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

SYNOPSIS

	log DEPOTPATH
	log PATH
	log -r N[:M] [DEPOT]PATH

OPTIONS

	-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 <http://search.cpan.org> 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::Path(3)						User Contributed Perl Documentation					      SVK::Path(3)

NAME

       SVK::Path - SVK path class

SYNOPSIS

	See below

DESCRIPTION

       The class represents a node in svk depot.

       root

       Returns the root representing the file system of the revision at the anchor.  Give optional pool (null to use default), otherwise use the
       internal root of the path object.  Be careful if you are using the root object but not keeping the path object.

       same_repos

       Returns true if all @other targets are from the same repository as this one.

       same_source

       Returns true if all @other targets are mirrored from the same source

       is_mirrored

       Returns the mirror object if the path is mirrored.  Returns additional path component if used in array context.

       normalize

       Normalize the revision to the last changed one.

       as_depotpath

       Makes target depotpath. Takes $revision number optionally.

       path

       Returns the full path of the target even if anchorified.

       descend

       Makes target descend into $entry

       universal

       Returns corresponding SVK::Target::Universal object.

       depotpath

       Returns depotpath of the target

       copy_ancestors

       Returns a list of "(path, rev)" pairs, which are ancestors of the current node.

       nearest_copy(root, path, [pool])

       given a root object (or a target) and a path, returns the revision root where it's ancestor is from another path, and ancestor's root and
       path.

       related_to

       Check if $self is related to another target.

       copied_from ($want_mirror)

       Return the nearest copy target that still exists.  If $want_mirror is true, only return one that was mirrored from somewhere.

       $self->seek_to($revision)

       Return the "SVK::Path" object that $self is at $revision.  Note that we don't have forward tracing, so if <$revision is greater than
       "$self-"revision>, a "SVK::Path" at <$revision> will be returned.  In other words, assuming "foo@N" for "-r N foo@M" when N > M.

as_url($local_only, [ $path, $rev ])
       Returns (url, revision) pair.

       node_id ()

       Returns the node id of this path object.

SEE ALSO

       SVK::Path::Checkout

perl v5.10.0							    2008-08-04							      SVK::Path(3)

Linux and UNIX Man Pages

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

Check Out this Related Man Page