ユーザインターフェースの言語を選択してください。他に何かありますか?

チェックすると、TortoiseSVN は週に一度、プログラムの新バージョンがないかダウンロードサイトに接続します。すぐに答えが知りたければ、今すぐチェック を使用してください。新バージョンがダウンロードされるわけではありません。単に新バージョンがあるという、情報ダイアログが表示されるだけです。

TortoiseSVN にはデフォルトでカスタムサウンドが 3 つインストールされています。

Windows のコントロールパネルで別のサウンド (もしくは完全に OFF) を選択できます。設定 はコントロールパネルへのショートカットです。

共通無視パターンはバージョン管理外のファイルを、コミットダイアログなどに表示しないようにするのに使用します。パターンにマッチしたファイルはインポートでも無視されます。除外するファイルやディレクトリは、名前や拡張子で判断します。パターンは空白で区切り、*/bin */obj *.bak *.~?? *.jar *.[Tt]mp のようにします。以上のパターンは、N 階層の親ディレクトリを含むパスに対して使用されることをご承知ください。単純なファイル拡張子以外の無視パターンの設定は、前述ほど簡単ではありません。パターンマッチの文法やどのようにパスをチェックするかといった詳細情報は、無視リストでのパターンマッチ項 をご覧ください。

ここで指定した無視パターンは、同じPCで動作する他の Subversion クライアント (コマンドラインクライアントを含む) でも有効になることに注意してください。

この無視パターンはすべてのプロジェクトに影響を与えます。バージョン管理されませんので、他のユーザには影響しません。対照的に、バージョン管理で svn:ignore 属性を使用し、バージョン管理からファイルやディレクトリを除外することもできます。詳細は 無視するファイルとディレクトリ項 をご覧ください。

このオプションはチェックアウトや更新時にコミット時の日時をファイルの日時として使うよう、TortoiseSVN に指示します。そうでなければ、TortoiseSVN は現在の日時を使用します。ソフトウェアを開発しているなら、ビルドシステムがコンパイルの要否を判断するのにタイムスタンプを使用するので、現在の日付にしておくのが最善でしょう。「最後にコミットした日付」 を使用していて、ファイルを古いリビジョンに戻す場合、プロジェクトがコンパイルされない可能性があります。

Subversion 設定ファイルを直接編集するには 編集 を使用してください。いくつかの設定は TortoiseSVN では直接変更することができません。そのときにこれが必要となります。Subversion の config ファイルについての詳細情報は、Runtime Configuration Area をご覧ください。(訳注 日本語訳は Subversion によるバージョン管理 をご覧ください) Automatic Property Setting 節には興味深い項目があり、これはここで設定します。(訳注 日本語訳は 属性の自動設定 です) Subversion は複数の設定情報を読み込めますが、その優先順位を知っておかなくてはならないことに注意してください。詳細は Configuration and the Windows Registry を参照してください。(訳注 日本語訳は 設定と Windows のレジストリ です)

web プロジェクトを使用する際、Subversion が内部情報を格納する .svn フォルダを、VS.NET は扱えません。これは Subversion のバグではありません。VS.NET とそこで使用する frontpage 拡張のバグです。この件に関してもっと調べるには Subversion の作業フォルダ項 をご覧ください。

Subversion や TortoiseSVN の振る舞いを変更する場合、これを制御する環境変数を設定するのに、チェックボックスを使用できます。

このオプションを変更すると、既存の作業コピーを新しい管理下のディレクトリに、自動でコンバートできないことに注意してください、スクリプトを使って自分で行うか、単純に新しい作業コピーをチェックアウトする必要があります。

別のプロセス (TSVNCache.exe) がすべての状態情報をキャッシュします。このプロセスは、全ドライブの変更を監視し、作業コピー内のファイルが更新されれば、その状態情報を再取得します。優先度が最低で動作しますので、他のプログラムが、これによりリソースをとられてしまうことはありません。これは状態情報が リアルタイム で更新されないということでもありますが、数秒でオーバーレイアイコンは更新されます。

利点: オーバーレイアイコンは状態を再帰的に表示します。つまり、作業コピーの深いところにあるファイルが更新されると、作業コピーのルートまでの全フォルダにも更新オーバーレイアイコンが付きます。さらにプロセスがシェルに通知を送れるのなら、通常、左のツリービューのオーバーレイも変更します。

欠点: プロジェクトについて作業をしていないときでも、プロセスが一定に動作しています。さらに、作業コピーのサイズ・数量にも依存しますが、およそ 10-50 MB の RAM を使用します。

シェル拡張 dll の内部で直接キャッシュします。別のフォルダに移るたびに、ステータス情報を取得します。

利点: メモリ消費がとても少なく (およそ 1 MB の RAM) てすみます。また、状態をリアルタイム に表示します。

欠点: 1 つのフォルダしかキャッシュしないため、オーバーレイアイコンは状態を再帰的に表示しません。大きな作業コピーでは、デフォルトのキャッシュよりも、エクスプローラのフォルダ表示に時間がかかります。また、mime-type 列が利用できません。

この設定では、TortoiseSVN はエクスプローラで状態をまったく取得しません。このため、ファイルはオーバーレイアイコンを取得できず、バージョン管理されたフォルダは 「通常」のオーバーレイアイコンしか取得しません。他のオーバーレイは表示されず、他の方法では有効だった、追加の列は無効になります。

利点: 追加でメモリを使用することは絶対になく、閲覧中にエクスプローラが遅くなることもありません。

欠点: ファイル・フォルダの状態情報は、エクスプローラに表示されません。作業コピーの変更点を見るには、「変更をチェック」 ダイアログを使用しなければなりません。

作業コピーのチェックアウトや、変更点のマージ、リポジトリブラウザの使用の際は常に、TortoiseSVN は直近に使用した URL を記録し、コンボボックスに提供します。時には URL がもう存在しなくなり、リストが散らかりますので、定期的に掃除するのに便利です。

コンボボックスに表示されている 1 項目だけを、その場で削除したい場合、下矢印をクリックしてコンボボックスを開き、削除したい項目にマウスをあわせて、Shift+Del を押してください。

TortoiseSVN は最近の入力したコミットログを保存しています。リポジトリごとに保存していますので、たくさんのリポジトリにアクセスする場合、極度に肥大化してしまうことがあります。

TortoiseSVN は、次回ログを参照した際の時間節約のため、ログ参照ダイアログが取得したログメッセージをキャッシュしています。メッセージがキャッシュされている状態で、他の誰かがログメッセージを編集した場合、キャッシュをクリアしないとその変更を参照できません。ログメッセージのキャッシュはダイアログ 1 タブで有効にできます。

多くのダイアログは、前回使用したときのサイズと画面内の位置を記憶しています。

Subversion サーバの認証を通れば、ユーザ名とパスワードを毎回入力しなくてもいいように、手元にキャッシュしています。セキュリティ上の理由や、リポジトリに別のユーザ名でアクセスするのにクリアしたいかもしれません……ジョンはあなたが彼の PC を使うのを知っていますか?

特定のサーバのみ、認証データをクリアしたければ、キャッシュデータの探し方について、認証項 をご覧ください。

TortoiseSVN は、進行ダイアログに書き込まれたすべてのログを保持しています。これは例えば、最近の更新コマンドで何が起きたのかをチェックしたいときに便利です。

ログファイルは長さを制限しており、大きくなりすぎたときには古い内容から破棄していきます。デフォルトでは 4000 行保持しますが、この数字はカスタマイズできます。

ここからログファイルの内容の確認や消去ができます。

ログデータが必要な時は常にログのキャッシュを有効にします。チェックすると、キャッシュが有効ならキャッシュからデータを取得します。キャッシュにメッセージがなければ、サーバから取得しキャッシュに追加します。

キャッシュを無効にすると、データを常にサーバから直接取得し、ローカルに保存しません。

オフラインで作業していたり、リポジトリサーバがダウンしていたりした場合でも、ログキャッシュを利用して、すでにキャッシュに保持したログメッセージを提供できます。もちろんキャッシュは最新の状態ではありませんから、この機能を使用するかどうかの選択肢があります。

サーバに接続せず、キャッシュからログデータを取得する際、ダイアログはオフライン状態であることをタイトルバーに表示します。

ログダイアログを表示する際、通常、新しいログメッセージをチェックするのにサーバに接続すると思います。ここでタイムアウトに 0 以外を指定したばあい、前回の接続からその秒数経過しているときだけ、サーバに接続します。頻繁にログダイアログを開き、サーバが遅い場合、これによりサーバとのやりとりを抑えることができますが、表示されるデータが完全に最新であるとは限りません。この機能を使用する場合は、折衷案として 300 (5 分) とするのをお勧めします。

コミットダイアログが表示される前に呼ばれます。フックスクリプトがバージョン管理下のファイルを変更したり、コミットするファイルのリストやコミットメッセージに影響を与える場合に使用してください。

コミットダイアログの OK をクリックした後、実際のコミットが始まる前に呼ばれます。

コミットが完了した後で (成功・失敗に関わらず) 呼ばれます。

リビジョンへの更新ダイアログが表示される前に呼ばれます。

Subversion の更新を実際に始める前に呼ばれます。

更新が完了した後で (成功・失敗に関わらず) 呼ばれます。

PATHMESSAGEFILECWD

PATHDEPTHMESSAGEFILECWD

PATHDEPTHMESSAGEFILEREVISIONERRORCWD

PATHCWD

PATHDEPTHREVISIONCWD

PATHDEPTHREVISIONERRORCWD

操作を開始したときのすべてのパスを格納した一時ファイルのパスです。各パスは、一時ファイル内に 1 行ごと格納されています。

コミット・更新が完了した際の深度です。

以下のような有効な値があります。

コミット用のログメッセージを格納しているファイルのパスです。このファイルには、UTF-8 エンコードのテキストが格納されています。start-commit フックの実行が完了すると、ログメッセージを読み返し、フックが変更する機会を与えます。

更新したりコミットが完了したときの、リポジトリのリビジョンです。

エラーメッセージを含むファイルのパスです。エラーがない場合、このファイルは空になります。

スクリプトを実行する現在の作業ディレクトリです。これはすべてに影響を与えるパスの、共通のルートディレクトリに設定されます。

TortoiseBlame は、ファイルにある行の歴史を背景色で表現できます。ここでは、最新と最古の色を指定して両端を設定でき、TortoiseBlame はこの 2 色を補間して、行ごとのリポジトリのリビジョンを表現します。

ここでは、テキストを表示するフォントとポイントサイズを指定できます。ここで指定したものを、ファイルの内容と、左ペインに表示する作者とリビジョンの両方に使用します。

ファイルの内容にタブ文字があった場合、空白を何文字使用して展開するかを定義します。

レジストリの HKCU\Software\TortoiseSVN\ConfigDir を使用して、Subversion 設定ファイルの場所を異なる場所に指定できます。これは TortoiseSVN のすべての動作に影響を与えます。

TSVNCache プログラムのキャッシュトレイアイコンを追加するため、HKCU\Software\TortoiseSVN\CacheTrayIcon に DWORD キーを値 1 で作成してください。これによりプログラムを作法に則って終了させます。そのため実際には開発者のみに有用です。

コミットメッセージエディタの自動補完リストには、コミットするファイル名が表示されます。この名前から拡張子を除くには、HKCU\Software\TortoiseSVN\AutocompleteRemovesExtensions にDWORD のキーを作成し、値を 1 としてください。

Windows エクスプローラの詳細ビューに表示する、TortoiseSVN が追加する列は、通常、作業コピーのみに有効です。作業コピーのみではなく、どこでもこの列を表示するには、HKCU\Software\TortoiseSVN\ColumnsEveryWhere に DWORD キーを作成し、値を 1 としてください。

別のブランチから、あるリビジョンをマージした際、マージ追跡情報が有効だと、そのリビジョン由来のログメッセージをまとめて、コミットログメッセージにします。変更するには、HKCU\Software\TortoiseSVN\MergeLogSeparator に SZ キーを作成し、お好みの文字列を設定してください。

TortoiseSVN は外部 diff ビューアを使用できます。しかし、ほとんどのそのようなビューアは注釈履歴 (注釈履歴の差分項) には対応していません。そのため、このような場合に TortoiseMerge にフォールバックしたくなるかと思います。それには、HKCU\Software\TortoiseSVN\DiffBlamesWithTortoiseMerge に DWORD キーを作成し、値を 1 としてください。