第6章 SubWCRevプログラム

SubWCRevは、デフォルトで外部参照を除き、ワーキングコピー内のすべてのファイルのSubversionステータスを読み取ります。見つかった最新コミットリビジョン番号と、そのリビジョンのコミットタイムスタンプを記録し、ワーキングコピーにローカルな変更があるか、または混合した更新リビジョンがあるかも記録します。リビジョン番号、更新リビジョン範囲、および変更ステータスは標準出力 (stdout) に表示されます。

SubWCRev.exe は、コマンドラインまたはスクリプトから呼び出され、コマンドラインパラメータを使用して制御されます。

SubWCRev WorkingCopyPath [SrcVersionFile DstVersionFile] [-nmdfe]
      

WorkingCopyPath は、チェック対象のワーキングコピーへのパスです。SubWCRev はワーキングコピーでのみ使用でき、リポジトリで直接使用することはできません。パスは絶対パスまたは現在のワーキングディレクトリからの相対パスを使用できます。

リポジトリリビジョンやURLなどのフィールドをテキストファイルに保存するために、SubWCRevにキーワード置換を実行させたい場合は、テンプレートファイル SrcVersionFile と、置換されたテンプレートのバージョンを含む出力ファイル DstVersionFile を指定する必要があります。

SubWCRev が特定のファイルやパスを考慮しないようにするために、無視パターンを指定できます。パターンは .subwcrevignore という名前のファイルから読み取られます。ファイルは指定されたパスとワーキングコピーのルートからも読み取られます。ファイルが存在しない場合、ファイルやパスは無視されません。.subwcrevignore ファイルには、改行で区切られた複数のパターンを含めることができます。パターンは、リポジトリルートからの相対パスと、.subwcrevignore ファイルのパスからの相対パスに対して照合されます。たとえば、TortoiseSVN ワーキングコピーの doc フォルダ内のすべてのファイルを無視するには、.subwcrevignore に次の行を含めます。

/trunk/doc
/trunk/doc/*

または、.subwcrevignore ファイルが trunk からチェックアウトされたワーキングコピーのルートにあると仮定して、次のパターンを使用すると

doc
doc/*

上の例と同じです。

すべての画像を無視するには、無視パターンを次のように設定できます。

*.png
*.jpg
*.ico
*.bmp

SubWCRev の動作に影響を与えるいくつかのオプションスイッチがあります。複数使用する場合は、-n -m ではなく、-nm のように、単一のグループとして指定する必要があります。

エラーがない場合、SubWCRev はゼロを返します。ただし、エラーが発生した場合、エラーメッセージは標準エラー出力 (stderr) に書き込まれ、コンソールに表示されます。そして、返されるエラーコードは次のとおりです。