| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| <html> |
| <head> |
| <meta http-equiv="Content-Language" content="en-us"> |
| <title>RevisionDiff Task</title> |
| </head> |
| <body> |
| <h2><a name="revisiondiff">RevisionDiff</a></h2> |
| <h3>Description</h3> |
| |
| <p>Generates an XML-formatted report file of the changes between two |
| revisions recorded in a <a href="http://subversion.tigris.org/" |
| target="_top">Subversion</a> repository. </p> |
| |
| <p><b>Important:</b> This task needs "svn" on the path. If it isn't, |
| you will get an error (such as error 2 on windows). If |
| <code><svn></code> doesn't work, try to execute |
| <code>svn.exe</code> from the command line in the target directory in |
| which you are working.</p> |
| |
| <h3>Parameters</h3> |
| <table border="1" cellpadding="2" cellspacing="0"> |
| <tr> |
| <td valign="top"><b>Attribute</b></td> |
| <td valign="top"><b>Description</b></td> |
| <td align="center" valign="top"><b>Required</b></td> |
| </tr> |
| <tr> |
| <td valign="top">start</td> |
| <td valign="top">The earliest revision from which diffs are to be |
| included in the report.</td> |
| <td align="center" valign="top">Yes.</td> |
| </tr> |
| <tr> |
| <td valign="top">end</td> |
| <td valign="top">The latest revision from which diffs are to be |
| included in the report.</td> |
| <td align="center" valign="top">Yes.</td> |
| </tr> |
| <tr> |
| <td valign="top">destfile</td> |
| <td valign="top">The file in which to write the diff report.</td> |
| <td align="center" valign="top">Yes</td> |
| </tr> |
| </table> |
| |
| <h3>Parameters inherited from the <code>svn</code> task</h3> |
| <table border="1" cellpadding="2" cellspacing="0"> |
| <tr> |
| <td valign="top"><b>Attribute</b></td> |
| <td valign="top"><b>Description</b></td> |
| <td align="center" valign="top"><b>Required</b></td> |
| </tr> |
| <tr> |
| <td valign="top">svnURL</td> |
| <td valign="top">the svn URL to diff.</td> |
| <td align="center" valign="top">No</td> |
| </tr> |
| <tr> |
| <td valign="top">failonerror</td> |
| <td valign="top">Stop the buildprocess if the command exits with a |
| returncode other than 0. Defaults to false</td> |
| <td align="center" valign="top">No</td> |
| </tr> |
| </table> |
| |
| <h3>Examples</h3> |
| <pre> <revisiondiff |
| svnURL="http://svn.apache.org/repos/asf/jakarta/bcel/trunk" |
| destfile="diff.xml" |
| start="152904" |
| end="153682" |
| /></pre> |
| |
| <p>Generates a revisiondiff report for all the changes that have been |
| made in the <code>Apache BCEL</code> module between the revisions |
| <code>152904</code> and <code>153682</code>. It writes these changes |
| into the file <code>diff.xml</code>.</p> |
| |
| <pre> <revisiondiff |
| destfile="diff.xml" |
| package="ant" |
| start="{2002-01-01}" |
| end="{2002-02-01}" |
| dest="my-working-copy-of-BCEL" |
| /></pre> |
| |
| <p>Generates a diff report for all the changes that have been made in |
| the <code>Apache BCEL</code> module in january 2002. In this example |
| <code>svnURL</code> has not been set, it is assumed that |
| <code>my-working-copy-of-BCEL</code> contains a checked out copy of |
| the BCEL module. It writes these changes into the file |
| <code>diff.xml</code>.</p> |
| |
| <h4>Generate Report</h4> |
| |
| <p>This antlib includes a basic XSLT stylesheet that you can use to |
| generate a HTML report based on the xml output. The following example |
| illustrates how to generate a HTML report from the XML report.</p> |
| |
| <pre> |
| <style in="diff.xml" |
| out="diff.html" |
| style="your-path-to/etc/diff.xsl"> |
| <param name="title" expression="Jakarta BCEL diff"/> |
| <param name="repo" expression="http://svn.apache.org/repos/asf/jakarta/bcel/trunk"/> |
| </style> |
| </pre> |
| |
| <h4>(Shortened) Example Output</h4> |
| <pre> |
| <?xml version="1.0" encoding="UTF-8"?> |
| <revisiondiff start="153872" end="152873" svnurl="http://svn.apache.org/repos/asf/jakarta/bcel/trunk" > |
| <path> |
| <name><![CDATA[LICENSE.txt]]></name> |
| <action>modified</action> |
| </path> |
| <path> |
| <name><![CDATA[NOTICE.txt]]></name> |
| <action>deleted</action> |
| </path> |
| </revisiondiff> |
| </pre> |
| |
| |
| |
| </body> |
| </html> |
| |
