Oprócz ścieżek do porównania wiersz poleceń WinMerge akceptuje kilka parametrów. Większość tych parametrów jest przeznaczona do używania WinMerge jako zewnętrznej aplikacji porównującej lub rozpoczynania operacji porównywania z pliku wsadowego.
Użyj jednego z następujących formatów dla polecenia WinMerge:
WinMergeU [/?]
WinMergeU [/r] [/r-] [/e] [/f filter] [/m
compare-method] [/t
window-type] [/x] [/xq] [/s] [/sw] [/s-] [/g
group-name] [/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
Wprowadzenie polecenia bez parametrów i nazw ścieżek po prostu otwiera okno
WinMerge. Parametry są poprzedzone ukośnikiem ( / ) lub
myślnik ( - ) charakter. Nazwy ścieżek nie mają znaku
przedrostka.
/?Otwiera pomoc WinMerge w tym temacie.
/rPorównuje wszystkie pliki we wszystkich podfolderach (porównanie rekurencyjne). Unikalne foldery (występujące tylko po jednej stronie) są wyświetlane w wyniku porównania jako osobne pozycje. Należy pamiętać, że uwzględnienie podfolderów może znacznie wydłużyć czas porównywania. Bez tego parametru WinMerge wyświetla tylko pliki i podfoldery na najwyższym poziomie dwóch folderów docelowych. Nie porównuje podfolderów.
/r-Porównuje wszystkie pliki w określonych folderach, ale wyklucza pliki i podfoldery w swoich podfolderach. Pozwala to na skrócenie czasu porównania.
/eUmożliwia zamknięcie WinMerge za pomocą jednego pliku Wyjście naciśnięcie klawisza. Jest to przydatne, gdy używasz WinMerge jako zewnętrznej aplikacji porównującej: możesz szybko zamknąć WinMerge, jak okno dialogowe. Bez tego parametru konieczne może być naciśnięcie przycisku Wyjście kilka razy, aby zamknąć wszystkie okna.
/fStosuje określony filtr, aby ograniczyć porównanie. Filtrem może być maska
pliku lub nazwa filtra
plików, np *.h *.cppXML/HTML Devel. Dodaj cudzysłów wokół
maski filtra lub nazwy zawierającej spacje.
/m compare-methodUstawia metodę porównania, która ma być używana do porównania. Może to być
jedno ze słów kluczowych Full,
Quick, Binary,
Date, SizeDate,
Size lub Existence.
/t window-typeOkreśla typ okna, w którym mają być wyświetlane pliki. Może to być jedno ze
słów kluczowych Text, Table,
Binary, Image,
Webpage lub Folder.
/xZamyka WinMerge (po wyświetleniu okna informacyjnego), gdy rozpoczniesz porównywanie identycznych plików. Parametr nie ma żadnego wpływu po porównaniu, jeśli np. pliki staną się identyczne w wyniku połączenia lub edycji. Ten parametr jest przydatny, gdy używasz WinMerge jako zewnętrznej aplikacji porównującej lub gdy chcesz wyeliminować niepotrzebne kroki, ignorując pliki, które nie różnią się między sobą.
/xqJest podobny do /x ale nie wyświetla komunikatu o
identycznych plikach.
/sOgranicza okna WinMerge do pojedynczej instancji. Na przykład, jeśli WinMerge jest już uruchomiony, w tej samej instancji zostanie otwarte nowe porównanie. Bez tego parametru dozwolonych jest wiele okien: w zależności od innych ustawień nowe porównanie może otworzyć się w istniejącym oknie lub w nowym oknie.
/swOgranicz okno WinMerge do jednej instancji oraz opcji /s. Jednakże oczekuje na zakończenie instancji wyświetlającej okno.
/s-Upewnij się, że zawsze wykonywana jest inna instancja, ignorując wartość opcji „Pozwól na uruchomienie tylko jednej instancji”.
/g group-nameOkreśla nazwę grupy dla instancji WinMerge. W przypadku użycia z
/s opcja, instancje o tej samej nazwie grupy współdzielą to
samo okno, co pozwala na organizowanie wielu grup z pojedynczą instancją.
/ulUniemożliwia programowi WinMerge dodanie lewej ścieżki do listy Ostatnio używane (MRU). Aplikacje zewnętrzne nie powinny dodawać ścieżek do listy MRU w oknie dialogowym Wybierz pliki lub foldery.
/umUniemożliwia programowi WinMerge dodanie środkowej ścieżki do listy Ostatnio używane (MRU). Aplikacje zewnętrzne nie powinny dodawać ścieżek do listy MRU w oknie dialogowym Wybierz pliki lub foldery.
/urUniemożliwia programowi WinMerge dodanie właściwej ścieżki do listy Ostatnio używane (MRU). Aplikacje zewnętrzne nie powinny dodawać ścieżek do listy MRU w oknie dialogowym Wybierz pliki lub foldery.
/uUniemożliwia programowi WinMerge dodanie dowolnej ścieżki (lewej lub prawej) do listy Ostatnio używane (MRU). Aplikacje zewnętrzne nie powinny dodawać ścieżek do listy MRU w oknie dialogowym Wybierz pliki lub foldery.
/wlOtwiera lewą stronę w trybie tylko do odczytu. Użyj tej opcji, jeśli nie chcesz zmieniać elementów po lewej stronie w porównaniu.
/wmOtwiera środkową stronę w trybie tylko do odczytu. Użyj tej opcji, jeśli nie chcesz zmieniać elementów po prawej stronie w porównaniu.
/wrOtwiera prawą stronę w trybie tylko do odczytu. Użyj tej opcji, jeśli nie chcesz zmieniać elementów po prawej stronie w porównaniu.
/newOtwiera nowe, puste okno.
/self-comparePorównuje określony plik z kopią pliku.
/clipboard-comparePorównuje dwie najnowsze treści historii schowka.
/minimizeUruchamia WinMerge jako zminimalizowane okno. Ta opcja może być przydatna podczas długich porównań.
/maximizeUruchamia WinMerge jako zmaksymalizowane okno.
/flPrzy uruchomieniu ustawia fokus na lewą stronę.
/fmPrzy uruchomieniu ustawia fokus na środkową stronę.
/frPrzy uruchomieniu ustawia fokus na prawą stronę.
/l linenumberOkreśla numer linii, do której należy przejść po załadowaniu plików.
/c charposOkreśla pozycję znaku, do której należy przejść po załadowaniu plików.
/table-delimiter delimiterOkreśla znak ogranicznika do edycji tabeli. Aby określić znak tabulacji, określ „tab”, „\t” lub „\x09”.
/dlOkreśla opis na lewym pasku tytułu, zastępując domyślny tekst nazwy folderu
lub pliku. Na przykład: /dl "Version 1.0„lub
/dl WorkingCopy. Używaj cudzysłowów wokół opisów
zawierających spacje.
/dmOkreśla opis na środkowym pasku tytułu, podobnie jak /dl.
/drOkreśla opis na prawym pasku tytułu, podobnie jak /dl.
/alAutomatyczne łączenie przy uruchomieniu z układem paneli: lewy (cel scalania) - środkowy (ich) - prawy (podstawowy).
/amAutomatyczne łączenie przy uruchomieniu z układem paneli: lewy (ich) - środkowy (cel scalania) - prawy (moje).
/arAutomatyczne łączenie przy uruchomieniu z układem paneli: lewy (podstawowy) - środkowy (ich) - prawy (cel scalania).
/noninteractiveUruchamia WinMerge bez wyświetlania okien komunikatów podczas porównywania lub generowania raportu. Proces kończy się automatycznie po zakończeniu operacji, dzięki czemu nadaje się do wykonywania wsadowego lub skryptowego.
/noprefsUruchamia WinMerge bez ładowania lub zapisywania ustawień z rejestru. We wszystkich porównaniach wykorzystywane są wyłącznie preferencje domyślne.
/enableexitcodeUstawia wynik porównania na kod zakończenia procesu. 0: identyczny, 1: inny, 2: błąd
/ignorewsTrwale kontroluje opcję „Odstępy” (ustawienia porównania białych znaków):
/ignorews:0 - nie ignoruj różnic w białych znakach.
/ignorews lub /ignorews:1 - zignorować
różnice w ilości białych znaków.
/ignorews:2 - zignoruj wszystkie białe znaki.
/ignoreblanklinesTrwale kontroluje opcję „Ignoruj puste linie”:
/ignoreblanklines:0 - wyłącza ignorowanie pustych linii.
/ignoreblanklines lub /ignoreblanklines:1
- umożliwia ignorowanie pustych linii.
/ignorecaseTrwale kontroluje opcję „Ignoruj wielkość liter”:
/ignorecase:0 - wyłącza ignorowanie różnic w wielkości
liter.
/ignorecase lub /ignorecase:1 - umożliwia
ignorowanie różnic w wielkości liter.
/ignoreeolTrwale kontroluje opcję „Ignoruj różnice EOL”:
/ignoreeol:0 - wyłącza ignorowanie różnic EOL.
/ignoreeol lub /ignoreeol:1 - umożliwia
ignorowanie różnic EOL.
/ignorecodepageTrwale kontroluje opcję „Ignoruj różnice stron kodowych”:
/ignorecodepage:0 - wyłącza ignorowanie różnic stron
kodowych.
/ignorecodepage lub /ignorecodepage:1 -
umożliwia ignorowanie różnic w stronach kodowych.
/ignorecommentsTrwale kontroluje opcję „Ignoruj różnice w komentarzach”:
/ignorecomments:0 - wyłącza ignorowanie komentarzy.
/ignorecomments lub /ignorecomments:1 -
umożliwia ignorowanie komentarzy.
/unpacker plugin pipeline
Określa potok wtyczki dla wtyczki Unpacker. Przykład: /unpacker
"SortAscending|SelectLines 1-10"
/prediffer plugin pipeline
Określa potok wtyczki dla wtyczki Prediffer. Przykład: /prediffer
"IgnoreColumns 1-10"
/cp codepage
Określa stronę kodową używaną do porównywania plików. Przykład: /cp
65001
/fileext file-extensionOkreśla rozszerzenie pliku służące do określania podświetlenia składni.
/cfg name=valueUstawia wartość konfiguracyjną w rejestrze WinMerge lub pliku INI.
Przykład: /cfg Settings/DiffAlgorithm=3
Jeżeli nazwa sekcji jest jednoznaczna i nie koliduje z innymi nazwami ustawień, można ją pominąć:
/cfg DiffAlgo=3
Uwaga: ten wpis nie wyjaśnia, które nazwy konfiguracji są dostępne. Aby
zapoznać się z listą ustawień, zobacz
HKEY_CURRENT_USER\Software\Thingamahoochie\WinMerge w
regedit.
leftpathOkreśla folder, plik lub plik projektu do otwarcia po lewej stronie.
middlepathOkreśla folder, plik lub plik projektu do otwarcia na środkowej stronie.
rightpathOkreśla folder, plik lub plik projektu do otwarcia po prawej stronie.
WinMerge nie może porównywać plików z folderami, więc parametry ścieżki
(,
leftpath i
middlepath) musi wskazywać ten
sam typ docelowy (foldery lub pliki). Jeśli WinMerge nie może znaleźć żadnej
z określonych ścieżek, otwiera okno dialogowe Wybierz pliki lub foldery, w
którym możesz przeglądać w poszukiwaniu prawidłowych ścieżek.rightpath
Podczas porównywania plików można określić nazwę folderu w jednym z parametrów ścieżki, o ile folder zawiera plik o tej samej nazwie, co określony w drugiej ścieżce pliku.
Rozważmy na przykład to polecenie:
WinMergeU C:\Folder\File.txt C:\Folder2
Jeśli C:\Folder2 zawiera plik o
nazwie File.txt: WinMerge domyślnie rozpoznaje drugą
ścieżkę jako specyfikację pliku i porównuje dwa pliki. Oczywiście polecenie
jest nieprawidłowe, jeśli C:\Folder2
robi nie zawierają plik o nazwie
File.txt.
/o outputpathOkreśla opcjonalną ścieżkę pliku wyjściowego, w której mają być zapisywane scalone pliki wynikowe.
Ścieżka wyjściowa jest rzadko potrzebna, gdy uruchamiasz WinMerge z wiersza poleceń. Jest przeznaczony do stosowania z narzędziami kontroli wersji, w których może być konieczne określenie ścieżki wyjściowej pliku wynik plik. Jeśli określisz ścieżkę wyjściową, WinMerge nadal będzie wyświetlać tylko dwa lub trzy pliki w oknie Porównaj pliki. Jeśli jednak zapiszesz którykolwiek z tych plików, zostanie on zapisany w ścieżce wyjściowej, pozostawiając dwa lub trzy pliki źródłowe nienaruszone.
W przypadku trójstronnego porównania tekstu określenie ścieżki wyjściowej powoduje również otwarcie panelu Wynik scalania u dołu okna Porównywanie plików, gdzie można przejrzeć i edytować wynik scalania przed zapisaniem go w ścieżce wyjściowej. Zobacz temat panelu Wynik scalania w Porównywanie i łączenie plików tekstowych.
Systemy kontroli wersji zazwyczaj odnoszą się do plików źródłowych i wynikowych za pomocą terminów takich jak ich, moje, i albo połączone lub rozwiązany. Jeśli określisz ścieżkę wyjściową w wierszu poleceń WinMerge i pracujesz z systemem kontroli wersji, powinieneś wyświetlić pliki w tej kolejności.
/or outputpath
Generuje raport porównawczy dla plików lub folderów. Przykład:
WinMergeU path1 path2 /or c:\tmp\report.html
Często warto połączyć tę opcję z:
/noninteractive - opuszcza WinMerge po utworzeniu raportu.
/minimize - uruchamia WinMerge w stanie zminimalizowanym.
/noprefs - ignoruje bieżące preferencje i używa ustawień
domyślnych. Wszelkie zmiany dokonane za pomocą /cfg będą
wówczas tymczasowe i nie zostaną zapisane.
Następujące /cfg ustawienia też mogą się przydać (nazwy
parametrów mogą w przyszłości ulec zmianie):
Dla porównania plików:
/cfg Settings/DiffContextV2=0 - ukrywa pasujące linie w
raporcie (odpowiednik Widok -> Kontekst różnicowy -> 0 linii).
/cfg Settings/ViewLineNumbers=1 - wyprowadza numery linii
(ustawione na 0, aby wyłączyć).
Dla porównania folderów:
/cfg Settings/DirViewExpandSubdirs=1 - automatycznie
rozwijaj wszystkie podfoldery.
/cfg ReportFiles/ReportType=2 - styl raportu: Prosty HTML.
/cfg ReportFiles/IncludeFileCmpReport=1 - dołącz raporty
porównawcze plików.
conflictfileOkreśla plik konfliktu, zwykle generowany przez system kontroli wersji. Plik konfliktu otwiera się w oknie Porównywanie plików, w którym można łączyć i rozwiązywać konflikty, jak opisano w Rozwiązywanie konfliktów plików. Należy pamiętać, że w przypadku pliku konfliktu nie można używać żadnych innych ścieżek.
/inifile inifileokreśla plik INI używany do ładowania i zapisywania ustawień zamiast rejestru.