SVN::Web::Revision(3pm) 				User Contributed Perl Documentation				   SVN::Web::Revision(3pm)

NAME

       SVN::Web::Revision - SVN::Web action to view a repository revision

SYNOPSIS

       In config.yaml

	 actions:
	   ...
	   revision:
	     class: SVN::Web::Revision
	     opts:
	       max_diff_size: 200_000
	       show_diff: 1 # or 0
	   ...

DESCRIPTION

       Shows information about a specific revision in a Subversion repository.

CONFIGURATION

       The following configuration options may be specified in config.yaml.

       max_diff_size
	   If showing the diff (see "show_diff"), this determines the maximum size of the diff that will be shown.  If the size of the generated
	   diff (in bytes) is larger than this figure then it is not shown.

	   Defaults to 200,000 bytes.

       show_diff
	   Boolean indicating whether or not a diff of every file that was changed in the revision should be shown.

	   Defaults to 1.

OPTIONS

       rev     The revision to show.  If not provided then use the repository's youngest revision.

TEMPLATE VARIABLES

       context Always "revision".

       rev     The revision that is being shown.

       youngest_rev
	       The repository's youngest revision.  This is useful when constructing "next revision" and "previous revision" links.

       date    The date on which the revision was committed, formatted according to "Time and date formatting" in SVN::Web.

       author  The revision's author.

       msg     The log message associated with this revision.

       paths   A hash of hash refs.  Each key is a path name.  The value is a further hash ref with the following keys.

	       isdir   A boolean value, true if the given path is a directory.

	       diff    A SVN::Web::DiffParser object representing the diff.  This may be undef, if the generated diff was larger than
		       "max_diff_size" or if "show_diff" is false.

	       diff_size
		       The size of the generated diff (before parsing).

	       max_diff_size
		       The configured maximum diff size.

	       action  A single letter indicating the action that carried out on the path.  A file was either added "A", modified "M", replaced
		       "R", or deleted "D".

	       copyfrom
		       If the file was copied from another file then this is the path of the source of the copy.

	       copyfromrev
		       If the file was copied from another file then this is the revision of the file that it was copied form.

EXCEPTIONS

       (revision %1 does not exist)
	   The given revision does not exist in the repository.

COPYRIGHT

       Copyright 2003-2004 by Chia-liang Kao "<clkao@clkao.org>".

       Copyright 2005-2007 by Nik Clayton "<nik@FreeBSD.org>".

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.14.2							    2012-06-11						   SVN::Web::Revision(3pm)