mirror of
https://github.com/apache/ant.git
synced 2025-05-15 20:45:11 +00:00
e967d77e02
PR: 5020 Reported By: jesse.glick@netbeans.com (Jesse Glick) git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@271131 13f79535-47bb-0310-9956-ffa450edef68
124 lines
4.8 KiB
HTML
124 lines
4.8 KiB
HTML
<html>
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Language" content="en-us">
|
|
<title>CVS Task</title>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h2><a name="cvs">Cvs</a></h2>
|
|
<h3>Description</h3>
|
|
<p>Handles packages/modules retrieved from a
|
|
<a href="http://www.cvshome.org/" target="_top">CVS</a> repository.</p>
|
|
<p>When doing automated builds, the <a href="get.html">get task</a> should be
|
|
preferred over the <i>checkout</i> command, because of speed.</p>
|
|
<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">command</td>
|
|
<td valign="top">the CVS command to execute.</td>
|
|
<td align="center" valign="top">No, default "checkout"</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">cvsRoot</td>
|
|
<td valign="top">the CVSROOT variable.</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">cvsRsh</td>
|
|
<td valign="top">the CVS_RSH variable.</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">dest</td>
|
|
<td valign="top">the directory where the checked out files should be placed.</td>
|
|
<td align="center" valign="top">No, default is project's basedir.</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">package</td>
|
|
<td valign="top">the package/module to check out.</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">tag</td>
|
|
<td valign="top">the tag of the package/module to check out.</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">date</td>
|
|
<td valign="top">Use the most recent revision no later than the given date</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">quiet</td>
|
|
<td valign="top">suppress informational messages.</td>
|
|
<td align="center" valign="top">No, default "false"</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">noexec</td>
|
|
<td valign="top">report only, don't change any files.</td>
|
|
<td align="center" valign="top">No, default to "false"</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">output</td>
|
|
<td valign="top">the file to direct standard output from the command.</td>
|
|
<td align="center" valign="top">No, default output to ANT Log as MSG_INFO.</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">error</td>
|
|
<td valign="top">the file to direct standard error from the command.</td>
|
|
<td align="center" valign="top">No, default error to ANT Log as MSG_WARN.</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">append</td>
|
|
<td valign="top">whether to append output/error when redirecting to a file.</td>
|
|
<td align="center" valign="top">No, default to "false".</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">port</td>
|
|
<td valign="top">Port used by CVS to communicate with the server.</td>
|
|
<td align="center" valign="top">No, default port 2401.</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">passfile</td>
|
|
<td valign="top">Password file to read passwords from.</td>
|
|
<td align="center" valign="top">No, default file ~/.cvspass.</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">failonerror</td>
|
|
<td valign="top">Stop the buildprocess if the command exits with a
|
|
returncode other than 0. Defaults to false</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
</table>
|
|
<h3>Examples</h3>
|
|
<pre> <cvs cvsRoot=":pserver:anoncvs@jakarta.apache.org:/home/cvspublic"
|
|
package="jakarta-tools"
|
|
dest="${ws.dir}"
|
|
/></pre>
|
|
<p>checks out the package/module "jakarta-tools" from the CVS
|
|
repository pointed to by the cvsRoot attribute, and stores the files in "${ws.dir}".</p>
|
|
<pre> <cvs dest="${ws.dir}" command="update"/></pre>
|
|
<p>updates the package/module that has previously been checked out into
|
|
"${ws.dir}".</p>
|
|
<pre> <cvs command="-q diff -u -N" output="patch.txt"/></pre>
|
|
<p>silently (-q) creates a file called patch.txt which contains a unified (-u) diff which includes new files added via "cvs add" (-N) and can be used as input to patch.</p>
|
|
<pre> <cvs command="update -A -d"/></pre>
|
|
<p>Updates from the head of repository ignoring sticky bits (-A) and creating any new directories as necessary (-d).</p>
|
|
<p>Note: the text of the command is passed to cvs "as-is" so any cvs options should appear
|
|
before the command, and any command options should appear after the command as in the diff example
|
|
above. See <a href="http://www.cvshome.org/docs/manual/index.html" target="_top">the cvs manual</a> for details,
|
|
specifically the <a href="http://www.cvshome.org/docs/manual/cvs_16.html" target="_top">Guide to CVS commands</a></p>
|
|
<hr><p align="center">Copyright © 2001 Apache Software Foundation. All rights
|
|
Reserved.</p>
|
|
|
|
</body>
|
|
</html>
|
|
|