Cvs

Description

Handles packages/modules retrieved from a CVS repository.

When doing automated builds, the get task should be preferred over the checkout command, because of speed.

Parameters

Attribute	Description	Required
command	the CVS command to execute.	No, default "checkout".
compression	`true` or `false` - if set to true, this is the same as compressionlevel="3"	No. Defaults to false.
compressionlevel	A number between 1 and 9 (corresponding to possible values for CVS' `-z#` argument). Any other value is treated as compression="false"	No. Defaults to no compression.
cvsRoot	the CVSROOT variable.	No
cvsRsh	the CVS_RSH variable.	No
dest	the directory where the checked out files should be placed.	No, default is project's basedir.
package	the package/module to check out.	No
tag	the tag of the package/module to check out.	No
date	Use the most recent revision no later than the given date	No
quiet	suppress informational messages.	No, default "false"
noexec	report only, don't change any files.	No, default to "false"
output	the file to direct standard output from the command.	No, default output to ANT Log as MSG_INFO.
error	the file to direct standard error from the command.	No, default error to ANT Log as MSG_WARN.
append	whether to append output/error when redirecting to a file.	No, default to "false".
port	Port used by CVS to communicate with the server.	No, default port 2401.
passfile	Password file to read passwords from.	No, default file ~/.cvspass.
failonerror	Stop the build process if the command exits with a return code other than 0. Defaults to false	No

Examples

  <cvs cvsRoot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic"

       package="jakarta-ant"

       dest="${ws.dir}"

  />

checks out the package/module "jakarta-ant" from the CVS repository pointed to by the cvsRoot attribute, and stores the files in "${ws.dir}".

  <cvs dest="${ws.dir}" command="update"/>

updates the package/module that has previously been checked out into "${ws.dir}".

  <cvs command="-q diff -u -N" output="patch.txt"/>

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. The equivalent, using <commandline> elements, is:


<cvs output="patch">

    <commandline>

        <argument value="-q"/>

        <argument value="diff"/>

        <argument value="-u"/>

        <argument value="-N"/>

    </commandline>

</cvs>

or:


<cvs output="patch">

    <commandline>

        <argument line="-q diff -u -N"/>

    </commandline>

</cvs>

You may include as many <commandline> elements as you like. Each will inherit the failonerror, compression, and other "global" parameters from the <cvs> element.

  <cvs command="update -A -d"/>

Updates from the head of repository ignoring sticky bits (-A) and creating any new directories as necessary (-d).

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 the cvs manual for details, specifically the Guide to CVS commands