DIFF(1) Narzędzia GNU DIFF(1)


NAZWA
diff - szukanie różnic pomiędzy dwoma plikami

SKŁADNIA
diff [options] from-file to-file

OPIS
W najprostszym przypadku diff porównuje zawartość dwóch
plików, from-file i to-file. Nazwa pliku - oznacza tekst
odczytywany ze standardowego wejścia. W specjalnym przy�
padku "diff - -" porównuje kopię standardowego wyjścia ze
samym sobą.

Jeśli from-file jest katalogiem a to-file nie, diff
porównuje plik z katalogu from-file którego nazwa jest
taka sama, jak to-file, i odwrotnie. Plik nie będący kata�
logiem nie może być -.

Jeśli zarówno from-file jak i to-file są katalogami, diff
porównuje odpowiednie pliki w obu katalogach, w kolejności
alfabetycznej. To porównanie nie jest rekurencyjne, chyba
że podano opcję -r lub -recursive. diff nigdy nie
porównuje zawartości katalogu tak, jakby był on plikiem.
Podany plik nie może być standardowym wejściem, ponieważ
standardowe wejście nie ma nazwy i nie dotyczy go zapis
`plik o tej samej nazwie'.

Opcje diff na ogół zaczynają się od -, więc zwykle nazwy
plików from-file oraz to-file nie mogą zaczynać się od -,
jednak argument -- traktuje pozostałe argumety jako nazwy
plików, nawet jeśli zaczynają się one od -.

Opcje
Poniżej znajduje się podsumowanie wszystkich opcji akcep�
towanych przez GNU diff. Większośc opcji posiada dwie
równoważne formy, jedną z nich jest pojedyncza litera
poprzedzona przez -, a drugą pełna nazwa poprzedzona przez
--. Wiele pojedynczych liter opcji (nie wymagających argu�
mentu) może być łączonych w poledynczym słowie: -ac jest
równoważne z -a -c. Opcje w formie pełnej nazwy mogą być
skracane do dowolnego unikalnego przedrostka. Klamry ( [
i ] ) oznaczają, że opcja pobiera opcjonaly argument.

-lines Wyświetlenie ilości linii kontekstu podanej w lines
(wartość całkowita). Ta opcja nie ustala
wyjściowego formatu, nie ma ona efektu jeśli nie
podano opcji -c lub -u. Ta opcja jest przestarzała.
Do prawidłowego działania patch potrzebuje co najm�
niej dwóch linii kontekstu. -a Traktowanie wszyst�
kich plików jako pliki tekstowe i porównywanie ich
linia po linii, nawet jeśli nie wyglądają one na
pliki tekstowe.

-b Ignorowanie zmian w ilości odstępów.



Narzędzia GNU 22 Wrzesień 1993 1





DIFF(1) Narzędzia GNU DIFF(1)


-B Ignorowanie zmian, które jedynie dodają lub usuwają
puste linie.

--brief
Poinformowanie jedynie o tym, czy pliki się różnią,
bez podawania szczegółów na temat różnic.

-c Użycie kontekstowego formatu wyjściowego.

-C lines
--context[=lines]
Użycie kontekstowego formatu wyjściowego i
pokazanie ilości linii kontekstu podanej w lines
(wartość całkowita), lub trzy jeśli nie podano
lines. Do prawidłowego działania patch potrzebuje
co najmniej dwóch linii kontekstu.

--changed-group-format=format
Użycie formatu wyjściowego format do wyświetlania
grupy linii zawierających różniące się linie z obu
plików w formacie if-then-else.

-d Zmiana algorytmu na taki, który może czasami
znaleźć większą liczbę zmian. Spowalnia to
działania diff (czasami bardzo znacznie).

-D name
Stworzenie połączonego formatu wyjścia if-then-
else, w zależności od makra preprocesora name.

-e
--ed Stworzenie wyjścia, które jest poprawnym skryptem
ed.

--exclude=pattern
Ignorowanie plików i podkatalogów, których nazwy
pasują do wzorca pattern podczas porównywania kata�
logów.

--exclude-from=file
Ignorowanie plików i podkatalogów, których nazwy
pasują do każdego wzorca zawartego w pliku file
podczas porównywania katalogów.

--expand-tabs
Rozszerzanie tabulatorów do spacji na wyjściu, aby
zachować oryginalne ułożenie tabulatorów pliku
wejściowego.

-f Stworzenie wyjścia, które wygląda prawie tak jak
skrypt ed, ale zawiera modyfikacje w kolejności
pojawiania się zmian w pliku.





Narzędzia GNU 22 Wrzesień 1993 2





DIFF(1) Narzędzia GNU DIFF(1)


-F regexp
Pokazanie ostatniej poprzedzającej linii, która
pasuje do regexp dla każdego różniącego się frag�
mentu w formacie kontekstowym i zunifikowanym.

--forward-ed
Stworzenie wyjścia, które wygląda prawie tak jak
skrypt ed, ale zawiera modyfikacje w kolejności
pojawiania się zmian w pliku.

-h Ta opcja aktualnie nie ma żadnego efekty, ale ist�
nieje dla kompatybilności z systemem Unix.

-H Użycie algorytmów heurystycznych aby przyspieszyć
przeszukiwanie dużych plików ze znaczną liczbą
rozrzuconych małych zmian.

--horizon-lines=lines
Nie ignorowanie ostatnich lines linii wspólnego
przedrostka oraz pierwszych lines linii wspólnego
przyrostka.

-i Ignorowanie zmian w wielkości liter, duże i małe
litery są uznawane za równoważne.

-I regexp
Ignorowanie zmian, które jedynie dodają lub usuwają
linie pasujące do regexp.

--ifdef=name
Stworzenie wyjścia w połączonym formacie
if-then-else, zależnie od makra preprocesora name.

--ignore-all-space
Ignorowanie wszystkich odstępów przy porównywaniu
plików.

--ignore-blank-lines
Ignorowanie zmian, które jedynie dodają lub usuwają
puste linie.

--ignore-case
Ignorowanie zmian w wielkości liter, duże i małe
litery są uznawane za równoważne.

--ignore-matching-lines=regexp
Ignorowanie zmian, które jedynie dodają lub usuwają
linie pasujące do regexp.

--ignore-space-change
Ignorowanie zmian w ilości odstępów.

--initial-tab
Wyprowadzenie tabulatora zamiast spacji przed



Narzędzia GNU 22 Wrzesień 1993 3





DIFF(1) Narzędzia GNU DIFF(1)


tekstem linii w formacie normalnym lub kontek�
stowym. Powoduje to normalny wygląd tabulatorów w
linii.

-l Przesłanie wyjścia przez pr, aby podzielić je na
strony.

-L label
--label=label
Użycie tekstu label w miejsce nazwy plikó w
nagłówku formatu kontekstowego i zunifikowanego.

--left-column
Wyświetlenie jedynie lewej kolumy z dwóch kolum w
formacie jeden obok drugiego.

--line-format=format
Użycie formatu format aby wyprowadzić wszystkie
linie w formacie if-then-else.

--minimal
Zmiana algorytmu na taki, który może czasami
znaleźć większą liczbę zmian. Spowalnia to
działania diff (czasami bardzo znacznie).

-n Wyprowadzenie różnic w formacie RCS, tak jak -f, z
tym wyjątkiem, że każda komenda wyszczególnia numer
linii której dotyczy.

-N
--new-file
Jeśli podczas porównywania katalogów plik istnieje
jedynie w jednym z katalogów, będzie traktowany
tak, jakby był obecny w drugim katalogu, ale pusty.

--new-group-format=format
Użycie formatu format do wyprowadzenia grupy linii
wziętej jedynie z drugiego pliku w formacie
if-then-else.

--new-line-format=format
Użycie formatu format do wyprowadzenia linii
wziętej jedynie z drugiego pliku w formacie
if-then-else.

--old-group-format=format
Użycie formatu format do wyprowadzenia grupy linii
wziętej jedynie z pierwszego pliku w formacie
if-then-else.

--old-line-format=format
Użycie formatu format do wyprowadzenia linii
wziętej jedynie z pierwszego pliku w formacie
if-then-else.



Narzędzia GNU 22 Wrzesień 1993 4





DIFF(1) Narzędzia GNU DIFF(1)


-p Pokazanie, do jakiej funkcji C należy każda ze
zmian.

-P Jeśli podczas porównywania katalogów plik istnieje
jedynie w drugim katalogu, będzie traktowany tak,
jakby był obecny w pierwszym katalogu, ale pusty.

--paginate
Przesłanie wyjścia przez pr, aby podzielić je na
strony.

-q Poinformowanie jedynie o tym, czy pliki się różnią,
bez podawania szczegółów na temat różnic.

-r Rekurencyjne porównanie wszystkich podkatalogów,
jeśli porównywane są katalogi.

--rcs Wyprowadzenie różnic w formacie RCS, tak jak -f, z
tym wyjątkiem, że każda komenda wyszczególnia numer
linii której dotyczy.

--recursive
Rekurencyjne porównanie wszystkich podkatalogów,
jeśli porównywane są katalogi.

--report-identical-files
-s Poinformowanie, jeśli oba pliki są identyczne.

-S file
Podczas porównywania katalogów rozpoczęcie od pliku
file. Opcja ta jest użyteczna podczas wznawiania
przerwanego porównania.

--sdiff-merge-assist
Wyświetlenie dodatkowych informacji pomocnych dla
sdiff. sdiff korzysta z tej opcji gdy uruchamia
diff. Użytkownicy nie powinni korzystać z tej opcji
dezpośrednio.

--show-c-function
Pokazanie, do jakiej funkcji C należy każda ze
zmian.

--show-function-line=regexp
Pokazanie ostatniej poprzedzającej linii, która
pasuje do regexp dla każdego różniącego się frag�
mentu w formacie kontekstowym i zunifikowanym.
regexp.

--side-by-side
Użycie formatu wyjściowego jedno obok drugiego.

--speed-large-files
Użycie algorytmów heurystycznych aby przyspieszyć



Narzędzia GNU 22 Wrzesień 1993 5





DIFF(1) Narzędzia GNU DIFF(1)


przeszukiwanie dużych plików ze znaczną liczbą
rozrzuconych małych zmian.

--starting-file=file
Podczas porównywania katalogów rozpoczęcie od pliku
file. Opcja ta jest użyteczna podczas wznawiania
przerwanego porównania.

--suppress-common-lines
Nie wyświetlanie wspólnych linii w formacie jeden
obok drugiego.

-t Rozszerzanie tabulatorów do spacji na wyjściu, aby
zachować oryginalne ułożenie tabulatorów pliku
wejściowego.

-T Wyprowadzenie tabulatora zamiast spacji przed tek�
stem linii w formacie normalnym lub kontekstowym.
Powoduje to normalny wygląd tabulatorów w linii.

--text Traktowanie wszystkich plików jako pliki tekstowe i
porównywanie ich linia po linii, nawet jeśli nie
wyglądają one na pliki tekstowe.

-u Użycie zunifikowanego formatu wyjściowego.

--unchanged-group-format=format
Użycie formatu format do wyprowadzenia wspólnej
grupy linii wziętej z obu plików w formacie
if-then-else.

--unchanged-line-format=format
Użycie formatu format do wyprowadzenia wspólnej
linii wziętej z obu plików w formacie if-then-else.

--unidirectional-new-file
Jeśli podczas porównywania katalogów plik istnieje
jedynie w drugim katalogu, będzie traktowany tak,
jakby był obecny w pierwszym katalogu, ale pusty.

-U lines
--unified[=lines]
Użycie kontekstowego formatu wyjściowego i
pokazanie ilości linii kontekstu podanej w lines
(wartość całkowita), lub trzy jeśli nie podano
lines. Do prawidłowego działania patch potrzebuje
co najmniej dwóch linii kontekstu.

-v
--version
Wyświetlenie informacji o wersji diff.

-w Ignorowanie odstępów podczas porównywania linii.




Narzędzia GNU 22 Wrzesień 1993 6





DIFF(1) Narzędzia GNU DIFF(1)


-W columns
--width=columns
Użycie szerokości wyjścia columns w formacie jeden
obok drugiego.

-x pattern
Podczas porównywania katalogów, ignorowanie plików
i podkatalogów których nazwa pasuje do wzorca pat�
tern.

-X file
Podczas porównywania katalogów, ignorowanie plików
i podkatalogów których nazwa pasuje do jednego z
wzorców podanych w pliku file.

-y Użycie formatu wyjściowego jeden obok drugiego.

PATRZ TAKŻE
cmp(1), comm(1), diff3(1), ed(1), patch(1), pr(1),
sdiff(1).

DIAGNOSTYKA
Zwracana wartość 0 oznacza że nie odnaleziono różnic, 1
oznacza pewne różnica a 2 kłopoty.

































Narzędzia GNU 22 Wrzesień 1993 7