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 >
2003-03-10 07:04:24 +00:00
< p > < b > Important< / b > This task needs "cvs" on the path. If it isn't, you will get
an error (such as error 2 on windows). If < cvs> doesn't work, try and execute
it from the command line in the target directory you are working in.
2001-02-13 12:32:01 +00:00
< 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 >
2002-04-04 10:34:22 +00:00
< td align = "center" valign = "top" > No, default " checkout" .< / td >
2001-02-13 12:32:01 +00:00
< / tr >
2002-04-04 10:34:22 +00:00
< tr >
2002-04-18 14:56:37 +00:00
< td valign = "top" > compression< / td >
2002-04-11 09:52:48 +00:00
< td valign = "top" > < code > true< / code > or < code > false< / code > - if set
2002-04-18 14:56:37 +00:00
to true, this is the same as compressionlevel=" 3" < / td >
2002-04-11 09:52:48 +00:00
< td align = "center" valign = "top" > No. Defaults to false.< / td >
< / tr >
< tr >
2002-04-18 14:56:37 +00:00
< td valign = "top" > compressionlevel< / td >
2002-04-11 09:52:48 +00:00
< td valign = "top" > A number between 1 and 9 (corresponding to
possible values for CVS' < code > -z#< / code > argument). Any
2002-04-18 14:56:37 +00:00
other value is treated as compression=" false" < / td >
2002-04-11 09:52:48 +00:00
< td align = "center" valign = "top" > No. Defaults to no compression.< / td >
2002-04-04 10:34:22 +00:00
< / tr >
2001-02-13 12:32:01 +00:00
< 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 >
2002-04-18 14:56:37 +00:00
< td valign = "top" > Stop the build process if the command exits with a
return code other than 0. Defaults to false< / td >
2001-10-19 08:47:14 +00:00
< td align = "center" valign = "top" > No< / td >
< / tr >
2001-02-13 12:32:01 +00:00
< / table >
< h3 > Examples< / h3 >
2002-04-04 07:43:36 +00:00
< pre > < cvs cvsRoot=" :pserver:anoncvs@cvs.apache.org:/home/cvspublic"
2003-02-19 09:23:20 +00:00
package=" ant"
2001-02-13 12:32:01 +00:00
dest=" ${ws.dir}"
/> < / pre >
2003-02-19 09:23:20 +00:00
< p > checks out the package/module " ant" from the CVS
2001-02-13 12:32:01 +00:00
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 >
2002-04-04 10:34:22 +00:00
2001-02-13 12:32:01 +00:00
< pre > < cvs command=" -q diff -u -N" output=" patch.txt" /> < / pre >
2002-04-04 10:34:22 +00:00
< 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.
The equivalent, using < commandline> elements, is:
< / p >
< pre >
< cvs output="patch">
< commandline>
< argument value="-q"/>
< argument value="diff"/>
< argument value="-u"/>
< argument value="-N"/>
< /commandline>
< /cvs>
< / pre >
or:
< pre >
< cvs output="patch">
< commandline>
< argument line="-q diff -u -N"/>
< /commandline>
< /cvs>
< / pre >
< p >
You may include as many < commandline> elements as you like.
Each will inherit the < code > failonerror< / code > , < code > compression< / code > , and other " global" parameters
from the < code > < cvs> < / code > element.
< / p >
2001-02-13 12:32:01 +00:00
< 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-04-04 07:43:36 +00:00
< hr >
2003-02-19 09:23:20 +00:00
< p align = "center" > Copyright © 2000-2003 Apache Software
2002-04-04 07:43:36 +00:00
Foundation. All rights Reserved.< / p >
2001-02-13 12:32:01 +00:00
< / body >
< / html >
