.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" ======================================================================== .\" .IX Title "SVN::Web::Diff 3pm" .TH SVN::Web::Diff 3pm "2016-11-12" "perl v5.24.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" SVN::Web::Diff \- SVN::Web action to show differences between file revisions .SH "SYNOPSIS" .IX Header "SYNOPSIS" In \fIconfig.yaml\fR .PP .Vb 5 \& actions: \& ... \& diff: \& class: SVN::Web::Diff \& ... .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" Returns the difference between two revisions of the same file. .SH "CONFIGURATION" .IX Header "CONFIGURATION" The following configuration options may be specified in \fIconfig.yaml\fR. .IP "max_diff_size" 4 .IX Item "max_diff_size" If showing the diff (see \f(CW\*(C`show_diff\*(C'\fR), 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. .Sp Defaults to 200,000 bytes. .SH "OPTIONS" .IX Header "OPTIONS" .IP "rev1" 8 .IX Item "rev1" The first revision of the file to compare. .IP "rev2" 8 .IX Item "rev2" The second revision of the file to compare. .IP "revs" 8 .IX Item "revs" A list of two or more revisions. If present, the smallest number in the list is assigned to \f(CW\*(C`rev1\*(C'\fR (overriding any given \f(CW\*(C`rev1\*(C'\fR value) and the largest number in the list is assigned to \f(CW\*(C`rev2\*(C'\fR (overriding any given \&\f(CW\*(C`rev2\*(C'\fR value). .Sp In other words: .Sp .Vb 1 \& ...?rev1=5;rev2=10 .Ve .Sp is equal to: .Sp .Vb 1 \& ...?revs=10;revs=5 .Ve .Sp This supports the \*(L"diff between arbitrary revisions\*(R" functionality. .IP "mime" 8 .IX Item "mime" The desired output format. The default is \f(CW\*(C`html\*(C'\fR for a diff marked up in \s-1HTML. \s0 The other allowed value is \f(CW\*(C`text\*(C'\fR, for a plain text unified diff. .SH "TEMPLATE VARIABLES" .IX Header "TEMPLATE VARIABLES" .IP "at_head" 8 .IX Item "at_head" Boolean, indicating whether or not we're currently diffing against the youngest revision of this file. .IP "context" 8 .IX Item "context" Always \f(CW\*(C`file\*(C'\fR. .IP "rev1" 8 .IX Item "rev1" The first revision of the file to compare. Corresponds with the \f(CW\*(C`rev1\*(C'\fR parameter, either set explicitly, or extracted from \f(CW\*(C`revs\*(C'\fR. .IP "rev2" 8 .IX Item "rev2" The second revision of the file to compare. Corresponds with the \f(CW\*(C`rev2\*(C'\fR parameter, either set explicitly, or extracted from \f(CW\*(C`revs\*(C'\fR. .IP "diff" 8 .IX Item "diff" An SVN::Web::DiffParser object that contains the text of the diff. Call the object's methods to format the diff. .IP "diff_size" 8 .IX Item "diff_size" The size of the generated diff (before parsing). .IP "max_diff_size" 8 .IX Item "max_diff_size" The configured maximum diff size. .SH "EXCEPTIONS" .IX Header "EXCEPTIONS" .ie n .IP "(cannot diff nodes of different types: %1 %2 %3)" 4 .el .IP "(cannot diff nodes of different types: \f(CW%1\fR \f(CW%2\fR \f(CW%3\fR)" 4 .IX Item "(cannot diff nodes of different types: %1 %2 %3)" The given path has different node types at the different revisions. This probably means a file was added, deleted, and then re-added as a directory at a later date (or vice-versa). .ie n .IP "(path %1 is a directory at rev %2)" 4 .el .IP "(path \f(CW%1\fR is a directory at rev \f(CW%2\fR)" 4 .IX Item "(path %1 is a directory at rev %2)" The user has tried to diff two directories. This is not currently supported. .ie n .IP "(path %1 does not exist in revision %2)" 4 .el .IP "(path \f(CW%1\fR does not exist in revision \f(CW%2\fR)" 4 .IX Item "(path %1 does not exist in revision %2)" The given path is not present in the repository at the given revision. .IP "(two revisions must be provided)" 4 .IX Item "(two revisions must be provided)" No revisions were given to diff against. .IP "(rev1 and rev2 must be different)" 4 .IX Item "(rev1 and rev2 must be different)" Either only one revision number was given, or several were given, but they're the same number. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright 2003\-2004 by Chia-liang Kao \f(CW\*(C`\*(C'\fR. .PP Copyright 2005\-2007 by Nik Clayton \f(CW\*(C`\*(C'\fR. .PP This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. .PP See