Ant User Manual

VssHistory

Description

Task to perform HISTORY commands to Microsoft Visual Source Safe.

Parameters

Attribute	Values	Required
login	username,password	No
vsspath	SourceSafe path	Yes
ssdir	directory where `ss.exe` resides. By default the task expects it to be in the PATH.	No
serverPath	directory where `srssafe.ini` resides.	No
fromDate	Start date for comparison	See below
toDate	Start date for comparison	See below
dateFormat	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.	No
fromLabel	Start label for comparison	No
toLabel	Start label for comparison	No
numdays	The number of days for comparison.	See below
output	File to write the diff.	No
recursive	true or false	No
style	brief, codediff, default or nofile. The default is default.	No

Specifying the time-frame

There are different ways to specify what time-frame you wish to evaluate:

Changes between two dates: Specify both fromDate and toDate
Changes before a date: Specify toDate
Changes after a date: Specify fromDate
Changes X Days before a date: Specify toDate and (negative!) numDays
Changes X Days after a date: Specify fromDate and numDays

Examples

<vsshistory vsspath="/myProject" recursive="true" 
            fromLabel="Release1"
            toLabel="Release2"/>

Shows all changes between "Release1" and "Release2".

<vsshistory vsspath="/myProject" recursive="true" 
            fromDate="01.01.2001"
            toDate="31.03.2001"/>

Shows all changes between January 1st 2001 and March 31st 2001 (in Germany, date must be specified according to your locale).

<tstamp>
  <format property="to.tstamp" pattern="M-d-yy;h:mma" />
</tstamp>

<vsshistory vsspath="/myProject" recursive="true" 
            numDays="-14"
            dateFormat="M-d-yy;h:mma"
            toDate="${to.tstamp}"/>

Shows all changes in the 14 days before today.