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.

ビルドの自動化を行う際には、 速度の面から、 checkoutコマンドよりもget タスクの方が良いでしょう。



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
属性 説明 必須
command 実行するCVSコマンド No、デフォルトは"checkout"
compression truefalse - true に設定された場合、 compressionlevel="3"と同じです。 No、デフォルトはfalse
compressionlevel 1から9までの数 (CVS' -z# の引数の指定可能な値によります) 他の値は compression="false" として扱われます。 No、デフォルトは圧縮無
cvsRoot CVSROOT変数 No
cvsRsh CVS_RSH 変数 No
dest チェックアウトしたファイルを置くディレクトリ No、デフォルトはプロジェクトのベースディレクトリ
package チェックアウトするパッケージまたはモジュール No
tag チェックアウトするパッケージまたはモジュールのタグ No
date 与えられた日付の最も直前のバージョンを使う No
quiet 情報メッセージを出さない No、デフォルトは"false"
noexec レポートのみで、何もファイルを変更しない No、デフォルトは"false"
output コマンドからの標準出力をファイルへリダイレクトする No、デフォルト出力は MSG_INFO として Ant のログに出力します
error コマンドからの標準エラーをファイルへリダイレクトする No、デフォルトエラーは MSG_WARN として Ant のログに出力します
append ファイルへリダイレクトする際に標準出力/標準エラーを追記にするかどうか No、デフォルトは"false"
port Port used by CVS to communicate with the server. No, default port 2401.
passfile パスワードを読み込むパスワードファイル No、デフォルトファイルは~/.cvspass.
failonerror 0以外の終了コードでコマンドが終了した場合に、 ビルドプロセスを停止するかどうか。 デフォルトはfalse No


  <cvs cvsRoot=""

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

"jakarta-ant"のパッケージあるいはモジュールを、 cvsRoot 属性により参照されるCVS リポジトリよりチェックアウトし、 ファイルを"${ws.dir}"に保存します。

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

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

以前、"${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:

メッセージを出さずに(-q)、 "cvs add" により追加された 新しいファイルが入っている(-N) 結合された(-u)差分ファイルの入っている、 パッチの入力として使える patch.txt という名前のファイルを作成します。 これと等価のものは<commandline>要素を使って次のようになります:

<cvs output="patch">
        <argument value="-q"/>
        <argument value="diff"/>
        <argument value="-u"/>
        <argument value="-N"/>
<cvs output="patch">
        <argument line="-q diff -u -N"/>

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

幾つでも自分の好きなだけ <commandline> 要素を入れることができます。 そのそれぞれが、 failonerrorcompression、および、 <cvs>要素からの他の"global"パラメータを継承します。

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

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

スティッキービットを無視しながら(-A)、 必要に応じてディレクトリを作りながら(-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

注意: コマンドのテキストは cvs に "そのまま"渡されるので、 全ての cvs オプションはコマンドの前に現れなければならず、 diff の例で示したように、 全てのコマンドオプションはコマンドの後になければなりません。 詳しくは cvsマニュアル、 特に cvsコマンドガイド をご覧下さい。

Copyright © 2000-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは漆島賢二が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]