2001-02-13 12:32:01 +00:00
< html >
< head >
< meta http-equiv = "Content-Language" content = "en-us" >
2002-02-03 22:00:42 +00:00
< title > CVS Task< / title >
2001-02-13 12:32:01 +00:00
< / head >
< body >
< h2 > < a name = "cvs" > Cvs< / a > < / h2 >
< h3 > Description< / h3 >
2001-12-29 19:46:45 +00:00
< p > Handles packages/modules retrieved from a
2001-02-13 12:32:01 +00:00
< 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 >
2001-11-19 10:54:50 +00:00
< tr >
< td valign = "top" > cvsRsh< / td >
< td valign = "top" > the CVS_RSH variable.< / td >
< td align = "center" valign = "top" > No< / td >
< / tr >
2001-02-13 12:32:01 +00:00
< 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 >
2001-12-29 19:46:45 +00:00
< td align = "center" valign = "top" > No, default to " false" < / td >
2001-02-13 12:32:01 +00:00
< / 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 >
2001-12-29 19:46:45 +00:00
< 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 >
2001-04-27 11:52:55 +00:00
< 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 >
2001-10-19 08:47:14 +00:00
< 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 >
2001-02-13 12:32:01 +00:00
< / 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 >
2001-12-29 19:46:45 +00:00
< 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,
2001-02-13 12:32:01 +00:00
specifically the < a href = "http://www.cvshome.org/docs/manual/cvs_16.html" target = "_top" > Guide to CVS commands< / a > < / p >
2002-01-10 08:48:33 +00:00
< hr > < p align = "center" > Copyright © 2001 Apache Software Foundation. All rights
2001-02-13 12:32:01 +00:00
Reserved.< / p >
< / body >
< / html >
