1 <?xml version="1.0" encoding="UTF-8"?>
2 <article id="Command_line">
3 <title>コマンドライン<indexterm>
4 <primary>コマンドライン</primary>
5 </indexterm><indexterm>
6 <primary>WinMerge コマンドライン</primary>
11 <para>WinMergeのコマンドラインは、比較するパスに加えいくつかのパラメータを受け付けます。
12 これらのパラメータのほとんどは、外部比較ツールとして使用したり、バッチファイルから比較操作を
13 開始できるようにすることを目的としています。
16 <para>WinMergeをコマンドラインから実行するには以下の書式のうちの1つを使用します:</para>
18 <para><cmdsynopsis sepchar=" ">
19 <command>WinMergeU</command>
21 <arg choice="opt" rep="norepeat"><option>/?</option></arg>
24 <para><cmdsynopsis sepchar=" ">
25 <command>WinMergeU</command>
27 <arg choice="opt" rep="norepeat"><option>/r</option></arg>
29 <arg choice="opt" rep="norepeat"><option>/e</option></arg>
31 <arg choice="opt" rep="norepeat"><option>/f</option>
32 <replaceable>filter</replaceable></arg>
34 <arg choice="opt" rep="norepeat"><option>/m</option>
35 <replaceable>compare-method</replaceable></arg>
37 <arg choice="opt" rep="norepeat"><option>/t</option>
38 <replaceable>window-type</replaceable></arg>
40 <arg><option>/x</option></arg>
42 <arg><option>/xq</option></arg>
44 <arg><option>/s</option></arg>
46 <arg><option>/sw</option></arg>
48 <arg><option>/s-</option></arg>
50 <arg choice="opt" rep="norepeat"><option>/ul</option></arg>
52 <arg choice="opt" rep="norepeat"><option>/um</option></arg>
54 <arg choice="opt" rep="norepeat"><option>/ur</option></arg>
56 <arg choice="opt" rep="norepeat"><option>/u</option></arg>
58 <arg choice="opt" rep="norepeat"><option>/wl</option></arg>
60 <arg choice="opt" rep="norepeat"><option>/wm</option></arg>
62 <arg choice="opt" rep="norepeat"><option>/wr</option></arg>
64 <arg choice="opt" rep="norepeat"><option>/new</option></arg>
66 <arg choice="opt" rep="norepeat"><option>/self-compare</option></arg>
68 <arg><option>/minimize</option></arg>
70 <arg><option>/maximize</option></arg>
72 <arg choice="opt" rep="norepeat"><option>/fl</option></arg>
74 <arg choice="opt" rep="norepeat"><option>/fm</option></arg>
76 <arg choice="opt" rep="norepeat"><option>/fr</option></arg>
78 <arg choice="opt" rep="norepeat"><option>/l</option>
79 <replaceable>linenumber</replaceable></arg>
81 <arg choice="opt" rep="norepeat"><option>/table-delimiter</option>
82 <replaceable>delimiter</replaceable></arg>
84 <arg choice="opt" rep="norepeat"><option>/dl</option>
85 <replaceable>leftdesc</replaceable></arg>
87 <arg choice="opt" rep="norepeat"><option>/dm</option>
88 <replaceable>middledesc</replaceable></arg>
90 <arg choice="opt" rep="norepeat"><option>/dr</option>
91 <replaceable>rightdesc</replaceable></arg>
93 <arg choice="opt" rep="norepeat"><option>/al</option></arg>
95 <arg choice="opt" rep="norepeat"><option>/am</option></arg>
97 <arg choice="opt" rep="norepeat"><option>/ar</option></arg>
99 <arg choice="opt" rep="norepeat"><option>/noninteractive</option></arg>
101 <arg choice="opt" rep="norepeat"><option>/noprefs</option></arg>
103 <arg choice="opt" rep="norepeat"><option>/ignorews</option></arg>
105 <arg choice="opt" rep="norepeat"><option>/ignoreblanklines</option></arg>
107 <arg choice="opt" rep="norepeat"><option>/ignorecase</option></arg>
109 <arg choice="opt" rep="norepeat"><option>/ignoreeol</option></arg>
111 <arg choice="opt" rep="norepeat"><option>/ignorecodepage</option></arg>
113 <arg choice="opt" rep="norepeat"><option>/ignorecomments</option></arg>
115 <arg choice="opt" rep="norepeat"><option>/unpacker</option>
116 <replaceable>unpacker-name</replaceable></arg>
118 <arg choice="opt" rep="norepeat"><option>/prediffer</option>
119 <replaceable>prediffer-name</replaceable></arg>
121 <arg choice="opt" rep="norepeat"><option>/cp</option>
122 <replaceable>codepage</replaceable></arg>
124 <arg choice="opt" rep="norepeat"><option>/fileext</option>
125 <replaceable>file-extension</replaceable></arg>
127 <arg choice="opt" rep="norepeat"><option>/cfg</option>
128 <replaceable>name=value</replaceable></arg>
130 <arg choice="opt" rep="norepeat"><option>/inifile</option>
131 <replaceable>inifile</replaceable></arg>
134 rep="norepeat"><replaceable>leftpath</replaceable></arg>
137 rep="norepeat"><replaceable>middlepath</replaceable></arg>
140 rep="norepeat"><replaceable>rightpath</replaceable></arg>
143 rep="norepeat"><option>/o</option>
144 <replaceable>outputpath</replaceable></arg>
147 rep="norepeat"><option>/or</option>
148 <replaceable>reportpath</replaceable></arg>
150 </cmdsynopsis></para>
152 <cmdsynopsis sepchar=" ">
153 <command>WinMergeU</command>
156 rep="norepeat"><replaceable>conflictfile</replaceable></arg>
159 <para>パラメータなしかパス名を入力すると単にWinMergeウインドウを開きます。
160 パラメータは、スラッシュ( <literal>/</literal> ) か、ダッシュ ( <literal>-</literal> ) 文字が
161 前に付加されます。パス名にはプリフィックス文字を付加しません。
166 <term><option>/?</option></term>
168 <para>このトピックのWinMergeヘルプを開きます。</para>
174 <primary>再帰フォルダ比較</primary>
176 <term><option>/r</option></term>
178 <para>すべてのサブフォルダ内のすべてのファイルを比較します(再帰比較)。
179 ユニークフォルダ (片方のみ存在するフォルダ)は、分離された項目として比較結果内にリストされます。
180 サブフォルダまで含めるとかなり比較時間が増大してしまうことに注意してください。
181 このパラメータを指定しなかった場合、WinMergeは比較するフォルダ内のファイルとトップレベルのサブフォルダのみリストします。
182 サブフォルダの中までは比較しません。</para>
188 <primary>WinMergeウインドウ</primary>
189 <secondary>閉じる</secondary>
192 <term><option>/e</option></term>
194 <para><keycap>Esc</keycap>キーでWinMergeが閉じるようにします。
195 WinMergeを外部比較アプリケーションとして使用する場合に便利です。
196 (ダイアログのようにすばやくWinMergeを閉じることができます)
197 この引数を指定しなかった場合、すべてのウインドウを閉じるのに何回も<keycap>Esc</keycap>キーを
198 押さなければならないことになるかもしれません。(2つ以上タブが開かれている場合、一回のESCキーの押下でWinMergeが終了してしまうのを期待している人はいないような気がしたので、日本語版ではこのオプションを指定しても2つ以上タブが開かれている場合は1つのタブを閉じるだけにし、タブが1つの時またはタブが一つもない時にWinMergeを終了するようにしました)</para>
204 <primary>フィルタ</primary>
205 <secondary>コマンドラインでの適用</secondary>
208 <term><option>/f</option></term>
210 <para>比較を制限するために、指定したフィルタを適用します。
211 フィルタは<filename><userinput>*.h
212 *.cpp</userinput></filename>のようなファイルマスクか、
213 <userinput>XML/HTML Devel</userinput>のようなファイルフィルタの名前です。
214 スペースを含むフィルタマスクやフィルタ名はダブルクォーテーションマークで括ってください。</para>
220 <primary>compare method</primary>
221 <secondary>applying in command line</secondary>
224 <term><option>/m <replaceable>compare-method</replaceable></option></term>
226 <para>フォルダ比較方法を指定します。
227 次のキーワードが指定できます。<userinput>Full</userinput>,
228 <userinput>Quick</userinput>, <userinput>Binary</userinput>,
229 <userinput>Date</userinput>, <userinput>SizeDate</userinput>
230 <userinput>Size</userinput></para>
236 <primary>window type</primary>
237 <secondary>applying in command line</secondary>
240 <term><option>/t <replaceable>window-type</replaceable></option></term>
242 <para>ファイルを表示するウインドウの種類を指定します。
243 次のキーワードが指定できます。 <userinput>Text</userinput>,
244 <userinput>Table</userinput>, <userinput>Binary</userinput>,
245 <userinput>Image</userinput></para>
250 <term><option>/x</option></term>
252 <para>同一ファイルの比較をしたときにWinMergeを閉じます。
254 このパラメータは比較後に効果がなくなります。
255 例えば、もしファイルがマージか編集の結果として同一となった場合です。
256 このパラメータは、WinMergeを外部アプリケーションとして使用したり、
257 差異のないファイルを無視することによって余分なステップを取り除きたい場合に便利です。
263 <term><option>/xq</option></term>
265 <para>オプション <option>/x</option> に似ていますが、同一ファイルであってもメッセージボックスを表示しません。
272 <primary>WinMergeウインドウ</primary>
273 <secondary>インスタンス制限</secondary>
276 <term><option>/s</option></term>
278 <para>WinMergeウインドウを1つのインスタンスに制限します。
279 例えば、WinMergeが既に実行中ならば、新しい比較は同じインスタンス内で実行されます。
280 この引数を指定しなかった場合、複数のウインドウが開かれる可能性があります:
281 設定によっては、新しい比較が既に存在するウインドウで実行されることも新しいウインドウで
287 <term><option>/sw</option></term>
289 <para>/s と同様にWinMergeウインドウを1つのインスタンスに制限します。
290 ただし、ウインドウを表示しているインスタンスが終了するまで待機します。
296 <term><option>/s-</option></term>
298 <para>"複数のインスタンスを起動しない"の設定値を無視して、
299 常に別のインスタンスが起動されるようにします。</para>
305 <primary>MRU リスト</primary>
308 <term><option>/ul</option></term>
310 <para>左側パスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
311 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
312 追加するべきではありません。</para>
317 <term><option>/um</option></term>
319 <para>中央のパスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
320 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
321 追加するべきではありません。</para>
326 <term><option>/ur</option></term>
328 <para>右側パスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
329 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
330 追加するべきではありません。</para>
335 <term><option>/u</option></term>
337 <para>(または<option>/ub</option>) 各々(左、右、中央)のパスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
338 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
346 <primary>ファイルの保護</primary>
349 <term><option>/wl</option></term>
351 <para>読み取り専用として左側を開きます。
352 比較時、左側を変更したくない場合に使用してください。</para>
357 <term><option>/wm</option></term>
359 <para>読み取り専用として中央を開きます。
360 比較時、中央を変更したくない場合に使用してください。</para>
365 <term><option>/wr</option></term>
367 <para>読み取り専用として右側を開きます。
368 比較時、右側を変更したくない場合に使用してください。</para>
373 <term><option>/new</option></term>
375 <para>新規ブランクウインドウを開きます。</para>
380 <term><option>/self-compare</option></term>
382 <para>指定された1つのファイルとそのファイルのコピーを比較します。</para>
388 <primary>WinMergeウインドウ</primary>
389 <secondary>最小化または最大化で開く</secondary>
392 <term><option>/minimize</option></term>
394 <para>最小化状態でWinMergeを開始します。
395 このオプションは長時間かかる比較を行う場合に便利です。</para>
400 <term><option>/maximize</option></term>
402 <para>最大化状態でWinMergeを開始します。
408 <term><option>/fl</option></term>
410 <para>起動時、左側にフォーカスを当てます</para>
415 <term><option>/fm</option></term>
417 <para>起動時、中央にフォーカスを当てます</para>
422 <term><option>/fr</option></term>
424 <para>起動時、右側にフォーカスを当てます</para>
429 <term><option>/l <replaceable>linenumber</replaceable></option></term>
431 <para>ファイルを読み込んだ後にジャンプする行番号を指定します。</para>
436 <term><option>/table-delimiter <replaceable>delimiter</replaceable></option></term>
438 <para>テーブル編集用の区切り文字を指定します。</para>
443 <term><option>/dl</option></term>
445 <para>左側タイトルバーの説明を指定します。
446 デフォルトのフォルダやファイル名テキストに上書きされます。例:
447 <userinput>/dl "Version 1.0</userinput>" や <userinput>/dl
448 WorkingCopy</userinput>. スペースを含む説明はダブルクォーテーションマークで括ってください。
454 <term><option>/dm</option></term>
456 <para><option>/dl</option>と同様に中央タイトルバーの説明を指定します。
462 <term><option>/dr</option></term>
464 <para><option>/dl</option>と同様に右側タイトルバーの説明を指定します。
470 <term><option>/al</option></term>
472 <para>起動時、左側で自動マージします。</para>
477 <term><option>/am</option></term>
479 <para>起動時、中央で自動マージします。</para>
484 <term><option>/ar</option></term>
486 <para>起動時、右側で自動マージします。</para>
491 <term><option>/noninteractive</option></term>
498 <term><option>/noprefs</option></term>
505 <term><option>/ignorews</option></term>
512 <term><option>/ignoreblanklines</option></term>
519 <term><option>/ignorecase</option></term>
526 <term><option>/ignoreeol</option></term>
533 <term><option>/ignorecodepage</option></term>
540 <term><option>/ignorecomments</option></term>
547 <term><option>/unpacker</option></term>
554 <term><option>/prediffer</option></term>
561 <term><option>/cp</option></term>
568 <term><option>/fileext <replaceable>file-extension</replaceable></option></term>
570 <para>シンタックスハイライトの種類を決定するため、ファイル拡張子を指定します。</para>
575 <term><option>/cfg</option></term>
582 <term><option><replaceable>leftpath</replaceable></option></term>
584 <para>左側で開くフォルダやファイルを指定します。
590 <term><option><replaceable>middle</replaceable></option></term>
592 <para>中央で開くフォルダやファイルを指定します。
598 <term><option><replaceable>right</replaceable></option></term>
600 <para>右側で開くフォルダやファイルを指定します。
603 <para>WinMergeは、ファイルとフォルダを比較できません。そのためパスパラメータ両方(または3つすべて)
604 (<option><replaceable>leftpath</replaceable></option> と
605 (<option><replaceable>middlepath</replaceable></option> と)
606 <option><replaceable>rightpath</replaceable></option>) には、同じ種類(フォルダかファイルのどちらか)
608 もし、WinMergeが指定したパスのどちらかを見つけることができなければ、
609 ファイルまたはフォルダ選択ダイアログを開きます。
610 ファイルまたはフォルダ選択ダイアログでは、正しいパスを選択できます。</para>
613 <para>ファイル比較では、パスパラメータの一つとしてフォルダ名を指定できます。
614 ただし、フォルダは他方のファイル名と同じファイルを含んでいる必要があります。
617 <para>例えば、以下のコマンドを考えます:</para>
619 <para><userinput>WinMergeU <filename>C:\Folder\File.txt</filename>
620 <filename class="directory">C:\Folder2</filename> </userinput></para>
622 <para>もし、<filename class="directory">C:\Folder2</filename>が
623 ファイル名<filename>File.txt</filename>を含んでいれば、
624 WinMergeは、暗黙的にファイル指定として第二のパスを解決します。
625 当然ながら、<filename class="directory">C:\Folder2</filename>がファイル名
626 <filename>File.txt</filename>を含んでいなければ、コマンドは不正とみなされます。</para>
634 <primary>差異をマージする</primary>
635 <secondary>結果ファイル</secondary>
638 <term><option>/o <replaceable>outputpath</replaceable></option></term>
641 マージした結果のファイルを保存するオプションの出力フォルダを指定します。
644 <para>出力パスはコマンドラインからWinMergeを開始する時まれにしか必要となりません。
645 それはバージョンコントロールツールとともに使用されることになります。
646 結果ファイルとして出力パスを指定する必要があるかもしれません。
647 もし、出力パスを指定した場合、あるペインを変更後保存すると、変更は出力パスのファイルに保存され、
651 <para>バージョンコントロールシステムは一般的に<glossterm>theirs</glossterm>や
652 <glossterm>mine</glossterm>、<glossterm>merged</glossterm>かまたは<glossterm>resolved</glossterm>
653 のような用語を使用し元と結果ファイルを参照します。
654 もし、WinMergeコマンドラインに出力パスを指定し、バージョンコントロールシステムと連携するならば、
655 この順番でファイルを並べるべきです。</para>
660 <term><option>/or</option></term>
668 <primary>コンフリクトファイル</primary>
669 <secondary>コマンドラインでの指定</secondary>
672 <term><option><replaceable>conflictfile</replaceable></option></term>
674 <para>コンフリクトファイルを指定します。
675 コンフリクトファイルは通常バージョンコントロールシステムによって生成されます。
676 コンフリクトファイルはファイル比較ウインドウで開かれ、
678 linkend="ResolveConflictFiles" />で説明している様にマージやコンフリクトを解決することができます。
679 コンフリクトファイルと共に他のパスは使用できないことに注意してください。</para>
685 <primary>ini ファイル</primary>
686 <secondary>コマンドラインでの指定</secondary>
689 <term><option>/inifile <replaceable>inifile</replaceable></option></term>
691 <para>レジストリの代わりに設定の読み込みと保存に使用するINIファイルを指定します。</para>