作業コピーが最新であり、競合がない場合、変更をコミットする準備ができています。コミットしたいファイルやフォルダを選択し、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に保存することもできます。もちろん、TortoiseSVNのインストールを更新しても、プライベートautolistは上書きされません。正規表現に慣れていない場合は、 https://ja.wikipedia.org/wiki/%E6%AD%A3%E8%A6%8F%E8%A1%A8%E7%8F%BE の紹介と、 https://regular-expressions.dokyumento.jp/ のオンラインドキュメントとチュートリアルをご覧ください。

正規表現を適切に調整するのは難しい場合があるため、適切な式を整理するのに役立つように、式を入力してからファイル名を入力してテストできるテストダイアログがあります。コマンドプロンプトからコマンドTortoiseProc.exe /command:autotexttestを使用して起動します。

ログメッセージウィンドウには、コミットメッセージスニペット機能も含まれています。これらのスニペットは、スニペットショートカットを入力するとオートコンプリートドロップダウンに表示され、オートコンプリートドロップダウンでスニペットを選択すると、スニペットの全文が挿入されます。 TortoiseSVNに付属のスニペットは、TortoiseSVNインストールbinフォルダに保持されています。独自のsnippetを定義して、%APPDATA%\TortoiseSVN\snippet.txtに保存することもできます。#はコメント文字です。改行は、\nや\rのようにエスケープすることで挿入できます。バックスラッシュを挿入するには、\\のようにエスケープします。

以前に入力したログメッセージを再利用できます。最近のメッセージをクリックして、この作業コピーに入力した最後の数件のメッセージのリストを表示するだけです。保存されるメッセージの数は、TortoiseSVN設定ダイアログでカスタマイズできます。

TortoiseSVNの設定の保存されたデータページから、保存されているすべてのコミットメッセージをクリアするか、Deleteキーを使用して、最近のメッセージダイアログ内から個々のメッセージをクリアできます。

ログメッセージにチェックされたパスを含めたい場合は、編集コントロールでコンテキストメニュー → ファイル名リストを貼り付けコマンドを使用できます。

ログメッセージにパスを挿入する別の方法は、ファイルリストから編集コントロールにファイルをドラッグするだけです。

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

図4.10　コミットの進行状況を示す進行状況ダイアログ

進行状況ダイアログは、コミットアクションを色分けして強調表示します

これはデフォルトの配色ですが、設定ダイアログを使用してこれらの色をカスタマイズできます。詳細については、「TortoiseSVNの色設定」のセクションを参照してください。