CvsTagDiff

Description

説明

Generates an XML-formatted report file of the changes between two tags or dates recorded in a CVS repository.

CVS リポジトリに記録された 2 つのタグや、日付の間の変更点についての、 XML 形式のレポートファイルを生成します。

Parameters

パラメータ

Attribute Description Required
startTag The earliest tag from which diffs are to be included in the report. exactly one of the two.
startDate The earliest date from which diffs are to be included in the report.
endTag The latest tag from which diffs are to be included in the report. exactly one of the two.
endDate The latest date from which diffs are to be included in the report.
destfile The file in which to write the diff report. Yes
属性 説明 必須
startTag どの期間をレポートに入れるか、その開始のタグ 2つのうち正確に1つ
startDate どの期間をレポートに入れるか、その開始の日付
endTag どの期間をレポートに入れるか、その終わりのタグ 2つのうち正確に1つ
endDate どの期間をレポートに入れるか、その終わりのタグ
destfile 差分レポートを書き出すファイル Yes

Parameters inherited from the cvs task

cvsより継承されたパラメータ

Attribute Description Required
compression true, false, or the number 1-9 (corresponding to possible values for CVS -z# argument). Any other value is treated as false No. Defaults to no compression. if passed true, level 3 compression is assumed.
cvsRoot the CVSROOT variable. No
cvsRsh the CVS_RSH variable. No
package the package/module to analyze. Yes
quiet suppress informational messages. No, default "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 buildprocess if the command exits with a returncode other than 0. Defaults to false No
属性 説明 必須
compression truefalse、 あるいは1から9の数 (CVS -z# の引数の可能な値に依存します) 他の値は false として扱われます。 No. デフォルトは圧縮なし。 trueが渡された場合、 圧縮レベル3と見なされます。
cvsRoot CVSROOT 変数 No
cvsRsh CVS_RSH 変数 No
package 分析するパッケージまたはモジュール Yes
quiet 情報メッセージを表示しません No, default "false"
port CVS がサーバーと接続するのに使われるポート番号 No、デフォルトは2401番ポート
passfile パスワードを読みこむパスワードファイル No、デフォルトファイルは~/.cvspass
failonerror 0 以外の戻り値でコマンドが終了したときにビルドプロセスを停止するか。 デフォルトは false No

Examples

  <cvstagdiff cvsRoot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic"
                destfile="tagdiff.xml"
                package="jakarta-ant"
                startTag="ANT_14"
                endTag="ANT_141"
  />

Generates a tagdiff report for all the changes that have been made in the jakarta-ant module between the tags ANT_14 and ANT_141. It writes these changes into the file tagdiff.xml.

jakarta-ant モジュールの ANT_14ANT_141 との間に なされた全ての変更のタグ差分レポートを生成します。 これらの変更点をtagdiff.xmlファイルに出力します。

  <cvstagdiff
                destfile="tagdiff.xml"
                package="jakarta-ant"
                startDate="2002-01-01"
                endDate="2002-31-01"
  />

Generates a tagdiff report for all the changes that have been made in the jakarta-ant module in january 2002. In this example cvsRoot has not been set. The current cvsRoot will be used (assuming the build is started from a folder stored in cvs. It writes these changes into the file tagdiff.xml.

jakarta-ant モジュールの 2002 年 1 月になされた全ての変更のタグ差分レポートを生成します。 この例では、cvsRootは設定されていません。 現在のcvsRootが使用されます。 (ビルドは cvs が保存されているフォルダから始まると仮定しています。) これらの変更点はtagdiff.xmlファイルに出力されます。

Generate Report

レポートの生成

Ant includes a basic XSLT stylesheet that you can use to generate a HTML report based on the xml output. The following example illustrates how to generate a HTML report from the XML report.

Ant には、 XML に基づいた HTML レポートの出力を生成するのに使われる 基本的な XSLT スタイルシートがあります。 次の例では、 XML レポートから HTML レポートを生成する方法を示します。

        <style in="tagdiff.xml" 
               out="tagdiff.html" 
               style="${ant.home}/etc/tagdiff.xsl">
          <param name="title" expression="Ant Diff"/>
          <param name="module" expression="jakarta-ant"/>
          <param name="cvsweb" expression="http://cvs.apache.org/viewcvs/"/>
        </style>

Sample Output

出力例

<?xml version="1.0" encoding="UTF-8"?>
<tagdiff startTag="ANT_14" endTag="ANT_141">
  <entry>
    <file>
      <name>src/main/org/apache/tools/ant/DirectoryScanner.java</name>
      <revision>1.15.2.1</revision>
      <prevrevision>1.15</prevrevision>
    </file>
  </entry>
</tagdiff>

Copyright © 2002 Apache Software Foundation. All rights Reserved.

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