WinMergeのコマンドラインは、比較するパスに加えいくつかのパラメーターを受け付けます。これらのパラメーターのほとんどは、外部比較ツールとして使用したり、バッチファイルから比較操作を開始できるようにすることを目的としています。
WinMergeをコマンドラインから実行するには以下の書式のうちの1つを使用します:
WinMergeU [/?]
WinMergeU [/r] [/r-] [/e] [/f filter] [/m
compare-method] [/t
window-type] [/x] [/xq] [/s] [/sw] [/s-] [/ul] [/um] [/ur] [/u] [/wl] [/wm] [/wr] [/new] [/self-compare] [/clipboard-compare] [/minimize] [/maximize] [/fl] [/fm] [/fr] [/l
linenumber] [/c charpos] [/table-delimiter
delimiter] [/dl
leftdesc] [/dm
middledesc] [/dr
rightdesc] [/al] [/am] [/ar] [/noninteractive] [/noprefs] [/enableexitcode] [/ignorews] [/ignoreblanklines] [/ignorecase] [/ignoreeol] [/ignorecodepage] [/ignorecomments] [/unpacker
unpacker-name] [/prediffer
prediffer-name] [/cp
codepage] [/fileext
file-extension] [/cfg
name=value] [/inifile
inifile] leftpath [middlepath] rightpath [/o
outputpath] [/or
reportpath]
WinMergeU conflictfile
パラメーターなしかパス名を入力すると単にWinMergeウィンドウを開きます。パラメーターは、スラッシュ( / )
か、ダッシュ ( - ) 文字が前に付加されます。パス名にはプリフィックス文字を付加しません。
/?このトピックのWinMergeヘルプを開きます。
/rすべてのサブフォルダー内のすべてのファイルを比較します(再帰比較)。ユニークフォルダー (片方のみ存在するフォルダー)は、分離された項目として比較結果内にリストされます。サブフォルダーまで含めるとかなり比較時間が増大してしまうことに注意してください。このパラメーターを指定しなかった場合、WinMergeは比較するフォルダー内のファイルとトップレベルのサブフォルダーのみリストします。サブフォルダーの中までは比較しません。
/r-指定されたフォルダー内のすべてのファイルを比較しますが、そのサブフォルダー内のファイルとサブフォルダーは除外します。これにより、比較時間を短縮することができます。
/eEscキーでWinMergeが閉じるようにします。WinMergeを外部比較アプリケーションとして使用する場合に便利です。(ダイアログのようにすばやくWinMergeを閉じることができます) この引数を指定しなかった場合、すべてのウインドウを閉じるのに何回もEscキーを押さなければならないことになるかもしれません。(2つ以上タブが開かれている場合、一回のESCキーの押下でWinMergeが終了してしまうのを期待している人はいないような気がしたので、日本語版ではこのオプションを指定しても2つ以上タブが開かれている場合は1つのタブを閉じるだけにし、タブが1つの時またはタブが一つもない時にWinMergeを終了するようにしました)
/f比較を制限するために、指定したフィルターを適用します。フィルターは*.h
*.cppXML/HTML
Develのようなファイルフィルターの名前です。スペースを含むフィルターマスクやフィルター名はダブルクォーテーションマークで括ってください。
/m compare-methodフォルダー比較方法を指定します。次のキーワードが指定できます。Full,
Quick, Binary,
Date, SizeDate,
Size
/t window-typeファイルを表示するウィンドウの種類を指定します。次のキーワードが指定できます。 Text,
Table, Binary,
Image, Webpage
/x同一ファイルの比較をしたときにWinMergeを閉じます。(情報ダイアログを表示した後) このパラメーターは比較後に効果がなくなります。例えば、もしファイルがマージか編集の結果として同一となった場合です。このパラメーターは、WinMergeを外部アプリケーションとして使用したり、差異のないファイルを無視することによって余分なステップを取り除きたい場合に便利です。
/xqオプション /x に似ていますが、同一ファイルであってもメッセージボックスを表示しません。
/sWinMergeウィンドウを1つのインスタンスに制限します。例えば、WinMergeが既に実行中ならば、新しい比較は同じインスタンス内で実行されます。この引数を指定しなかった場合、複数のウィンドウが開かれる可能性があります: 設定によっては、新しい比較が既に存在するウィンドウで実行されることも新しいウィンドウで実行されることもあります。
/sw/s と同様にWinMergeウィンドウを1つのインスタンスに制限します。ただし、ウインドウを表示しているインスタンスが終了するまで待機します。
/s-"複数のインスタンスを起動しない"の設定値を無視して、常に別のインスタンスが起動されるようにします。
/ul左側パスが最近使用した項目(MRU)リストに追加されるのを防ぎます。外部アプリケーションは、ファイルまたはフォルダーの選択ダイアログのMRUリストにパスを追加するべきではありません。
/um中央のパスが最近使用した項目(MRU)リストに追加されるのを防ぎます。外部アプリケーションは、ファイルまたはフォルダーの選択ダイアログのMRUリストにパスを追加するべきではありません。
/ur右側パスが最近使用した項目(MRU)リストに追加されるのを防ぎます。外部アプリケーションは、ファイルまたはフォルダーの選択ダイアログのMRUリストにパスを追加するべきではありません。
/u(または/ub)
各々(左、右、中央)のパスが最近使用した項目(MRU)リストに追加されるのを防ぎます。外部アプリケーションは、ファイルまたはフォルダーの選択ダイアログのMRUリストにパスを追加するべきではありません。
/wl読み取り専用として左側を開きます。比較時、左側を変更したくない場合に使用してください。
/wm読み取り専用として中央を開きます。比較時、中央を変更したくない場合に使用してください。
/wr読み取り専用として右側を開きます。比較時、右側を変更したくない場合に使用してください。
/new新規ブランクウィンドウを開きます。
/self-compare指定された１つのファイルとそのファイルのコピーを比較します。
/clipboard-compareクリップボード履歴の直近2つの内容を比較します。
/minimize最小化状態でWinMergeを開始します。このオプションは長時間かかる比較を行う場合に便利です。
/maximize最大化状態でWinMergeを開始します。
/fl起動時、左側にフォーカスを当てます。
/fm起動時、中央にフォーカスを当てます。
/fr起動時、右側にフォーカスを当てます。
/l linenumberファイルを読み込んだ後にジャンプする行番号を指定します。
/c charposファイルを読み込んだ後にジャンプする文字位置を指定します。
/table-delimiter delimiterテーブル編集用の区切り文字を指定します。タブ文字を指定する場合、「tab」または「\t」、「\x09」を指定してください。
/dl左側タイトルバーの説明を指定します。デフォルトのフォルダーやファイル名テキストに上書きされます。例: /dl "Version
1.0" や /dl
WorkingCopy. スペースを含む説明はダブルクォーテーションマークで括ってください。
/dm/dlと同様に中央タイトルバーの説明を指定します。
/dr/dlと同様に右側タイトルバーの説明を指定します。
/al起動時、左側で自動マージします。
/am起動時、中央で自動マージします。
/ar起動時、右側で自動マージします。
/noninteractiveTBD
/noprefsTBD
/enableexitcode比較結果をプロセス終了コードに設定します。0: 同一, 1: 差異あり, 2: エラー
/ignorewsTBD
/ignoreblanklinesTBD
/ignorecaseTBD
/ignoreeolTBD
/ignorecodepageTBD
/ignorecommentsTBD
/unpackerTBD
/predifferTBD
/cpTBD
/fileext file-extensionシンタックスハイライトの種類を決定するため、ファイル拡張子を指定します。
/cfgTBD
leftpath左側で開くフォルダーやファイルを指定します。
middlepath中央で開くフォルダーやファイルを指定します。
rightpath右側で開くフォルダーやファイルを指定します。
WinMergeは、ファイルとフォルダーを比較できません。そのためパスパラメーター両方(または3つすべて)(leftpathmiddlepathrightpath
ファイル比較では、パスパラメーターの一つとしてフォルダー名を指定できます。ただし、フォルダーは他方のファイル名と同じファイルを含んでいる必要があります。
例えば、以下のコマンドを考えます:
WinMergeU C:\Folder\File.txt C:\Folder2
もし、C:\Folder2がファイル名File.txtを含んでいれば、WinMergeは、暗黙的にファイル指定として第二のパスを解決します。当然ながら、C:\Folder2がファイル名File.txtを含んでいなければ、コマンドは不正とみなされます。
/o outputpathマージした結果のファイルを保存するオプションの出力ファイルパスを指定します。
出力パスはコマンドラインからWinMergeを開始する時まれにしか必要となりません。それはバージョンコントロールツールとともに使用されることになります。結果ファイルとして出力パスを指定する必要があるかもしれません。もし、出力パスを指定した場合、あるペインを変更後保存すると、変更は出力パスのファイルに保存され、元ファイルは前の状態のままになります。
バージョンコントロールシステムは一般的にtheirsやmine、mergedかまたはresolvedのような用語を使用し元と結果ファイルを参照します。もし、WinMergeコマンドラインに出力パスを指定し、バージョンコントロールシステムと連携するならば、この順番でファイルを並べるべきです。
/orTBD
conflictfileコンフリクトファイルを指定します。コンフリクトファイルは通常バージョンコントロールシステムによって生成されます。コンフリクトファイルはファイル比較ウインドウで開かれ、「コンフリクトファイルの解決」で説明している様にマージやコンフリクトを解決することができます。コンフリクトファイルと共に他のパスは使用できないことに注意してください。
/inifile inifileレジストリの代わりに設定の読み込みと保存に使用するINIファイルを指定します。