youys
/
ant

<html>

<head>
<meta http-equiv="Content-Language" content="en-us">
<title>Ant User Manual</title>
</head>

<body>

<h2><a name="vsshistory">VssHistory</a></h2>
<h3>Description</h3>
Task to perform HISTORY commands to Microsoft Visual Source Safe.
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
  <tr> 
    <th>Attribute</th>
    <th>Values</th>
    <th>Required</th>
  </tr>
  <tr> 
    <td>login</td>
    <td>username,password</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>vsspath</td>
    <td>SourceSafe path</td>
    <td>Yes</td>
  </tr>
  <tr> 
    <td>ssdir</td>
    <td>directory where <code>ss.exe</code> resides. By default the task 
        expects it to be in the PATH.</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>serverPath</td>
    <td>directory where <code>srssafe.ini</code> resides.</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>fromDate</td>
    <td>Start date for comparison</td>
    <td>See below</td>
  </tr>
  <tr> 
    <td>toDate</td>
    <td>Start date for comparison</td>
    <td>See below</td>
  </tr>
  <tr>
    <td>dateFormat</td>
    <td>Format of dates in fromDate and toDate. Used when calculating dates with 
      the numdays attribute. This string uses the formatting rules of SimpleDateFormat. 
      Defaults to DateFormat.SHORT.</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>fromLabel</td>
    <td>Start label for comparison</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>toLabel</td>
    <td>Start label for comparison</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>numdays</td>
    <td>The number of days for comparison.</td>
    <td>See below</td>
  </tr>
  <tr> 
    <td>output</td>
    <td>File to write the diff.</td>
    <td>No</td>
  </tr>
  <tr> 
    <td>recursive</td>
    <td>true or false</td>
    <td>No</td>
  <tr> 
  <tr> 
    <td>style</td>
    <td>brief, codediff, default or nofile. The default is default.</td>
    <td>No</td>
  <tr> 
</table>

<h4>Specifying the time-frame</h4>
<p>There are different ways to specify what time-frame you wish to evaluate:</p>
<ul>
  <li>Changes between two dates: Specify both <code>fromDate</code> and <code>toDate</code> </li>
  <li>Changes before a date: Specify <code>toDate</code></li>
  <li>Changes after a date: Specify <code>fromDate</code></li>
  <li>Changes X Days before a date: Specify <code>toDate</code> and (negative!) <code>numDays</code></li>
  <li>Changes X Days after a date: Specify <code>fromDate</code> and <code>numDays</code></li>
</ul>


<h3>Examples</h3>
<blockquote>
  <pre>
&lt;vsshistory vsspath=&quot;/myProject&quot; recursive=&quot;true&quot; 
            fromLabel=&quot;Release1&quot;
            toLabel=&quot;Release2&quot;/&gt;
</pre>
</blockquote>
<p>Shows all changes between &quot;Release1&quot; and &quot;Release2&quot;.</p>

<blockquote>
  <pre>
&lt;vsshistory vsspath=&quot;/myProject&quot; recursive=&quot;true&quot; 
            fromDate=&quot;01.01.2001&quot;
            toDate=&quot;31.03.2001&quot;/&gt;
</pre>
</blockquote>
<p>Shows all changes between January 1st 2001 and March 31st 2001 (in Germany, date must be specified according to your locale).</p>

<blockquote> 
  <pre>
&lt;tstamp&gt;
  &lt;format property=&quot;to.tstamp&quot; pattern=&quot;M-d-yy;h:mma&quot; /&gt;
&lt;/tstamp&gt;

&lt;vsshistory vsspath=&quot;/myProject&quot; recursive=&quot;true&quot; 
            numDays="-14"
            dateFormat=&quot;M-d-yy;h:mma&quot;
            toDate=&quot;${to.tstamp}&quot;/&gt;
</pre>
</blockquote>
<p>Shows all changes in the 14 days before today.</p>

<hr>
<p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All rights
Reserved.</p>

</body>
</html>