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

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

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

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

共通無視パターンはバージョン管理外のファイルを、コミットダイアログなどに表示しないようにするのに使用します。パターンにマッチしたファイルはインポートでも無視されます。除外するファイルやディレクトリは、名前や拡張子で判断します。パターンは空白で区切り、bin obj *.bak *.~?? *.jar *.[Tt]mp のようにします。このパターンにはパス区切り文字が必要ありません。ファイルとディレクトリを区別する方法はないことに注意してください。パターンマッチの文法といった詳細情報は、「無視リストでのパターンマッチ」 をご覧ください。

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

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

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

Subversion 設定ファイルを直接編集するには 編集 を使用してください。いくつかの設定は TortoiseSVN では直接変更することができないため、その場合にこれが必要です。Subversion の config ファイルについての詳細情報は、Runtime Configuration Area をご覧ください。Automatic Property Setting の節には興味深い項目があり、これはここで設定します。Subversion は複数の設定情報を読み込めますが、その優先順位を知っておかなくてはならないことに注意してください。詳細は Configuration and the Windows Registry を参照してください。

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

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

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

リビジョングラフは、トランク、ブランチ、タグを見分けることで、リポジトリを明確に可視化しようとします。これは Subversion に組み込まれた分類ではなく、パス名から抽出した情報です。デフォルト設定では、Subversion のドキュメントで推奨されている英語名規約ですが、もちろんあなたの使い方はことなるかもしれません。

みっつの矩形で表すパスを、認識するため使用するパターンを指定してください。パターンは大文字小文字を区別しませんが、小文字で書いてください。* や ? といったワイルドカードはいつものように使用できます。また、; で複数のパターンを区切ってください。マッチングに使用されてしまうため、余計な空白は含めないでください。

リビジョングラフで、ノードタイプ (つまり追加、削除、名前変更といったノード) を表すのに使用する色です。ノードの分類を識別するため、ノードタイプと分類の両方を表示するよう、リビジョングラフに色をませるよう指示できます。このチェックが付いていないと、ノードタイプを表すためだけに色を使用します。使用するそれぞれの色を指定するには、色選択ダイアログを使用してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

時には、すべてのリポジトリが同じ URL を使用するサーバに、接続しなければならないかもしれません。svnbridge の旧バージョンではこうなるでしょう。そのようなリポジトリにアクセスする必要がある場合、このオプションをチェックする必要があります。そうでなければ、性能向上のため、チェックしないままにしてください。

いくつかのホスティングサービスでは、すべてのリポジトリが同じ UUID を与えます。また、自分のリポジトリフォルダをコピーして新しいリポジトリを作成、のようなことさえしたかもしれません。さまざまな理由でこれはまずい考えです。UUID は一意でなければなりません。しかし、このチェックボックスをチェックすると、そのような状況でもログキャッシュが動作します。必要なければ、性能向上のため、チェックしないままにしてください。

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

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

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

たくさんのリポジトリをブラウズすると、たくさんのログキャッシュを蓄積することになります。そのリポジトリを頻繁に使用しなければ、キャッシュが大きくふくらむことはありません。そのため、TortoiseSVN はデフォルトで、ここにセットした時間後にキャッシュを削除します。キャッシュの削除を制御するのに、この項目を使用してください。

大きなキャッシュの再取得は、より負荷が高くなります。そのため、TortoiseSVN は小さなキャッシュしか削除しません。この値で、適切な閾値を調節してください。

時折、キャッシュに何か障害が発生し、それが元でクラッシュすることがあります。これが発生すると、問題の再発防止のため、通常自動的にキャッシュを削除します。それほど安定していない、ナイトリービルドを使用する場合、とにかくキャッシュを保持するため、これを選択できます。

コミットダイアログを表示する前に呼ばれます。フックがバージョン管理下のファイルを変更したり、コミットするファイルのリストやコミットメッセージに影響を与える場合に使用してください。しかし、初期の段階でフックが呼ばれるため、コミット用に選択したオブジェクトの全リストは有効でないことに注意するべきです。

コミットダイアログの 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 で作成してください。これによりプログラムを作法に則って終了させます。そのため実際には開発者のみに有用です。

シェル拡張から TortoiseProc.exe に渡されたコマンドラインパラメータを表示するには、HKCU\Software\TortoiseSVN\Debug に DWORD のキーを作成し、値を 1 としてください。

これは Windows エクスプローラ以外のものを使用したり、コンテキストメニューが正しく表示できないといった問題が発生したりしたときに便利です。TortoiseSVN にシェルのコンテキストメニューのアイコンを表示させたくない場合、HKCU\Software\TortoiseSVN\ShowContextMenuIcons に DWORD のキーを値 0 で作成してください。またアイコンを表示する場合は、この値を 1 としてください。

他の TortoiseSVN コマンド (更新、コミットなど) を実行している間、エクスプローラの状態オーバーレイアイコンを更新したくない場合、HKCU\Software\TortoiseSVN\BlockStatus に DWORD のキーを作成し、値を 1 としてください。

HKCU\Software\TortoiseSVN\UpdateCheckURL には TortoiseSVN の更新があった場合にダウンロードするテキストファイルの URL が格納されています。必要に応じて HKCU を HKLM に変更することもできますが、HKLM の設定を HKCU は上書きしてしまいます。企業の管理者が承認するまで TortoiseSVN の更新をさせないようにするのに便利だと思います。

コミットメッセージエディタの自動補完リストには、コミットするファイル名が表示されます。この名前から拡張子を除くには、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 としてください。

ログダイアログでは、ファイルのログを表示する際、現在の作業コピーのリビジョンを強調しています。フォルダに対して同じことをするには、作業コピーに対してクロールしなければなりませんが、作業コピーが大きいと、この操作に時間がかかります。この機能を有効にするには、HKCU\Software\TortoiseSVN\RecursiveLogRev に DWORD のレジストリキーを、作成しなければなりません。0 に設定するとこの機能を無効にします (フォルダの強調なし)。1 (デフォルト) に設定すると、状態を再帰的に取得します (作業コピーツリーの最新リビジョンを検索)。2 に設定すると、選択したフォルダ自体のリビジョンをチェックしますが、子項目のチェックはしません。

デフォルトでは、インポート直後など、既存のフォルダ構造上に作業コピーをチェックアウトすると、リポジトリの内容と差異がある既存の項目は上書きされず、変更マークが付きます。コミットの際には、このローカルの内容がリポジトリに送信されることになります。ふたりの人が同じファイルを追加した場合、後でコミットした方がオリジナルバージョンを上書きしてしまわないように、既存の内容と差異がある場合は、チェックアウトが失敗するべきだと思う人々もいます。この例のように強制的にチェックアウトが失敗するようにする場合、HKCU\Software\TortoiseSVN\AllowUnversionedObstruction に DWORD レジストリキーを 値 0 で作成しなければなりません。