NAntContrib Help Task Reference <vsshistory> | v0.92-beta1 |
[This is preliminary documentation and subject to change.]
Generates an XML file showing all changes made to a Visual SourceSafe project/file between specified labels or dates (by a given user).
Attribute | Type | Description | Required |
---|---|---|---|
output | file | Output file to save history to (as XML). | True |
fromdate | datetime | Start date for comparison. | False |
fromlabel | string | The value of the label to start comparing to. If it is not included, the compare will start with the very first history item. | False |
recursive | bool | Determines whether to perform the comparison recursively. The default is true. | False |
todate | datetime | End date for comparison. | False |
tolabel | string | The value of the label to compare up to. If it is not included, the compare will end with the last history item. | False |
user | string | Name of the user whose changes you want to see. | False |
dbpath | file | The path to the folder that contains "srcsafe.ini". | True |
path | string | The Visual SourceSafe project or file path you wish the perform the action on (starting with "$/"). | True |
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False |
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False |
password | string | The password to use to login to the SourceSafe database. | False |
unless | bool | Opposite of if . If false then the task will be executed; otherwise, skipped. The default is false. |
False |
username | string | The name of the user needed to access the Visual SourceSafe database. When no username is specified and "Use network name for automatic user log in" is enabled for the Visual SourceSafe database, then the current Windows username will be used to log in. |
False |
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False |
Write all changes between "Release1" and "Release2" to XML file "changelog.xml".
<vsshistory dbpath="C:\VSS\srcsafe.ini" path="$/My Project" fromlabel="Release1" tolabel="Release2" output="changelog.xml" />
Write all changes between January 1st 2004 and March 31st 2004 to XML file "history.xml".
<vsshistory dbpath="C:\VSS\srcsafe.ini" path="$/My Project" fromdate="01/01/2004" todate="03/31/2004" output="history.xml" />