---
name: "SVN::Web::Revision"
section: "3pm"
platform: "linux"
package: "libsvn-web-perl"
version: "0.63-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SVN::Web::Revision"
---

# SVN::Web::Revision(3pm)

SVN::Web action to view a repository revision

## 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\>