TortoiseSVN は Windows Vista 以上で動作し、32ビット版と64ビット版のどちらでも使用できます。64ビット版 Windows 用のインストーラーは32ビットの拡張部分も含みます。つまり、32ビットアプリケーションで TortoiseSVN のコンテキストメニューやオーバーレイを使用するために、別途32ビット版をインストールする必要はありません。

Windows 98、Windows ME、Windows NT4に対するサポートはバージョン1.2.0以前で終了し、Windows 2000とXPのSP2までは1.7.0以前で終了しました。Windows XP SP3は1.9.0以前で終了しました。もしそれらが必要であれば、旧バージョンをダウンロードしてインストールすることができます。

TortoiseSVNはインストーラーを使用すると簡単にインストールできます。インストーラーのファイルをダブルクリックし、画面の指示に従ってください。後はインストーラーが面倒を見てくれます。最後にPCを再起動するのをお忘れなく。

TortoiseSVN のユーザーインターフェイスを翻訳する言語パックが、たくさんの言語で提供されています。言語パックのインストール方法は、付録G 言語パックとスペルチェッカーを参照してください。

もしインストール中、またはインストール後に問題が発生した場合、https://tortoisesvn.net/faq.htmlでオンラインFAQを確認してください。

現実のプロジェクトでは、どこか安全なサーバーにリポジトリを構築し、それを制御するために Subversion サーバーをインストールします。今回は練習なのでサーバーを使用せず、 Subversion のローカルリポジトリ機能を使用し、リポジトリをローカルのハードディスクの中に構築して直接アクセスするようにします。

最初にPC上で新しい空のディレクトリを作成します。どこに作成しても良いのですが、練習として C:\svn_repos に作成したとします。そして、すぐに作成したフォルダーを右クリックし、コンテキストメニューから TortoiseSVN → ここにリポジトリを作成... を実行します。こうすれば、リポジトリがフォルダー内に作成され、使用可能な状態になります。また、 フォルダー構造を作成 ボタンをクリックすれば、デフォルトの内部フォルダー構造を作成することができます。

これでリポジトリができましたが、その中身はまだ空です。 C:\Projects\Widget1 に追加したいファイルのセットがあるとします。エクスプローラーで Widget1 フォルダーに移動し、右クリックします。そして、 TortoiseSVN → インポート... を実行すると、次のインポートダイアログが表示されます。

図1.2 インポートダイアログ

Subversion のリポジトリは、インターネット上のどこのリポジトリでも指定できるようにURLで参照します。この場合は、私たちが持っているローカルリポジトリのURL、 file:///c:/svn_repos/trunk を指すようにする必要があります。そして、プロジェクト名 Widget1 を追加します。 file: の後に3つのスラッシュあることや、スラッシュの向きにも注意してください。

このダイアログのもう１つの重要な機能が、インポートメッセージ欄です。ここには何をしているのか説明するメッセージを入力することができます。プロジェクトの履歴を参照するとき、このコミットメッセージはどのような変更をなぜ行ったのかを知る有力なガイドになります。今回は簡単に「Widget1プロジェクトをインポート」とでも入力してください。OKボタンをクリックすると、フォルダーがリポジトリに登録されます。

これでプロジェクトがリポジトリに登録されましたので、次に日常の作業に使用する作業コピーを作成します。フォルダーをインポートしたとき、フォルダーが自動的に作業コピーになる訳ではないので注意してください。Subversionでは、新しい作業コピーを作ることをチェックアウトといいます。リポジトリのWidget1フォルダーを、PC上の開発用フォルダーC:\Projects\Widget1-Devにチェックアウトしてみましょう。フォルダーを作成し、次にそれを右クリックして、TortoiseSVN → チェックアウト... を選択します。それからチェックアウト元のURLを、file:///c:/svn_repos/trunk/Widget1のような形式で入力し、OKをクリックします。これで開発用フォルダーに、リポジトリからファイルが読み込まれます。

この作業コピーのファイルをエクスプローラーで見ると、右下に緑色のチェックが入っていることに気が付くと思います。これは、この作業コピーがリポジトリの中にあるファイルと同じ内容であることを示しています。

さて、 filename>Widget1-Dev

しかし何が変更されたのでしょうか？変更されたファイルの１つを右クリックし、 TortoiseSVN → 差分 を選択してみてください。 TortoiseSVN のファイル比較ツールが起動し、どの行が変更されたのかが厳密に表示されます。

図1.3 ファイル差分ビューアー

さて、変更の内容に問題がないようでしたら、リポジトリを更新しましょう。これを変更をコミットすると言います。 Widget1-Dev フォルダーを右クリックし、 TortoiseSVN → コミット を選択してください。コミットダイアログには変更されたファイルが、チェックボックス付きで一覧表示されます。この中の一部のファイルのみをコミットすることもできますが、今回はすべてのファイルをコミットしましょう。メッセージ欄に何に関する変更なのかという説明を記入し、 OK をクリックします。ファイルがリポジトリにアップロードされていることを表示する進捗ダイアログが表示され、コミットが完了します。

プロジェクトの開発が進むにつれ、新規のファイルを追加する必要が出てくるかもしれません。 Extras.c とというファイルにある新しい機能を追加し、参照を既存の Makefile に追加するとしましょう。このフォルダーを右クリックして、 TortoiseSVN → 追加 を実行します。追加ダイアログが表示され、バージョン管理されていないファイルがすべて表示されるので、追加したいファイルを選択します。他にも、追加したいファイルを右クリックして、 TortoiseSVN → 追加 を実行することでファイルを追加することもできます。

次にフォルダーをコミットするとき、新しいファイルは追加と表示され、既存のファイルは変更と表示されます。なお、変更されたファイルをダブルクリックすると、どのような変更が行われたのかを確認することができます。

TortoiseSVNで最も便利な機能のひとつがログダイアログです。ここで、コミットされたファイルやフォルダの一覧と、コミット時に入力された詳細なメッセージを見ることができます。（勧めに応じてコミットメッセージを入力しましたか？入力していないなら、なぜ重要なのかが分かりますね）

図1.4 ログダイアログ

はい、ここでは少しずるをしてTortoiseSVNリポジトリからのスクリーンショットを使いました。

上の欄には、コミットされたリビジョンの一覧が、コミット時のメッセージの冒頭と一緒に表示されます。リビジョンを１つ選択すると、中央の欄にはそのリビジョンのログメッセージの全文、下の欄には変更されたファイルやフォルダの一覧が表示されます。

それぞれの欄でコンテキストメニューを使用すると、その情報に関する様々な操作ができます。下の欄のファイルをダブルクリックすると、そのリビジョンでの変更の詳細を見ることができます。詳しくは「リビジョンログダイアログ」を参照してください。

どのバージョン管理システムでも、以前に行った変更を取り消す機能を持っています。元に戻したくなったら、 TortoiseSVN では簡単に実行することができます。

まだコミットしていない変更を取り消して、ファイルを編集前の状態に戻したくなった場合は、 TortoiseSVN → 変更の取り消し... を選択します。これで変更が取り消され（この場合はごみ箱の中に入ります）、作業をする前にコミットされたバージョンに戻すことができます。一部の変更だけを取り消したい場合は TortoiseMerge を使用すれば、行単位に変更を確認したり、変更を取り消したりすることができます。

特定のリビジョンで行った変更を取り消したい場合は、ログダイアログを使用して変更を取り消したいリビジョンを探します。そして、 コンテキストメニュー → このリビジョンにおける変更を取り消す を選択すると、そのリビジョンで変更された部分が変更前の状態に戻ります。

次のような場面を想像してみてください。2人の同僚、ハリーとサリーがいたとします。2人は同時に同じリポジトリ内のファイルを編集しようとしています。始めにハリーが変更を保存してから、（数分後に）サリーが自分の新しいファイルを偶然にも上書きする可能性があります。（システムが変更を記憶しているので）ハリーのバージョンが永遠に失われるわけではありませんが、ハリーが行った変更はサリーの新バージョンに隠されて見えなくなります。サリーがハリーの変更を取り込まなかったからです。おそらく事故でですが、ハリーの作業は事実上失われたり、少なくとも後のバージョンのファイルには現れなくなったりします。これは確実に回避しなければならな状況です。

図2.2 回避したい問題

多くのバージョン管理システムでは、ロック・変更・アンロックモデルというとても単純な方法で、この問題に対処しています。このようなシステムでは、リポジトリはひとつのファイルにつき同時に一人しか変更できないようにしています。この場合、ハリーは変更を加える前にあらかじめロックをしなければなりません。ファイルをロックすることは、図書館から本を貸りるようなものです。ハリーがファイルにロックをかけると、サリーはそこに変更を加えられなくなります。サリーがファイルをロックしようとしても、リポジトリはその要求を拒否します。できるのは、ファイルを読むことと、ハリーが変更を終えてロックを解除するのを待つことだけです。ハリーが変更を終えてロックを解除すると、サリーはロックして編集できるようになります。

図2.3 ロック・変更・アンロックモデル

ロック・変更・アンロックモデルの問題点は、少々制限が厳しいことで、しばしばユーザーの作業の邪魔になります。

Subversion や CVS などのバージョン管理システムは、ロックの代わりに コピー・変更・マージ モデルを使用します。このモデルでは、ユーザーのクライアントが個別にリポジトリを読み込み、ファイルやプロジェクトの個人的な 作業コピー を作成します。そこからユーザーは並行して作業し、個人のコピーを変更します。最後に個人のコピーを新しい最終版にマージします。バージョン管理システムはマージの補助を行いますが、正しくマージする最終責任は人間が負うことになります。

例を挙げましょう。ハリーとサリーがそれぞれ同じプロジェクトの作業コピーを、リポジトリからコピーして作成したとします。2人とも同時に作業し、それぞれのコピーの同じファイル A に変更を加えました。先にサリーがリポジトリに変更を保存します。そのあとハリーが変更を適用しようとしますが、ハリーのファイル A は最新ではないとリポジトリに言われてしまいます。一方、リポジトリのファイル A には、ハリーが最後にコピーしたときから、何らかの変更が加わっています。そこでハリーは、リポジトリから新しい変更点を取得し、作業コピーのファイル A にマージするように指示を出します。幸い、サリーの変更はハリーの変更に重なりません。そのため、いったん両方の変更点を統合してしまえば、作業コピーの内容をリポジトリに書き戻すことができます。

図2.4 コピー・変更・マージモデル

図2.5 ...コピー・変更・マージモデル（の続き）

では、サリーの変更がハリーの変更に重なっていたら？そのときはどうなるのでしょう？この状況は競合と呼ばれ、ふつうは多発するものではありません。ハリーがクライアントプログラムに、リポジトリの最新の変更を自分の作業コピーにマージするよう指示を出すと、作業コピーのファイル A は競合している状態になります。このとき彼は競合した変更を両方とも見ることができ、どちらを採用するかを選択することができます。ソフトウェアは自動的に競合を解決できないことに注意してください。理解し正しく選択する力を持っているのは人間だけです。ハリーがいったん重なった変更を解決したら、（おそらくサリーと競合について話し合ったあとで）マージしたファイルを安全にリポジトリに保存できます。

コピー・変更・マージモデルは少々無秩序に見えますが、実際にはとてもスムーズに事が進みます。ユーザーは他の人を待つこともなく、並行して作業を進められます。同じファイルに対して作業を行った場合でも、ほとんどの変更は重ならないことが分かると思います。そして、競合を解決するのにかかる時間は、ロックシステムで失われる時間よりもずっと少ないのです。

このことは、最終的にひとつの重要な要因にたどり着きます。ユーザー間のコミュニケーションです。ユーザーがお互いに意見をやりとりしなければ、構文上・意味上の競合が増えていきます。どんなシステムもユーザーに完璧なコミュニケーションを強要できませんし、意味上の競合も検出できません。したがって、ロックシステムなら競合は防げるなどという間違った思い込みで安心するなど、全く意味がありません。実際には、ロックは生産性を下げる以外の何物でもないように思えます。

ロック・変更・アンロックモデルの方がよいといわれる事例もあります。マージできないファイルがある場合です。例えば、リポジトリに画像イメージが含まれている場合、2人が同時にイメージを変更してもこれをマージする方法はありません。ハリーとサリーのどちらも自分の行った変更を失ってしまいます。

通常、 Subversion はコピー・変更・マージモデルを使用しますし、ほとんどの場合この方法が求められていると思います。しかし、バージョン1.2で、 Subversion はファイルのロックもサポートしました。したがって、マージできないファイルがあったり、管理するのに単にロックポリシーを強制したりしたい場合にも、 Subversion は必要に応じてそういった機能を提供することができます。

作業コピーについてはすでに説明したとおりですので、今度は Subversion クライアントでどのように作業コピーを作成したり使用したりするかを見ていきましょう。

Subversion の作業コピーは、ローカルシステム上にある通常のディレクトリツリーで、ここにファイルが集められています。お望みのファイルをどれでも編集することができますし、それがソースコードのファイルなら、いつも通りそのファイルからプログラムをコンパイルできます。作業コピーは自分の個人的な作業場所です。 Subversion が他人の変更をここに組み込むことはありませんし、同様に、明確に指示するまで自分の変更が他人に公開されることもありません。

作業コピーのファイルに変更を加え、それがうまく動作することを確認したあとで、その変更を同じプロジェクトで一緒に作業しているほかの人に（リポジトリに書き込むことで） 公開 するためのコマンドが Subversion には用意されています。また、他の人の変更が公開されたときは、その変更を（リポジトリから読み出して）自分の作業コピーにマージするコマンドが用意されています。

作業コピーには、 Subversion のコマンドの実行を補助するために、作成・保守される特別なファイルがあります。具体的には、作業コピーの中に .svn という名前のサブディレクトリが作られます。これは作業コピーの 管理ディレクトリ として知られています。管理ディレクトリ内のファイルは、まだ公開していない変更があるか、また他の人の作業によって最新でなくなっているかを Subversion が認識する助けになります。 Subversion 1.7 以前では、 .svn ディレクトリは作業コピー内のバージョン管理対象のディレクトリそれぞれに作られていました。 Subversion 1.7 で完全に方法が変更され、各作業コピーが持つ管理ディレクトリは作業コピーのルートの直下に1つだけ作られるようになりました。

典型的な Subversion リポジトリでは、いくつものプロジェクトのファイル（やソースコード）を保持し、リポジトリのファイルシステムツリー以下に、プロジェクトごとのサブディレクトリを置いています。この配置では、ユーザーの作業コピーは大抵リポジトリの特定のサブツリーに相当します。

例えば、２つのソフトウェアプロジェクトがあるリポジトリがあったとします。

図2.6 リポジトリのファイルシステム

具体的には、リポジトリのルートディレクトリに paint と calc というサブディレクトリがあります。

作業コピーを取得するために、リポジトリのサブツリーを チェックアウト しなければなりません（チェックアウト は、リソースのロックや予約が必要なように思われますが、そんなことはありません。単に、プロジェクトのプライベートなコピーを作成するだけです）。

button.c を変更したとしましょう。 .svn ディレクトリには、ファイルの変更日時と元の内容が記録されていますから、 Subversion はファイルが変更されていることがわかります。しかし、変更は明確に指示するまで公開はされません。変更を公開する操作は通常、変更をリポジトリへ コミット する（もしくは チェックイン する）と呼ばれています。

変更を他の人に公開するには、 Subversion のコミット（commit）コマンドを使用します。

さて、 button.c への変更を、リポジトリにコミットした後で、他のユーザーが /calc の作業コピーをチェックアウトすると、変更が反映された最新版のファイルが取得されます。

自分にサリーという相棒がいて、 /calc の作業コピーを自分と同時にチェックアウトしたとします。自分が button.c の変更をコミットしても、サリーの作業コピーは変更されません。 Subversion はユーザーが操作しないと作業コピーを更新しないからです。

サリーのプロジェクトを最新状態にするには、Subversion に作業コピーを 更新 するよう指示します。これは Subversion の更新（update）コマンドを使用します。これによって、自分の変更がサリーの作業コピーに組み込まれ、またチェックアウト後にコミットされた他の人の変更も同様に組み込まれます。

サリーは、どのファイルを更新するかを指定する必要はありません。Subversion は .svn ディレクトリの情報とリポジトリ内の詳細情報を使用して、どのファイルを更新するか決めるのです。

Subversion のリポジトリは、ローカルディスクや様々なネットワークプロトコル経由など、多様な方法でアクセスできます。しかし、リポジトリの位置は常に URL で表します。 URL スキーマはアクセス方法を表します。

Subversion のURLの大部分には標準的な文法を使用し、URLの中にサーバー名やポート番号を含めることができます。 file:// によるアクセス方法は、通常はローカルアクセスに使用しますが、ネットワーク上のホストに対する UNC パスにも使用できます。そのためURLは file://hostname/path/to/repos のような形式になります。同一マシン内では URL の hostname の部分を省略するか localhost としてください。このためローカルパスを表すには、file:///path/to/repos のようにスラッシュが3つ並べることになります。

また Windows 上で file:// スキームを使用する場合は、同じマシン上のカレントドライブとは別のドライブにあるリポジトリにアクセスするためには、非公式の「標準」構文を使う必要があります。以下のURLパス構文のどちらか一方を使えばアクセスできます。ここで X はリポジトリのあるドライブです。

file:///X:/path/to/repos
...
file:///X|/path/to/repos
...

Windows の（URL以外の）パスの形式ではバックスラッシュを使用しますが、URLには通常スラッシュを使用することに注意してください。

ネットワークフォルダー上でもFSFSリポジトリにはアクセスできますが、これはさまざまな理由によりお勧めできません。

svn commit （コミット）の操作は、ファイルやディレクトリの変更を、単一の不可分トランザクションで公開します。作業コピーで、ファイル内容の変更、ファイルやディレクトリの作成、削除、名前の変更、コピーなど行い、それ全体を単位とした完全な変更セットをコミットできます。

リポジトリでは、コミットを不可分トランザクションとして扱い、変更をすべて配置するか、何も配置しないかのどちらかになります。 Subversion はプログラムの異常終了や、システムの異常終了、ネットワーク障害、他のユーザーの操作に直面しても、この最小単位を保持しようとします。

リポジトリがコミットを受け付けるごとに、ファイルシステムツリーの状態が新しく作成されます。これを リビジョン と呼びます。リビジョンごとに一意の自然数が割り当てられ、直前のリビジョンよりも1だけ大きくなります。リポジトリを新規作成した直後のリビジョンは 0 で、ルートディレクトリ以外はなにも含まれていません。

リポジトリを視覚化するよい方法は、ツリーの連続で表すというものです。 0 から始まるリビジョン番号の配列が、左から右に追加されていく状況を想像してください。それぞれのリビジョン番号には対応したファイルシステムツリーがあり、それぞれのツリーはコミット後のリポジトリの状態を示す「スナップショット」です。

図2.7 リポジトリ

作業コピーが、リポジトリの特定のリビジョンに常に対応しているとは限らないということに充分注意してください。複数の異なるリビジョンが混在している可能性があります。たとえば、最新のリビジョンが 4 であるリポジトリから、作業コピーをチェックアウトしたとします。

calc/Makefile:4
integer.c:4
button.c:4
      

この時点では作業ディレクトリは、リポジトリのリビジョン 4 と完全に一致します。しかし、ここで button.c に変更を加え、変更をコミットしたとします。他にコミットした人がいなければ、このコミットではリポジトリにリビジョン 5 を作成し、作業コピーの内容は以下のようになります。

calc/Makefile:4
integer.c:4
button.c:5
      

この時点で、サリーが integer.c を変更し、リビジョン 6 を作成したとします。 svn update で自分の作業コピーを更新すると、以下のようになります。

calc/Makefile:6
integer.c:6
button.c:6
      

サリーの integer.c への変更は、自分の作業コピーに現れますが、 button.c へ行った自分の変更はそのままです。この例では、Makefile の内容はリビジョン 4、5、6 で全く同じものですが、 Subversion は作業コピー中の Makefile のリビジョンを 6 にして、最新であることを表現します。そのため作業コピーのトップでまっさらな更新を行うと、一般的に、作業コピーはリポジトリの特定のリビジョンに完全に一致します。

作業ディレクトリ内のファイルに対して、Subversion は２つの本質的な情報を .svn/ 管理領域に記録します。

この情報とリポジトリとのやりとりによって、 Subversion は、作業ファイルが以下の4つの状態のどれかを確認できます。

これで、 D:\SVN\MyNewRepository に新しいリポジトリを作成できました。

ローカルリポジトリにアクセスするには、そのフォルダーへのパスが必要です。 Subversion ではすべてリポジトリのパスを file:///C:/SVNRepository/ という形で表すことを覚えておいてください。すべてスラッシュ（「/」）を使用することに注意してください。

ネットワークフォルダー上のリポジトリにアクセスするには、ドライブ文字の割り当てと UNC パスの両方が使えます。 UNC パスは file://ServerName/path/to/repos/ といった形です。先頭にスラッシュ（「/」）が２つあることに注意してください。

SVN 1.2 以前では、UNC パスは file:///\\ServerName/path/to/repos というもっと曖昧な形でした。この形もまだサポートしていますが、お勧めしません。

原理上、FSFSリポジトリはネットワークフォルダー上に配置でき、file://プロトコルを用いて複数のユーザーからアクセスできますが、これは絶対にお勧め しません 。実際のところ、このような使い方を私たちは思いとどまってほしいと強く思いますし、様々な理由からサポートもしません。

file:// アクセスは、ローカルでの1ユーザーのみのアクセスを想定しており、そのようにテストとデバッグを行っています。リポジトリを共有したい場合は、 まさに 適切なサーバーをセットアップする必要がある場面であり、それは見かけほど難しくはありません。サーバーの選択・設定のガイドラインは、 「リポジトリへのアクセス」 をお読みください。

データをリポジトリにインポートする前に、データをどのような構成にするかをはじめに考える必要があります。おすすめのレイアウトを採用すれば、あとがより楽になるでしょう。

リポジトリの構成には標準的な、おすすめの方法があります。多くの人は開発の「メインライン」を保持するためのトランク（trunk）ディレクトリ、ブランチコピーを入れるブランチ（branches）ディレクトリ、そしてタグコピーを入れるタグ（tags）ディレクトリを作成します。リポジトリに単一のプロジェクトでしか使わない場合には、次のように、この3つのディレクトリをリポジトリ最上位に作ります。

/trunk
/branches
/tags
    

このレイアウトは一般的に使われていますので、 TortoiseSVN で新しくリポジトリを作成する際には、このディレクトリ構造を作成をするかどうか確認します。

リポジトリに複数のプロジェクトがあるなら、以下のようにサブディレクトリでまとめたレイアウトにしたり、

/trunk/paint
/trunk/calc
/branches/paint
/branches/calc
/tags/paint
/tags/calc
    

以下のようにプロジェクトでまとめたりします。

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags
    

プロジェクト同士があまり密接に連携しておらず、それぞれ個々にチェックアウトできるなら、プロジェクトごとにまとめる方法が便利でしょう。プロジェクト同士が連携している場合には、一度に全てチェックアウトしたいと思うことでしょうし、ひとつの配布パッケージに結合されるプロジェクトなどはサブディレクトリでまとめた方がいいでしょう。この方法ならば、ひとつのトランクをチェックアウトするだけで済み、またサブプロジェクト間の関係も容易に把握できます。

トップレベルに /trunk /tags /branches を配置するアプローチを採用する場合でも、ブランチやタグを作るたびにトランクの全体をコピーしなければならないと言うことはありません。また、ある意味ではこの構造は最も柔軟な形となります。

関連がないプロジェクトはリポジトリを分けるという方法もあります。変更をコミットする際、リビジョン番号はプロジェクトごとに振られるのではなく、リポジトリ全体の変更に振られます。関連のない２つのプロジェクトがリポジトリを共有すると、リビジョン番号に大きなギャップが生じます。 Subversion プロジェクトと TortoiseSVN プロジェクトは同じホストアドレスにありますが、独立して開発できるよう、またビルド番号で混乱しないよう、リポジトリが分けられています。

もちろん、以上の標準的なレイアウトを無視しても構いません。自分たちでうまく作業できるように、様々な整理の仕方があるでしょう。ここで選択したものを、永遠に使い続けなければならないわけではないということを覚えておいてください。いつでもリポジトリを再構成できます。ブランチやタグは特定のディレクトリですから、 TortoiseSVN はお好みにあわせて移動したり名前を変更したりできます。

あるレイアウトから別のレイアウトへ切り替えるのは、ただ単にサーバー側で移動するだけです。リポジトリの構成が気に入らなければ、ディレクトリを移動させてください。

そのため、まだ基本的なフォルダー構造を、リポジトリに作成していないのであれば、今のうちにやっておくべきです。これを行うには、2通りの方法があります。 /trunk /tags /branches 構造を単に作成したいだけであれば、リポジトリブラウザーを使用して、3つのフォルダーを作成できます（3つのコミットに分かれます）。もっと深い階層を作成する場合は、まずディスクにフォルダー構造を作成し、その後一度にコミットする方法が簡単です。以下のように行います。

中身をインポートしたフォルダーの名前はリポジトリに現れないことに注意してください。たとえば、以下のようなフォルダー構造を作成した場合、

C:\Temp\New\trunk
C:\Temp\New\branches
C:\Temp\New\tags

リポジトリルートに C:\Temp\New をインポートすると、次のようになります。

/trunk
/branches
/tags

図4.1 エクスプローラーのアイコンオーバーレイ表示

TortoiseSVN のもっとも目に見える機能のひとつが、作業コピーのファイルに現れるアイコンオーバーレイです。これにより、ファイルが変更されているかどうかが一目瞭然となります。オーバーレイが表す内容については、 「アイコンオーバーレイ」 をご覧ください。

図4.2 バージョン管理下のフォルダーのコンテキストメニュー

TortoiseSVN のコマンドは、すべて Windows エクスプローラーのコンテキストメニューから呼び出します。ファイルやフォルダーを右クリックすると、多くは直接見えています。コマンドは、ファイルやフォルダーであるかどうか、その親フォルダーがバージョン管理下にあるかどうかで変わります。 TortoiseSVN のメニューは、エクスプローラーのファイルメニューにも現れます。

場合によっては、TortoiseSVN のエントリを、複数目にするかもしれません。これはバグではありません。

図4.3 バージョン管理されたフォルダー内のショートカットに対するエクスプローラーのファイルメニュー

この例では、バージョン管理下のフォルダー内にバージョン管理外のショートカットがある場合、エクスプローラーのファイルメニューに TortoiseSVN のエントリが 3つ 現れます。ひとつはフォルダー用、ひとつはショートカット用、最後にショートカットが指すオブジェクト用です。見分けるためにアイコンの右下に、ファイル、フォルダー、ショートカットのメニューエントリか、複数選択した項目かを示すマークがつきます。

図4.4 バージョン管理下のディレクトリに対する右ドラッグメニュー

作業コピーの中にファイルやフォルダーを右ドラッグしたり、バージョン管理下のディレクトリにバージョン管理外のファイルやフォルダーを右ドラッグしたりすると、そのドラッグハンドラによって他のコマンドが有効になります。

共通の操作は Windows のショートカットでよく知られていますが、ボタンに表示されるわけではありませんし、メニューもありません。「表示を更新する」のように、したいことが明確なのに方法が分からない場合は、ここをチェックしてみてください。

アクセスしようとしているリポジトリがパスワードで保護されている場合、認証ダイアログが表示されます。

図4.5 認証ダイアログ

ユーザー名とパスワードを入力してください。チェックボックスをチェックすると、証明書が保存されます。証明書は Subversion のデフォルトディレクトリ（%APPDATA%\Subversion\auth）にある、次の3つのサブディレクトリに格納されます。

認証情報のキャッシュをクリアするには、TortoiseSVNの設定ダイアログの 保存されたデータページから行えます。すべて消去ボタンで、すべてのリポジトリのキャッシュされた認証データを消去します。消去...ボタンではキャッシュされた認証データのうちどれを消去するかを選択するダイアログが表示されます。「保存データの設定」 を参照してください。

Windows のログオフ時やシャットダウン時に認証データを削除したい場合は、 %APPDATA%\Subversion\auth ディレクトリを削除するシャットダウンスクリプトを使用すれば実現できます。例えば、

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"

このようなスクリプトをインストールする方法は、http://www.windows-help-central.com/windows-shutdown-script.html に説明があります。

認証とアクセスコントロールに関して、サーバーをどのようにセットアップするかに関する情報は、 「リポジトリへのアクセス」を参照ください。

TortoiseSVN のダイアログの多くは、大量の情報を表示します。しかし、これを画面全体に最大化するよりは、縦方向・横方向のみ最大化した方が便利な場合があります。 最大化 ボタンに便利なショートカットを用意しています。マウスで中クリックすると縦に最大化され、右クリックすると横方向に最大化されます。

すでにいくつかのプロジェクトが登録されているリポジトリにインポートする場合、リポジトリ構造はすでに決まっていることでしょう。新しいリポジトリにデータをインポートする場合には、どのようにリポジトリを構成するかを考えるのに、時間を費やす価値はあります。もっとアドバイスが必要であれば、 「リポジトリのレイアウト」をお読みください。

この章では、 Subversion のインポート（import）コマンドについて解説しています。このコマンドは、ディレクトリ階層を一度にリポジトリにインポートするよう設計されています。この動作には、いくつか欠点もあります。

このような理由から、リポジトリに初期構造の /trunk /tags /branches を作成する場合を除いて、import コマンドを使用せずに、 「その場でインポート」 で説明している2段階の手順で実行することをお勧めします。ここでは、基本的なインポートのしかたを示します。

リポジトリにプロジェクトをインポートする前に、次の作業を行ってください。

そして Windows エクスプローラーで、プロジェクトのディレクトリ構造の最上位フォルダーを選択し、右クリックでコンテキストメニューを出してください。 TortoiseSVN → インポート... コマンドを選択すると、次のダイアログボックスが表示されます。

図4.6 インポートダイアログ

このダイアログで、プロジェクトのインポート先のリポジトリの場所を示すURLを入力する必要があります。リポジトリには、インポートしようとするローカルフォルダーは現れず、その中身だけが現れるということ注意してください。例えば次のような構造があるとします。

C:\Projects\Widget\source
C:\Projects\Widget\doc
C:\Projects\Widget\images

ここで、 C:\Projects\Widget を http://mydomain.com/svn/trunk にインポートすると、Widget サブディレクトリではなく、その中のサブディレクトリが trunk の直下に現れるので、驚くかもしれません。サブディレクトリ名は、 http://mydomain.com/svn/trunk/Widget-X というようにURLの一部として指定する必要があります。インポートコマンドでは、リポジトリの中にサブディレクトリがない場合、自動的に作成されることに注意してください。

インポートメッセージは、ログメッセージとして使われます。

デフォルトでは、常に無視するパターンにマッチしたファイル・フォルダーはインポートされません。 無視ファイルを含める チェックボックスを使用すると、この動作を上書きします。常に無視するパターンの設定の詳細は 「一般設定」をご覧ください。

OK を押すと、TortoiseSVN は全てのファイルが入った完全なディレクトリを、リポジトリにインポートします。これでプロジェクトがバージョン管理下にあるリポジトリに格納されました。なお、インポートしたフォルダーは、バージョン管理下に入りません。バージョン管理下の 作業コピー を取得するには、インポートしたときのバージョンをチェックアウトする必要があります。もしくは、フォルダーをその場でインポートする方法をご覧ください。

既にリポジトリが存在していて、新しいフォルダー構造を追加する場合は、次のように操作してください。

バージョン管理下のファイルに、ユーザー別のデータを含める必要がある場合があります。つまり、それぞれのユーザー・開発者別に、環境に合わせて変更しなければならないファイルがある場合です。そういったファイルは、ユーザーがそれぞれいつでもリポジトリにコミットしてしまうことができるために、バージョン管理が難しくなります。

このような場合、テンプレートファイルを使用することをお勧めします。開発者が必要な全てのデータを含むファイルを作成し、そのファイルをバージョン管理下に置きます。開発者はそのファイルをチェックアウトします。それから、それぞれの開発者がそのファイルのコピーを作成し、名前を変更します。そうするとコピーを変更してもなんの問題もありません。

たとえば、TortoiseSVN の構築スクリプトを参照してください。このファイルの名前は default.build.user ですが、リポジトリにはありません。default.build.user.tmpl ファイルがあるだけです。default.build.user.tmpl はテンプレートファイルで、開発者ごとにコピーを作成し、 default.build.user と名前を変更するようになっています。このファイルの中には、ユーザーがどの行を編集・変更すればいいか判るように、セットアップのしかたをコメントとして追加しています。

ユーザーが不安にならないように、default.build.userを親フォルダーの無視リストに追加してあります。つまり、Subversionのsvn:ignoreプロパティをそのファイルに設定しています。これにより（バージョン管理外のファイルのように）コミットごとに表示されることがなくなります。

チェックアウトの際、 深さ を選択することで、子フォルダーを再帰処理する深さを選択できます。大きなツリーの一部だけをチェックアウトしたい場合は、まずツリーの一番上のフォルダーのみをチェックアウトし、それから選択されたフォルダーを再帰的に更新してください。

手っ取り早く必要な項目だけをチェックアウトし、その項目だけを保持しておくのであれば、 項目を選択... ボタンをクリックしてください。新しいダイアログが開くので、作業コピーに入れたいすべての項目をチェックして、それ以外の項目のチェックを外してください。作業コピーは部分的なチェックアウトという状態になります。この作業コピーを更新した場合は、チェックアウトされたファイルだけが更新され、存在しないファイルは更新されません。

作業コピーを部分的にチェックアウトした場合（つまり、チェックアウトする深さに再帰的以外を指定した場合）、次のような方法で後から簡単にサブフォルダーを追加したり除外したりすることができます。

この機能は、大きなツリーの一部をチェックアウトする時だけでなく、ひとつの作業コピーを更新する際にも非常に便利です。 Project01 から Project99 といったサブフォルダーがある大きなツリーがあり、 Project03、Project25、Project76/SubProj だけをチェックアウトしようとしているとしましょう。以下のような手順となります。

作業コピーが最新で競合がない場合、変更をコミットする準備ができています。コミットするファイルやフォルダーを選択し、 TortoiseSVN → コミット... を実行してください。

図4.8 コミットダイアログ

コミットダイアログには変更されたファイルや、追加・削除・バージョン管理外のファイルが表示されます。変更されたファイルをコミットしたくない場合は、ファイルのチェックをはずしてください。バージョン管理外のファイルを含める場合は、追加・コミットするファイルにチェックをつけてください。

バージョン管理中のファイルや変更されたファイルのすべてを手早くチェックしたり外したりしたい場合は、項目が表示されている一覧の上部にある項目をクリックしてください。

項目の状態に応じた色やオーバーレイについての詳細は、「ローカルとリモートの状態」をご覧ください。

別のリポジトリパスに切り替えた項目には、(s)マークが付きます。何かを切り替えてブランチで作業した後、トランクに戻すのを忘れている可能性もあります。これは警告マークです。

コミットダイアログで変更のあるファイルをダブルクリックすると、変更を確認するよう外部差分ツールが起動します。スクリーンショットにあるようにコンテキストメニューでもっとオプションを指定できます。ここからファイルをドラッグして、テキストエディターやIDEといったアプリケーションに持っていくこともできます。

項目の左にあるチェックボックスをクリックして、選択状態を切り替えられます。ディレクトリに対して、 Shift を押しながら選択すると、再帰的に動作します。

下の欄に表示される列はカスタマイズすることができます。列見出しの上で右クリックすると、表示される列を選択するコンテキストメニューが表示されます。また、列の境界上にマウスを持っていくとドラッグハンドルが表示され、列幅を変更できます。以上のカスタマイズは保存されるので、次回も同じ列見出しで表示されます。

デフォルトでは変更をコミットすると、コミット完了後に保持していたファイルのロックが自動的に解除されます。ロックを保持したままにしたい場合は、 ロックを保持 チェックボックスにチェックしておきます。チェックボックスのデフォルト状態は、 Subversion 設定ファイルの no_unlock オプションから取得されます。 Subversion 設定ファイルの編集については、 「一般設定」 をご覧ください。

コミットダイアログは、関連するファイルのグループ化を助ける Subversion の変更リスト機能をサポートしています。この機能については、 「変更リスト」 をご覧ください。

時には、ファイルに対して行った変更の一部だけをコミットしたくなることがあるでしょう。例えば、何かを作業をしている途中で緊急の修正をコミットする必要に迫られ、しかも作業中のファイルに変更を加えなければならなくなった場合などです。

ファイルを右クリックし、コンテキストメニュー → コミット後に復元を実行してください。これでファイルの現状のコピーが作成されます。それからファイルをテキストエディターなどを使用して編集し、コミットしたくない変更点をすべて元に戻してください。変更を保存した後で、ファイルをコミットします。

コミットが完了すると、ファイルのコピーが自動的に復元され、コミットされていなかった変更点が元に戻ります。

バージョン管理下のファイルが頻繁に変更されても、コミットしたくないことがあります。これはビルドプロセスの弱点を表しています。なぜそのファイルをバージョン管理下に置いたのでしょう？テンプレートファイルを使用するべきではありませんか？しかし、時にこれはやむを得ないことがあります。古典的な理由としては、使用しているIDEが、ビルドする際に必ずタイムスタンプを更新してしまうということがあります。すべてのビルド設定を含んでいるため、プロジェクトファイルをバージョン管理下に置かなければなりませんが、単にタイムスタンプが更新されただけではコミットする必要はありません。

このような厄介なことを解決するのに、 ignore-on-commit という変更リストを用意されています。この変更リストに追加されたファイルは、コミットダイアログで自動的にチェックが外されます。チェックを入れれば、変更をコミットすることができます。

コミットする変更を説明するログメッセージを必ず入力してください。後日プロジェクトのログメッセージを閲覧するときに、いつ、何が起きたかを確認できます。メッセージは長くても簡潔でもお好みでよいのですが、多くのプロジェクトで、使用する言語や、厳密なフォーマットといった記述する内容のガイドラインがあります。

メールで使用するような規約を用いて、ログメッセージの簡単な整形を行うことができます。 text にスタイルを適用する場合、 *text* で太字、 _text_ で下線、^text^ で斜体になります。

図4.9 コミットダイアログのスペルチェッカー

TortoiseSVN にはログメッセージを正しく書けるよう、スペルチェッカーが内蔵されています。これで間違った単語を強調表示できます。訂正候補にアクセスするには、コンテキストメニューを使用してください。もちろん、 すべて の技術用語が登録されているわけではないので、正しい綴りの単語がエラーとして表示される可能性があります。こうした用語は、コンテキストメニューから個人辞書に登録できます。

ログメッセージウィンドウは、ファイル名や関数の自動補完機能も持っています。コミットしようとしている（テキスト）ファイルから、クラス名や関数名を（ファイル名と同様に）抽出するのに正規表現を使用します。3文字入力したり、 Ctrl+Space を押したりしたとき、このリストにある単語と一致すると、名前全体を選択するドロップダウンを表示します。 TortoiseSVN が標準で持っている正規表現は、 TortoiseSVN をインストールした bin フォルダーに格納されています。自分で正規表現を定義し、 %APPDATA%\TortoiseSVN\autolist.txt に格納しておくこともできます。もちろん自分の autolist は TortoiseSVN をアップデートしても上書きされません。正規表現になじみがないのであれば、 http://ja.wikipedia.org/wiki/正規表現 にある説明や、 http://www.regular-expressions.info/ にあるオンラインドキュメントやチュートリアルをご覧ください。

完全に正しい正規表現を書くのは難しいので、式の組み合わせを整理しやすくするために、式を入力し、ファイル名を入力すれば、それがマッチするかどうかをテストできるテストダイアログを用意しています。コマンドプロンプトから、 TortoiseProc.exe /command:autotexttest とコマンドを入力すれば起動します。

ログメッセージウィンドウにはコミットメッセージのスニペット機能もついています。ショートカットキーを押すとスニペットの一覧が表示され、一覧から入力するスニペットを選択するとテキストが挿入されます。TortoiseSVN により提供されるスニペットは TortoiseSVN をインストールしたフォルダのbinの中にあります。%APPDATA%\TortoiseSVN\snippet.txt を編集することで自作のスニペットを作成することもできます。# はコメントキャラクターです。\n や \r で改行を挿入できます。また、バックスラッシュを挿入するには \\ のようにエスケープします。

以前入力したログメッセージを再利用できます。最近のログメッセージをクリックして、その作業コピーで入力した最新のログメッセージ一覧を表示します。保存しているログメッセージの数は、 TortoiseSVN 設定ダイアログでカスタマイズできます。

TortoiseSVN の設定ダイアログの 保存データ ページで、保存されたコミットメッセージをすべて消去することができます。 最近のログメッセージ ダイアログで Delete キーを押すと、特定の保存されたログメッセージを消去することができます。

入力欄のコンテキストメニュー → ファイル名のリストを貼付を実行すると、チェックしたパスをログメッセージに入れることができます。

ファイルリストにあるファイルをログメッセージの入力欄にドラッグするだけでも、ログメッセージにパスを入力することができます。

OKを押すと、コミットの進行状況を表示するダイアログが表示されます。

図4.10 コミットの状況を表示している進行ダイアログ

進行ダイアログでは、コミット状態に応じて色分けで表示されます。

これはデフォルトの色設定ですが、設定ダイアログで色をカスタマイズできます。詳細は 「TortoiseSVN の色の設定」をご覧ください。

ファイルの競合は、複数の開発者があるファイルの同じ行を変更した際に発生します。 Subversion はプロジェクトの事情を何も知らないため、開発者間の競合については解決できません。テキストファイルの場合、競合している箇所は以下のようなマークがつけられます。

<<<<<<< filename
    your changes
=======
    code merged from repository
>>>>>>> revision

また、競合しているファイルについては、３つのファイルが Subversion によって追加されます。

TortoiseSVN → 競合の編集 で外部マージツールや競合エディターを起動するか、テキストエディターを使用して手作業で競合を解決するかしてください。コードがどうあるべきか決定し、必要な変更をしてから保存してください。TortoiseMergeやその他の有名なマージツールを使用した方が、３画面表示でこれらのファイルを確認でき、競合マーカーを気にする必要がないため、より簡単でしょう。テキストエディターを使用する場合は、 <<<<<<< という文字列で始まる行を検索してください。

その後、TortoiseSVN → 競合の解決コマンドを実行し、リポジトリに変更をコミットしてください。なお、競合の解決コマンドは、実際に競合を解決する訳ではありません。変更をコミットできるようにfilename.ext.mineやfilename.ext.r*ファイルを削除するだけです。

バイナリファイルが競合した場合、 Subversion はそのファイルをマージしようとしません。ローカルファイルには変更が加えられず（自分が変更したままで）、filename.ext.r*ファイルを作られます。自分の変更を取り消し、リポジトリのバージョンにしたい場合は、「変更の取り消し」コマンドを使ってください。リポジトリのバージョンを自分の変更したファイルで置き換えるのなら、「競合の解決」コマンドを実行してからコミットしてください。

親フォルダーを右クリックし、

複数の開発者が同じプロパティを変更した場合、プロパティの競合が発生します。ファイルの内容と同様に、競合は開発者のみが解決できます。

一方の変更を取り消してもう一方で上書きする場合は、ローカルのプロパティを用いて解決するかリモートのプロパティを用いて解決するを選択してください。変更をマージする必要がある場合は、手作業でプロパティを編集を選択し、どのプロパティをどうするか決めてから、解決してください。

開発者がファイルやフォルダーを移動・名前変更・削除したときに、別の開発者が移動・名前変更・削除を行っていたり、変更をしていたりすると、ツリーの競合が発生します。ツリーの競合はさまざまな状況で起こり得ますし、その競合を解決するにはそれぞれ異なった手順が必要です。

また、ファイルが Subversion によりローカルで削除されると、ローカルファイルシステムからも削除されるため、ツリーの競合があったとしても競合のオーバーレイを表示できず、競合を解決しようにも右クリックもできません。 競合の編集 オプションを用いる代わりに、 変更をチェック ダイアログを使用してください。

TortoiseSVN は変更をマージするための正しい場所を見つけるのを支援することができますが、競合を整理するにはさらに作業が必要かもしれません。作業ベースを更新すると、常に更新時のリポジトリにある各項目のリビジョンが含まれます。更新後に変更を取り消した場合、そのリポジトリの状態へと戻り、変更開始時の状態には戻りません。

図4.12 エクスプローラーのアイコンオーバーレイ表示

Subversion のリポジトリから作業コピーにチェックアウトすると、 Windows エクスプローラー上でファイルのアイコンが変化しているのが分かります。これこそ TortoiseSVN を有名にした理由のひとつです。 TortoiseSVN はオーバーレイアイコンと呼ばれるアイコンを、元のファイルアイコンの上に重ねて表示します。ファイルの Subversion における状態によってオーバーレイアイコンが変わります。

作業コピーにチェックアウトしたばかりのファイルには緑のチェックマークをオーバーレイします。Subversion の状態は 通常 です。

ファイルの編集をはじめるとすぐに状態が 変更 に変わり、アイコンオーバレイも赤いエクスクラメーションマークに変わります。これで最後に作業コピーを更新してからどのファイルに変更を加え、コミットする必要があるかどうか分かります。

更新中に 競合 が発生したら、黄色いエクスクラメーションマークのアイコンに変わります。

ファイルに svn:needs-lock プロパティを設定していると、 Subversion はそのファイルにロックをかけるまで読み取り専用にします。そのようなファイルには、編集前にロックするまで、このオーバーレイが表示されます。

ファイルをロックしており、かつ Subversion の状態が 通常 であれば、もう他人にファイルの変更を許可しても良いのにロックを解除し忘れないように、このアイコンが表示されます。

バージョン管理から 削除 されるカレントフォルダー内のファイルやフォルダー、またバージョン管理が紛失したフォルダー内にあるファイルにこのアイコンがつけられます。

バージョン管理に 追加 されるファイルやフォルダーには+印がつきます。

横棒印は、ファイルやフォルダーが、バージョン管理的に 無視 されていることを示します。このオーバーレイはオプションです。

バージョン管理下にないファイルやフォルダーで、無視されていない場合には、このアイコンが表示されます。このオーバーレイはオプションです。

実際のところ、上記のアイコンのすべてがシステムで使用されている訳ではないことが分かると思います。 Windows で使用できるオーバーレイの数はかなり制限されていますし、また TortoiseCVS の古いバージョンを一緒に使用していると、使用できるオーバーレイスロットが不足します。TortoiseSVN は 「Good Citizen ™」 （良い市民）になれるように、他のアプリケーションにも使用する機会を与えるように、オーバーレイの使用を制限しています。

Tortoise クライアントが今より増えた場合（TortoiseCVS、TortoiseHg、...）、アイコンの限界は現実的な問題になります。この問題を回避するために、 TortoiseSVN プロジェクトではすべての Tortoise クライアントで共通に使用できる、 DLL で読み込むアイコンセットを導入しました。すでに統合されているかどうかを確認するには、クライアントの供給元に確認してください。 :-)

Subversion の状態に対応するアイコンオーバーレイの付き方や、その他の技術詳細は、 「アイコンオーバーレイ」 をご覧ください。

図4.13 エクスプローラーのプロパティページの Subversion タブ

オーバーレイアイコンより詳しい、ファイルやディレクトリに関する詳細情報を確認したい場合、エクスプローラーのプロパティダイアログから、 Subversion が提供するすべての情報を確認することができます。ファイルやディレクトリを選択し、コンテキストメニューの Windows メニュー → プロパティ を選択するだけです（TortoiseSVN のサブメニュー内のものではなく、エクスプローラーのプロパティであることに注意してください）。 Subversion の管理下のファイルやフォルダーでプロパティを表示すると、 TortoiseSVN 独自のプロパティページが表示されます。ここで、選択したファイルやフォルダーに関するすべての情報を見ることができます。

図4.14 変更をチェック

自分でどのファイルを変更したか、また他の人がどのファイルを変更しコミットしたかを知ることは非常に有用です。これには TortoiseSVN → 変更をチェック... コマンドが役に立ちます。このダイアログは作業コピー内にある何らかの変更をしたファイルや、バージョン管理外のファイルをすべて表示します。

リポジトリをチェック をクリックすると、リポジトリで行われた変更を参照できます。競合が起こりそうな場合、更新前にこれで変更点を確認できます。リポジトリの全てのフォルダーを更新しないで、選択したファイルのみ更新することもできます。デフォルトでは、 リポジトリをチェック ボタンは、リモートの状態を作業コピーにチェックアウトした深さまで検索します。リポジトリ内のチェックアウトしていないファイルやフォルダーまで確認したい場合は、 Shift キーを押しながら リポジトリをチェック ボタンをクリックしてください。

このダイアログでは、状態が色分けして表示されます。

これはデフォルトの色設定ですが、設定ダイアログで色をカスタマイズできます。詳細は 「TortoiseSVN の色の設定」をご覧ください。

オーバーレイアイコンは他の状態を表示するためにも使われます。次のスクリーンショットは、必要な時に表示される可能性のあるすべてのオーバーレイを示しています。

オーバーレイは次の状態を示しています。

異なるリポジトリのパスに切り替えた項目には、(s)印が示されます。ブランチで何かの作業を行った後で、トランクに切り替え忘れることがあるかもしれません。これが警告のサインです。コンテキストメニューを使用すれば、通常のパスに切り替えることができます。

このダイアログのコンテキストメニューから、変更点の差分を表示することができます。 自分 が行ったローカルの変更をチェックするには、 コンテキストメニュー → 作業ベースと比較 を使用してください。他人が行ったリポジトリへの変更は、 コンテキストメニュー → Unified形式で差分を表示 を使用してください。

個々のファイルの変更を取り消すこともできます。誤ってファイルを消してしまった場合には、 紛失 と表示されますし、 変更の取り消し を実行すればファイルを回復することができます。

バージョン管理外のファイルや無視されたファイルは、 コンテキストメニュー → 削除 でごみ箱に送ることができます。完全に（ごみ箱を経由させずに）ファイルを削除するには、 Shift キーを押したまま 削除 をクリックしてください。

ファイルの中を確認したければ、テキストエディターや IDE のような別のアプリケーションにファイルをドラッグするか、エクスプローラーのフォルダーにドラッグするかすれば、コピーを保存することができます。

リストの列はカスタマイズできます。列見出しの上で右クリックすると、表示する列を選択するコンテキストメニューが表示されます。また、列の境界上にマウスを持っていくとドラッグハンドルが表示され、列幅を変更できます。カスタマイズ結果は保存されるので、次回以降も同じ列見出しになります。

関連のない複数の仕事を一度に行った場合、変更リストにファイルをグループ化することもできます。詳しくは 「変更リスト」 をご覧ください。

ダイアログの下部に、作業コピーで使われている、リポジトリリビジョンの範囲の概要を表示しています。これは 更新 リビジョンではなく コミット リビジョンであり、ファイルが更新されたリビジョンではなく、ファイルが最後にコミットされた時のリビジョン範囲を表しています。作業コピー全体ではなく、表示されている項目のみのリビジョン範囲であることに注意してください。作業コピー全体に対してこの情報を表示する場合は、 表示する項目 の 未変更 チェックボックスにチェックを入れてください。

ファイルの中でどのような変更をしたのか確認する場合は、変更のあるファイルを選択して、TortoiseSVN のコンテキストメニューから 差分を表示 を選択してください。外部差分ビューアーが起動し、現在のファイルとチェックアウト・更新を行った直後のコピー（作業ベース、 BASE リビジョン）とを比較できます。

図4.18 リビジョンログダイアログ

ログダイアログは、様々な場所から表示することができます。

リポジトリが使用できない場合、 オフラインにしますか？ というダイアログが表示されます。詳しくは、 「オフラインモード」で説明します。

上のリストの アクション 列には、そのリビジョンで何が行われたのかを示すアイコンが表示されます。4種類のアイコンが、それぞれ1列ずつ表示されます。

そのリビジョンでファイルやディレクトリが変更された場合、変更 アイコンが1列目に表示されます。

そのリビジョンでファイルやディレクトリが追加された場合、追加 アイコンが2列目に表示されます。

そのリビジョンでファイルやフォルダーが削除された場合、削除 アイコンが3列目に表示されます。

そのリビジョンでファイルやフォルダーが置換された場合、置換 アイコンが4列目に表示されます。

そのリビジョンでファイルやディレクトリが移動されたり名前が変更されたりした場合、移動 アイコンが4列目に表示されます。

そのリビジョンでファイルやフォルダーが移動または名前変更によって置換された場合、移動置換 アイコンが4列目に表示されます。

そのリビジョンでファイルやフォルダーがマージされた場合、マージ アイコンが4列目に表示されます。

そのリビジョンでファイルやフォルダーが逆マージされた場合、逆マージ アイコンが4列目に表示されます。

図4.19 リビジョンログダイアログの上部のリストのコンテキストメニュー

ログダイアログの上部のリストには、より詳細な情報にアクセスできるコンテキストメニューがあります。このメニューにはファイルのログでしか現れないものや、フォルダーのログでしか現れないものがあります。

図4.20 Code Collaborator 設定ダイアログ

図4.21 ２つのリビジョンを選択した時の上部のリストのコンテキストメニュー

同時に２つのリビジョンを（Ctrl を押しながら）選択すると、コンテキストメニューの内容が以下の機能に変わります。

２つ以上のリビジョンを選択（通常 Ctrl や Shift を押しながら選択）すると、コンテキストメニューには「これらのリビジョンにおける変更を取り消す」項目が現れます。これがリビジョンのグループを変更を一度に取り消す、最も簡単な方法です。

また、前述のとおり、選択したリビジョンを別の作業コピーにマージできます。

選択したすべてのリビジョンが、同じ作者のものであれば、すべてのリビジョンの作者を一気に編集できます。

図4.22 ログダイアログ下部の一覧でコンテキストメニューを表示したところ

ログダイアログの下の欄にも、

のためのコンテキストメニューがあります。ログダイアログの下の欄で複数のファイルが選択されていた場合、コンテキストメニューは次のように変化します。

図4.23 ログダイアログ下部の一覧で複数ファイル選択時にコンテキストメニューを表示したところ

ログダイアログは以下のような場合、変更履歴を最後まで表示しないことがあります。

ログメッセージをもっと見たい場合は、次の100件 をクリックして次の100件のログメッセージを取得してください。必要なだけ繰り返せます。

このボタンの隣に多機能ボタンがあります。前回使用したオプションが記憶されていますが、三角形をクリックすると、他のオプションを指定できます。

表示する範囲を指定... を使用すると、表示するリビジョンの範囲を指定することができます。ダイアログが表示されるので、開始リビジョンと終了リビジョンを指定してください。

すべて表示 を使用すると、 HEAD からリビジョン 1 までさかのぼって すべての ログメッセージを表示することができます。

ログダイアログを開いている間に他のコミットが実行された場合など、最新のリビジョンに更新したい場合は、 F5 キーを押してください。

ログキャッシュを読み込みなおすには、 Ctrl+F5 キーを押してください。

ログダイアログは、現在の作業コピーのリビジョンではなく、 HEAD リビジョンからログを表示するため、まだ作業コピーに取得されていない部分のログメッセージが表示されることがよくあります。これを明確にするために、作業コピーのリビジョンに一致するコミットメッセージは太字で表示されます。

フォルダーのログが表示される際、太字で表示されるリビジョンは、フォルダー内のファイルの最新のリビジョンになります。これには作業コピーのクロールが必要です。クロールは別スレッドで実行するため、ログ表示に遅延は起こりませんが、フォルダーによってはすぐに太字で表示されないことがあります。

Subversion 1.5 以降では、プロパティでマージ情報を保持しています。これにより、マージでの変更点の詳細な履歴を得られます。例えば、ブランチで新機能を開発し、それをトランクにマージした場合、たとえブランチでの開発で1000回コミットしたとしても、トランクではマージした1回分のログしか存在しなくなります。

図4.24 マージ追跡リビジョンを表示したログダイアログ

マージを含んだコミットのリビジョンの詳細を見る場合、 マージされたリビジョンを含める チェックボックスを使用してください。これによりログメッセージを再取得しますが、マージされたリビジョンに由来するのログメッセージが挿入されます。マージされたリビジョンは、別ツリーで変更されているので、灰色で表示されます。

もちろん、マージは決して単純ではありません。ブランチでの機能開発中、メインラインコードと同期を取り続けるために、トランクからたびたび行わなければならないでしょう。そのため、ブランチのマージ履歴には、別レイヤのマージ履歴が含まれていることでしょう。ログダイアログでは、異なるレイヤをインデントレベルで表します。

リビジョンプロパティは、項目の Subversion プロパティとは異なるものです。リビジョンプロパティは、ログメッセージやコミット日時、コミットした人（作者）といった、リポジトリの特定のリビジョン番号に関連する説明的な項目です。

時には、一度入力したログメッセージを変更したいこともあるでしょう。綴り間違いがあったり、またメッセージを改善したり、その他の理由で変更したくなるかもしれません。また、コミットした作者を変更したくなるかもしれません。認証を設定し忘れてしまったとか……

Subversion では、必要に応じてリビジョンプロパティをいつでも変更できます。しかし、その変更を元に戻せない（この変更はバージョン管理外になります）ので、デフォルトではこの機能は無効になっています。有効にするには、 pre-revprop-change フックを設定する必要があります。この手順の詳細については、 Subversion Book の Hook Scripts をご覧ください。 Windows マシンでのフックの実装については、 「サーバー側フックスクリプト」 をご覧ください。

いったん必要なフックをサーバーに設定してしまえば、任意のリビジョンに対して、作者やログメッセージ（またはその他のリビジョンプロパティ）を変更できます。ログダイアログの上部のリストのコンテキストメニューを使用してください。中央の欄のコンテキストメニューを使用して、ログメッセージを編集することもできます。

興味あるログメッセージを限定して表示させたい場合は、何百もあるリストをスクロールするよりも、ログダイアログの上端にある絞り込みコントロールを使用したほうが便利です。日付の範囲を指定すると、その範囲のメッセージだけに絞り込むことができます。検索ボックスに文字列を入力すると、その文字列が含まれるメッセージだけに絞って表示できます。

検索アイコンクリックすると、検索対象となる情報の種類や、 正規表現 を使用するかどうかを選択できます。普段は単純な文字列検索で充分でしょうが、より複雑な検索条件を指定したい場合は、正規表現を使用することができます。検索ボックスの上にマウスを置くと、正規表現の記号や特殊文字の使い方がツールチップで表示されます。絞り込み文字列がログ項目と一致するかどうかがチェックされ、絞り込み文字列と 一致 した項目のみが表示されます。

単純な文字列での検索の仕方は、検索エンジンと似ています。複数の文字列を空白で区切って入力すると、すべての文字列を含む項目が検索されます。文字列の前に - を付けると、その文字列が含まれないものが検索されます（語句の否定検索）。そして、最初に ! を付けると、検索文字列全体が否定になります。前に + を付けた文字列は、以前に - を付けて除外した文字列であっても、含まれるものが検索されます。なお、含まれる・除外される指示の順番が重要であることに気を付けてください。空白を含む文字列を検索する場合は、文字列を引用符で囲んでください。引用符の文字を含む文字列を検索する場合は、引用符を2つ並べてエスケープしてください。なお、バックスラッシュ文字はエスケープ文字 ではなく 、単純な文字列検索では特別な意味を持たないことに注意してください。次のサンプルを見たほうが簡単でしょう。

Alice Bob -Eve

は、 Alice と Bob を含み、 Eve を含ま内文字列を検索します。

Alice -Bob +Eve

は、 Alice を含んでかつ Bob を含まないか、 Eve を含む文字列を検索します。

-Case +SpecialCase

は、 Case という文字列を含まないが、 SpecialCase という文字列は含む文字列を検索します。

!Alice Bob

は、 Alice も　Bob も含まない文字列を検索します。

!-Alice -Bob

は、ド・モルガンの法則を思い出してください。 NOT(NOT Alice AND NOT Bob) なので、 (Alice OR Bob) となります。

"Alice and Bob"

は、 「Alice and Bob」 という文字列を検索します。

""

は、テキストのどこかに二重引用符が含まれている文字列を検索します。

"Alice says ""hi"" to Bob"

は、 「Alice says "hi" to Bob」　という文字列を検索します。

正規表現についての説明はこのマニュアルの範囲外です。 http://ja.wikipedia.org/wiki/正規表現 にある説明や、 http://www.regular-expressions.info/ にあるオンラインのドキュメントやチュートリアルをご覧ください。

絞り込みは、すでに取得したメッセージのみが対象になることに注意してください。リポジトリからメッセージをダウンロードすることはありません。

また、 影響を受けるパスのみ表示 を使用すると、下の欄のパス名を絞り込みすることもできます。影響を受けるパスとは、ログを表示するために使われたパスを含むパスです。フォルダーのログを取得する場合は、そのフォルダー以下すべてが対象になります。ファイルの場合は、そのファイルのみが対象になります。通常、パスのリストには影響を受けるパス以外にも、同時にコミットされたパスが灰色で表示されます。ボックスをチェックすると、それらのパスは非表示になります。

運用上、ログメッセージを特定の書式に統一したい場合があります。変更点の説明文が、上部のリストに表示される冒頭の部分に表示されない場合などです。 tsvn:logsummary プロパティを使用すると、上部のリストに表示されているログメッセージの一部を抽出できます。このプロパティの使い方は、 「TortoiseSVN のプロジェクトプロパティ」 をご覧ください。

ログダイアログの 統計 ボタンは、リビジョンについての興味深い情報を表示します。作業者が何人いるのか、コミットは何回行われているのか、週ごとの進行状況、等といった情報です。これで、誰ががんばり屋で誰がなまけ者か一目で分かります。;-)

「作者別コミット数」ページ

図4.25 「作者別コミット数」ヒストグラム

このグラフは、プロジェクト内のどのユーザーがアクティブかを、ヒストグラム、積み重ね棒グラフ、円グラフで表します。

図4.26 「作者別コミット数」円グラフ

少数の主要な作者と、多数の細かい協力者がいる環境では、細分化されてグラフが読みにくくなります。グラフの下にあるスライダーを使用して閾値（全コミットにおけるパーセンテージ）を設定すると、活動状況が閾値以下の人が その他 カテゴリにグループ化されます。

「時期別コミット数」ページ

図4.27 「時期別コミット数」グラフ

このページでは、プロジェクトの活動状況を、一定期間のコミット回数 および 作者別で表示します。これによりプロジェクトがいつ活動していたか、そのとき誰が作業したかといった判断材料になるでしょう。

多数の作者がいる場合、グラフにたくさんの線が表示されます。この画面ではさらに２つの表示方法が使用できます。 折れ線グラフ は、作者の活動状況ごとに表示し、 積み重ね面グラフ は、作者の活動状況を積み重ねて表示します。後者では線が交差しなくなるためため、グラフは読みやすくなりますが、個別の作者の状況は読みにくくなります。

デフォルトでは、分析する際、ユーザー名の大文字と小文字が区別されます。そのため、 PeterEgan と PeteRegan というユーザーは別人として扱われます。しかし多くの場合、ユーザー名の大文字と小文字を区別しておらず、時には混同して入力されます。つまり、 DavidMorgan と davidmorgan を同一として扱うということです。 作者名の大文字/小文字を区別しない チェックボックスを使用して、どのように扱うかを決めてください。

この統計はログダイアログと同じ期間が対象になることに注意してください。1リビジョンしか表示していないときには、統計には大した情報は現れません。

図4.28 オフライン移行ダイアログ

ログキャッシュを有効にしている場合、サーバーに接続できなくても、ログダイアログやリビジョングラフはオフラインモードで使用できます。これはキャッシュからのデータを使用し、作業を継続できますが、おそらく最新でも完全でもありません。

ここでは以下の3つの選択肢があります。

デフォルトに設定する チェックボックスは、このダイアログを再度表示しないようにし、選択を常に使用します。ここで設定したとしても、 TortoiseSVN → 設定 で、デフォルト値の変更（削除）が行えます。

新しいログメッセージを取得するためにサーバーを再チェックする場合、単純に F5 で表示を更新できます。ログキャッシュを使用している場合（デフォルトで有効）、新しいログメッセージがあるかリポジトリをチェックし、新しいもののみを取得します。ログキャッシュがオフラインモードになっている場合、オンラインモードに切り替えを試みます。

ログキャッシュを使用しており、メッセージの内容や作者を更新したい場合、Shift+F5 や Ctrl+F5 で表示しているメッセージをサーバーから再取得し、ログキャッシュを更新できます。これは現在表示されているメッセージにしか効果はなく、そのリポジトリのキャッシュ全体が無効になるわけではないことに注意してください。

サードパーティの差分ツールを設定している場合、差分コマンドを選択する際にShift を押すと代替ツールを使用できます。その他の差分ツールの設定については、 「外部プログラムの設定」 をご覧ください。

プロジェクトを続けていくと、時には改行コードを CRLF から LF に変更したり、セクションのインデントを変更したりすることがあります。不幸なことに、かなりの行を変更しなければならないにもかかわらず、コードの意味に変化はありません。以下のオプションでは、比較や差分を適用する際の変更点の把握方法を管理します。これらの設定は、 TortoiseMerge の設定のほか、 マージ や 注釈履歴 ダイアログから行うことができます。

改行コードを無視する は、改行コードのみの変更を無視します。

空白を比較する は、インデントや行内の空白の追加・削除を変更点に含めます。

空白の変更を無視する は、空白の数や種類（インデントや、タブとスペースの変更など）のみの変更を無視します。空白がないところに追加されたり、存在する空白が完全に削除されたりした場合は、変更として表示されます。

すべて空白を無視する は、空白のみの変更をすべて無視します。

当然、内容の変更のある行は、常に差分に含まれます。

図4.29 リビジョンの比較ダイアログ

リポジトリブラウザーで２つのツリーを選択したり、ログダイアログでフォルダーのの２つのリビジョンを選択したりすると、 コンテキストメニュー → リビジョンを比較 が実行できるようになります。

このダイアログでは、変更されたすべてのファイルが表示され、コンテキストメニューから個々に比較や注釈履歴の取得を行えます。

変更ツリー をエクスポートすることができます。これは、プロジェクトのツリー構造の中で、変更されたファイルのみを他人に渡したい場合に便利です。この操作は選択したファイルにのみ作用しますので、あらかじめエクスポートするファイル（通常はすべて）を選択してから、 コンテキストメニュー → 選択をエクスポート... を実行してください。そして、変更ツリーを保存する場所を指定してください。

また、 コンテキストメニュー → 選択ファイルのリストを保存... を使用すると、変更されたファイルの 一覧 をエクスポートすることができます。

ファイルの一覧 と 行われた操作（変更・追加・削除）をエクスポートする場合、 コンテキストメニュー → 選択範囲をクリップボードにコピー を使用してください。

最上部のボタンは、比較の方向を変更します。ＡからＢへの変更を表示しているとき、必要に応じて、ＢからＡへの変更も表示できます。

リビジョン番号が表示されているボタンで、リビジョン範囲を変更することができます。範囲を変更すると、２つのリビジョン間の差分が自動的に更新されます。

ファイル名の一覧が非常に長い場合、検索ボックスを使用して、特定のテキストを含むファイル名のみを抽出できます。単純文字列検索を行いますので、Ｃのソースファイルを指定したい場合は、 *.c ではなく .c と指定してください。

テキストファイルの差分を取るツールは、 TortoiseMerge を含めてたくさんありますが、私たちはよく画像ファイルに、どんな変更が加えられたかを知りたくなることもありました。そのために TortoiseIDiff を作成しました。

図4.30 画像差分ビューアー

一般的な画像ファイル形式のファイルを選択して TortoiseSVN → 差分を表示 を実行すると、画像の差分を表示するために TortoiseIDiff が起動します。デフォルトでは画像が横に並んで表示されますが、表示メニューやツールバーで上下に表示するように切り替えることができます。また、ライトボックスを使用した時のように、画像を重ねて表示することもできます。

画像をズームイン・アウトしたり、移動したりすることもできます。画像を左ドラッグすることで、移動することができます。 画像位置を同期 オプションを選択しておくと、スクロールバーやマウスホイールで画像を移動する時、両方の画像が同期して移動するようになります。

画像情報ボックスには、ピクセル単位のサイズや、解像度、色深度など、画像ファイルの詳細を表示されます。このボックスが邪魔になるなら、 表示 → 画像情報 で隠すことができます。これと同じ情報は、画像のタイトルバーの上にマウスを移動すると表示されます。

画像を重ねて表示している場合、画面左端のスライダーを使用して、画像の相対的な輝度（アルファブレンド）を制御できます。スライダー上をクリックすると、透明度を直接設定できますし、スライダをドラッグすると、確認しながら透明度を変更できます。 Ctrl+Shift+ホイール でも透明度を変更できます。

スライダの上にあるボタンを押すと、透明度を 0% と 100% で切り替えられます。また、ボタンをダブルクリックすると、もう一度ボタンをクリックするまで、１秒ごとに透明度を自動で交互に切り替わります。複数の小さな変更を探すのに便利でしょう。

重ね合せでは分からない差分を確認したい場合もあります。プリント基板の画像イメージに２つのリビジョンがあり、どの配線が変更されたかを調べたい場合などです。アルファブレンドを無効にすると、各ピクセルの色が XOR されて差分が表示されます。変更のない部分は真っ白になり、変更点だけ色が表示されます。

テキストファイル以外の文書の差分を表示するには、ファイルフォーマットを理解できるソフトウェアを使用する必要があります。通常は、その文書を作成するために使用したソフトウェアを使用します。よく使用される Microsoft Office や OpenOffice.org には差分を表示するための機能があり、 TortoiseSVN には有名な拡張子のファイルの差分を表示する際に、これらのソフトウェアをしかるべき設定で呼び出すことができるスクリプトが添付されています。どのような拡張子がサポートされているかを確認したり、新しく追加したりするためには、 TortoiseSVN → 設定を実行し、 外部プログラム セクションの 高度な設定 をクリックしてください。

私たちが提供するツールで必要なことが実現できない場合は、オープンソース・商用のツールがたくさんあるので、その中から使用できるものを試してみてください。それぞれに特徴がありますし、この一覧は完全なものではありませんが、検討に値するものをいくつか以下に紹介します。

TortoiseSVN でこれらのツールを使用するよう設定する方法は 「外部プログラムの設定」 をご覧ください。

Subversion の無視パターンは、ワイルドカードとしてメタ文字を使用してファイルを特定する、 UNIX で使用されてきたファイル名展開を使用します。特別な意味を持つのは次の文字です。

パターン比較では大文字と小文字を区別しますが、これは Windows で問題の原因になるかもしれません。両方指定すれば、強制的に大文字小文字を区別しないようにできます。例えば、 *.tmp を大文字小文字にかかわらず無視するには、 *.[Tt][Mm][Pp] のようなパターンで指定してください。

展開方法の公式な定義が必要であれば、シェルコマンド言語の IEEE 仕様書 Pattern Matching Notation を参照してください。

Subversionからファイルやフォルダーを削除するには、 TortoiseSVN → 削除 を実行してください。

TortoiseSVN → 削除 を実行すると、ファイルやフォルダーは作業コピーからすぐに削除され、次のコミットでリポジトリから削除するようにマークされます。項目の親フォルダーには「削除」 オーバーレイアイコンを表示します。変更をコミットする前ならば、親フォルダーに対して TortoiseSVN → 変更の取り消し を実行すると、ファイルを取り戻すことができます。

項目をリポジトリから削除しても、バージョン管理外のファイルやフォルダーとして残しておきたい場合は、 拡張コンテキストメニュー → 削除（作業コピーは保持） を使用してください。エクスプローラーのリストウインドウ（右画面）で Shift キーを押したまま項目を右クリックすると、拡張コンテキストメニューが表示されます。

TortoiseSVN のコンテキストメニューを使用せずに、項目をエクスプローラーで削除した場合、コミットの際に、コミットダイアログにはそのファイルが紛失と表示され、バージョン管理からも削除するかどうか確認してきます。しかし、作業コピーに対して更新を実行すれば、 Subversion は紛失したファイルを特定し、リポジトリから最新のファイルを取得して置き換えます。バージョン管理下のファイルを削除する場合は、必ず TortoiseSVN → 削除 を使用するようにしてください。そうすると Subversion は項目を本当に削除するべきかどうか推測する必要がなくなります。

ファイルやフォルダーの名前をその場で変更するならば、 コンテキストメニュー → 名前を変更... を使用してください。新しい名前を入力すれば完了です。

作業コピー内でファイルを（例えば異なるサブフォルダーへ）移動する場合は、マウスの右ドラッグ＆ドロップ操作を使用して次のように操作してください。

ファイルの移動やコピーは、他にも Windows のコピー/切り取りコマンドを使って行うこともできます。コピーしたいファイルを選択し、右クリックしてエクスプローラーの コンテキストメニュー → コピー を実行します。それからコピー先のフォルダーを開いて右クリックし、 TortoiseSVN → 貼り付け を選択します。ファイルを移動する場合は、 コンテキストメニュー → コピー の代わりに コンテキストメニュー → 切り取り を使用します。

また、リポジトリブラウザーを用いて、項目を移動することもできます。詳細は 「リポジトリブラウザー」 をご覧ください。

リポジトリ内に、大文字か小文字かのみが異なる名前のファイル（例えば TEST.TXT と test.txt）がある場合、 Windows のクライアントでは、親ディレクトリの更新やチェックアウトができなくなります。 Subversion は文字の大小を区別していますが、Windows はそうではないからです。

これは２人が別々の作業コピーから、大文字か小文字かのみが異なる名前のファイルをコミットした場合に発生します。また Linux のような、大文字と小文字を区別するファイルシステムを使用するシステムからコミットした場合も、発生します。

この場合は、どちらかを一方のみを残し、もう一方をリポジトリから削除（または名前変更）しなりません。

時に、親切な IDE がリファクタリングの一環でファイルの名前変更を行います。そしてもちろん Subversion に通知しません。変更をコミットすると、 Subversion には古いファイル名が紛失ファイル、新しいファイル名がバージョン管理外のファイルとして見えることになります。新しいファイルを追加することもできますが、 Subversion にはそのファイルの関連が分からないので、履歴が追跡できなくなってしまいます。

改善策は、実際には名前変更であったと Subversion に通知することで、これは コミット ダイアログや 変更をチェック ダイアログから行うことができます。古い名前（紛失）と新しい名前（バージョン管理外）の両方を選択し、 コンテキストメニュー → 移動を修復 を使用すれば、２つのファイルを名前変更の関係にすることができます。

通常は、生成される全てのファイルが Subversion に無視されるように、無視リストを設定するでしょう。しかし、クリーンビルドを行うために、これらの無視される項目を削除したい場合はどうしますか？通常は、 makefile でこれを行うよう設定しますが、 makefile がデバッグ中だったり、他のビルドシステムに変更しているときには、これらを丸ごとクリアする手段があると便利です。

TortoiseSVN では、そのような場合に 拡張コンテキストメニュー → バージョン管理外の項目を削除... という機能を提供しています。エクスプローラーのリストウインドウ（右画面）で Shift キーを押したままフォルダーを右クリックすると、拡張コンテキストメニューが表示されます。これにより、作業コピーにあるバージョン管理外のファイルの一覧ダイアログが現れます。削除する項目を選択または選択解除してください。

ここで項目が削除される際、ごみ箱が使用されますので、ここで誤ってバージョン管理下に置くはずのファイルを削除してしまっても元に戻せます。

図4.37 Subversion のプロパティページ

Subversion のプロパティは、 Windows のプロパティダイアログから確認したり設定したりできますが、他に TortoiseSVN → プロパティ や コンテキストメニュー → プロパティ の TortoiseSVN の状態リストでも確認できます。

自分でプロパティを定義できるほか、 Subversion で特別な意味をもつプロパティを追加することもできます。これは svn: で始まります。 svn:externals もその一種です。外部参照の扱い方は 「外部項目」 をご覧ください。

Subversion のプロパティに関する詳細情報は、Special Properties をご覧ください。

プロパティの追加と編集

図4.38 プロパティの追加

新しいプロパティを追加するには、まず 新規... をクリックしてください。メニューから必要なプロパティ名を選択し、プロパティダイアログに必要な情報を入力します。これらのプロパティダイアログの詳細は 「プロパティエディター」 をご覧ください。

独自のダイアログを持たないプロパティを追加するには、 新規... メニューの高度な設定を選択します。そして、既存のプロパティをコンボボックスから選択するか、カスタムプロパティの名前を入力するかします。

一度にたくさんの項目に対してプロパティを設定する場合は、エクスプローラーでファイルやフォルダーを複数選択し、コンテキストメニュー → プロパティ を選択してください。

現在のフォルダー以下にある すべての ファイルやフォルダーに対してプロパティを適用する場合、 プロパティを再帰的に適用する チェックボックスをチェックしてください。

既存のプロパティを編集する場合、プロパティの一覧から編集するプロパティを選択し、 編集... をクリックしてください。

既存のプロパティを削除したい場合、プロパティの一覧から削除するプロパティを選択し、 削除 をクリックしてください。

svn:externals プロパティは、同じリポジトリからでも完全に異なるリポジトリからでも、他のプロジェクトを取得するのに使用できます。詳細は 「外部項目」 をご覧ください。

プロパティの編集は最新リビジョンに対して

プロパティはバージョン管理されているため、以前のリビジョンのプロパティを編集することはできません。ログダイアログや、リポジトリブラウザー上で最新以外のリビジョンを表示している場合は、プロパティと値の一覧は見られますが、編集はできません。

TortoiseSVN は自身が持つ特殊なプロパティをいくつか持っています。これは tsvn: で始まります。

TortoiseSVN はいくつかのバグ追跡ツールと統合できます。このとき bugtraq: で始まるプロジェクトプロパティを使用します。詳細情報は 「バグ追跡ツール／課題追跡システムとの統合」 をご覧ください。

TortoiseSVN は、webviewer: で始まるプロジェクトプロパティを使用して、いくつかの Web ベースのリポジトリブラウザーとも統合できます。詳細は 「Web ベースのリポジトリビューアーとの統合」 をご覧ください。

TortoiseSVN で新しいサブフォルダーを作業コピーに追加する際、親フォルダーに設定されているプロジェクトプロパティは、新しいサブフォルダーにも自動的に追加されます。

一部のプロパティは、自動処理に使用されるため、特定の値や特定の書式にする必要があります。正しい書式を設定やすくするため、 TortoiseSVN では幾つかの特定のプロパティについて、設定可能な値を表示したり、独立コンポーネントに分配したりするための編集ダイアログを提供しています。

外部参照項目

図4.44 svn:externals プロパティページ

svn:externals プロパティは、同じリポジトリもしくは完全に異なるリポジトリから、他のプロジェクトを取得するのに使用できます。詳細は 「外部項目」 をご覧ください。

チェックアウトした外部フォルダーや、外部項目の Subversion の URL のサブフォルダーの名前を設定する必要があります。外部フォルダーの最新リビジョンをチェックアウトしておけば、外部項目がリポジトリの中で変更されたときに、作業コピーを更新させることができます。しかし、特定の安定した時点のものを外部で参照できるようにするには、使用する特定のリビジョンを指定することもできます。また、この場合、ペグリビジョンと同じリビジョンを指定したいかもしれません。外部項目が将来何らかの時点で改名されると、Subversionは作業コピーでこの項目を更新できなくなります。ペグリビジョンを指定することで、最新版ではなくペグリビジョンの時の名前をSubversionに検索させることができます。

最新リビジョンを探すを押すと、外部項目の各URLを確認し、右端の列に最新リビジョン表示されます。最新リビジョンが分かったら、外部項目の上で右クリックすると、選択された外部項目を該当する最新リビジョンにペグ付けできます。最新リビジョンが不明な場合、右クリックのコマンドを実行すると、まず最新リビジョンが取得されます。

SVN キーワード

図4.45 svn:keywords プロパティページ

ファイル内に展開したいキーワードを選択してください。

改行コード

図4.46 svn:eol-style プロパティページ

使用したい行末のスタイルを選択します。それで、 TortoiseSVN は適切なプロパティ値を使用することができます。

課題追跡システムとの統合

図4.47 tsvn:bugtraq プロパティページ

ログメッセージの大きさ

図4.48 ログメッセージサイズのプロパティページ

これら3つのプロパティは、ログメッセージの書式を制御します。最初の２つを設定すると、コミットダイアログやロックダイアログで、メッセージが最小文字列の長さに達するまでOKボタンが無効になります。境界の位置は、それらのログメッセージの幅制限が設定されているプロジェクトのためのガイドとして指定されたカラム幅でマーカーを示しています。値をゼロに設定すると、プロパティが削除されます。

プロジェクトの言語

図4.49 言語プロパティページ

コミットダイアログのログメッセージのスペルチェックに使用する言語を選択してください。右のログメッセージのペインでクリックして選択すると、ファイルリストのチェックボックスが有効になりますので、 ファイル名のリストを貼付 を選択してください。デフォルトでは Subversion の状態が、既定の言語で表示されます。このボックスがチェックされるとステータスが常に英語のみになります。英語のログメッセージを必要とするプロジェクトで有効です。

MIMEタイプ

図4.50 svn:mime-type プロパティページ

svn:needs-lock

図4.51 svn:needs-lock プロパティページ

このプロパティは、作業コピーがロックされていない場合、ファイルを読み取り専用の状態でチェックアウトするかどうかを制御します。

svn:executable

図4.52 svn:executable プロパティページ

このプロパティは、Unix / Linux システム上で、チェックアウト時にファイルに実行属性を付与するかどうかを指定します。これは、 Windows でチェックアウトする場合には影響しません。

マージログメッセージのテンプレート

リビジョンが作業コピーにマージされるたびに、TortoiseSVNはマージされた全リビジョンからログメッセージを作成します。コミットダイアログの最近のログメッセージボタンを押すと現れます。

以下のプロパティを指定すると、作成されるメッセージをカスタマイズできます。

図4.53 プロパティダイアログのマージログメッセージのテンプレート設定

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

このプロパティは生成されるログメッセージの最初の部分になります。次のキーワードを使用することができます。

{revisions}

マージされたリビジョン番号のカンマ区切りのリスト（例えば、3, 5, 6, 7）。

{revisionsr}

{revisions}と同様だが、各リビジョンの前にrが付く（例えば、r3, r5, r6, r7）。

{revrange}

マージされたリビジョン番号のカンマ区切りのリストだが、可能な場合は範囲をグループ化する（例えば、3, 5-7）。

{mergeurl}

マージのソースURL、すなわちリビジョンのマージ元の場所。

この文字列の既定値は「{mergeurl}からリビジョン{revrange}をマージ:」で、最後に改行が入ります。

tsvn:mergelogtemplatemsg

このプロパティはマージされた各リビジョンがどのように見えるかを定義します。次のキーワードを使用することができます。

{msg}

マージされたリビジョンのログメッセージ（入力されたまま）。

{msgoneline}

{msg}と同様だが、改行文字が空白に置き換えられ、ログメッセージ全体が1行で表現されたもの。

{author}

マージされたリビジョンの作者。

{rev}

マージされたリビジョン番号。

{bugids}

マージされたリビジョンのバグID（もしあれば）。

tsvn:mergelogtemplatemsgtitlebottom

この文字列はtsvn:mergelogtemplatetitleまたはtsvn:mergelogtemplatereversetitleで指定されたタイトル文字列の位置を指定します。このプロパティをyesまたはtrueに設定すると、タイトル文字列は冒頭ではなく末尾に追加されます。

重要

これはマージされたリビジョンがすでにログキャッシュにある場合のみ動作します。もしログキャッシュを無効にしていたり、マージ前にログを表示していなかったりすると、メッセージにはマージされたリビジョンの情報が入りません。

さて、ここで/project1の作業コピーをD:\dev\project1にチェックアウトとするとしましょう。D:\dev\project1フォルダーを選択して右クリックし、コンテキストメニューからWindows メニューの → プロパティを選択します。プロパティダイアログが表示されます。次に Subversion タブに移動すると、プロパティを設定することができます。プロパティ... をクリックして表示されるダイアログで、svn:externalsが既に存在すればそれをダブルクリックし、そうでなければ新規... ボタンを押し、メニューからsvn:externalsを選択します。新たな外部項目を追加するには、新規... ボタンをクリックしてから、表示されるダイアログで必要な情報を入力します。

ローカルのパスに空白や特殊文字を使用したい場合、二重引用符で囲ったり、Unix シェル形式のエスケープ文字 \ (バックスラッシュ) を特殊文字の前に置いてください。もちろんこれは、パス区切り文字に /（スラッシュ）を使わなければならない、ということでもあります。この挙動は Subversion 1.6 の新機能で、それ以前のクライアントでは動作しないことに注意してください。

外部プロジェクトが同じリポジトリにある場合、メインプロジェクトの変更をコミットすると、変更がコミットリストに含まれます。

もし異なるリポジトリに存在する外部プロジェクトに変更を加えた場合、メインプロジェクトをコミットする際に外部プロジェクトに加えた変更も併せて表示されます。しかし、これらの外部プロジェクトへの変更は別々にコミットしなければなりません。

svn:externals の定義に絶対 URL を使用し、作業コピーを再配置しなければならない（つまり、リポジトリの URL を変更する）場合、外部参照は変化せず、もう動作しないかも知れません。

このような問題を避けるため、Subversion クライアントバージョン 1.5 以降では、相対外部参照 URL をサポートします。相対 URL を指定する４つの異なる方法をサポートしています。以下の例では、２つのリポジトリ（http://example.com/svn/repos-1 と http://example.com/svn/repos-2）があると仮定します。C:\Working に http://example.com/svn/repos-1/project/trunk のチェックアウトがあり、トランクに svn:externals プロパティをセットしています。

必要に応じて、URLに対してペグリビジョンや操作対象リビジョンを設定することができます。ペグリビジョンや操作対象リビジョンについて詳しいことは、 Subversion book の corresponding chapter をご覧ください。

TortoiseSVN がプロパティをどのように扱うかについての詳細な情報は、 「プロジェクト設定」 を参照してください。

共通サブプロジェクトへの他のアクセス方法については、 「共通のサブプロジェクトを含める」 を参照してください。

Subversion 1.6 では、フォルダーと同じ文法を用いて、単一ファイルの外部項目を作業コピーに追加できます。しかし、いくつか制限事項があります。

外部ファイルの挙動は、あらゆる点でその他のバージョン管理下のファイルと同等ですが、通常のコマンドでは、移動・削除ができません。代わりに svn:externals プロパティを変更しなければなりません。

ファイルやフォルダーの作業コピーを作成済みで、他の作業コピーの外部参照として設定したい場合は、Windowsエクスプローラーからドラッグ＆ドロップするだけで追加することができます。

ファイルやフォルダーを、ある作業コピーから外部参照を設定したい場所に右ドラッグしてください。マウスボタンを離して現れるコンテキストメニューで、SVN ここに外部参照として追加というメニュー項目をクリックすると、svn:externals

プロジェクトを標準的なディレクトリ構成でインポートしているなら、ブランチ/タグバージョンを作成するのはとても簡単です。

図4.54 ブランチ/タグの作成ダイアログ

ブランチやタグにコピーしたい作業コピーのフォルダーを選択してから、 TortoiseSVN → ブランチ/タグの作成... コマンドを実行してください。

新しいブランチのコピー先 URL のデフォルトは、作業コピーの基準になったコピー元 URL になっています。ブランチ/タグの URL を新しいパスに変更してください。つまり、

    http://svn.collab.net/repos/ProjectName/trunk

の代わりに、

    http://svn.collab.net/repos/ProjectName/tags/Release_1.10

のようにするということです。前回使用した命名規則を思い出せなければ、右にあるボタンをクリックすれば、リポジトリブラウザーが開かれ、既存のリポジトリの構造を確認することができます。

そして、コピーの作成元を選択してください、ここでは3つの選択肢があります。

作業コピーを新しく作成したブランチに自動的に切り替えたい場合、作業コピーを新しいブランチ/タグへ切り替える チェックボックスをチェックしてください。しかしそうするには、まず作業コピーに変更が含まれていないことを確認してください。もし含まれていると、切り替えたときにブランチの作業コピーに変更点がマージされていまいます。

もし作業コピーが svn:externals プロパティで別のプロジェクトを含んでいると、外部項目がブランチ/タグダイアログの下部に一覧表示されます。各外部項目とそのターゲットパス、ソースURL、リビジョンが表示されます。

新しいタグを常に一貫した状態にするためには、すべての外部項目の持つリビジョンが固定されていることを確認する必要があります。外部項目を確認せず、また外部項目のリビジョンが将来変更される可能性のある HEAD を指定していた場合、新しいタグをチェックアウトする際に外部項目はその時点での HEAD リビジョンが取得されてしまい、コンパイルに失敗する可能性があります。そのため、タグを作成するときには、常に外部項目に明示的なリビジョン番号を設定することをお勧めします。

外部項目はブランチ/タグのソースに応じて自動的に現在の HEAD か作業コピーの BASE に固定されます。

リポジトリに新しいコピーをコミットするには OK を押してください。ログメッセージを書くのを忘れないでください。コピーは リポジトリの内部 で行われることに注意してください。

作業コピーを新しく作成したブランチに切り替えなければ、ブランチやタグを作成しても、作業コピーには影響を 与えない ことに注意してください。作業コピーからブランチを作成したとしても、その変更はトランクではなく新しいブランチにコミットされます。そのため、作業コピーのマークは、変更されたままになっているかもしれません。

作業コピーがなくてもブランチやタグを作成する方法があります。リポジトリブラウザーを開き、フォルダーを新しい場所にドラッグします。 Ctrl キーを押しながらドラッグするとコピーになり、そうでなければフォルダーはコピーされずに移動します。

マウスの右ボタンでフォルダーをドラッグする方法もあります。マウスのボタンを離すと、コンテキストメニューでフォルダーを移動するかコピーするかを選択することができます。もちろん、ブランチやタグを作成するときは、フォルダーを移動ではなくコピーしてください。

ログダイアログから行う方法もあります。例えばトランクの、特定のリビジョン（HEAD リビジョンでも古いリビジョンでも良い）のログダイアログを表示し、右クリックして リビジョンからブランチ/タグを作成 を選択します。

……それが（それほどではありませんが）問題です。チェックアウトは、リポジトリの指定したブランチから作業コピーへすべてダウンロードしますが、 TortoiseSVN → 切り替え... は変更のあったデータのみを作業コピーに転送します。ネットワーク負荷をとるか、忍耐力をとるかですね。:-)

新しく作成したブランチやタグで作業するには、いくつかの方法があります。次のように行ってください。

図4.55 切り替えダイアログ

Subversion 自身はタグとブランチを区別しませんが、通常は以下のように少し異なる使い方をします。

図4.56 マージウィザード - リビジョン範囲の選択

マージ元のURL 欄には、作業コピーに取り込みたい変更があるブランチやタグのフォルダーの URL をすべて入力してください。... をクリックしてリポジトリを閲覧し望みのブランチを探すこともできます。以前このブランチからマージしたことがあるのであれば、以前使用されたURLの履歴のドロップダウンリストから選択するだけです。

名前が変更されたり削除されたりしたブランチからマージしようとする場合は、そのブランチが存在したリビジョンに戻らなければなりません。このような場合、マージする範囲のリビジョン（下記）をペグリビジョンで指定しないと、HEADリビジョンのパスが見つけられずにマージが失敗します。

マージするリビジョンの範囲 フィールドに、マージするリビジョンのリストを入力してください。ここではリビジョン１つ、コンマで区切ったリビジョンの指定、ダッシュでつないだリビジョンの範囲と以上の組み合わせが使用できます。

マージ時にペグリビジョンを特定する必要がある場合、ペグリビジョンをリビジョン番号の最後に、 5-7,10@3 のように追加してください。この例では、リビジョン5、6、7、10とペグリビジョンの3がマージされます。

必要なリビジョンの範囲を選択する最も簡単な方法は、ログを表示 をクリックして、最近の変更点一覧をログメッセージと共に表示することです。単一リビジョンからマージしたい場合は、そのリビジョンを選択するだけです。複数のリビジョンからマージしたい場合は、その範囲を（通常 Shift キーを押しながら）選択してください。OK をクリックすると、マージするリビジョン番号のリストに入力されます。

すでにコミットしてしまった変更を取り消して、作業コピーを元に戻すようにマージする場合、戻したいリビジョンを選択して、逆マージチェックボックスを必ずチェックしてください。

このブランチからの変更をすでにマージしてある場合、うまくいけば変更をコミットしたときのメッセージに、マージした最後のリビジョンを記録してあるかもしれません。この場合、作業コピーのログメッセージを追跡するのに ログを表示 を使用できます。リビジョンをチェンジセットとして考えているのを思い出し、前回のマージの終点を今回のマージの始点をしてください。たとえば、前回リビジョン 37 から 39 までマージした場合、今回のマージの始点をリビジョン 40 にしてください。

Subversion のマージ追跡機能を使用する場合、どのリビジョンをすでにマージしたかを覚えておく必要はありません。Subversion が記録しています。リビジョン範囲をからのままにしておくと、まだマージしていないリビジョンすべてが対象になります。詳細は 「マージ追跡」 をご覧ください。

マージ追跡機能を使用する場合は、ログダイアログには前回マージされたリビジョンや、共通の祖先以前の時点（つまりブランチがコピーされる以前）のリビジョンが、グレーで表示されます。マージ不可能なリビジョンを隠すチェックボックスを使用すると、こうしたリビジョンを隠し、マージすることができるリビジョンだけを表示することができます。

他の人が変更をコミットしている場合、 HEAD リビジョンを指定する場合は注意してください。最後の更新のあとに誰かがコミットを行っており、想定しているリビジョンを指していないかもしれません。

リビジョンの範囲は空欄だったり、すべてのリビジョンのラジオボタンがチェックされていたりした場合は、 Subversion はまだマージされていないすべてのリビジョンをマージします。これは再統合または自動マージとして知られています。

再統合マージを適用するには、いくつか条件があります。まず、サーバーがマージ追跡をサポートしていなければなりません。作業コピーの深さに制限があってはなりません（部分的なチェックアウトであってはならない）。ローカルの変更や切り替えられた項目、 HEAD 以外のリビジョンに更新された項目があってはなりません。ブランチでの開発中にトランクに行われた変更は、ブランチをまたがってマージされます（もしくはマージ済みとマークされます）。マージ対象になるリビジョンの範囲は自動的に計算されます。

次へ >をクリックすると、 「マージオプション」 に進みます。

図4.57 マージウィザード - ツリーのマージ

機能ブランチをトランクにマージするために、この方法を使用する場合、トランクの作業コピーでマージウィザードを起動する必要があります。

開始点: 欄には、トランク のフォルダーの URL を入力してください。間違っているように思われるかもしれませんが、トランクが、ブランチの変更を追加する起点となることを思い出してください。... をクリックして、リポジトリを参照することもできます。

終了点: 欄に、機能ブランチのフォルダーの URL を入力してください。

開始点リビジョン 欄と 終了点リビジョン 欄の両方に、同期をとりたい２つのツリーの最新リビジョン番号を入力してください。他の誰もコミットしていないという確認が取れているのなら、どちらも HEAD リビジョンを指定できます。同期をとってから、誰かがコミットする機会があったのなら、最近のコミットの内容を失わないように、リビジョン番号を指定してください。

リビジョンを選択するには ログを表示 も使用できます。

ウィザードのこのページでは、マージの実行前に、さらにオプションの指定ができます。ほとんどの場合デフォルトの設定を使用するだけでしょう。

マージする深さを指定することもできます。これは、作業コピー内をどの程度深くたどってマージを行うかということです。深さについては 「チェックアウトの深さ」 で説明しています。デフォルトの深さは 作業コピー で、既存の深さをそのまま使用します。

大抵の場合、マージ時にはファイルの履歴を考慮した方が好ましいので、共通の祖先からの変更がマージされます。時には、リポジトリに入っていなくても、関連している可能性が高いファイル同士ををマージする必要もあるでしょう。例えば、第三者が作成したライブラリのバージョン1と2が、別々なディレクトリに入れられていた場合です。理屈からみれば両者は関連していますが、Subversionにはそれが別個にインポートされたファイルの集合としか認識できず、両者が関連しているとは分かりません。この2つのツリーの差分をマージしようとすると、全体を追加して全体を削除する操作になってしまいます。Subversionが履歴の差分を無視して現状の差分のみを使用するようにするには、 履歴を無視する をチェックしてください。本件についての詳細な説明は、 Subversion book の Noticing or Ignoring Ancestry を参照してください。

改行コードや空白の変更に対する扱い方を指定できます。このオプションについては 「改行コードと空白のオプション」 で説明しています。デフォルトの振る舞いは、空白や改行コードの差異も実際の変更としてマージします。

強制的にマージする をチェックすると、ローカルで変更されたファイルやバージョン管理されていないファイルに対して削除を行うようなツリーの競合を無視します。こうしたファイルが削除されると復元する方法がないので、このオプションはデフォルトではチェックされていません。

マージ追跡を使用していて、実際にはマージせずにマージしたという印をつけたい場合、 マージを実施せず、マージしたことにする チェックボックスをチェックしてください。そうする理由として２つ考えられます。１つは、マージそのものがマージアルゴリズムに対して複雑すぎ、手でコードを変更した後、マージアルゴリズムが行うようにマージにより変更したという印をつけたい場合です。もう１つは、特定のリビジョンがマージされるのを防ぐ場合です。すでにマージしたという印がついていれば、マージ追跡を関知するクライアントでは、マージを防げます。

すべての設定が終われば、あとは マージ ボタンを押すだけです。このとき マージのテスト を押すと、作業コピーを 変更せずに マージ結果をプレビューすることができます。これでマージを実行した時に変更が入るファイルの一覧や、競合が発生する 可能性のある ファイルを見ることができます。マージ処理はマージを追跡することではるかに複雑になるため、あらかじめマージが競合なしで完了するかを確実に判断する方法がないので、実際には問題なくマージできるようなファイルであっても、マージのテストでは競合すると表示される場合もあります。

マージ進行ダイアログには、マージの各状態を、リビジョン範囲とともに表示します。ここには想定していたよりも一つ多くリビジョンを表示するかもしれません。例えば、リビジョン 123 をマージするように指示した場合、進行ダイアログには、「リビジョン 122 〜 123 をマージ」 と表示されます。マージは差分と密接に関連していることを思い出してください。マージ処理は、リポジトリの二点間における差分の一覧を生成し、その差分を作業コピーに適用する形で動作します。進行ダイアログは、単純にこの差分の始点と終点を表示しているに過ぎません。

さて、マージが完了しました。マージ結果を見て期待通りになっているかを確認するのがいいでしょう。通常マージはかなり複雑です。ブランチがトランクからかなりずれてしまえば、しばしば競合を引き起こします。

バージョン 1.5 未満の Subversion のクライアント・サーバーは、マージ情報を格納しておらず、マージしたリビジョンは、手作業で追跡しなければなりません。ある変更点のテストを行い、そのリビジョンをコミットする際に、マージで取り込んだリビジョン番号を 常に コミットログに記録するべきです。あとで別のマージを適用しようとしたときに、再度変更を取り込むことがないよう、すでにマージした内容を知る必要があります。これについては Subversion Book の Best Practices for Merging をご覧ください。

サーバーとすべてのクライアントが Subversion 1.5 以上の場合、マージ追跡機構がマージしたリビジョンを記録し、再度マージすることがないようにします。これにより、単純にリビジョン範囲全体を指定し、実際に新しいリビジョンのみがマージされるといったことができるようになります。

ブランチ管理は重要です。このブランチをトランクに合わせて最新の状態を維持したければ、たびたびマージを確実に行わないと、ブランチとトランクがだんだん離れていってしまうのです。もちろん上で説明したように、変更点を再度マージしてしまうことは避けなければなりません。

Subversion 1.5 は、マージ追跡機構を導入しました。あるツリーから別のツリーへ変更をマージすると、マージしたリビジョン番号を格納し、この情報を様々な異なる用途に使用します。

マージを行う際、クライアントはマージ追跡情報を、svn:mergeinfo に格納します。マージをコミットする際には、サーバーはその情報をデータベースに格納し、マージやログ、注釈情報などのリクエストに適切に応答します。システムが適切に動作するには、サーバーとリポジトリ、全クライアントを確実にアップグレードしなければなりません。以前のクライアントでは、svn:mergeinfo プロパティを格納しませんし、以前のサーバーでは、新しいクライアントが要求した情報を提供できません。

マージ追跡についてそれ以外のことについては、 Subversion のMerge Tracking の説明をご覧ください。

マージが常にすんなり完了するとは限りません。時には競合を起こします。TortoiseSVN は、競合の解決 ダイアログを表示して、この処理の手助けをしてくれます。

図4.58 競合の解決ダイアログ

リポジトリにコミット済みの他の変更と、ローカルでの他の変更が競合した場合は、円滑にマージされている可能性が高いです。マージ可能なすべての変更がマージされます。競合の解決ダイアログは、競合を解決する異なる方法を提供します。

ファイルの内容やプロパティが変更されたことによって発生するふつうの競合については、競合箇所にどれを保持するか、不採用かを選択するためのボタンがダイアログに表示されます。

ツリーの競合がある場合は、まず様々な種類のツリーの競合について「ツリーの競合」を参照し、どのような解決策が取れるかを確認してください。

マージ後にツリーの競合を解決するために、さまざまな競合の解決方法を選択するダイアログが表示されます。

図4.59 ツリー競合の解決ダイアログ

ツリーの競合には様々な要因があるため、ダイアログでは競合に応じた解決方法のボタンが表示されます。ボタンの文字列とラベルで、その選択肢がどのように競合を解決するかが説明されます。自信がない場合は、後で競合を解決するために、ダイアログをキャンセルするか、後でボタンを押すかしてください。

別々のブランチで新しい機能を開発する際、機能が完成した時の再統合指針を立てると良いと思います。別の作業がトランク (trunk) で同時に進んでいる場合、時間がたつにつれて差異は深刻になり、マージを行うのは悪夢のようになります。

機能が比較的単純で、開発に時間がかからなそうであれば、機能が完成するまで全体を分けたブランチを維持し、ブランチの変更をトランクにマージするという、単純なアプローチを採用できます。マージウィザードでは、これを単純に リビジョンの範囲をマージ で、リビジョン範囲にブランチのリビジョン期間を指定して行います。

その機能に時間がかかり、トランクに対して変更を説明する必要がある場合、ブランチの同期を維持する必要があります。これは、トランクの変更点 プラス 新機能をブランチが持つように、単純にトランクへの変更を定期的にブランチへマージするということです。同期プロセスでは リビジョンの範囲をマージ を用います。機能が完成したら、ブランチを再統合する や 異なる２つのツリーをマージ のどちらかを用いて、trunk にマージできます。

トランクのすべての変更を機能ブランチに反映する他の（手早い）方法として、拡張コンテキストメニュー（Shiftキーを押したままファイルを右クリック）にあるTortoiseSVN → すべてマージ...を使用できます。

図4.60 すべてマージダイアログ

このダイアログは非常に簡単です。しなければならないことは、 「マージオプション」 にあるように、マージオプションを設定することだけです。TortoiseSVN は、マージ追跡を使用して残りを自動的に処理します。

デフォルトではロックを行わず、コミットアクセスできる人が、いつでもどのファイルでも変更をコミットすることができます。他の人は自分の作業コピーを定期的に更新し、ローカルに行った変更をリポジトリにマージするでしょう。

ファイルの ロックを取得 すると、自分しかそのファイルをコミットできなくなります。他のユーザーがコミットしようとしても、自分がロックを解除するまでできません。ロックしたファイルは、どんな方法でもリポジトリ内の変更ができません。そのため、ロック所有者を除いて削除も名前の変更もできなくなります。

しかし他のユーザーは、自分がロックしたことを知る必要はありません。定期的にロック状態をチェックしなければ、まず他のユーザーはコミットが失敗して気が付くでしょう。ほとんどこのケースでしょうがあまり便利ではありません。ロックの管理を簡単にするには、新しい Subversion のプロパティで svn:needs-lock があります。ファイルにこのプロパティが（値は何でも）セットされていると、ファイルをチェックアウトや更新すると常にローカルのコピーは読み取り専用になります。ファイルにロックを取得しない限りこのままです。この動作は、まずロックを取得するまでファイルの編集ができないということを警告しています。バージョン管理下で読み取り専用のファイルは、編集前にロックする必要があることを示すように、TortoiseSVN では特別なオーバーレイアイコンでマークされます。

ロックは所有者と共に作業コピーの場所に記録されます。自宅や職場など複数の作業コピーがある場合、ロックは作業コピーの中のひとつだけに記録されます。

仕事仲間の一人がロックを取得し、解除しないまま休暇を取ってしまったら、どうしたらいいでしょう? Subversion は強制的にロックする方法を用意しています。他の誰かが持っているロックを解除することを、ロックの 強制解除 と呼び、他の誰かが既にロックしているファイルを強制的にロックすることを、ロックの 横取り と呼びます。当然、仕事仲間と友人でいたいなら、軽々しく行うことではありません。

ロックはリポジトリに記録されます。また、ロックトークンはローカルの作業コピーに作成されます。他の誰かがロックを強制解除したりして、食い違いが発生すると、ローカルのロックは無効になります。リポジトリは常に決定的なリファレンスです。

ロックを取得したい作業コピーのファイルを選択し、TortoiseSVN → ロックの取得... コマンドを選択してください。

図4.61 ロックダイアログ

ダイアログが現れ、コメントを入力できるようになります。そのため他の人はなぜロックしたのかが判ります。コメントはオプションで、現在のところ Svnserve ベースリポジトリでしか使用できません。他の誰かからロックを横取りする場合（のみ）、ロックを奪う にチェックをつけてください。その後 OK をクリックしてください。

プロジェクトのプロパティの TSVN：logtemplatelock を設定すると、ロック時のメッセージを記入するユーザーにメッセージのひな形を提供することができます。プロパティを設定する方法は、 「プロジェクト設定」 を参照してください。

フォルダーを選択して、TortoiseSVN → ロックを取得... を使用すると、ロックするよう選択したすべてのサブフォルダー内の すべてのファイルがある状態でロックダイアログが開きます。本当に全階層をロックするのなら、これでできます。ですが、本当に仕事仲間をプロジェクトから閉め出してしまうのなら、彼らの中の評価は非常に悪くなるでしょう。慎重に使用してください...

もう必要でなくなったロックの解除を忘れないように、ロックされたファイルはコミットダイアログに表示され、デフォルトで選択されています。コミットを続けると、変更されていないとしても、選択したままのファイルのロックが解除されます。特定のファイルでロックを解除したくない場合、そのファイルのチェックを外せます（変更されていない場合）。変更したファイルのロックを保持したければ、変更をコミットする前に ロックを保持 チェックボックスを有効にしておく必要があります。

手動でロックを解除するには、ロックを解除したいファイルを作業コピーで選択し、TortoiseSVN → ロックを解除コマンドを選択してください。追加で入力することはありません。そこで TortoiseSVN はリポジトリに接続し、ロックを解除します。フォルダーに対してこのコマンドを使用し、再帰的に全ロックの解除を行えます。

図4.62 変更をチェックダイアログ

誰がロックをかけているかを確認するのに、TortoiseSVN → 変更をチェック... を使用できます。ローカルに保持したロックの印はすぐに現れます。他の人が保持しているロックをチェックするには（そして誰がロックを強制解除したり横取りしたりしたかを見るには）、リポジトリをチェック をクリックしてください。

ここのコンテキストメニューから、他の人が保持しているロックを、強制解除したり横取りしたりするように、ロックを取得したり解除したりもできます。

上記のように、ロックを使用するのに最も効果的な方法は、svn:needs-lock プロパティを設定することです。プロパティの設定については 「プロジェクト設定」 をご覧ください。このプロパティを持つファイルは、ロックを取得していないと、チェックアウトや更新をしたときに常に読み込み専用になります。

TortoiseSVN は、忘れないように特別なオーバーレイアイコンで表示します。

ファイルやフォルダーをリポジトリに追加した際に、自動的にプロパティを設定するように Subversion を設定できます。詳細情報は 「プロパティの自動設定」 をご覧ください。

Subversion 1.2 以降で作成したリポジトリでは、リポジトリの hooks ディレクトリに４つフックテンプレートが追加されています。それぞれロック取得の前後、ロック解除の前後に呼ばれます。

ファイルがロックされたときに、そのファイルを表すのに email を送信するような、post-lock や post-unlock フックスクリプトをサーバーにインストールするのは名案です。そういったスクリプトが適切な場所にあると、誰かがファイルをロック・ロック解放するとユーザーすべてに通知されます。リポジトリフォルダーの hooks/post-lock.tmpl に、サンプルフックスクリプトがあります。

フックを使用すると、ロックの強制解除・横取りを禁止したり、特定の管理者のみに制限したりすることもできます。また、ロックの強制解除・横取りが発生した時に、ロックの所有者にメールを送るようにすることもできます。

詳細は 「サーバー側フックスクリプト」 を参照してください。

まず、変更したものの make とテスト をする必要があります。それから、親フォルダーで TortoiseSVN → コミット... する代わりに、TortoiseSVN → パッチを作成... を選択してください、

図4.63 パッチ作成ダイアログ

ここで完全なコミットをするときのように、パッチに含めるファイルを選択できます。これで選択したファイルに対する、リポジトリを最後に更新したときからの変更点をまとめたファイルを得ることができます。

ダイアログの中の列は、 変更をチェック ダイアログの中の列と同じ方法でカスタマイズできます。詳細は 「ローカルとリモートの状態」 をご覧ください。

オプションボタンはをクリックすると、パッチの作り方を指定できます。たとえば、出力するパッチファイルで行末文字や空白文字の変更を含めないようにすることができます。

違うファイルの変更点を含めた分割したパッチも生成できます。もちろん、パッチファイルを生成してから、同じ ファイルに変更を加えて別のパッチを作成すると、２つ目のパッチには 両方 の変更点が含まれることになります。

それでは、任意のファイル名でファイルを保存してください。パッチファイルは任意の拡張子でかまいませんが、.patch や .diff を拡張子に使用するのが通例となっています。これでパッチファイルを送信する準備ができました。

また、ファイルに保存せずクリップボードに保存することもできます。電子メールに貼り付けて誰かにレビューしてもらう際に、そうしたくなると思います。また、１つのマシンに２つ作業コピーがあり、片方からもう片方へ変更を持っていくときに、クリップボードにパッチがあるとべんりです。

必要であれば、コミットや変更をチェックダイアログでパッチファイルを作成することができます。ファイルを選択して、コンテキストメニューからパッチを作成するメニュー項目を選択してください。オプションダイアログを表示する場合は、 Shift を押しながら右クリックしてください。

作業コピーにパッチファイルを適用します。パッチを作成したフォルダーと同じ階層で行う必要があります。よくわからなければ、パッチファイルの最初の行を見てください。たとえば、最初のファイルが doc/source/english/chapter1.xml に対するもので、パッチファイルの最初の行が Index: english/chapter1.xml なら、doc/source/ フォルダーでパッチを適用する必要があります。適切な作業コピーを使用していても、適用するフォルダー階層が間違っていると、TortoiseSVN は適切な階層を使用するよう注意を促します。

パッチファイルを作業コピーに適用するために、少なくともリポジトリの読み込み権限が必要です。これは、他の開発者がリビジョンを変更していないかどうか、マージプログラムが参照するからです。

フォルダーのコンテキストメニューから、TortoiseSVN → パッチを適用... をクリックしてください。すると「ファイルを開く」 ダイアログボックスが現れ、適用するパッチファイルを選択できます。デフォルトでは .patch ファイルか .diff ファイルのみが表示されていますが、「すべてのファイル」を選択できます。あらかじめパッチをクリップボードに保存していれば、「ファイルを開く」 ダイアログの クリップボードから開く... を使用できます。

その他には、パッチファイルが .patch や .diff といった拡張子を持つ場合、直接そのファイルを右クリックして、TortoiseSVN → パッチを適用... を選んでください。この場合、作業コピーの場所を入力することになります。

この２つは同じことを違う方法で行っているだけです。１つ目は作業コピーを選択してからパッチファイルを閲覧し、２つ目はパッチファイルを選択してから作業コピーを閲覧します。

一度パッチファイルや作業コピーの場所を選択すると、パッチファイルの変更を作業コピーにマージするように TortoiseMerge が起動します。小さなウィンドウに変更のあったファイルを表示するので、その中の項目をダブルクリックして変更の確認や、マージしたファイルの保存を行ってください。

他の開発者のパッチが適用されたので、今度は誰もがリポジトリから変更点にアクセスできるよう、コミットする必要があります。

図4.64 注釈履歴ダイアログ

ずっと前のリビジョンに興味がなければ、注釈を見始めるリビジョンを設定できます。全リビジョンの注釈履歴を見るのなら、これを 1 に設定してください。

デフォルトでは、 TortoiseBlame を使用して注釈を見ます。これは、異なるリビジョンを色分けして、見やすくしてくれます。注釈を印刷したり編集したりしたければ、 注釈履歴を見るためにテキストビューアーを用いる を選択してください。

改行コードや空白の変更に対する扱い方を指定できます。このオプションについては 「改行コードと空白のオプション」 で説明しています。デフォルトの振る舞いは、空白や改行コードの差異も実際の変更としますが、インデントの変更を無視してオリジナルの作者を見たい場合は、ここで適切なオプションを選択できます。

このオプションには、サーバーから取得するためかなり時間がかかる可能性はありますが、必要に応じてマージ情報を含めることができます。行が別のソースからマージされると、注釈履歴情報は、変更が元のソースだけでなく、それがこのファイルにマージされたリビジョンで作成されたリビジョンを表示します。

OKを押すと、TortoiseSVNは注釈ファイルを作成するため、データの取得を始めます。注釈処理が終了すると、結果を一時ファイルに書き出し、結果を表示します。

図4.65 TortoiseBlame

TortoiseSVN に含まれる TortoiseBlame は、注釈ファイルを読みやすくしてくれます。マウスをある行の注釈情報列の上に持っていくと、同じリビジョンの行の背景を濃くして表示します。同じ更新者が行ったけれどもリビジョンが異なる行は、薄く色を付けて表示します。ディスプレイが 256 色モードに設定されていると、きれいに色分けされない可能性があります。

行の上で 左クリック すると、同じリビジョンのすべての行に色分けされます。同じ作業者の、他のリビジョンの行は薄い色で色分けされます。この色分けは貼り付いて、色分けを失わないようにマウスを移動できます。リビジョンをもう一度クリックすると、色分けが解除されます。

注釈情報の列の上ならどこでもマウスを持ってくると、ヒントボックスの中にリビジョンのコメント（ログメッセージ）を表示します。そのリビジョンのログメッセージをコピーするには、注釈情報の列を右クリックしてでてくるコンテキストメニューを使用してください。

注釈レポートを 編集 → 検索... を使用して検索できます。これでリビジョン番号、作業者、ファイルの内容を検索できます。ログメッセージは検索できません。ログダイアログを使用して検索してください。

また、編集 → 指定した行へ移動... で指定した行番号にジャンプします。

注釈情報列の上にマウスを持っていくと、リビジョンを比較したり、履歴を検査するのに便利なコンテキストメニューが使用可能になります。この時マウスのある行のリビジョン番号を参照します。コンテキストメニュー → 前リビジョンの注釈履歴 では、同じファイルに対する前のリビジョンを上限とした注釈履歴レポートを生成します。今見ている行に対する最終更新の、直前のファイルの状態を表す注釈履歴レポートを得られます。コンテキストメニュー → 変更を表示 は、参照しているリビジョンの変更点を表示する diff ビューアーを起動します。コンテキストメニュー → ログを表示は、参照しているリビジョンから始まる、リビジョンログダイアログを表示します。

もっと視覚的に変更点の新旧を見たい場合、表示 → 各行の変更時期を色分けする を選択してください。これにより、新しい行は赤、古い行は青のグラデーションで表します。デフォルトの色分けは、薄い色になっていますが、TortoiseBlame の設定で変更できます。

注釈履歴の起動時にマージ追跡を使用していると、マージされた行が若干異なって表示されます。別のパスからのマージによって変更された行には、マージが行われたリビジョンではなく、マージ元のファイルが最後に変更された時のリビジョンと作者が表示されます。この場合、リビジョンと作者が斜体で表示されます。注釈情報列の上にマウスを移動させると、マージされたリビジョンがツールチップ上に表示されます。マージした行をこのような形で表示させたくない場合、注釈履歴を起動するときに マージ情報を含める チェックボックスをオフにしてください。

表示 → マージ元のパス を選択すると、マージに関係するパスが表示されます。その行がマージ以外の操作によって最後に変更されたときのパスが表示されます。

注釈履歴情報の中のリビジョンは、その行の内容が変更された最後のリビジョンを表します。ファイルを他からコピーして作成したとき、それから行を変更するまで、その行の注釈履歴のリビジョンは元のソースファイルの最後の変更であり、コピーが作成されたリビジョンではありません。これはマージ情報と共に表示されるパスにも適用されます。パスは、最後の変更がその行に作成されたリポジトリの場所を示しています。

TortoiseBlame の設定は、TortoiseSVN → 設定... の TortoiseBlame タブでアクセスできます。 「TortoiseBlame の設定」 をご覧ください。

注釈履歴レポートの限界の１つは、ファイルを特定のリビジョンにおける、各行を変更した最後の人しか見ることができません。時には、誰が変更したかと同様に、誰が作成したかを知りたいことがあります。 TortoiseBlame の行を右クリックしてコンテキストメニューを表示しすると、そのリビジョンでの変更を見ることができます。しかし、変更点と注釈履歴を 同時に 確認したい場合は、差分と注釈履歴のレポートを組み合わせなければなりません。

リビジョンログダイアログには、以下のようないくつかのオプションがあります。

リビジョングラフの各ノードは、現在表示されているツリーで何かしらの変更が行われたリビジョンを表しています。形や色でノードの違いを区別できます。形は固定ですが、色は TortoiseSVN → 設定 を使用して設定できます。

デフォルトのいグラフには、項目の追加・コピー・削除のみが表示されています。プロジェクト内のすべてのリビジョンが表示されると、重要な時に非常に巨大なグラフになってしまいます。本当に、変更が行われた すべての リビジョンが必要ならば、 表示 メニューやツールバーに、表示させるためのオプションがあります。

デフォルトの表示（グループ化無効）では、ノードは縦方向に、厳密にリビジョン順で配置されるため、実行された順番が視覚的に分かります。同じ列にある２つのノードの順番は明白です。２つののノードが隣接する列にある場合、ノードが重なる心配がないため、補正は少なくて済みます。そしてそのため、少々明白でない場合があります。そのような最適化が、複雑なグラフを妥当な大きさにしておくために必要です。なお、この順序づけでは、 古い方 にあるノードの 端 （つまり、グラフを古いノードを下に表示する場合は、ノードの下端）を、参照として使用します。ノードの形がすべて同じ大きさであるわけではないため、参照する端は重要です。

リビジョングラフは非常に複雑になることがありますので、任意の表示にできるようにいくつもの機能があります。ツールバーの表示メニューから使用できます。

大きなリビジョングラフを参照するのに、外観ウィンドウを使用してください。小さなウィンドウに、図の全体を表示し、現在の表示範囲を強調しています。強調範囲をドラッグすると、表示領域が変化します。

リビジョンの日時、作者。コメントは、マウスをリビジョンボックスの上にかざしたときに出るヒントボックスに表示します。

２つのリビジョンを選択（Ctrl-左クリック）すると、そのリビジョン間の差分を表示するコンテキストメニューを使用できます。ブランチ作成ポイントで差分を表示できますが、通常ブランチ終了ポイント（つまり HEAD リビジョン）について表示したいことでしょう。

差分をUnified差分ファイル（最小の文脈で全差分を１ファイルにまとめたもの）で見られます。 コンテキストメニュー → リビジョンを比較 を選択すると、変更したファイルの一覧が表示されます。ファイル名を ダブルクリック すると両リビジョンを取得し、視覚差分ツールで比較します。

リビジョン上で 右クリック すると、履歴を表示するのに コンテキストメニュー → ログ表示 を使用できます。

別の作業コピーにある、選択したリビジョンの変更もマージできます。フォルダー選択ダイアログにより、マージ結果を格納する作業コピーを選択できますが、確認ダイアログはなく、また動作チェックもできません。変更されていない作業コピーを用い、選択したリビジョンをマージするのに失敗したら、変更を取り消すのがよい方法です。 これはあるブランチから別のブランチへ、選択したリビジョンをマージするのに便利です。

新しい情報を取得するためサーバーを再チェックする場合、単純に F5 で表示を更新できます。ログキャッシュを使用する場合（デフォルトで有効）、新しいログメッセージがあるかリポジトリをチェックし、新しいもののみを取得します。ログキャッシュがオフラインモードだった場合、オンラインモードにしようともします。

ログキャッシュを使用しており、メッセージの内容や作者を変更しようとする場合、必要なメッセージを再読込するのにログダイアログを使用するべきです。リビジョングラフはリポジトリのルートから動作しますので、ログキャッシュ全体を無効にせねばならず、キャッシュにためるのに非常に長い時間がかかります。

大きなツリーはナビゲートしにくい場合があり、一部を隠したり、小さなツリー群に分割したりしたくなると思います。ノードに出入りするノードリンクの点の上にマウスを移動すると、このための複数のポップアップボタンを目にすることになります。

付随するサブツリーを折りたたむには、-ボタンをクリックしてください。

折りたたまれたツリーを展開するには、+ボタンをクリックしてください。ツリーが折りたたまれている場合、隠されたサブツリーを表すため、表示したままとなります。

×ボタンをクリックすると、取り付けたサブツリーを分割し、独立したツリーとしてグラフに表示します。

○ボタンを押すと、分割したツリーを再度取り付けます。ツリーが遠いところで分割された際には、分割したサブツリーがあることを示すため、このボタンを表示したままとなります。

グラフの背景をクリックすると、すべて展開 や すべて連結する を提供する、メインコンテキストメニューを表示します。折りたたんだり分割したブランチがなければ、コンテキストメニューを表示しません

作業コピーを.svnディレクトリがない通常のフォルダーにしたい場合は、作業コピーのルートにある.svnディレクトリを削除するだけです。

それ以外にも、作業コピーのフォルダー自身にエクスポートする方法もあります。Windowsエクスプローラーで、ファイルペインにある作業コピーのルートフォルダーを、フォルダーペインの同じフォルダーに右ドラッグしてください。TortoiseSVNはこの特殊なケースを検出し、作業コピーをバージョン管理下から外すかどうかを聞いてきます。はい と答えると、コントロールディレクトリを削除し、まっさらなバージョン管理されていないディレクトリになります。

TortoiseSVN は任意のバグ追跡ツールと統合できます。そのためには、 bugtraq: で始まるプロパティを、フォルダーに対して定義する必要があります。（「プロジェクト設定」）

図4.70 課題追跡システムのプロパティダイアログ

課題追跡システムのプロパティを編集する場合、適切な値を簡単に設定するために、専用のプロパティエディターを使用します。

TortoiseSVN と課題追跡システムを統合するには、２つ方法があります。ひとつは単純文字列による方法、もうひとつは 正規表現 による方法です。プロパティにはどちらの方法も使用できます。

bugtraq:message と bugtraq:logregex の両方を設定した場合、logregex が優先されます。

tsvn: プロパティのいくつかは true/false 値をとります。TortoiseSVN は yes を true と同義に、no を false と同義に解釈します。

TortoiseSVN で新しいサブフォルダーを作業コピーに追加する際、親フォルダーに設定されているプロジェクトプロパティは、新しいサブフォルダーにも自動的に追加されます。

この課題追跡システムとの統合は、 TortoiseSVN に限定されたものではなく、どの Subversion クライアントでも共通で使用できます。詳細については、TortoiseSVN のソースリポジトリにある Issue Tracker Integration Specification の全文をお読みください（リポジトリへのアクセスのしかたは、「ライセンス」 で説明します）。

前節では、ログメッセージへ課題情報の追加について扱いました。しかし、課題追跡システムから情報を取得する必要がある場合、どのようにしたらよいのでしょう？コミットダイアログは、課題追跡システムと対話できるような、外部プログラムを統合するためのCOMインターフェイスを備えています。通常、自分に割り当てられた未解決の課題の一覧を問い合わせて、このコミットに関連する課題を選択できるといいのではないでしょうか。

そのようなインターフェイスはいずれも、課題追跡システムに強く依存しているので、私たちはこの部分を提供することはできませんし、そのようなプログラムの作成方法について説明することは、このマニュアルの範疇を超えてしまいます。インターフェイスの定義や、C#やC++/ATLで書かれたサンプルプラグインは、 TortoiseSVN リポジトリの contrib フォルダから取得できます（リポジトリのアクセスの仕方は、 「ライセンス」で説明します）。API の概要も 7章IBugtraqProvider インターフェイス で得られます。それ以外の（動作する）サンプルプラグインとして、 C# では Gurtle があり、これは課題管理システム Google Code と連動するために必要な COM インターフェイスを実装しています。

説明のために、システム管理者が、インストールした課題管理システムプラグインを提供し、 TortoiseSVN の設定ダイアログでそのプラグインを使用する作業コピーをセットアップしたとしましょう。プラグインに割り当てられた作業コピーからコミットダイアログを開くと、ダイアログの上部に新しいボタンが現れるはずです。

図4.71 課題追跡システムクエリダイアログの例

この例では、複数の未解決課題を選択できます。その後、プラグインがログメッセージに追加する、特定のフォーマットのテキストを生成できます。