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

いろいろな場所からログダイアログを表示できます。

リポジトリが利用できない場合、「オフラインモード」 で説明する、オフラインにしますか? ダイアログを目にすることになります。

上部ペインには、そのリビジョンで何が行われたかをまとめた アクション 列があります。4 つのアイコンが、それぞれ 1 列ずつ表示されます。

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

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

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

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

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

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

図4.17 2 リビジョン選択時の上部ペインコンテキストメニュー

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

2 つ以上のリビジョンを選択 (通常 Ctrl や Shift を押しながら選択) すると、 コンテキストメニューにリビジョンの範囲を指定してすべての変更を取り消す項目が現れます。これがリビジョンのグループを一度に元に戻す、簡単な方法です。

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

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

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

ログダイアログの下部ペインにもコンテキストメニューがあり、以下を行えます。

ログダイアログは以下のような理由で、すべての変更を常に表示するわけではありません。

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

このボタンの隣に、前回使用したオプションを記憶している、マルチファンクションボタンがあります。三角をクリックすると他のオプションを指定できます。

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

最新リビジョンからリビジョン 1 へ すべての ログメッセージが見たければ、すべて表示 を押してください。

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

フォルダのリビジョンを表示する際、強調されたリビジョンは、そのフォルダの近辺にある最大のリビジョンになります。これには作業コピーのクロールが必要です。これは大きな作業コピーでは、遅い処理になり、クロールが完了するまでログメッセージが表示されません。この機能を無効にしたり、制限したりしたい場合は、「レジストリの設定」 で説明するように、レジストリキー HKCU\Software\TortoiseSVN\RecursiveLogRev をセットしてください。

Subversion 1.5 以降では、属性を利用してマージ情報を保持しています。これにより、マージでの変更点の詳細な履歴を得られます。例えば、ブランチで新機能を開発し、ブランチをトランクにマージした場合、たとえブランチでの開発で 1000 コミットしたとしても、トランクでのその機能の開発には、1 コミットしかしていないことになってしまいます。

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

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

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

リビジョン属性は、各項目の Subversion 属性とはまったく違います。リビジョン属性は、ログメッセージやコミット日時、コミットした人 (作者) といった、リポジトリの特定のリビジョン番号に関連する説明的な項目です。

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

Subversion では、必要に応じてリビジョン属性をいつでも変更できます。しかし、その変更を元に戻せない (この変更はバージョン管理外になります) ので、デフォルトではこの機能は無効になっています。有効にするには、pre-revprop-change フックをセットアップしなければなりません。この手順の詳細については、Subversion Book の Hook Scripts をご覧ください。(訳注 日本語では フックスクリプトをご覧ください) Windows マシンでのフックの実装については、「サーバ側フックスクリプト」 をご覧ください。

一度、必要なフックをサーバにセットアップしてしまえば、任意のリビジョンに対して、作者とログメッセージ (もしくはその他のリビジョン属性) を変更できます。ログダイアログの上部ペインからコンテキストメニューを使用してください。中央ペインのコンテキストメニューを使用しても、ログメッセージを編集できます。

興味あるログメッセージを表示するよう限定するなら、何百もあるリストをスクロールするよりも、ログダイアログの上端にあるフィルタコントロールを使用したほうがいいです。開始終了日のコントロールで日付の範囲をしてください。検索ボックスで入力した部分文字列を持つメッセージだけを表示できます。

検索アイコンをクリックして、検索したい情報を選択してください。また正規表現モードも選択できます。通常はシンプルなテキスト検索があれば十分でしょうが、もっと柔軟な検索語句を指定したい場合、正規表現を使用できます。ボックスの上にマウスを持っていくと、正規表現の使い方のヒントをツールチップで表示します。オンラインドキュメントやチュートリアルも http://www.regular-expressions.info/ にあります。フィルタは、フィルタ文字列がログエントリとマッチするかどうかをチェックし、フィルタ文字列と マッチ したエントリのみを表示します。

フィルタ文字列に一致しないログエントリを表示するようフィルタをかけるには、文字列をエクスクラメーションマーク ('!') で始めてください。例えば、フィルタ文字列 !username は username がコミットしていないエントリのみを表示します。

このフィルタは、すでに取得したメッセージにのみ効果があることに注意してください。リポジトリからメッセージをダウンロードするような動作はしません。

また、下部ペインのパス名を、変更されたパスで無関係なものは表示しない チェックボックスでフィルタできます。関係するパスは、ログを表示するのに使用するパスを含んでいます。フォルダのログを取得する場合、そのフォルダ以下のログを取得することを意味しています。ファイルに対しては、その 1 ファイルのみであることを意味しています。チェックボックスは 3 状態をとります。すべてのパスを表示する、または無関係なものを灰色にする、無関係なものを完全に隠すです。

時には運用手順として、ログメッセージを特定のフォーマットにする必要があるかもしれません。これは変更点を説明するテキストが、上部ペインに表示する短縮サマリに表示されないということです。tsvn:logsummary 属性を使用して、上部ペインに表示しているログメッセージの一部を抽出できます。この属性の使い方は、「TortoiseSVN のプロジェクト属性」 をご覧ください。

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

「作者によるコミット」ページ

図4.20 「作者によるコミット」ヒストグラム

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

図4.21 「作者によるコミット」円グラフ

少数の主要な作者と、多数のこまかな協力者がいるところでは、小さなセグメントが多くなり、グラフが読みにくくなります。グラフの下にあるスライダを使用してしきい値 (全コミットにおけるパーセンテージ) を設定し、活動状況がしきい値以下の人を その他 カテゴリにします。

「日毎のコミット数」ページ

図4.22 「日毎のコミット数」グラフ

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

複数の作者がいる場合、グラフの線がたくさん表示されます。ここで 2 通りの表示があります。通常 は、作者の活動状況ごとに表示し、積み重ね は、作者の活動状況を積み重ねて表示します。後者では、グラフを読みやすくするため、線が交差するのを避けますが、作者ごとに表示した方が見やすいでしょう。

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

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

図4.23 オフライン化ダイアログ

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

ここでは以下の 3 種のオプションがあります。

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

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

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