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