作業コピーが最新で競合がない場合、変更をコミットする準備ができています。コミットするファイルやフォルダーを選択し、 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 とコマンドを入力すれば起動します。

The log message window also includes a commit message snippet facility. These snippets are shown in the autocomplete dropdown once you type a snippet shortcut, and selecting the snippet in the autocomplete dropdown then inserts the full text of the snippet. The snippets supplied with TortoiseSVN are held in the TortoiseSVN installation bin folder. You can also define your own snippets and store them in %APPDATA%\TortoiseSVN\snippet.txt. # is the comment character. Newlines can be inserted by escaping them like this: \n and \r. To insert a backslash, escape it like this: \\.

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

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

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

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

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

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

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

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