wangwei
/
antliscence
forked from 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>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>outputfilename</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 or codediff or nofile. The default is brief.</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 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 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;vsshistory recursive=&quot;true&quot; 
        numDays="-14"
        toDate=&quot;31.01.2001&quot;/&gt;
</pre>
</blockquote>
<p>Shows all changes in the 14 days before January 31st 2001 (in Germany, date must be specified according to your locale).</p>

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

</body>
</html>