2018-12-21 11:20:43 +01:00
|
|
|
<!DOCTYPE html>
|
2006-09-11 04:19:00 +00:00
|
|
|
<!--
|
|
|
|
|
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
|
|
|
|
|
|
2019-05-25 13:41:47 +02:00
|
|
|
https://www.apache.org/licenses/LICENSE-2.0
|
2006-09-11 04:19:00 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
-->
|
2018-12-21 11:20:43 +01:00
|
|
|
<html lang="en">
|
2001-04-29 16:24:21 +00:00
|
|
|
<head>
|
2005-04-29 18:58:16 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
|
2018-02-28 07:58:59 +01:00
|
|
|
<title>Microsoft Visual SourceSafe (VSS) Tasks</title>
|
2001-04-29 16:24:21 +00:00
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<h1>Microsoft Visual SourceSafe Tasks User Manual</h1>
|
|
|
|
|
<p>by</p>
|
|
|
|
|
<ul>
|
2018-02-28 07:58:59 +01:00
|
|
|
<li>Craig Cottingham</li>
|
|
|
|
|
<li>Andrew Everitt</li>
|
|
|
|
|
<li>Balazs Fejes 2</li>
|
|
|
|
|
<li><a href="mailto:Glenn_Twiggs@bmc.com">Glenn_Twiggs@bmc.com</a></li>
|
|
|
|
|
<li>Martin Poeschl (<a href="mailto:mpoeschl@marmot.at">mpoeschl@marmot.at</a>)</li>
|
|
|
|
|
<li>Phillip Wells</li>
|
|
|
|
|
<li>Jon Skeet (<a href="mailto:jon.skeet@peramon.com">jon.skeet@peramon.com</a>)</li>
|
|
|
|
|
<li>Nigel Magnay (<a href="mailto:nigel.magnay@parsec.co.uk">nigel.magnay@parsec.co.uk</a>)</li>
|
|
|
|
|
<li>Gary S. Weaver</li>
|
|
|
|
|
<li>Jesse Stockall</li>
|
|
|
|
|
</ul>
|
2018-03-04 10:36:45 +01:00
|
|
|
<hr/>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h2>Contents</h2>
|
|
|
|
|
<ul>
|
2018-02-28 07:58:59 +01:00
|
|
|
<li><a href="#intro">Introduction</a></li>
|
|
|
|
|
<li><a href="#tasks">The Tasks</a></li>
|
2001-04-29 16:24:21 +00:00
|
|
|
</ul>
|
2018-02-28 07:58:59 +01:00
|
|
|
|
|
|
|
|
<br/>
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="intro">Introduction</h2>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>These tasks provide an interface to
|
|
|
|
|
the <a href="https://msdn.microsoft.com/en-us/library/3h0544kx(v=vs.80).aspx"
|
|
|
|
|
target="_top">Microsoft Visual SourceSafe</a> SCM.
|
2018-03-10 20:17:33 +01:00
|
|
|
The <code class="code">org.apache.tools.ant.taskdefs.optional.vss</code> package consists of a
|
|
|
|
|
simple framework to support VSS functionality as well as some Apache Ant tasks encapsulating
|
|
|
|
|
frequently used VSS commands. Although it is possible to use these commands on the desktop, they
|
|
|
|
|
were primarily intended to be used by automated build systems.</p>
|
|
|
|
|
<p>If you get a <code class="output">CreateProcess error=2</code> when running these, it means
|
|
|
|
|
that <kbd>ss.exe</kbd> was not found. Check to see if you can run it from the command line—you
|
|
|
|
|
may need to alter your path, or set the <var>ssdir</var> property.</p>
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="tasks">The Tasks</h2>
|
2001-04-29 16:24:21 +00:00
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<table>
|
2018-05-15 10:29:27 +02:00
|
|
|
<tr><th scope="col">Task</th><th scope="col">Description</th></tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vssget">vssget</a></td>
|
|
|
|
|
<td>Retrieves a copy of the specified VSS file(s).</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vsslabel">vsslabel</a></td>
|
|
|
|
|
<td>Assigns a label to the specified version or current version of a file or project.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vsshistory">vsshistory</a></td>
|
|
|
|
|
<td>Shows the history of a file or project in VSS.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vsscheckin">vsscheckin</a></td>
|
|
|
|
|
<td>Updates VSS with changes made to a checked out file, and unlocks the VSS master copy.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vsscheckout">vsscheckout</a></td>
|
|
|
|
|
<td>Copies a file from the current project to the current folder, for the purpose of editing.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vssadd">vssadd</a></td>
|
|
|
|
|
<td>Adds a new file into the VSS Archive</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vsscp">vsscp</a></td>
|
|
|
|
|
<td>Change the current project being used in VSS</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td><a href="#vsscreate">vsscreate</a></td>
|
|
|
|
|
<td>Creates a project in VSS.</td>
|
|
|
|
|
</tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
</table>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<hr/>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h2>Task Descriptions</h2>
|
|
|
|
|
|
|
|
|
|
<!-- VSSGET -->
|
|
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vssget">VssGet</h2>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Description</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Task to perform GET commands to Microsoft Visual SourceSafe.</p>
|
|
|
|
|
<p>If you specify two or more attributes from version, date and label only one will be used in the
|
|
|
|
|
order version, date, label.</p>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-04-29 16:24:21 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>vsspath</td>
|
|
|
|
|
<td>SourceSafe path which specifies the project/file(s) you wish to perform the action on.</td>
|
|
|
|
|
<td>Yes</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>login</td>
|
|
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to VSS. Note
|
|
|
|
|
that you may need to specify both (if you have a password)—Ant/VSS will hang if you
|
|
|
|
|
leave the password out and VSS does not accept login without a password.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>localpath</td>
|
|
|
|
|
<td>Override the working directory and get to the specified path</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>writable</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No; default <q>false</q></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>recursive</td>
|
|
|
|
|
<td><q>true|false</q>. Note however that in the SourceSafe UI there is a setting accessed
|
|
|
|
|
via <q>Tools/Options/GeneralTab</q> called <q>Act on projects recursively</q>. If this
|
|
|
|
|
setting is checked, then the <var>recursive</var> attribute is effectively ignored, and get
|
|
|
|
|
will always be done recursively</td>
|
|
|
|
|
<td>No; default <q>false</q></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>version</td>
|
|
|
|
|
<td>a version number to get</td>
|
|
|
|
|
<td rowspan="3">No; only one of these may be used</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>date</td>
|
|
|
|
|
<td class="left">a date stamp to get at</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>label</td>
|
|
|
|
|
<td class="left">a label to get for</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
2001-07-27 08:43:26 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>quiet</td>
|
|
|
|
|
<td>suppress output</td>
|
|
|
|
|
<td>No; defaults to <q>off</q></td>
|
2001-07-27 08:43:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>autoresponse</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>What to respond with (sets the <kbd>-I</kbd> option). By default, <kbd>-I-</kbd> is
|
2018-02-28 07:58:59 +01:00
|
|
|
used; values of <q>Y</q> or <q>N</q> will be appended to this.</td>
|
|
|
|
|
<td>No</td>
|
2001-07-27 08:43:26 +00:00
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>writablefiles</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Behavior when local files are writable. Valid options are: <q>replace</q>, <q>skip</q>
|
|
|
|
|
and <q>fail</q>; <q>skip</q> implies <var>failonerror</var>=<q>false</q></td>
|
|
|
|
|
<td>No; defaults to <q>fail</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q></td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>filetimestamp</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Set the behavior for timestamps of local files. Valid options
|
|
|
|
|
are <q>current</q>, <q>modified</q>, or <q>updated</q>.</td>
|
|
|
|
|
<td>No; defaults to <q>current</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
</table>
|
|
|
|
|
<p>Note that only one of version, date or label should be specified</p>
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Perform a get on the VSS Project <samp>$/source/myproject</samp> using the username <q>me</q> and
|
|
|
|
|
the password <q>mypassword</q>. That will recursively get the files which are
|
|
|
|
|
labeled <q>Release1</q> and write them to the local directory <samp>C:\mysrc\myproject</samp>. The
|
|
|
|
|
local files will be writable.</p>
|
|
|
|
|
|
2001-04-29 16:24:21 +00:00
|
|
|
<pre>
|
|
|
|
|
<vssget localPath="C:\mysrc\myproject"
|
2002-06-22 23:38:38 +00:00
|
|
|
recursive="true"
|
2001-04-29 16:24:21 +00:00
|
|
|
label="Release1"
|
|
|
|
|
login="me,mypassword"
|
2002-09-26 13:28:41 +00:00
|
|
|
vsspath="$/source/aProject"
|
2018-02-28 07:58:59 +01:00
|
|
|
writable="true"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<hr/>
|
2001-04-29 16:24:21 +00:00
|
|
|
<!-- VSSLABEL -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vsslabel">VssLabel</h2>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Description</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Task to perform LABEL commands to Microsoft Visual SourceSafe.</p>
|
|
|
|
|
<p>Assigns a label to the specified version or current version of a file or project.</p>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-04-29 16:24:21 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>vsspath</td>
|
|
|
|
|
<td>SourceSafe path which specifies the project/file(s) you wish to perform the action on.</td>
|
|
|
|
|
<td>Yes</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>login</td>
|
|
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to VSS. Note
|
|
|
|
|
that you may need to specify both (if you have a password)—Ant/VSS will hang if you
|
|
|
|
|
leave the password out and VSS does not accept login without a password.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<tr>
|
|
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2001-07-27 08:43:26 +00:00
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>label</td>
|
|
|
|
|
<td>A label to apply to the hierarchy</td>
|
|
|
|
|
<td>Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>version</td>
|
|
|
|
|
<td>An existing file or project version to label. By default the current version is
|
|
|
|
|
labeled.</td>
|
2003-04-15 04:28:59 +00:00
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<tr>
|
|
|
|
|
<td>comment</td>
|
|
|
|
|
<td>The comment to use for this label. Empty or <q>-</q> for no comment.</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>autoresponse</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>What to respond with (sets the <kbd>-I</kbd> option). By default, <kbd>-I-</kbd> is
|
2018-02-28 07:58:59 +01:00
|
|
|
used; values of <q>Y</q> or <q>N</q> will be appended to this.</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
|
|
|
|
</tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
</table>
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Label the current version of the VSS project <samp>$/source/aProject</samp> with the
|
|
|
|
|
label <q>Release1</q> using the username <q>me</q> and the password <q>mypassword</q>.</p>
|
|
|
|
|
|
2001-04-29 16:24:21 +00:00
|
|
|
<pre>
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsslabel vsspath="$/source/aProject"
|
2001-04-29 16:24:21 +00:00
|
|
|
login="me,mypassword"
|
2018-02-28 07:58:59 +01:00
|
|
|
label="Release1"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Label version 4 of the VSS file <samp>$/source/aProject/myfile.txt</samp> with the
|
|
|
|
|
label <q>1.03.004</q>. If this version already has a label, the operation (and the build) will
|
|
|
|
|
fail.</p>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2001-04-29 16:24:21 +00:00
|
|
|
<pre>
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsslabel vsspath="$/source/aProject/myfile.txt"
|
2001-04-29 16:24:21 +00:00
|
|
|
version="4"
|
2018-02-28 07:58:59 +01:00
|
|
|
label="1.03.004"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<hr/>
|
2001-04-29 16:24:21 +00:00
|
|
|
<!-- VSSHISTORY -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vsshistory">VssHistory</h2>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Description</h3>
|
|
|
|
|
Task to perform HISTORY commands to Microsoft Visual SourceSafe.
|
|
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>vsspath</td>
|
|
|
|
|
<td>SourceSafe path which specifies the project/file(s) you wish to perform the action on.</td>
|
|
|
|
|
<td>Yes</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>login</td>
|
|
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to VSS. Note
|
|
|
|
|
that you may need to specify both (if you have a password)—Ant/VSS will hang if you
|
|
|
|
|
leave the password out and VSS does not accept login without a password.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>fromDate</td>
|
|
|
|
|
<td>Start date for comparison</td>
|
|
|
|
|
<td>See below</td>
|
|
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>toDate</td>
|
2002-07-09 21:06:15 +00:00
|
|
|
<td>End date for comparison</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>See below</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>dateFormat</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Format of dates in <var>fromDate</var> and <var>toDate</var>. Used when calculating dates
|
|
|
|
|
with the <var>numdays</var> attribute. This string uses the formatting rules of
|
|
|
|
|
SimpleDateFormat.</td>
|
|
|
|
|
<td>No; defaults to <code>DateFormat.SHORT</code></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>fromLabel</td>
|
|
|
|
|
<td>Start label for comparison</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>toLabel</td>
|
|
|
|
|
<td>Start label for comparison</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>numdays</td>
|
|
|
|
|
<td>The number of days for comparison.</td>
|
|
|
|
|
<td>See below</td>
|
|
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>output</td>
|
|
|
|
|
<td>File to write the diff.</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
2002-06-22 23:38:38 +00:00
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>recursive</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td><q>true|false</q></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>No</td>
|
2002-06-22 23:38:38 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>style</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td><q>brief</q>, <q>codediff</q>, <q>default</q> or <q>nofile</q>.</td>
|
|
|
|
|
<td>No; defaults to <q>default</q></td>
|
2002-06-22 23:38:38 +00:00
|
|
|
</tr>
|
2002-07-09 21:06:15 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>user</td>
|
|
|
|
|
<td>Name the user whose changes we would like to see</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q></td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>Specifying the time-frame</h4>
|
|
|
|
|
<p>There are different ways to specify what time-frame you wish to evaluate:</p>
|
|
|
|
|
<ul>
|
2018-02-28 07:58:59 +01:00
|
|
|
<li>Changes between two dates: Specify both <var>fromDate</var> and <var>toDate</var></li>
|
|
|
|
|
<li>Changes before a date: Specify <var>toDate</var></li>
|
|
|
|
|
<li>Changes after a date: Specify <var>fromDate</var></li>
|
|
|
|
|
<li>Changes X Days before a date: Specify <var>toDate</var> and (negative!) <var>numDays</var></li>
|
|
|
|
|
<li>Changes X Days after a date: Specify <var>fromDate</var> and <var>numDays</var></li>
|
2001-04-29 16:24:21 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Show all changes between <q>Release1</q> and <q>Release2</q>.</p>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsshistory vsspath="$/myProject" recursive="true"
|
2001-04-29 16:24:21 +00:00
|
|
|
fromLabel="Release1"
|
2018-02-28 07:58:59 +01:00
|
|
|
toLabel="Release2"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Show all changes between January 1st 2001 and March 31st 2001 (in Germany, date must be specified
|
|
|
|
|
according to your locale).</p>
|
2001-04-29 16:24:21 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsshistory vsspath="$/myProject" recursive="true"
|
2001-04-29 16:24:21 +00:00
|
|
|
fromDate="01.01.2001"
|
2018-02-28 07:58:59 +01:00
|
|
|
toDate="31.03.2001"/></pre>
|
2001-04-29 16:24:21 +00:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Shows all changes in the last fortnight.</p>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
2001-04-29 16:24:21 +00:00
|
|
|
<tstamp>
|
2004-11-19 09:07:12 +00:00
|
|
|
<format property="to.tstamp" pattern="M-d-yy;h:mma"/>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tstamp>
|
|
|
|
|
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsshistory vsspath="$/myProject" recursive="true"
|
2001-04-29 16:24:21 +00:00
|
|
|
numDays="-14"
|
|
|
|
|
dateFormat="M-d-yy;h:mma"
|
2018-02-28 07:58:59 +01:00
|
|
|
toDate="${to.tstamp}"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-03-04 10:36:45 +01:00
|
|
|
<hr/>
|
2001-04-29 16:24:21 +00:00
|
|
|
<!-- VSSCHECKIN -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vsscheckin">VssCheckin</h2>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Description</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Task to perform CHECKIN commands to Microsoft Visual SourceSafe.</p>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-04-29 16:24:21 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>vsspath</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>SourceSafe path which specifies the project/file(s) you wish to perform the action on.</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>login</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to
|
|
|
|
|
VSS. Note that you may need to specify both (if you have a password)—Ant/VSS will hang
|
|
|
|
|
if you leave the password out and VSS does not accept login without a password.</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>localpath</td>
|
|
|
|
|
<td>Override the working directory and get to the specified path</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>writable</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>recursive</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>comment</td>
|
|
|
|
|
<td>Comment to use for the files that where checked in.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>autoresponse</td>
|
|
|
|
|
<td><q>Y</q>, <q>N</q> or empty. Specify how to reply to questions from VSS.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Check in the file(s) named <samp>test*</samp> in the project <samp>$/test</samp> using the local
|
|
|
|
|
directory <samp>D:\build</samp>.</p>
|
|
|
|
|
|
2001-04-29 16:24:21 +00:00
|
|
|
<pre>
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsscheckin vsspath="$/test/test*"
|
2001-04-29 16:24:21 +00:00
|
|
|
localpath="D:\build\"
|
|
|
|
|
comment="Modified by automatic build"/>
|
|
|
|
|
</pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<hr/>
|
2001-04-29 16:24:21 +00:00
|
|
|
<!-- VSSCHECKOUT -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vsscheckout">VssCheckout</h2>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Description</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Task to perform CHECKOUT commands to Microsoft Visual SourceSafe.</p>
|
|
|
|
|
<p>If you specify two or more attributes from <var>version</var>, <var>date</var>
|
|
|
|
|
and <var>label</var> only one will be used in the
|
|
|
|
|
order <var>version</var>, <var>date</var>, <var>label</var>.</p>
|
2001-04-29 16:24:21 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-04-29 16:24:21 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>vsspath</td>
|
|
|
|
|
<td>SourceSafe path which specifies the project/file(s) you wish to perform the action on.</td>
|
|
|
|
|
<td>Yes</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>login</td>
|
|
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to VSS. Note
|
|
|
|
|
that you may need to specify both (if you have a password)—Ant/VSS will hang if you
|
|
|
|
|
leave the password out and VSS does not accept login without a password.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>localpath</td>
|
|
|
|
|
<td>Override the working directory and get to the specified path</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>writable</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>recursive</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>version</td>
|
|
|
|
|
<td>a version number to get</td>
|
|
|
|
|
<td rowspan="3">No; only one of these may be used</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>date</td>
|
|
|
|
|
<td class="left">a date stamp to get at</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>label</td>
|
|
|
|
|
<td class="left">a label to get for</td>
|
2001-04-29 16:24:21 +00:00
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>writablefiles</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Behavior when local files are writable. Valid options are: <q>replace</q>, <q>skip</q>
|
|
|
|
|
and <q>fail</q>; <q>skip</q> implies <var>failonerror</var>=<q>false</q></td>
|
|
|
|
|
<td>No; defaults to <q>fail</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>filetimestamp</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Set the behavior for timestamps of local files. Valid options
|
|
|
|
|
are <q>current</q>, <q>modified</q>, or <q>updated</q>.</td>
|
|
|
|
|
<td>No; defaults to <q>current</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>getlocalcopy</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Set the behavior to retrieve local copies of the files.</td>
|
|
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
2001-04-29 16:24:21 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Check out the project <samp>$/test</samp> recursively to the directory <samp>D:\build</samp>.</p>
|
|
|
|
|
|
2001-04-29 16:24:21 +00:00
|
|
|
<pre>
|
2002-09-26 13:28:41 +00:00
|
|
|
<vsscheckout vsspath="$/test"
|
2001-04-29 16:24:21 +00:00
|
|
|
localpath="D:\build"
|
|
|
|
|
recursive="true"
|
2018-02-28 07:58:59 +01:00
|
|
|
login="me,mypass"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<hr/>
|
2002-03-21 08:33:56 +00:00
|
|
|
<!-- VSSADD -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vssadd">VssAdd</h2>
|
2002-03-21 08:33:56 +00:00
|
|
|
<h3>Description</h3>
|
|
|
|
|
Task to perform ADD commands to Microsoft Visual SourceSafe.
|
|
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2002-03-21 08:33:56 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>localpath</td>
|
|
|
|
|
<td>Specify the local file(s) to add to VSS</td>
|
|
|
|
|
<td>Yes</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>login</td>
|
|
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to VSS. Note
|
|
|
|
|
that you may need to specify both (if you have a password)—Ant/VSS will hang if you
|
|
|
|
|
leave the password out and VSS does not accept login without a password.</td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>writable</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>recursive</td>
|
|
|
|
|
<td><q>true|false</q></td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>comment</td>
|
|
|
|
|
<td>Comment to use for the files that where checked in.</td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>autoresponse</td>
|
|
|
|
|
<td><q>Y</q>, <q>N</q> or empty. Specify how to reply to questions from VSS.</td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
2002-03-21 08:33:56 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Add the file named <samp>build.00012.zip</samp> into the project current working directory
|
|
|
|
|
(see <code>vsscp</code>).</p>
|
|
|
|
|
|
2002-03-21 08:33:56 +00:00
|
|
|
<pre>
|
|
|
|
|
<vssadd localpath="D:\build\build.00012.zip"
|
2018-02-28 07:58:59 +01:00
|
|
|
comment="Added by automatic build"/></pre>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<hr/>
|
2002-03-21 08:33:56 +00:00
|
|
|
<!-- VSSCP -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vsscp">VssCp</h2>
|
2002-03-21 08:33:56 +00:00
|
|
|
<h3>Description</h3>
|
|
|
|
|
<p>Task to perform CP (Change Project) commands to Microsoft Visual SourceSafe.</p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>This task is typically used before a <code>VssAdd</code> in order to set the target project</p>
|
2002-03-21 08:33:56 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2002-03-21 08:33:56 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>vsspath</td>
|
|
|
|
|
<td>SourceSafe path which specifies the project you wish to make the current project.</td>
|
|
|
|
|
<td>Yes</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>login</td>
|
|
|
|
|
<td><q>username[,password]</q>—The username and password needed to get access to VSS. Note
|
|
|
|
|
that you may need to specify both (if you have a password)—Ant/VSS will hang if you
|
|
|
|
|
leave the password out and VSS does not accept login without a password.</td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serverPath</td>
|
|
|
|
|
<td>directory where <samp>srcsafe.ini</samp> resides.</td>
|
|
|
|
|
<td>No</td>
|
2002-03-21 08:33:56 +00:00
|
|
|
</tr>
|
2003-04-15 04:28:59 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if <kbd>ss.exe</kbd> exits with a return code <q>100</q>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>true</q></td>
|
2003-04-15 04:28:59 +00:00
|
|
|
</tr>
|
2002-03-21 08:33:56 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Set the current VSS project to <samp>$/Projects/ant</samp>.</p>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<pre><vsscp vsspath="$/Projects/ant"/></pre>
|
2018-02-28 07:58:59 +01:00
|
|
|
|
|
|
|
|
<hr/>
|
2002-03-22 08:43:14 +00:00
|
|
|
<!-- VSSCREATE -->
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="vsscreate">VssCreate</h2>
|
|
|
|
|
<h3>Description</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Task to perform CREATE commands to Microsoft Visual Source Safe.</p>
|
|
|
|
|
<p>Creates a new project in VSS.</p>
|
2002-03-22 08:43:14 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2002-03-22 08:43:14 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Values</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2002-03-22 08:43:14 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>login</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td><q>username,password</q></td>
|
2002-03-22 08:43:14 +00:00
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>vsspath</td>
|
|
|
|
|
<td>SourceSafe path of project to be created</td>
|
|
|
|
|
<td>Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>ssdir</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>directory where <kbd>ss.exe</kbd> resides.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; by default expected to be in <code>PATH</code></td>
|
2002-03-22 08:43:14 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>quiet</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>suppress output</td>
|
|
|
|
|
<td>No; defaults to <q>off</q></td>
|
|
|
|
|
</tr>
|
2002-03-22 08:43:14 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>failOnError</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>fail if there is an error creating the project.</td>
|
|
|
|
|
<td>No; defaults to <q>true</q></td>
|
2002-03-22 08:43:14 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>autoresponse</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>What to respond with (sets the <kbd>-I</kbd> option). By default, <kbd>-I-</kbd> is
|
2018-02-28 07:58:59 +01:00
|
|
|
used; values of <q>Y</q> or <q>N</q> will be appended to this.</td>
|
2002-03-22 08:43:14 +00:00
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>comment</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>The comment to use for this label. Empty or <q>-</q> for no comment.</td>
|
2002-03-22 08:43:14 +00:00
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<h3>Examples</h3>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<p>Create the VSS Project <samp>$/existingProject/newProject</samp>.</p>
|
2018-02-09 06:54:03 +01:00
|
|
|
|
2018-05-15 09:51:58 +02:00
|
|
|
<pre><vsscreate vsspath="$/existingProject/newProject"/></pre>
|
2002-03-22 08:43:14 +00:00
|
|
|
|
2001-04-29 16:24:21 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
