WinMergeのコマンドラインは、比較するパスに加えいくつかのパラメーターを受け付けます。 これらのパラメーターのほとんどは、外部比較ツールとして使用したり、バッチファイルから比較操作を 開始できるようにすることを目的としています。
WinMergeをコマンドラインから実行するには以下の書式のうちの1つを使用します:
WinMergeU
[/?
]
WinMergeU
[/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は比較するフォルダー内のファイルとトップレベルのサブフォルダーのみリストします。 サブフォルダーの中までは比較しません。
/e
EscキーでWinMergeが閉じるようにします。 WinMergeを外部比較アプリケーションとして使用する場合に便利です。 (ダイアログのようにすばやくWinMergeを閉じることができます) この引数を指定しなかった場合、すべてのウインドウを閉じるのに何回もEscキーを 押さなければならないことになるかもしれません。(2つ以上タブが開かれている場合、一回のESCキーの押下でWinMergeが終了してしまうのを期待している人はいないような気がしたので、日本語版ではこのオプションを指定しても2つ以上タブが開かれている場合は1つのタブを閉じるだけにし、タブが1つの時またはタブが一つもない時にWinMergeを終了するようにしました)
/f
比較を制限するために、指定したフィルターを適用します。
フィルターは
のようなファイルマスクか、
*.h
*.cpp
XML/HTML Devel
のようなファイルフィルターの名前です。
スペースを含むフィルターマスクやフィルター名はダブルクォーテーションマークで括ってください。
/m compare-method
フォルダー比較方法を指定します。
次のキーワードが指定できます。Full
,
Quick
, Binary
,
Date
, SizeDate
Size
/t window-type
ファイルを表示するウインドウの種類を指定します。
次のキーワードが指定できます。 Text
,
Table
, Binary
,
Image
, Webpage
/x
同一ファイルの比較をしたときにWinMergeを閉じます。 (情報ダイアログを表示した後) このパラメーターは比較後に効果がなくなります。 例えば、もしファイルがマージか編集の結果として同一となった場合です。 このパラメーターは、WinMergeを外部アプリケーションとして使用したり、 差異のないファイルを無視することによって余分なステップを取り除きたい場合に便利です。
/xq
オプション /x
に似ていますが、同一ファイルであってもメッセージボックスを表示しません。
/s
WinMergeウインドウを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
指定された1つのファイルとそのファイルのコピーを比較します。
/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
起動時、右側で自動マージします。
/noninteractive
TBD
/noprefs
TBD
/enableexitcode
比較結果をプロセス終了コードに設定します。0: 同一, 1: 差異あり, 2: エラー
/ignorews
TBD
/ignoreblanklines
TBD
/ignorecase
TBD
/ignoreeol
TBD
/ignorecodepage
TBD
/ignorecomments
TBD
/unpacker
TBD
/prediffer
TBD
/cp
TBD
/fileext file-extension
シンタックスハイライトの種類を決定するため、ファイル拡張子を指定します。
/cfg
TBD
leftpath
左側で開くフォルダーやファイルを指定します。
middle
中央で開くフォルダーやファイルを指定します。
right
右側で開くフォルダーやファイルを指定します。
WinMergeは、ファイルとフォルダーを比較できません。そのためパスパラメーター両方(または3つすべて)
(
と
(leftpath
と)
middlepath
) には、同じ種類(フォルダーかファイルのどちらか)
を指し差なければなりません。
もし、WinMergeが指定したパスのどちらかを見つけることができなければ、
ファイルまたはフォルダー選択ダイアログを開きます。
ファイルまたはフォルダー選択ダイアログでは、正しいパスを選択できます。rightpath
ファイル比較では、パスパラメーターの一つとしてフォルダー名を指定できます。 ただし、フォルダーは他方のファイル名と同じファイルを含んでいる必要があります。
例えば、以下のコマンドを考えます:
WinMergeU
C:\Folder\File.txt
C:\Folder2
もし、C:\Folder2
が
ファイル名File.txt
を含んでいれば、
WinMergeは、暗黙的にファイル指定として第二のパスを解決します。
当然ながら、C:\Folder2
がファイル名
File.txt
を含んでいなければ、コマンドは不正とみなされます。
/o outputpath
マージした結果のファイルを保存するオプションの出力ファイルパスを指定します。
出力パスはコマンドラインからWinMergeを開始する時まれにしか必要となりません。 それはバージョンコントロールツールとともに使用されることになります。 結果ファイルとして出力パスを指定する必要があるかもしれません。 もし、出力パスを指定した場合、あるペインを変更後保存すると、変更は出力パスのファイルに保存され、 元ファイルは前の状態のままになります。
バージョンコントロールシステムは一般的にtheirsや mine、mergedかまたはresolved のような用語を使用し元と結果ファイルを参照します。 もし、WinMergeコマンドラインに出力パスを指定し、バージョンコントロールシステムと連携するならば、 この順番でファイルを並べるべきです。
/or
TBD
conflictfile
コンフリクトファイルを指定します。 コンフリクトファイルは通常バージョンコントロールシステムによって生成されます。 コンフリクトファイルはファイル比較ウインドウで開かれ、 「コンフリクトファイルの解決」で説明している様にマージやコンフリクトを解決することができます。 コンフリクトファイルと共に他のパスは使用できないことに注意してください。
/inifile inifile
レジストリの代わりに設定の読み込みと保存に使用するINIファイルを指定します。