bodewig 01/03/16 01:01:40
Modified: docs/manual optionaltasklist.html
Added: docs/manual/OptionalTasks starteam.html
Log:
documentation for the optional <starteam> task.
Submitted by: Matthew Di Iorio <MDiIorio@iss.net>
Revision Changes Path
1.8 +1 -0 jakarta-ant/docs/manual/optionaltasklist.html
Index: optionaltasklist.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/optionaltasklist.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- optionaltasklist.html 2001/03/02 15:56:42 1.7
+++ optionaltasklist.html 2001/03/16 09:01:29 1.8
@@ -34,6 +34,7 @@
<a href="OptionalTasks/renameextensions.html"><i>RenameExtensions</i></a><br>
<a href="OptionalTasks/script.html">Script</a><br>
<a href="OptionalTasks/sound.html">Sound</a><br>
+<a href="OptionalTasks/starteam.html">Starteam</a><br>
<a href="OptionalTasks/stylebook.html">Stylebook</a><br>
<a href="OptionalTasks/telnet.html">Telnet</a><br>
<a href="OptionalTasks/test.html">Test</a><br>
1.1 jakarta-ant/docs/manual/OptionalTasks/starteam.html
Index: starteam.html
===================================================================
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>Ant User Manual</title>
</head>
<body>
<h2>Starteam</h2>
<h3>Description</h3>
Checks out files from a StarTeam project.
<p>
The <i>includes</i> and <i>excludes</i> attributes function differently
from
other tasks in Ant. Multiple patters must be seperated by spaces, not
commas. See the examples for more information.
<p>
This program makes use of functions from the StarTeam API. As a result
this task is only available to licensed users of StarTeam. You must have
<CODE>starteam-sdk.jar</CODE> in your classpath to run this task.
For more information about the StarTeam API and how to license it, see
the <a href="http://www.starbase.com">StarBase</a> web site.
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
<td align="center" valign="top"><b>Required</b></td>
</tr>
<tr>
<td valign="top">servername</td>
<td valign="top">The name of the StarTeam server.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">serverport</td>
<td valign="top">The port number of the StarTeam server.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">projectname</td>
<td valign="top">The name of the StarTeam project.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">viewname</td>
<td valign="top">The name of the view in the StarTeam project.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">username</td>
<td valign="top">The username of the account used to log in to the StarTeam server.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">password</td>
<td valign="top">The password of the account used to log in to the StarTeam server.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">targetfolder</td>
<td valign="top">The folder to which files are checked out.</td>
<td align="center" valign="top">yes</td>
</tr>
<tr>
<td valign="top">foldername</td>
<td valign="top">The subfolder in the project from which to check out files.</td>
<td align="center" valign="top">no</td>
</tr>
<tr>
<td valign="top">force</td>
<td valign="top">Overwrite existing folders if this is set to "true". Defaults
to "false".</td>
<td align="center" valign="top">no</td>
</tr>
<tr>
<td valign="top">recursion</td>
<td valign="top">Indicates if subfolders should be searched for files to check
out. Defaults to "true".</td>
<td align="center" valign="top">no</td>
</tr>
<tr>
<td valign="top">verbose</td>
<td valign="top">Provides progress information. Defaults to "false".</td>
<td align="center" valign="top">no</td>
</tr>
<tr>
<td valign="top">includes</td>
<td valign="top">Only check out files that match at least one of the patterns
in this list. Patterns must be seperated by spaces. Patterns in <i>excludes</i>
take precedence over patterns in <i>includes</i>.</td>
<td align="center" valign="top">no</td>
</tr>
<tr>
<td valign="top">excludes</td>
<td valign="top">Do not check out files that match at least one of the patterns
in this list. Patterns must be seperated by spaces. Patterns in <i>excludes</i>
take precedence over patterns in <i>includes</i>.</td>
<td align="center" valign="top">no</td>
</tr>
</table>
<h3>Examples</h3>
<pre>
<starteam servername="STARTEAM"
serverport="49201"
projectname="AProject"
viewname="AView"
username="auser"
password="secret"
targetfolder="C:\dev\buildtest\co"
/>
</pre>
The minimum necessary to check out files out from a StarTeam server. This will
check out all files in the <i>AView</i> view of the <i>AProject</i>
project to
<code>C:\dev\buildtest\co</code>.
<pre>
<starteam servername="STARTEAM"
serverport="49201"
projectname="AProject"
viewname="AView"
username="auser"
password="secret"
targetfolder="C:\dev\buildtest\co"
foldername="\Dev"
excludes="*.bak *.old"
force="true"
/>
</pre>
This will checkout all files from the <i>Dev</i> folder and below that do not
end in <i>.bak</i> or <i>.old</i>. The force flag will cause any
existing files to be
overwritten by the version in StarTeam.
<pre>
<starteam servername="STARTEAM"
serverport="49201"
projectname="AProject"
viewname="AView"
username="auser"
password="secret"
targetfolder="C:\dev\buildtest\co"
includes="*.htm *.html"
excludes="index.*"
/>
</pre>
This is an example of overlapping <i>includes</i> and <i>excludes</i>
attributes. Because
<i>excludes</i> takes precedence over <i>includes</i>, files named
<code>index.html</code> will
not be checked out by this command.
<p>
<hr>
<p align="center">
Copyright © 2000,2001 Apache Software Foundation. All rights Reserved.
</p>
</body>
</html>
|