第5章 日常操作ガイド

目次

さぁはじめましょう
アイコンオーバーレイ
コンテキストメニュー
ドラッグ & ドロップ
共通のショートカット
認証
ウィンドウの最大化
リポジトリへのデータインポート
インポート
その場でインポート
特殊ファイル
参照プロジェクト
作業コピーのチェックアウト
チェックアウトの深さ
変更点をリポジトリにコミット
コミットダイアログ
変更リスト
コミット一覧からの項目の除外
コミットログメッセージ
コミットの進行状況
他人の修正に伴う作業コピーの更新
競合の解消
ステータス情報取得
アイコンオーバーレイ
Windows エクスプローラの TortoiseSVN 列
こちらの状態とあちらの状態
差分表示
変更リスト
リビジョンログダイアログ
リビジョンログダイアログの起動
リビジョンログのアクション
追加情報の取得
詳細なログメッセージの取得
マージ追跡機能
ログメッセージや作者の変更
ログメッセージのフィルタリング
統計情報
オフラインモード
表示の更新
差分の参照
ファイルの差分
改行コードと空白のオプション
フォルダの比較
TortoiseIDiff を使用した画像の差分
外部 Diff/Merge ツール
ファイルやディレクトリの追加
ファイル・フォルダのコピー・移動・名前変更
無視するファイルとディレクトリ
無視リストでのパターンマッチ
削除・移動・名前の変更
ファイル・フォルダの削除
ファイルやフォルダの移動
ファイル名の大文字小文字の変換
ファイル名の大文字小文字が競合した場合の対処
ファイルの名前変更の修復
バージョン管理外フォルダの削除
変更の取り消し
クリーンアップ
プロジェクト設定
Subversion の属性
TortoiseSVN のプロジェクト属性
ブランチ・タグ付け
ブランチ・タグの作成
チェックアウトするか切り替えるか...
マージ
リビジョン範囲のマージ
ブランチの再統合
2 つの異なるツリーをマージする
マージオプション
マージ結果のレビュー
マージ追跡
マージ中に発生した競合の扱い
Merge a Completed Branch
ロック
Subversion でロックがどのように働くか
ロックの取得
ロックの解除
ロック状態のチェック
ロックしていないファイルを読み込み専用にするには
ロックのフックスクリプト
パッチの作成及び適用
パッチファイルの作成
パッチファイルの適用
誰がその行を変更したか?
ファイルの注釈履歴
注釈履歴の差分
リポジトリブラウザ
リビジョングラフ
リビジョングラフのノード
表示の変更
グラフの利用
表示の更新
Subversion 作業コピーをエクスポート
作業コピーをバージョン管理外へ
作業コピーの再配置
バグ追跡システム / 課題追跡システムとの統合
ログメッセージの課題番号付与
課題追跡システムからの情報取得
Web ベースリポジトリビューアとの統合
TortoiseSVN の設定
一般設定
アイコンオーバレイ設定
ネットワーク設定
外部プログラムの設定
保存データの設定
ログのキャッシュ
クライアント側フックスクリプト
TortoiseBlame の設定
レジストリの設定
Subversion の作業フォルダ
最終ステップ

このドキュメントは TortoiseSVN クライアントの日々の使い方を説明しています。バージョン管理システムの解説ではなく、Subversion (SVN) の解説でもありません。だいたい何をしたいか分かっているなら、調べる場所として便利ですが、どのように行うかは全く思い出させてくれません。

Subversion でのバージョン管理の解説が必要なら、Version Control with Subversion というすばらしい本をお薦めします。

このドキュメントは、TortoiseSVN や Subversion と同様、現在もまだ作成中です。間違いがあったら私たちが修正できるよう、メーリングリストに投稿してください。日常操作ガイド (DUG) のスクリーンショットの中には、現在のソフトウェアの状態を反映していないものがあるかもしれません。ご容赦ください。TortoiseSVN の作業は空いた時間でしているのです。

日常操作ガイドを最大限に活用するには、以下を前提としています。

  • すでに TortoiseSVN をインストールしてあることを前提にします。

  • バージョン管理システムになじみがあることを前提にします。

  • Subversion の基本を知っていることを前提にします。

  • サーバのセットアップを行っているかどうかして、Subversion のリポジトリにアクセスできることを前提にします。

さぁはじめましょう

アイコンオーバーレイ

図 5.1. エクスプローラのアイコンオーバーレイ表示

エクスプローラのアイコンオーバーレイ表示


TortoiseSVN の目立つ機能に、作業コピーのファイルに現れるアイコンオーバーレイがあります。これにより、ファイルが変更されているかどうかが一目瞭然となります。オーバーレイが表現する内容については アイコンオーバーレイ項をご覧ください。

コンテキストメニュー

図 5.2. バージョン管理下のディレクトリに対するコンテキストメニュー

バージョン管理下のディレクトリに対するコンテキストメニュー


すべての TortoiseSVN コマンドは、Windows エクスプローラのコンテキストメニューから呼び出されます。ファイルやフォルダを 右クリック すると、ほとんどは直接見えています。ファイルやフォルダであるかどうか、その親フォルダがバージョン管理下にあるかどうかでそのコマンドは有効になります。TortoiseSVN メニューを、エクスプローラのファイルメニューの一部としても見ることができます。

ティップ

ほとんど使用しないようなコマンドは、拡張コンテキストメニューでのみ使用できます。拡張コンテキストメニューを表示するには、Shift キーを押したまま、右クリック してください。

いくつかの場合、TortoiseSVN エントリを、複数眼にするかもしれません。これはバグではありません!

図 5.3. バージョン管理フォルダでショートカットする、エクスプローラのファイルメニュー

バージョン管理フォルダでショートカットする、エクスプローラのファイルメニュー


この例では、バージョン管理下のフォルダ内にバージョン管理外のショートカットがある場合、エクスプローラのファイルメニューに TortoiseSVN のエントリが 3 つ あります。ひとつはフォルダ用、ひとつはショートカットそのもの用、最後にショートカットが指し示すオブジェクト用です。以上を見分けるのに、ファイル、フォルダ、ショートカットのメニューエントリか、複数選択した項目かに関係なく、アイコンの右下にマークがつきます。

Windows 2000 を使用している場合、コンテキストメニューはテキストのみとなり、メニューアイコンがつきません。以前のバージョンでは動作していましたが、Microsoft が Vista 用にアイコンハンドラの動作を変更したため、別の表示方法をとらねばならず、申し訳ありませんが Windows 2000 では動作しなくなりました。

ドラッグ & ドロップ

図 5.4. バージョン管理下のディレクトリに対する右ドラッグメニュー

バージョン管理下のディレクトリに対する右ドラッグメニュー


作業コピーの中にファイルやフォルダを 右ドラッグ したり、バージョン管理下のディレクトリにバージョン管理外のファイルやフォルダを 右ドラッグ すると、そのドラッグハンドラによって他のコマンドが有効になります。

共通のショートカット

共通の操作は Windows のショートカット出よく知られたものですが、ボタンに表示されるわけではありませんし、メニューもありません。行き詰まってしまったら、リフレッシュを兼ねてここをチェックしてみてください。

F1

もちろんヘルプです。

F5

現在の表示を最新の情報に更新します。もしかしたら、最も便利な 1 キーコマンドかもしれません。例えば……エクスプローラでは、作業コピーのアイコンオーバーレイを更新します。コミットダイアログでは作業コピーを再走査し、コミットが必要なファイルを探します。リビジョンログダイアログではリポジトリに再接続し、最新の変更をチェックします。

Ctrl-A

すべて選択します。エラーメッセージが出て email にコピー & ペーストしたいときに使用できます。Ctrl-A でエラーメッセージを選択し……

Ctrl-C

……選択した文字列をコピーします。

認証

アクセスしようとしているリポジトリがパスワードで保護されている場合、認証ダイアログが表示されます。

図 5.5. 認証ダイアログ

認証ダイアログ


ユーザ名とパスワードを入力してください。TortoiseSVN が証明書を Subversion のデフォルトディレクトリ (%APPDATA%\Subversion\auth) にある、以下の 3 つのサブディレクトリに格納するかどうかチェックボックスで指定できます。

  • svn.simple には BASIC 認証 (ユーザ名/パスワード) の証明書があります。

  • svn.ssl.server には SSL サーバ証明書があります。

  • svn.username には、(パスワードがいらない) ユーザ名のみの認証用の証明書があります。

全サーバの認証キャッシュをクリアしたければ、TortoiseSVN 設定ダイアログの保存データ ページから行えます。このボタンで、以前のバージョンでレジストリに格納した認証情報と同様に、Subversion の auth ディレクトリからキャッシュされた認証データをクリアします。保存データの設定項 をご覧ください。

サーバの認証やアクセスコントロールのセットアップ方法について詳細な情報は、第3章 を参照してください。

ウィンドウの最大化

TortoiseSVN のダイアログの多くは、大量の情報を表示します。しかし画面全体の最大化よりも、縦方向の最大化や、横方向の最大化が便利なことがあります。