すべての TortoiseSVN のコマンドがコマンドライン引数で制御できます。バッチファイルで自動化したり、テキストエディターなどの他のプログラムから、特定のコマンドやダイアログを起動したりすることができます。
TortoiseSVN はあくまで GUI クライアントです。ここでは TortoiseSVN のダイアログを表示させて、ユーザーに入力を促す方法を説明します。入力を伴わずに操作をするスクリプトを書くのであれば、公式の Subversion コマンドラインクライアントを使用してください。
TortoiseSVN の GUI プログラムは TortoiseProc.exe から呼び出します。実行するコマンドは /command:<コマンド名> 引数で指定し、 <コマンド名> の部分にはコマンド名を指定します。ほとんどのコマンドでは /path:"<パス名>" 引数でパスを指定する必要があります。下記の表で、 /command:<コマンド名> で指定するコマンドと、 /path:"<パス名>" で指定するパスの意味を説明します。
There's a special command that does not require the parameter /command:abcd but, if nothing is specified on the command line, starts the project monitor instead. If /tray is specified, the project monitor starts hidden and only adds its icon to the system tray.
コマンドによっては、複数の対象のパスを受け付けます（例えば、コミット時に複数のファイルを指定する場合など）。 /path 引数には * で区切って複数のパスを指定することができます。
改行で区切った複数のパスを記述したファイルで指定することもできます。ファイルはUTF-16形式で、BOM を入れないでください。ファイルを渡したい場合は、/pathではなく/pathfileを使用してください。コマンド実行後にTortoiseProcがファイルを自動削除するようにしたい場合は、/deletepathfileを使用してください。/deletepathfileを指定しない場合、手作業でファイルを削除しなければファイルは残ります。
多くのコマンド（コミットや更新など）で表示される進行ダイアログは、通常はコマンドが終了した後も ボタンを押すまで開いたままになります。設定ダイアログで進行ダイアログを自動的に閉じるように設定することができます。ただしこの場合、コマンドをバッチファイルから起動しても、 TortoiseSVN コンテキストメニューから起動しても、進行ダイアログが閉じるようになります。
/configdir:"<設定ファイルのディレクトリのパス>" を指定すると、異なる場所にある設定ファイルを指定することができます。この引数は、レジストリで設定されているデフォルトパスを上書きします。
/closeonend 引数を指定すると、設定を変更することなくコマンド終了時に進行ダイアログを自動で閉じることができます。
/closeonend:0 ダイアログを自動的に閉じません。
/closeonend:1 エラーがなければ自動的に閉じます。
/closeonend:2 エラーや競合がなければ自動的に閉じます。
/closeonend:3 エラー、競合、マージがなければ自動的に閉じます。
エラーや競合がない場合にローカル操作の進行ダイアログを自動的に閉じるには、 /closeforlocal 引数を指定してください。
以下の表には、 TortoiseProc.exe のコマンドラインで使用してアクセスすることができる、すべてのコマンドを一覧しています。上で述べたように、 /command:<コマンド名> の形で使用してください。この表では紙面を節約するため、頭に付ける /command は省略しています。
表D.1 使用できるコマンドとオプションの一覧
| コマンド | 説明 |
|---|---|
| :about | 「バージョン情報」ダイアログを表示します。コマンドが省略された場合もバージョン情報ダイアログを表示します。 |
| :log |
ログダイアログを開きます。
An svn date revision can be in one of the following formats:
|
| :checkout | 「チェックアウト」ダイアログを開きます。 /path でチェックアウト先のディレクトリを指定します。 /url でチェックアウト元の URL を指定します。 /blockpathadjustments を指定すると、チェックアウトパスの自動調整を抑制します。 /revision:XXX でチェックアウトするリビジョンを指定します。 |
| :import | 「インポート」ダイアログを開きます。 /path でインポートするデータのディレクトリを指定します。 /logmsg 引数で、ログメッセージの初期値を指定できます。また、 /logmsgfile:<パス> でファイルからログメッセージの初期値を指定することもできます。この場合、 <パス> でログメッセージの入ったファイルの場所を指定します。 |
| :update | /path で指定した作業コピーを HEAD リビジョンに更新します。 /rev を指定すると、どのリビジョンに更新するかをユーザーに確認するダイアログを表示します。ダイアログを表示しないようにするには、 /rev:1234 のようにリビジョン番号を指定してください。その他のオプションとして /nonrecursive や /ignoreexternals や /includeexternals があります。 /stickydepth を指定すると、部分的なチェックアウトを行う際に、深さが固定されます。 /skipprechecks を指定すると、更新前に行われるすべての検査を行いません。これを指定すると ログを表示 ボタンが無効になり、更新後に差分のコンテキストメニューも無効になります。 |
| :commit | コミットダイアログを開きます。 /path でコミットするディレクトリやファイルのリストを指定します。 /logmsg でログメッセージを初期値を指定できます。また、 /logmsgfile:<パス> でログメッセージの初期値をファイルで指定することもできます。この場合、 <パス> でログメッセージの入ったファイルの場所を指定します。バグ追跡システムとの統合が正しく設定されている場合、 /bugid:"<バグ ID>" でバグ ID ボックスの値を設定することができます。 |
| :add | /path で指定されたファイルをバージョン管理に追加します。 |
| :revert | 作業コピーで行った変更を取り消します。 /path で取り消す項目を指定します。 |
| :cleanup | /path で指定された作業コピーの、中断されたり失敗したりした操作をクリーンアップし、作業コピーのロックを解除します。 /noui を指定すると、（クリーンアップの終了を通知したりエラーを表示したりする）ポップアップダイアログを抑制します。 /noprogressui を指定すると、進行状況ダイアログの表示も抑制します。 /nodlg を指定すると、ユーザーがクリーンアップ処理の内容を選択するためのダイアログを表示しません。クリーンアップ時の動作は、 /cleanup、 /revert、 /delunversioned、 /delignored、 /refreshshell、 /externals で指定することができます。 |
| :resolve | /path で指定した競合ファイルを解決済みにします。 /noquestion を指定すると、本当に行ってもよいか確認せずに解決済みにします。 |
| :repocreate | /path にリポジトリを作成します。 |
| :switch | 切り替えダイアログを開きます。/pathで切り替えるディレクトリ、/urlで切り替え先のURLを指定します。 |
| :export | /path で指定された作業コピーを別のディレクトリにエクスポートします。 /path でバージョン管理外ディレクトリを指定すると、ダイアログが表示されて /path で指定されたディレクトリにエクスポートする URL を尋ねてきます。 /blockpathadjustments を指定すると、パスの自動調整を抑制します。 |
| :dropexport | 作業コピーを /path から /droptarget で指定されたディレクトリにエクスポートします。このコマンドでは、エクスポートダイアログを表示せずに直接実行します。 /overwrite を指定すると、既存のファイルを確認なしで上書きします。 /autorename を指定すると、ファイルが既に存在するとき、上書きせずにエクスポートされたファイルの名前を自動的に変更します。/extendedオプションは、localchangesと共に指定すると、ローカルで変更されたファイルのみをエクスポートし、unversionedと共に指定すると、それに加えてバージョン管理されていない項目もすべてエクスポートします。 |
| :dropvendor | /path で指定されたフォルダーを、 /droptarget で指定されたディレクトリに再帰的にコピーします。ターゲットの作業コピーに対して、新しいファイルは自動的に追加され、見つからないファイルは削除され、基本的にコピー元とコピー先は全く同じになります。 |
| :merge | マージダイアログを開きます。/path にはターゲットディレクトリを指定します。マージするリビジョン範囲は、 /fromurl:URL, /revrange:string のオプションを使用できます。2つのリポジトリツリーをマージするには、 /fromurl:URL, /tourl:URL, /fromrev:xxx, /torev:xxx のオプションを使用できます。 |
| :mergeall | 「すべてマージ」ダイアログを開きます。 /path で対象ディレクトリを指定します。 |
| :copy | ブランチ/タグダイアログを開きます。/pathでブランチ/タグの作成元の作業コピーを指定します。また、/urlは作成先のURLです。 URLが^で始まる場合は、リポジトリのルートからの相対URLとみなされます。新しいブランチ/タグへ作業コピーを切り替えオプションを既定でチェックしておきたい場合は、/switchaftercopyを指定してください。中間フォルダーを作成オプションをチェックするには、/makeparentsスイッチを指定してください。/logmsgでログメッセージの初期値を指定できます。また、コマンドラインでログメッセージを渡したくない場合は、/logmsgfile:<パス>を使用します。<パス>でログメッセージが入ったファイルの場所を指定します。 |
| :settings | 設定ダイアログを開きます。 |
| :remove | /path で指定されたファイルをバージョン管理下から削除します。 |
| :rename | /path で指定されたファイルの名前を変更します。このファイルの新しい名前を入力するダイアログが表示されます。一度に同様のファイルの名前の変更を行う際、確認を行わないようにするには、 /noquestion を指定してください。 |
| :diff | TortoiseSVNの設定で指定された外部差分ビューアーを起動します。/pathには1番目のファイルを指定します。/path2オプションを指定すると、その2つのファイルに対して差分ビューアーが起動します。/path2を省略すると、/pathで指定されたファイルとその作業ベースの間の差分となります。指定されたファイルにプロパティの変更がある場合は、変更された各プロパティについても外部差分ビューアーが起動されます。これを防ぐには、/ignorepropsを指定してください。リビジョン番号を指定するには、/startrev:xxxや/endrev:xxxを指定してください。ペグリビジョンを指定する場合は、/pegrevision:xxxを指定してください。/blameを指定して/path2を指定しない場合、指定されたリビジョンのファイルの注釈履歴が表示されます。 /line:xxxを指定すると、差分を表示するときにその行番号にジャンプします。 |
| :showcompare |
指定されたURLのプロパティの変更があった場合、変更された各プロパティについても外部差分ビューアーが起動します。これを避けるには、 |
| :conflicteditor | /path の競合ファイルを編集するために、 TortoiseSVN の設定ダイアログで指定した競合エディターを起動します。 |
| :relocate | 再配置ダイアログを表示します。 /path には、再配置する作業コピーのパスを指定します。 |
| :help | ヘルプファイルを開きます。 |
| :repostatus | 「変更をチェック」ダイアログを開きます。 /path には作業コピーのディレクトリを指定します。 /remote を指定すると、ユーザーが リポジトリをチェック ボタンを押したときのように、直ちにリポジトリにアクセスを開始します。 |
| :repobrowser |
|
| :ignore | /path で指定されたすべての対象を無視リストに追加します。つまり svn:ignore プロパティにそのファイルを追加します。 |
| :blame |
|
| :cat | /path で指定した URL や作業コピーのパスのファイルを、 /savepath:path で指定した場所に保存します。 /revision:xxx でリビジョンを指定できます。指定したリビジョンのファイルを取得するのに使用できます。 |
| :createpatch | /path で指定されたパスのパッチファイルを作成します。「名前を付けて保存」ダイアログをスキップする場合は、 /savepath:path でパッチファイルを保存するディレクトリのパスを指定してください。パッチファイルを統合差分ビューアーで表示する場合は、 /noview を指定してください。 |
| :revisiongraph |
グラフウィンドウを表示せずに、特定のパスのリビジョングラフのイメージファイルを作成する場合には、 リビジョングラフは、表示方法を設定するための多くのオプションがあり、出力イメージファイルを作成するときにこれらのオプションを設定できます。オプションは |
| :lock | /path で指定したファイルや、指定したディレクトリにあるすべてのファイルをロックします。ロック時のコメントを入力するよう「ファイルをロック」ダイアログを表示します。 |
| :unlock | /path で指定したファイルや、指定したディレクトリにあるすべてのファイルのロックを解除します。 |
| :rebuildiconcache | Windows のアイコンキャッシュを再生成します。Windows のアイコンが破損したときのみ使用してください。（避けられない）副作用として、デスクトップのアイコンが再配置されてしまうことがあります。メッセージボックスの表示を抑制するには、 /noquestion を指定してください。 |
| :properties |
このコマンドでバージョン管理されたプロパティを扱う場合は、作業コピーを指定する必要があります。
特定のプロパティのプロパティダイアログを直接開く場合は、プロパティ名を |
| :sync |
Exports/imports settings, either depending on whether the current settings or the exported settings are newer, or as specified. If a path is passed with The parameter If neither If If The parameter |
コマンドの例（1行で入力してください）
TortoiseProc.exe /command:commit
/path:"c:\svn_wc\file1.txt*c:\svn_wc\file2.txt"
/logmsg:"ログメッセージのテスト" /closeonend:0
TortoiseProc.exe /command:update /path:"c:\svn_wc\" /closeonend:0
TortoiseProc.exe /command:log /path:"c:\svn_wc\file1.txt"
/startrev:50 /endrev:60 /closeonend:0