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>/cfg</option>
125 <replaceable>name=value</replaceable></arg>
127 <arg choice="opt" rep="norepeat"><option>/inifile</option>
128 <replaceable>inifile</replaceable></arg>
131 rep="norepeat"><replaceable>leftpath</replaceable></arg>
134 rep="norepeat"><replaceable>middlepath</replaceable></arg>
137 rep="norepeat"><replaceable>rightpath</replaceable></arg>
140 rep="norepeat"><option>/o</option>
141 <replaceable>outputpath</replaceable></arg>
144 rep="norepeat"><option>/or</option>
145 <replaceable>reportpath</replaceable></arg>
147 </cmdsynopsis></para>
149 <cmdsynopsis sepchar=" ">
150 <command>WinMergeU</command>
153 rep="norepeat"><replaceable>conflictfile</replaceable></arg>
156 <para>パラメータなしかパス名を入力すると単にWinMergeウインドウを開きます。
157 パラメータは、スラッシュ( <literal>/</literal> ) か、ダッシュ ( <literal>-</literal> ) 文字が
158 前に付加されます。パス名にはプリフィックス文字を付加しません。
163 <term><option>/?</option></term>
165 <para>このトピックのWinMergeヘルプを開きます。</para>
171 <primary>再帰フォルダ比較</primary>
173 <term><option>/r</option></term>
175 <para>すべてのサブフォルダ内のすべてのファイルを比較します(再帰比較)。
176 ユニークフォルダ (片方のみ存在するフォルダ)は、分離された項目として比較結果内にリストされます。
177 サブフォルダまで含めるとかなり比較時間が増大してしまうことに注意してください。
178 このパラメータを指定しなかった場合、WinMergeは比較するフォルダ内のファイルとトップレベルのサブフォルダのみリストします。
179 サブフォルダの中までは比較しません。</para>
185 <primary>WinMergeウインドウ</primary>
186 <secondary>閉じる</secondary>
189 <term><option>/e</option></term>
191 <para><keycap>Esc</keycap>キーでWinMergeが閉じるようにします。
192 WinMergeを外部比較アプリケーションとして使用する場合に便利です。
193 (ダイアログのようにすばやくWinMergeを閉じることができます)
194 この引数を指定しなかった場合、すべてのウインドウを閉じるのに何回も<keycap>Esc</keycap>キーを
195 押さなければならないことになるかもしれません。(2つ以上タブが開かれている場合、一回のESCキーの押下でWinMergeが終了してしまうのを期待している人はいないような気がしたので、日本語版ではこのオプションを指定しても2つ以上タブが開かれている場合は1つのタブを閉じるだけにし、タブが1つの時またはタブが一つもない時にWinMergeを終了するようにしました)</para>
201 <primary>フィルタ</primary>
202 <secondary>コマンドラインでの適用</secondary>
205 <term><option>/f</option></term>
207 <para>比較を制限するために、指定したフィルタを適用します。
208 フィルタは<filename><userinput>*.h
209 *.cpp</userinput></filename>のようなファイルマスクか、
210 <userinput>XML/HTML Devel</userinput>のようなファイルフィルタの名前です。
211 スペースを含むフィルタマスクやフィルタ名はダブルクォーテーションマークで括ってください。</para>
217 <primary>compare method</primary>
218 <secondary>applying in command line</secondary>
221 <term><option>/m <replaceable>compare-method</replaceable></option></term>
223 <para>フォルダ比較方法を指定します。
224 次のキーワードが指定できます。<userinput>Full</userinput>,
225 <userinput>Quick</userinput>, <userinput>Binary</userinput>,
226 <userinput>Date</userinput>, <userinput>SizeDate</userinput>
227 <userinput>Size</userinput></para>
233 <primary>window type</primary>
234 <secondary>applying in command line</secondary>
237 <term><option>/t <replaceable>window-type</replaceable></option></term>
239 <para>ファイルを表示するウインドウの種類を指定します。
240 次のキーワードが指定できます。 <userinput>Text</userinput>,
241 <userinput>Table</userinput>, <userinput>Binary</userinput>,
242 <userinput>Image</userinput></para>
247 <term><option>/x</option></term>
249 <para>同一ファイルの比較をしたときにWinMergeを閉じます。
251 このパラメータは比較後に効果がなくなります。
252 例えば、もしファイルがマージか編集の結果として同一となった場合です。
253 このパラメータは、WinMergeを外部アプリケーションとして使用したり、
254 差異のないファイルを無視することによって余分なステップを取り除きたい場合に便利です。
260 <term><option>/xq</option></term>
262 <para>オプション <option>/x</option> に似ていますが、同一ファイルであってもメッセージボックスを表示しません。
269 <primary>WinMergeウインドウ</primary>
270 <secondary>インスタンス制限</secondary>
273 <term><option>/s</option></term>
275 <para>WinMergeウインドウを1つのインスタンスに制限します。
276 例えば、WinMergeが既に実行中ならば、新しい比較は同じインスタンス内で実行されます。
277 この引数を指定しなかった場合、複数のウインドウが開かれる可能性があります:
278 設定によっては、新しい比較が既に存在するウインドウで実行されることも新しいウインドウで
284 <term><option>/sw</option></term>
286 <para>/s と同様にWinMergeウインドウを1つのインスタンスに制限します。
287 ただし、ウインドウを表示しているインスタンスが終了するまで待機します。
293 <term><option>/s-</option></term>
295 <para>"複数のインスタンスを起動しない"の設定値を無視して、
296 常に別のインスタンスが起動されるようにします。</para>
302 <primary>MRU リスト</primary>
305 <term><option>/ul</option></term>
307 <para>左側パスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
308 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
309 追加するべきではありません。</para>
314 <term><option>/um</option></term>
316 <para>中央のパスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
317 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
318 追加するべきではありません。</para>
323 <term><option>/ur</option></term>
325 <para>右側パスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
326 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
327 追加するべきではありません。</para>
332 <term><option>/u</option></term>
334 <para>(または<option>/ub</option>) 各々(左、右、中央)のパスが最近使用した項目(MRU)リストに追加されるのを防ぎます。
335 外部アプリケーションは、ファイルまたはフォルダの選択ダイアログのMRUリストにパスを
343 <primary>ファイルの保護</primary>
346 <term><option>/wl</option></term>
348 <para>読み取り専用として左側を開きます。
349 比較時、左側を変更したくない場合に使用してください。</para>
354 <term><option>/wm</option></term>
356 <para>読み取り専用として中央を開きます。
357 比較時、中央を変更したくない場合に使用してください。</para>
362 <term><option>/wr</option></term>
364 <para>読み取り専用として右側を開きます。
365 比較時、右側を変更したくない場合に使用してください。</para>
370 <term><option>/new</option></term>
372 <para>新規ブランクウインドウを開きます。</para>
377 <term><option>/self-compare</option></term>
379 <para>指定された1つのファイルとそのファイルのコピーを比較します。</para>
385 <primary>WinMergeウインドウ</primary>
386 <secondary>最小化または最大化で開く</secondary>
389 <term><option>/minimize</option></term>
391 <para>最小化状態でWinMergeを開始します。
392 このオプションは長時間かかる比較を行う場合に便利です。</para>
397 <term><option>/maximize</option></term>
399 <para>最大化状態でWinMergeを開始します。
405 <term><option>/fl</option></term>
407 <para>起動時、左側にフォーカスを当てます</para>
412 <term><option>/fm</option></term>
414 <para>起動時、中央にフォーカスを当てます</para>
419 <term><option>/fr</option></term>
421 <para>起動時、右側にフォーカスを当てます</para>
426 <term><option>/l <replaceable>linenumber</replaceable></option></term>
428 <para>ファイルを読み込んだ後にジャンプする行番号を指定します。</para>
433 <term><option>/table-delimiter <replaceable>delimiter</replaceable></option></term>
435 <para>テーブル編集用の区切り文字を指定します。</para>
440 <term><option>/dl</option></term>
442 <para>左側タイトルバーの説明を指定します。
443 デフォルトのフォルダやファイル名テキストに上書きされます。例:
444 <userinput>/dl "Version 1.0</userinput>" や <userinput>/dl
445 WorkingCopy</userinput>. スペースを含む説明はダブルクォーテーションマークで括ってください。
451 <term><option>/dm</option></term>
453 <para><option>/dl</option>と同様に中央タイトルバーの説明を指定します。
459 <term><option>/dr</option></term>
461 <para><option>/dl</option>と同様に右側タイトルバーの説明を指定します。
467 <term><option>/al</option></term>
469 <para>起動時、左側で自動マージします。</para>
474 <term><option>/am</option></term>
476 <para>起動時、中央で自動マージします。</para>
481 <term><option>/ar</option></term>
483 <para>起動時、右側で自動マージします。</para>
488 <term><option>/noninteractive</option></term>
495 <term><option>/noprefs</option></term>
502 <term><option>/ignorews</option></term>
509 <term><option>/ignoreblanklines</option></term>
516 <term><option>/ignorecase</option></term>
523 <term><option>/ignoreeol</option></term>
530 <term><option>/ignorecodepage</option></term>
537 <term><option>/ignorecomments</option></term>
544 <term><option>/unpacker</option></term>
551 <term><option>/prediffer</option></term>
558 <term><option>/cp</option></term>
565 <term><option>/cfg</option></term>
572 <term><option><replaceable>leftpath</replaceable></option></term>
574 <para>左側で開くフォルダやファイルを指定します。
580 <term><option><replaceable>middle</replaceable></option></term>
582 <para>中央で開くフォルダやファイルを指定します。
588 <term><option><replaceable>right</replaceable></option></term>
590 <para>右側で開くフォルダやファイルを指定します。
593 <para>WinMergeは、ファイルとフォルダを比較できません。そのためパスパラメータ両方(または3つすべて)
594 (<option><replaceable>leftpath</replaceable></option> と
595 (<option><replaceable>middlepath</replaceable></option> と)
596 <option><replaceable>rightpath</replaceable></option>) には、同じ種類(フォルダかファイルのどちらか)
598 もし、WinMergeが指定したパスのどちらかを見つけることができなければ、
599 ファイルまたはフォルダ選択ダイアログを開きます。
600 ファイルまたはフォルダ選択ダイアログでは、正しいパスを選択できます。</para>
603 <para>ファイル比較では、パスパラメータの一つとしてフォルダ名を指定できます。
604 ただし、フォルダは他方のファイル名と同じファイルを含んでいる必要があります。
607 <para>例えば、以下のコマンドを考えます:</para>
609 <para><userinput>WinMergeU <filename>C:\Folder\File.txt</filename>
610 <filename class="directory">C:\Folder2</filename> </userinput></para>
612 <para>もし、<filename class="directory">C:\Folder2</filename>が
613 ファイル名<filename>File.txt</filename>を含んでいれば、
614 WinMergeは、暗黙的にファイル指定として第二のパスを解決します。
615 当然ながら、<filename class="directory">C:\Folder2</filename>がファイル名
616 <filename>File.txt</filename>を含んでいなければ、コマンドは不正とみなされます。</para>
624 <primary>差異をマージする</primary>
625 <secondary>結果ファイル</secondary>
628 <term><option>/o <replaceable>outputpath</replaceable></option></term>
631 マージした結果のファイルを保存するオプションの出力フォルダを指定します。
634 <para>出力パスはコマンドラインからWinMergeを開始する時まれにしか必要となりません。
635 それはバージョンコントロールツールとともに使用されることになります。
636 結果ファイルとして出力パスを指定する必要があるかもしれません。
637 もし、出力パスを指定した場合、あるペインを変更後保存すると、変更は出力パスのファイルに保存され、
641 <para>バージョンコントロールシステムは一般的に<glossterm>theirs</glossterm>や
642 <glossterm>mine</glossterm>、<glossterm>merged</glossterm>かまたは<glossterm>resolved</glossterm>
643 のような用語を使用し元と結果ファイルを参照します。
644 もし、WinMergeコマンドラインに出力パスを指定し、バージョンコントロールシステムと連携するならば、
645 この順番でファイルを並べるべきです。</para>
650 <term><option>/or</option></term>
658 <primary>コンフリクトファイル</primary>
659 <secondary>コマンドラインでの指定</secondary>
662 <term><option><replaceable>conflictfile</replaceable></option></term>
664 <para>コンフリクトファイルを指定します。
665 コンフリクトファイルは通常バージョンコントロールシステムによって生成されます。
666 コンフリクトファイルはファイル比較ウインドウで開かれ、
668 linkend="ResolveConflictFiles" />で説明している様にマージやコンフリクトを解決することができます。
669 コンフリクトファイルと共に他のパスは使用できないことに注意してください。</para>
675 <primary>ini ファイル</primary>
676 <secondary>コマンドラインでの指定</secondary>
679 <term><option>/inifile <replaceable>inifile</replaceable></option></term>
681 <para>レジストリの代わりに設定の読み込みと保存に使用するINIファイルを指定します。</para>