.\" {PTM/AB/0.1/21-12-1998/""}
.\" translated by Adam Byrtek <alpha@irc.pl>
.\" ------------
.\" Date: Fri, 11 Sep 1998 19:13:45 +0100
.\" From: Edward Betts <edward@hairnet.demon.co.uk>
.\"
.\" Derived from the GNU diff info page.
.\" May be distributed under the GPL.
.\"
.\" Reformatted, added --binary option, output formats descriptions,
.\" {PTM/WK/2001-I}  <wkotwica@post.pl>
.\" ------------
.TH DIFF 1 "1 padziernika 1994" "Narzdzia rnicowe GNU" "Narzdzia GNU"
.SH NAZWA
diff \- szukanie rnic pomidzy dwoma plikami
.SH SKADNIA
.B diff
.RB [ opcje ]
.I plik1 plik2
.SH OPIS
Dokumentacja niniejsza nie jest ju utrzymywana i moe by niedokadna
lub niekompletna.  Autorytatywnym rdem jest obecnie dokumentacja
Texinfo.  Dostp do niej uzyskasz wpisujc w wierszu polece:
.RS
.B pinfo diff
.RE
lub
.RS
.BR "info diff" .
.RE
W najprostszym przypadku \fBdiff\fP porwnuje zawarto dwch plikw,
\fIplik1\fP i \fIplik2\fP. Nazwa pliku \fB\-\fP oznacza tekst
odczytywany ze standardowego wejcia. W specjalnym przypadku \fB"diff \-
\-"\fP porwnuje kopi standardowego wyjcia ze samym sob.
.PP
Jeli \fIplik1\fP jest katalogiem a \fIplik2\fP nie, \fBdiff\fP
porwnuje plik z katalogu \fIplik1\fP, ktrego nazwa jest taka sama, jak
\fIplik2\fP, i odwrotnie. Plik nie bdcy katalogiem nie moe by \fB\-\fP.
.PP
Jeli zarwno \fIplik1\fP jak i \fIplik2\fP s katalogami, \fBdiff\fP
porwnuje odpowiednie pliki w obu katalogach, w kolejnoci alfabetycznej. To
porwnanie nie jest rekurencyjne, chyba e podano opcj \fB\-r\fP lub
\fB\--recursive\fP.
\fBdiff\fP nigdy nie porwnuje zawartoci katalogu tak, jakby by on
plikiem. Podany plik nie moe by standardowym wejciem, poniewa standardowe 
wejcie nie ma nazwy i nie dotyczy go zapis `plik o tej samej nazwie'.
.PP
Opcje \fBdiff\fP na og zaczynaj si od \fB\-\fP, wic zwykle nazwy plikw
\fIplik1\fP oraz \fIplik2\fP nie mog zaczyna si od \fB\-\fP, jednak
argument \fB\-\-\fP traktuje pozostae argumenty jako nazwy plikw, nawet jeli
zaczynaj si one od \fB\-\fP.
.SH OPCJE
Poniej znajduje si podsumowanie wszystkich opcji akceptowanych przez GNU
\fBdiff\fP. Wikszo opcji posiada dwie rwnowane formy, jedn z nich jest
pojedyncza litera poprzedzona kresk \fB\-\fP, a drug pena nazwa
poprzedzona przez \fB\-\-\fP. Wiele pojedynczych liter opcji (nie
wymagajcych argumentu) moe by czonych w pojedynczym sowie: `\fB\-ac\fP'
jest rwnowane z `\fB\-a \-c\fP'. Opcje w formie penej nazwy mog by
skracane do dowolnego unikalnego przedrostka.
Klamry (\fB[\fP i \fB]\fP) oznaczaj, e opcja pobiera opcjonalny argument.
.TP
.B \-i
.br
.ns
.TP
.B \-\-ignore\-case
Ignorowanie zmian w wielkoci liter, due i mae litery s uznawane za
rwnowane.
.TP
.B \-w
.br
.ns
.TP
.B \-\-ignore\-all\-space
Ignorowanie wszystkich odstpw przy porwnywaniu plikw.
.TP
.B \-b
.br
.ns
.TP
.B \-\-ignore\-space\-change
Ignorowanie zmian w iloci odstpw.
.TP
.B \-B
.br
.ns
.TP
.B \-\-ignore\-blank\-lines
Ignorowanie zmian, ktre jedynie dodaj lub usuwaj puste linie.
.TP
.BI "\-I " regexp
.br
.ns
.TP
.BI \-\-ignore\-matching\-lines= regexp
Ignorowanie zmian, ktre jedynie dodaj lub usuwaj linie pasujce do
wyraenia regularnego \fIregexp\fP.
.TP
.B \-\-binary
\fBdiff\fP normalnie czyta i zapisuje wszystkie dane jako tekst.  Ta opcja
wymusza odczyt i zapis danych w trybie binarnym.  Nie ma efektu na systemach
zgodnych z POSIX, jak GNU czy tradycyjne Uniksy.  Jednak wiele systemw
operacyjnych komputerw osobistych oznacza koniec linii dwuznakow sekwencj:
znakiem powrotu karetki plus znak nowej linii.
Na takich systemach \fBdiff\fP normalnie ignoruje powroty karetki na wejciu
i generuje je na kocu kadej linii wyjciowej, ale z opcj \fB\-\-binary\fP
traktuje powrt karetki jak kady inny znak wejciowy i nie dokada go na
kocu tworzonych linii.  Przydatne do operowania na plikach nie-tekstowych,
ktre maj by wymieniane z systemami POSIX-owymi.
.br
Do porwnywania dwu plikw bajt po bajcie suy polecenie
.BR cmp (1).
.TP
.B \-a
.br
.ns
.TP
.B \-\-text
Traktowanie wszystkich plikw jako pliki tekstowe i porwnywanie ich linia
po linii, nawet jeli nie wygldaj one na pliki tekstowe.

.TP
.B \-c
.br
.ns
.TP
.BI "\-C " linie
.br
.ns
.TP
.BR \-\-context [ = \fIlinie\fP]
Uycie kontekstowego formatu wyjciowego z pokazaniem iloci linii kontekstu
podanej w \fIlinie\fP (warto cakowita), lub trzy jeli nie podano
\fIlinie\fP. Do prawidowego dziaania \fBpatch\fP potrzebuje co najmniej
dwch linii kontekstu.
.TP
.B \-u
.br
.ns
.TP
.BI "\-U " linie
.br
.ns
.TP
.BI \-\-unified[= linie ]
Uycie zunifikowanego formatu wyjciowego i pokazanie iloci linii kontekstu
podanej w \fIlinie\fP (warto cakowita), lub trzy jeli nie podano
\fIlinie\fP. Do prawidowego dziaania \fBpatch\fP potrzebuje co najmniej
dwch linii kontekstu.
.TP
.BI \- linie
Wywietlenie iloci linii kontekstu podanej w \fIlinie\fP (warto
cakowita). Ta opcja nie ustala wyjciowego formatu, nie ma ona efektu jeli
nie podano opcji \-c lub \-u. Ta opcja jest przestarzaa. Do prawidowego
dziaania \fBpatch\fP potrzebuje co najmniej dwch linii kontekstu.
.TP
.BI "\-L " etykieta
.br
.ns
.TP
.BI \-\-label= etykieta
Uycie tekstu \fIetykieta\fP w miejsce nazwy plikw w nagwku formatu
kontekstowego i zunifikowanego.
.TP
.B \-p
.br
.ns
.TP
.B \-\-show\-c\-function
Pokazanie, do jakiej funkcji C naley kada ze zmian.
.TP
.BI "\-F " regexp
.br
.ns
.TP
.BI \-\-show\-function\-line= regexp
Pokazanie ostatniej poprzedzajcej linii, ktra pasuje do wyraenia regularnego
\fIregexp\fP dla kadego rnicego si fragmentu w formacie kontekstowym
i zunifikowanym.
.TP
.B \-q
.br
.ns
.TP
.B \-\-brief
Poinformowanie jedynie o tym, czy pliki si rni, bez podawania szczegw
na temat rnic.
.TP
.B \-e
.br
.ns
.TP
.B \-\-ed
Stworzenie wyjcia, ktre jest poprawnym skryptem \fPed\fP.
.TP
.B \-f
.br
.ns
.TP
.B \-\-forward\-ed
Stworzenie wyjcia, ktre wyglda prawie tak jak skrypt \fBed\fP, ale
zawiera modyfikacje w kolejnoci pojawiania si zmian w pliku.
.TP
.B \-n
.br
.ns
.TP
.B \-\-rcs
Wyprowadzenie rnic w formacie RCS, tak jak \fB\-f\fP, z tym wyjtkiem,
e kada komenda wyszczeglnia numer linii, ktrej dotyczy.
.TP
.B \-y
.br
.ns
.TP
.B \-\-side\-by\-side
Uycie formatu wyjciowego jeden obok drugiego.
.TP
.BI "\-W " kolumny
.br
.ns
.TP
.BI \-\-width= kolumny
Uycie szerokoci wyjcia \fIkolumny\fP w formacie jedna obok drugiej.
.TP
.B \-\-left\-column
Wywietlenie jedynie lewej kolumny z dwch wsplnych w formacie jedna obok
drugiej.
.TP
.B \-\-suppress\-common\-lines
Nie wywietlanie wsplnych linii w formacie jedna obok drugiej.
.TP
.BI "\-D " nazwa
.br
.ns
.TP
.BI \-\-ifdef= nazwa
Stworzenie poczonego wyjcia w formacie \fB\#ifdef\fP, zalenego od makra
preprocesora \fInazwa\fP.
.TP
.BI \-\-old\-group\-format= formatgrupy
Uycie formatu \fIformatgrupy\fP do wyprowadzenia grupy linii wzitej
jedynie z pierwszego pliku.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.TP
.BI \-\-new\-group\-format= formatgrupy
Uycie formatu \fIformatgrupy\fP do wyprowadzenia grupy linii wzitej
jedynie z drugiego pliku.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.TP
.BI \-\-changed\-group\-format= formatgrupy
Uycie formatu wyjciowego \fIformatgrupy\fP do wywietlania grupy linii
zawierajcych rnice si linie z obu plikw.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.TP
.BI \-\-unchanged\-group\-format= formatgrupy
Uycie formatu \fIformatgrupy\fP do wyprowadzenia wsplnej grupy linii
wzitej z obu plikw.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.RS

.B Format grupy linii
.br
W formacie okrelajcym sposb wypisania grupy linii zwyke znaki oznaczaj
same siebie;
specyfikacje konwersji zaczynaj si od znaku procentu \fB%\fP i maj jedn
z poniszych postaci:
.TP 3
.B %\<
linie z \fIplik1\fP, cznie z kocowym znakiem nowej linii, formatowane
zgodnie z formatem starych linii
.TP 3
.B %\>
linie z \fIplik2\fP, formatowane zgodnie z formatem nowych linii
.TP 3
.B %\=
linie wsplne dla obu plikw, formatowane zgodnie z formatem linii
niezmienionych
.TP 3
.BR % [ - ][\fIszer\fP][ . [\fIdok\fP]]{ doxX } \fIlitera\fP
warto okrelona \fIliter\fP, sformatowana w stylu printf.
.I litery
maj, w odniesieniu do grup linii w nowym pliku, nastpujce znaczenie
(dla grup w starym pliku uywa si maych liter):
.nf
   \fBF\fP  numer pierwszej linii
   \fBL\fP  numer ostatniej linii
   \fBN\fP  ilo linii = L-F+1
   \fBE\fP  F-1
   \fBM\fP  L+1
.fi
.TP 3
.B %%
pojedynczy dosowny znak procentu \fB%\fP.
.TP 3
.BI %c' C '
gdzie \fIC\fP jest pojedynczym znakiem, oznacza \fIC\fP.  Nie moe to by
odwrotny ukonik ani apostrof. Na przykad,
.B %c':'
oznacza dwukropek, nawet wewntrz czci then formatu if\-then\-else, ktr
normalnie by koczy.
.TP 3
.BI %c'\e O '
gdzie \fIO\fP jest acuchem 1, 2 lub 3 cyfr semkowych, oznacza
znak o kodzie semkowym \fIO\fP.  Na przykad, 
.B %c'\e0'
oznacza znak null.
.TP 3
.BI ( A = B ? T : E )
Jeli \fIA\fP rwna si \fIB\fP, to \fIT\fP, w przeciwnym razie \fIE\fP.
\fIA\fP i \fIB\fP s albo obie staymi podanymi dziesitnie albo pojedynczymi
literami, interpretowanymi jak wyej.
.RE
.TP
.BI \-\-line\-format= formatlinii
Uycie formatu \fIformatlinii\fP do wyprowadzenia wszystkich linii.
To samo, co rwnoczesne uycie wszystkich opcji formatowania linii
.RB ( --old-line-format ", " --new-line-format ", " --unchanged-line-format )
z tym samym formatem.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.TP
.BI \-\-old\-line\-format= formatlinii
Uycie formatu \fIformatlinii\fP do wyprowadzenia linii wzitej jedynie
z pierwszego pliku.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.TP
.BI \-\-new\-line\-format= formatlinii
Uycie formatu \fIformatlinii\fP do wyprowadzenia linii wzitej jedynie
z drugiego pliku.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.TP
.BI \-\-unchanged\-line\-format= formatlinii
Uycie formatu \fIformatlinii\fP do wyprowadzenia wsplnej linii wzitej
z obu plikw.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if\-then\-else.
.RS

.B Format linii
.br
W formacie okrelajcym sposb wypisania linii zwyke znaki oznaczaj
same siebie;
specyfikacje konwersji zaczynaj si od znaku procentu \fB%\fP i maj jedn
z poniszych postaci:
.TP 3
.B %l
zawarto danej linii, nie liczc koczcego j znaku nowej linii (jeli
jest takowy).  Ten format ignoruje czy linia jest niekompletna czy
poprawnie zakoczona.
.ns
.TP 3
.B %L
zawarto danej linii, cznie z koczcym j znakiem nowej linii (jeli
jest takowy).  Jeeli linia jest niekompletna, to zachowuje t niekompletno.
.ns
.TP 3
.BR % [ - ][\fIszer\fP][ . [\fIdok\fP]]{ doxX } n
numer linii wejciowej, sformatowany w stylu printf.
.TP 3
.B %%
dosowny znak procentu \fB%\fP.
.TP 3
.BI %c' C '
dosowny znak \fIC\fP.  Nie moe to by odwrotny ukonik ani apostrof.
.TP 3
.BI %c'\e O '
znak o kodzie semkowym \fIO\fP.
.RE

.TP
.B \-l
.br
.ns
.TP
.B \-\-paginate
Przesanie wyjcia przez \fBpr\fP, aby podzieli je na strony.
.TP
.B \-t
.br
.ns
.TP
.B \-\-expand\-tabs
Rozszerzanie tabulatorw do spacji na wyjciu, aby zachowa oryginalne
uoenie tabulatorw pliku wejciowego.
.TP
.B \-T
.br
.ns
.TP
.B \-\-initial\-tab
Wyprowadzenie tabulatora zamiast spacji przed tekstem linii w formacie
normalnym lub kontekstowym. Powoduje to normalny wygld tabulatorw w linii.

.TP
.B \-r
.br
.ns
.TP
.B \-\-recursive
Rekurencyjne porwnanie wszystkich podkatalogw, jeli porwnywane s katalogi.
.TP
.B \-N
.br
.ns
.TP
.B \-\-new\-file
Jeli podczas porwnywania katalogw plik istnieje jedynie w jednym z
katalogw, bdzie traktowany tak, jakby by obecny w drugim katalogu, ale
pusty.
.TP
.B \-P
.br
.ns
.TP
.B \-\-unidirectional\-new\-file
Jeli podczas porwnywania katalogw plik istnieje jedynie w drugim katalogu,
bdzie traktowany tak, jakby by obecny w pierwszym katalogu, ale pusty.
.TP
.B \-s
.br
.ns
.TP
.B \-\-report\-identical\-files
Poinformowanie, jeli oba pliki s identyczne.
.TP
.BI "\-x " wzorzec
.br
.ns
.TP
.BI \-\-exclude= wzorzec
Podczas porwnywania katalogw, ignorowanie plikw i podkatalogw, ktrych
nazwy pasuj do wzorca \fIwzorzec\fP.
.TP
.BI "\-X " plik
.br
.ns
.TP
.BI \-\-exclude\-from= plik
Podczas porwnywania katalogw, ignorowanie plikw i podkatalogw, ktrych
nazwa pasuje do jednego z wzorcw podanych w pliku \fIplik\fP.
.TP
.BI "\-S " plik
.br
.ns
.TP
.BI \-\-starting\-file= plik
Podczas porwnywania katalogw rozpoczcie od pliku \fIplik\fP. Opcja ta
jest uyteczna podczas wznawiania przerwanego porwnania.

.TP
.BI \-\-horizon\-lines= linie
Nie ignorowanie ostatnich \fIlinie\fP linii wsplnego przedrostka oraz
pierwszych \fIlinie\fP linii wsplnego przyrostka.
.TP
.B \-d
.br
.ns
.TP
.B \-\-minimal
Zmiana algorytmu na taki, ktry moe czasami znale mniejsz liczb zmian.
Spowalnia to dziaania \fBdiff\fP (czasami bardzo znacznie).
.TP
.B \-H
.br
.ns
.TP
.B \-\-speed\-large\-files
Uycie algorytmw heurystycznych aby przyspieszy przeszukiwanie duych
plikw ze znaczn liczb rozrzuconych maych zmian.

.TP
.B \-h
Ta opcja aktualnie nie ma adnego efektu, ale istnieje dla zgodnoci
z systemem Unix.
.TP
.B \-\-sdiff\-merge\-assist
Wywietlenie dodatkowych informacji pomocnych dla \fBsdiff\fP. \fBsdiff\fP
korzysta z tej opcji gdy uruchamia \fBdiff\fP. Uytkownicy nie powinni
korzysta z tej opcji bezporednio.

.TP
.B \-\-help
Wywietlenie informacji o stosowaniu programu i dostpnych opcjach.
.TP
.B \-v
.br
.ns
.TP
.B \-\-version
Wywietlenie numeru wersji programu.
.SH KOPIOWANIE
Plik ten powsta na podstawie podrcznika info pakietu diffutils.

Copyright (C) 1992, 1993, 1994 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the entire
resulting derived work is distributed under the terms of a permission
notice identical to this one.

Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation approved
by the Foundation.
.SH ZOBACZ TAKE
.BR cmp (1),
.BR comm (1),
.BR diff3 (1),
.BR ed (1),
.BR patch (1),
.BR pr (1),
.BR sdiff (1).
.SH DIAGNOSTYKA
Zwracana warto 0 oznacza, e nie odnaleziono rnic, 1 oznacza znalezienie
rnic, a 2 kopoty.