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

ログダイアログを表示できる場所はいくつかあります。

リポジトリが利用できない場合は、オフラインにしますか？ダイアログが表示されます。これについては、「オフラインモード」のセクションで説明しています。

上部のペインには、アクション列があり、そのリビジョンで実行された内容をまとめたアイコンが含まれています。4つの異なるアイコンがあり、それぞれ独自の列に表示されます。

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

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

リビジョンでファイルまたはディレクトリが削除された場合、3番目の列に削除アイコンが表示されます。

リビジョンでファイルまたはディレクトリが置き換えられた場合、4番目の列に置換アイコンが表示されます。

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

リビジョンでファイルまたはディレクトリが移動/名前変更によって置き換えられた場合、4番目の列に移動して置換アイコンが表示されます。

リビジョンでファイルまたはディレクトリがマージされた場合、4番目の列にマージアイコンが表示されます。

リビジョンでファイルまたはディレクトリがリバースマージされた場合、4番目の列にリバースマージアイコンが表示されます。

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

ログダイアログの上部ペインには、さらに多くの情報にアクセスできるコンテキストメニューがあります。これらのメニューエントリの一部は、ファイルに対してログが表示されている場合にのみ表示され、一部はフォルダーに対してログが表示されている場合にのみ表示されます。

図 4.20. Code Collaborator 設定ダイアログ

図 4.21. 2つの選択したリビジョンの上部ペインコンテキストメニュー

（通常の Ctrl キー修飾子を使用して）一度に2つのリビジョンを選択すると、コンテキストメニューが変更され、オプションが少なくなります。

（通常の Ctrl または Shift 修飾子を使用して）2つ以上のリビジョンを選択すると、コンテキストメニューに、選択したリビジョンで行われたすべての変更を元に戻すエントリが含まれます。これは、リビジョンのグループを一度にロールバックする最も簡単な方法です。

上記のように、選択したリビジョンを別のワーキングコピーにマージすることもできます。

選択したすべてのリビジョンの作成者が同じ場合は、それらのすべてのリビジョンの作成者を一度に編集できます。

図 4.22. コンテキストメニュー付きのログダイアログ下部ペイン

ログダイアログの下部ペインにも、次のことができるコンテキストメニューがあります。

ログダイアログの下部ペインで複数のファイルが選択されている場合、コンテキストメニューは次のようになります。

図 4.23. 複数のファイルが選択された場合のログダイアログ下部ペインのコンテキストメニュー。

ログダイアログには、これまでに加えられたすべての変更が常に表示されるわけではありません。理由はいくつかあります。

より多くのログメッセージを表示する場合は、次の 100 件をクリックして、次の 100 件のログメッセージを取得します。これは、必要に応じて何度でも繰り返すことができます。

このボタンの横には、最後に使用したオプションを記憶する多機能ボタンがあります。矢印をクリックして、提供されている他のオプションを確認してください。

特定のリビジョン範囲を表示する場合は、範囲を表示...を使用します。ダイアログが表示され、開始リビジョンと終了リビジョンを入力するように求められます。

すべてのリビジョン 1 から HEAD までのログメッセージを表示する場合は、すべて表示を使用します。

ログダイアログが開いている間に他のコミットがあった場合に、最新のリビジョンを更新するには、F5 キーを押します。

ログキャッシュを更新するには、Ctrl-F5 キーを押します。

ログダイアログには、現在のワーキングコピーリビジョンからではなく、HEAD からのログが表示されるため、ワーキングコピーでまだ更新されていないコンテンツのログメッセージが表示されることがよくあります。これをより明確にするために、ワーキングコピーにあるリビジョンに対応するコミットメッセージは太字で表示されます。

フォルダーのログを表示すると、強調表示されるリビジョンは、そのフォルダー内のどこかに見つかった最高のリビジョンであり、ワーキングコピーのクロールが必要です。クロールは、ログの表示を遅らせないように別のスレッド内で実行されますが、その結果、フォルダーの強調表示がすぐに表示されない場合があります。

Subversion 1.5 以降では、プロパティを使用してマージの記録が保持されます。これにより、マージされた変更の詳細な履歴を取得できます。たとえば、ブランチで新機能を開発し、そのブランチをトランクにマージバックすると、ブランチ開発中に 1000 件のコミットがあったとしても、機能開発はマージの単一コミットとしてトランクログに表示されます。

図 4.24. マージ追跡リビジョンを表示するログダイアログ

そのコミットの一部としてマージされたリビジョンの詳細を確認する場合は、マージされたリビジョンを含めるチェックボックスを使用します。これにより、ログメッセージが再度フェッチされますが、マージされたリビジョンからのログメッセージもインターリーブされます。マージされたリビジョンは、ツリーの別の部分で行われた変更を表すため、灰色で表示されます。

もちろん、マージは決して簡単ではありません！ブランチでの機能開発中には、ブランチをメインラインコードと同期させるために、トランクからブランチへのマージバックが時折発生する可能性があります。したがって、ブランチのマージ履歴には、別のレイヤーのマージ履歴も含まれます。これらの異なるレイヤーは、インデントレベルを使用してログダイアログに表示されます。

リビジョンプロパティは、各アイテムの Subversion プロパティとは完全に異なります。Revprop は、ログメッセージ、コミット日、コミッター名（作成者）など、リポジトリ内の特定のリビジョン番号に関連付けられている記述項目です。

以前に入力したログメッセージを変更したい場合があります。たとえば、スペルミスがある場合や、メッセージを改善したい場合、またはその他の理由で変更したい場合などです。または、認証の設定を忘れたか、その他の理由でコミットの作成者を変更したい場合などです。

Subversion では、いつでもリビジョンプロパティを変更できます。ただし、そのような変更は元に戻すことができない（これらの変更はバージョン管理されていない）ため、この機能はデフォルトで無効になっています。これを機能させるには、pre-revprop-change フックを設定する必要があります。その方法の詳細については、Subversion Book の フックスクリプト の章を参照してください。Windows マシンでのフックの実装に関する追加の注意事項については、「サーバーサイドフックスクリプト」のセクションを参照してください。

必要なフックでサーバーを設定したら、ログダイアログの上部ペインのコンテキストメニューを使用して、任意のリビジョンの作成者とログメッセージ（またはその他の revprop）を変更できます。中央のペインのコンテキストメニューを使用してログメッセージを編集することもできます。

数百件のリストをスクロールするのではなく、関心のあるログメッセージのみを表示するように制限したい場合は、ログダイアログの上部にあるフィルターコントロールを使用できます。開始日と終了日のコントロールを使用すると、出力を既知の日付範囲に制限できます。検索ボックスを使用すると、特定のフレーズを含むメッセージのみを表示できます。

検索アイコンをクリックして、検索する情報を選択し、正規表現モードを選択します。通常は、単純なサブストリング検索のみが必要ですが、より柔軟な検索用語が必要な場合は、正規表現を使用できます。ボックスにマウスを合わせると、正規表現関数またはサブストリング関数の使用方法に関するヒントがツールチップに表示されます。フィルターは、フィルター文字列がログエントリと一致するかどうかを確認し、フィルター文字列と一致するエントリのみが表示されるように機能します。

単純なサブストリング検索は、検索エンジンと同様の方法で機能します。検索する文字列はスペースで区切られ、すべての文字列が一致する必要があります。先頭に - を使用して、特定のサブストリングが見つからないことを指定（その用語の一致を反転）し、式の先頭に ! を使用して、式全体の一致を反転できます。先頭に + を使用して、サブストリングを - で以前に除外した場合でも、含める必要があることを指定できます。包含/除外の順序はここで重要であることに注意してください。引用符を使用して、スペースを含む必要のある文字列を囲むことができ、リテラルの引用符を検索する場合は、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」 を検索します。

正規表現検索の使用法を説明することは、このマニュアルの範囲を超えていますが、 https://regular-expressions.dokyumento.jp/ でオンラインドキュメントとチュートリアルを見つけることができます。

これらのフィルターは、すでに取得されているメッセージに対して機能することに注意してください。リポジトリからのメッセージのダウンロードを制御するものではありません。

下部ペインのパス名をフィルタリングするには、影響を受けたパスのみを表示チェックボックスを使用することもできます。影響を受けたパスとは、ログを表示するために使用されたパスを含むパスです。フォルダーのログを取得する場合、それはそのフォルダーまたはその下のすべてのものを意味します。ファイルの場合、それはその1つのファイルのみを意味します。通常、パスリストには、同じコミットの影響を受ける他のパスも灰色で表示されます。ボックスがオンになっている場合、これらのパスは非表示になります。

作業慣行によっては、ログメッセージが特定のフォーマットに従う必要がある場合があります。これは、変更を記述するテキストが、上部ペインに表示される省略された概要には表示されないことを意味します。プロパティ tsvn:logsummary を使用すると、ログメッセージの一部を抽出して上部ペインに表示できます。このプロパティの使用方法については、「TortoiseSVN プロジェクトプロパティ」のセクションをお読みください。

統計ボタンをクリックすると、ログダイアログに表示されているリビジョンに関する興味深い情報を示すボックスが表示されます。これにより、作業中の作者の数、コミット数、週ごとの進捗状況などが表示されます。これで、誰が一番頑張っていて、誰が怠けているのかが一目でわかります ;-)

作者別コミットページ

図 4.25. 作者別コミットヒストグラム

このグラフは、プロジェクトでアクティブだった作者を、単純なヒストグラム、積み重ねヒストグラム、または円グラフとして示します。

図 4.26. 作者別コミット円グラフ

主要な作者が数名で、マイナーな貢献者が多数いる場合、小さなセグメントの数がグラフを読みにくくする可能性があります。下部にあるスライダーを使用すると、アクティビティが その他 カテゴリにグループ化されるしきい値（総コミット数のパーセンテージとして）を設定できます。

日付別コミットページ

図 4.27. 日付別コミットグラフ

このページでは、コミット数と作者の観点からプロジェクトアクティビティのグラフィカルな表現を提供します。これにより、プロジェクトがいつ作業されているか、そして誰がいつ作業していたかのアイデアが得られます。

複数の作者がいる場合、グラフに多くの線が表示されます。ここでは、2つのビューが利用可能です。通常ビューでは、各作者のアクティビティがベースラインを基準にし、積み重ねビューでは、各作者のアクティビティが下の線を基準にします。後者のオプションは線が交差するのを防ぎ、グラフを読みやすくする可能性がありますが、1人の作者の出力を確認しにくくなります。

デフォルトでは、分析は大文字と小文字が区別されるため、ユーザー PeterEgan と PeteRegan は異なる作者として扱われます。ただし、多くの場合、ユーザー名はcase-insensitiveであり、一貫性なく入力されることもあるため、DavidMorgan と davidmorgan を同一人物として扱いたい場合があります。作者を大文字と小文字を区別しないチェックボックスを使用して、この処理方法を制御します。

統計はログダイアログと同じ期間を対象としていることに注意してください。ログダイアログが1つのリビジョンのみを表示している場合、統計はあまり多くのことを教えてくれません。

図 4.28. オフラインにするダイアログ

サーバーに到達できず、ログキャッシュが有効になっている場合は、ログダイアログとリビジョングラフをオフラインモードで使用できます。これはキャッシュからのデータを使用するため、情報が最新でない場合や不完全な場合でも、作業を続行できます。

ここには3つのオプションがあります。

これをデフォルトにするチェックボックスをオンにすると、このダイアログが再表示されなくなり、次回選択したオプションが常に選択されます。実行後も、TortoiseSVN → 設定からデフォルトを変更（または削除）できます。

新しいログメッセージがないかサーバーを再度確認したい場合は、F5を使用してビューを更新するだけです。ログキャッシュ（デフォルトで有効）を使用している場合、これはリポジトリをチェックして新しいメッセージがないか確認し、新しいメッセージのみをフェッチします。ログキャッシュがオフラインモードの場合、オンラインに戻ろうともします。

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