%& -translate-file=il2-pl
\def\fontprefix{pl}
\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename diffutils.info
@settitle Porwnywanie i scalanie plikw
@setchapternewpage odd
@documentencoding ISO-8859-2
@documentlanguage pl
@c %**end of header

@set TRANSLATED marzec 2001

@ifinfo
@format
START-INFO-DIR-ENTRY
* Porwnywanie i scalanie plikw: (diffutils).      Narzdzia rnicowe GNU.
* cmp: (diffutils)Wywoanie cmp.           Porwnuje dwa pliki binarnie.
* diff: (diffutils)Wywoanie diff.         Porwnuje dwa pliki tekstowe.
* diff3: (diffutils)Wywoanie diff3.       Porwnuje trzy pliki tekstowe.
* patch: (diffutils)Wywoanie patch.       ata plik ze starego tworzc nowy.
* sdiff: (diffutils)Wywoanie sdiff.       Interaktywnie scala zmiany.
END-INFO-DIR-ENTRY
@end format
@end ifinfo

@ifinfo
Plik ten dokumentuje polecenia @code{diff}, @code{diff3}, @code{sdiff}
i @code{cmp} w wersji GNU, pokazujce rnice pomidzy plikami tekstowymi
oraz polecenie @code{patch} do korzystania z ich wynikw do aktualizacji
plikw.

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.

@ignore
Permission is granted to process this file through TeX and print the
results, provided the printed document carries copying permission
notice identical to this one except for the removal of this paragraph
(this paragraph not being relevant to the printed manual).

@end ignore
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.
@end ifinfo

@titlepage
@title Porwnywanie i scalanie plikw
@subtitle @code{diff}, @code{diff3}, @code{sdiff}, @code{cmp} i @code{patch}
@subtitle Wydanie 1.3, do @code{diff} 2.5 i @code{patch} 2.1
@subtitle wrzesie 1993
@author napisali: David MacKenzie, Paul Eggert i Richard Stallman

@page
@vskip 0pt plus 1filll
Copyright @copyright{} 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.
@end titlepage

@node Top, , , (dir)

@ifinfo
Plik ten dokumentuje polecenia @code{diff}, @code{diff3}, @code{sdiff}
i @code{cmp} w wersji GNU, pokazujce rnice pomidzy plikami tekstowymi
oraz polecenie @code{patch} do korzystania z ich wynikw do aktualizacji
plikw.

@c HQ: w oryginale diff 2.4, inaczej ni wyej !
To jest wydanie 1.3, do @code{diff} 2.5 i @code{patch} 2.1.
@end ifinfo

@menu
* Od tumacza::		Par sw od tumacza.

* Oglny opis::		Wstpne informacje.

* Porwnanie::		Co to znaczy porwnanie plikw.
* Formaty wyjciowe::	Formaty zestawie rnic.
* Porwnywanie katalogw::	Porwnywanie plikw i katalogw.
* Dostosowywanie wyjcia::	Upikszanie wyjcia @code{diff}.
* Wydajno diff::	Przyspieszanie i usprytnianie @code{diff}.
* Porwnanie trzech plikw::	Formaty raportw rnic trjstronnych.

* Scalanie diff3::	Scalanie wedug wsplnego przodka.
* Interaktywne scalanie::	Interaktywne scalanie za pomoc @code{sdiff}.
* Scalanie z patch::	Uycie @code{patch} do zmiany starych plikw w nowe.
* Tworzenie at::	Wskazwki, jak tworzy rozsyane aty.

* Wywoanie cmp::	Sposb uruchamiania @code{cmp} i zestawienie opcji.
* Wywoanie diff::	Sposb uruchamiania @code{diff} i zestawienie opcji.
* Wywoanie diff3::	Sposb uruchamiania @code{diff3} i zestawienie opcji.
* Wywoanie patch::	Sposb uruchamiania @code{patch} i zestawienie opcji.
* Wywoanie sdiff::	Sposb uruchamiania @code{sdiff} i zestawienie opcji.

* Niekompletne linie::	Linie z brakujcym zakoczeniem znakiem nowej linii.
* Plany::		Jeli sdzisz, e znalaze bd lub niedocignicie.

* Indeks poj::	Skorowidz poj.
@end menu


@node Od tumacza, Oglny opis, , Top
@unnumbered Od tumacza
Niniejszy przekad powsta
w ramach @uref{http://ptm.linux.pl/, Projektu Tumaczenia Manuali}
z wykorzystaniem istniejcych tumacze stron podrcznika systemowego
man do programw @code{diff} i @code{patch}, ktre wykonali:
Przemek Borys (@email{pborys@@p-soft.silesia.linux.org.pl})
oraz Adam Byrtek (@email{alpha@@irc.pl}).

Wykorzystany fragment Ksigi Drogi i Cnoty Lao-Tsy -- na podstawie przekadw
Tadeusza bikowskiego (@cite{Literatura na wiecie}, 1987, nr 1)
oraz anonimowego L.Z. (http://www.nnk.art.pl/kluseczka/tao_te_king.html).

Obecnie (@value{TRANSLATED}), zawarty w podrczniku systemowym man opis
GNU @code{patch} jest bardziej aktualny.  Do czasu aktualizacji niniejszego
dokumentu wszelkie wtpliwoci zwizane ze szczegami dziaania @code{patch}
najlepiej rozstrzyga zagldajc do podrcznika systemowego.

Zgoszenia bdw, komentarze i sugestie
prosz przesya na list dyskusyjn Projektu: @email{ptm@@amg.net.pl}.

W.Kotwica (@email{wkotwica@@post.pl})

@unnumberedsec Rozpowszechnianie
To jest nieoficjalne tumaczenie warunkw rozpowszechniania na jzyk polski.
Nie zostao ono opublikowane przez Free Software Foundation
i pod wzgldem prawnym nie stanowi warunkw rozpowszechniania -- ustanawia
je wycznie oryginalny tekst angielski.  Jednak tumacz ma nadziej, e
pomoe ono lepiej zrozumie warunki rozpowszechniania osobom mwicym
po polsku.

This is an unofficial translation of the distribution terms into
Polish language. It was not published by the Free Software Foundation, and
does not legally state the distribution terms--only the original English text
does that. However, the translator hopes that it will help Polish language
speakers understand distribution terms better.

Zezwala si na tworzenie i rozpowszechnianie wiernych kopii
tego podrcznika, pod warunkiem, e na wszystkich kopiach zostanie zachowana
informacja o prawach autorskich i niniejsze zezwolenie.

Zezwala si na kopiowanie i rozpowszechnianie zmienionych wersji
tego podrcznika na warunkach jak dla wiernych kopii, pod warunkiem, e
caa praca pochodna bdzie rozpowszechniana na warunkach zezwolenia
identycznego jak niniejsze.

Zezwala si na kopiowanie i rozpowszechnianie tumacze tego
podrcznika na inny jzyk, pod wyej podanymi warunkami dla zmienionych
wersji, z wyjtkiem tego, e niniejsze zezwolenie moe by ustanowione
w tumaczeniu zaakceptowanym przez Fundacj.

@node Oglny opis, Porwnanie, Od tumacza , Top
@unnumbered Oglny opis
@cindex oglny opis @code{diff} i @code{patch}

Uytkownicy komputerw czsto maj powd, by pyta jak rni si od siebie
dwa pliki.  By moe jeden z plikw jest nowsz wersj drugiego.  Albo moe
oba pochodz od identycznych kopii, ale zostay zmienione przez rne osoby.

Do pokazania rnic pomidzy dwoma plikami lub odpowiadajcymi sobie plikami
w dwu katalogach korzystamy z polecenia @code{diff}.  Wypisuje ono
rnice pomidzy plikami, wiersz po wierszu, w jednym z kilku dostpnych
formatw, ktre mona wybra opcjami wiersza polece.  Taki komplet rnic
jest czsto zwany @dfn{rnic} (@dfn{diff}) lub @dfn{at} (@dfn{patch}).
Dla plikw, ktre s identyczne normalnie @code{diff} nie tworzy adnego
wyjcia; dla plikw binarnych (nie-tekstowych), @code{diff} normalnie zgasza
tylko, e s rne.

Do pokazania offsetw (pozycji w pliku) i numerw linii, gdzie dwa pliki si
rni korzystamy z polecenia @code{cmp}.  Moe ono take pokaza, jeden obok
drugiego, wszystkie znaki, ktrymi pliki si rni.  Innym sposobem
porwnania dwu plikw znak po znaku jest polecenia Emacs-a
@kbd{M-x compare-windows}.
@xref{Other Window, , Other Window, emacs, The GNU Emacs Manual},
gdzie opisano je dokadniej.

Do pokazania rnic pomidzy trzema plikami korzystamy z polecenia
@code{diff}.  Gdy dwie osoby niezalenie od siebie naniosy zmiany w tym
samym pierwowzorze, @code{diff3} potrafi zgosi rnice pomidzy oryginaem,
a zmienionymi wersjami i utworzy scalony plik, zawierajcy poprawki obu
osb z ostrzeeniami o konfliktach.

Do interaktywnego scalania dwu plikw korzystamy z polecenia @code{sdiff}.

Zbir rnic utworzony przez @code{diff} mona wykorzysta do przekazania
aktualizacji plikw tekstowych (jak np. kod rdowy programw) innym osobom.
Metoda ta jest szczeglnie przydatna gdy rnice s niewielkie w stosunku
do caoci plikw.  Majc wyjcie polecenia @code{diff}, mona skorzysta
z programu @code{patch} by uaktualni, @dfn{zaata}, dany egzemplarz pliku.
Jeli spojrzymy na @code{diff} jak na odejmowanie jednego pliku od drugiego
w celu uzyskania ich rnicy, to moemy traktowa @code{patch} jak dodawanie
rnicy do jednego pliku by otrzyma drugi.

Ten podrcznik najpierw koncentruje si na tworzeniu rnic, a potem
pokazuje, jak uy je do aktualizacji plikw.

GNU @code{diff} napisali Mike Haertel, David Hayes, Richard
Stallman, Len Tower i Paul Eggert.  Wayne Davison zaprojektowa
i zaimplementowa zunifikowany format wyjciowy.  Podstawowy algorym opisano
w ``An O(ND) Difference Algorithm and its Variations'', Eugene W. Myers,
@cite{Algorithmica} Vol.@: 1 No.@: 2, 1986, pp.@: 251--266; oraz w ``A File
Comparison Program'', Webb Miller i Eugene W. Myers,
@cite{Software---Practice and Experience} Vol.@: 15 No.@: 11, 1985,
pp.@: 1025--1040.
@c From: "Gene Myers" <gene@cs.arizona.edu>
@c They are about the same basic algorithm; the Algorithmica
@c paper gives a rigorous treatment and the sub-algorithm for
@c delivering scripts and should be the primary reference, but
@c both should be mentioned.
Algorytm ten zosta niezalenie odkryty, jak opisano w
``Algorithms for Approximate String Matching'',
E. Ukkonen, @cite{Information and Control} Vol.@: 64, 1985, pp.@: 100--118.
@c From: "Gene Myers" <gene@cs.arizona.edu>
@c Date: Wed, 29 Sep 1993 08:27:55 MST
@c Ukkonen should be given credit for also discovering the algorithm used
@c in GNU diff.

GNU @code{diff3} jest napisa Randy Smith.  GNU @code{sdiff} napisa Thomas
Lord.  GNU @code{cmp} napisali Torbjorn Granlund i David MacKenzie.

@code{patch} zosta napisany gwnie przez Larry'ego Wall;
rozszerzenia GNU napisali gwnie Wayne Davison i David MacKenzie.
Czci tego podrcznika zostay zaadaptowane z podrcznika systemowego man,
ktry napisa Larry Wall, za jego zgod.

@node Porwnanie, Formaty wyjciowe, Oglny opis, Top
@chapter Co to znaczy porwnanie
@cindex wprowadzenie

Rnice pomidzy dwoma plikami mona postrzega na kilka sposobw.
Z pewnego punktu widzenia rnice s pewnym cigiem linii, ktre usunito,
wstawiono lub zmieniono w pliku, by otrzyma inny plik.  @code{diff}
porwnuje pliki linia po linii, odnajduje grupy rnicych si linii
i informuje o kadej takiej grupie.  Rnice si linie potrafi wywietli
w rnych formatach, do rnych zastosowa.

GNU @code{diff} moe pokaza, czy pliki si rni, bez wyszczeglniania
rnic.  Umoliwia te pominicie pewnych rodzajw rnic, ktre nie s dla
nas istotne.  Najczciej takimi rnicami s zmiany liczby biaych znakw
(odstpw) midzy sowami czy liniami.  @code{diff} pozwala te na
nieuwzgldnianie rnic w wielkoci liter czy zmian w liniach pasujcych
do wskazanego wyraenia regularnego.  Opcje te mona sumowa: na przykad,
moemy ignorowa zarwno zmiany iloci biaych znakw, jak i wielkoci liter.

Z innego punktu widzenia rnice pomidzy plikami to pewien cig par znakw,
ktre s albo identyczne albo rne od siebie.  @code{cmp} podaje rnice
midzy dwoma plikami znak po znaku, a nie linia po linii.  Wskutek tego, do
porwnywania plikw binarnych jest przydatniejszy ni @code{diff}.  Przy
plikach tekstowych przydaje si gwnie wtedy, gdy chcemy wiedzie tylko, czy
dwa pliki s identyczne czy nie.

Dla porwnania skutkw, jakie moe mie rozwaanie zmian znak po znaku
w porwnaniu z analizowaniem ich linia po linii, zastanwmy si, co si
stanie gdy na pocztku pliku dooymy pojedynczy znak nowej linii.
Jeli nasz plik porwnamy nastpnie z plikiem, w ktrym nie ma tego znaku,
a ktry poza tym jest identyczny, @code{diff} poinformuje, e do pliku
zostaa dodana pusta linia, podczas gdy @code{cmp} zamelduje, e prawie
wszystkie znaki obu plikw si rni.

@code{diff3} normalnie porwnuje linia po linii trzy pliki wejciowe,
znajduje grupy linii, ktre si rni i powiadamia o kadej takiej grupie.
Jego wyjcie zaprojektowano tak, by atwo byo sprawdzi dwa rne zbiory
zmian wykonanych na tym samym pliku.

@menu
* Porcje::		Grupy rnicych si linii.
* Odstpy::		Pomijanie rnic o odstpy.
* Puste linie::		Pomijanie rnic o puste linie.
* Wielko liter::	Pomijanie rnic w wielkoci liter.
* Pomijanie podanych::	Pomijanie rnic pasujcych do wyraenia regularnego.
* Krtko::		Podsumowywanie, ktre pliki si rni.
* Binarnie::		Porwnywanie plikw binarnych lub wymuszanie
			porwna tekstowych.
@end menu

@node Porcje, Odstpy, , Porwnanie
@section Porcje
@cindex porcje

Przy porwnywaniu dwu plikw @code{diff} znajduje cigi linii wsplnych
obu plikom, poprzeplatane grupami linii rnicych si zwanych kawakami,
porcjami, fragmentami (@dfn{hunks}).    Porwnanie dwu identycznych plikw
zwraca jeden cig wsplnych linii i adnych porcji, gdy adne linie
nie rni si od siebie.  Porwnanie dwu cakowicie odmiennych plikw nie
daje w ogle wsplnych linii tylko jedn wielk porcj, ktra zawiera
wszystkie linie obu plikw.  Oglnie, istnieje wiele sposobw dopasowywania
linii z danych dwu plikw.  @code{diff} prbuje zminimalizowa cakowity
rozmiar porcji odnajdujc dugie cigi wsplnych linii przeplecione maymi
porcjami rnych linii.

Na przykad, zamy, e plik @file{F} zawiera trzy linie @samp{a}, @samp{b},
@samp{c}, a plik @file{G} zawiera te same trzy linie w odwrotnej kolejnoci
@samp{c}, @samp{b}, @samp{a}.  Jeli @code{diff} jako wspln lini
znajduje @samp{c}, to polecenie @samp{diff F G} daje w wyniku:

@example
1,2d0
< a
< b
3a2,3
> b
> a
@end example

@noindent
Jeli natomiast, zamiast tego, @code{diff} zauwaa, e wspln lini
jest @samp{b}, to tworzy takie wyjcie:

@example
1c1
< a
---
> c
3c3
< c
---
> a
@end example

@noindent
Moliwe jest te trafienie na @samp{a} jako wspln lini.
@code{diff} nie zawsze znajduje optymalne dopasowanie midzy plikami --
idzie na skrty, by dziaa szybciej.  Jednak tworzone przeze wyjcie
jest zwykle bliskie najkrtszemu moliwemu.  Mona wyrwna ten kompromis
opcj @samp{--minimal} (@pxref{Wydajno diff}).

@node Odstpy, Puste linie, Porcje, Porwnanie
@section Pomijanie rnic w rozmieszczeniu odstpw
@cindex spacje i tabulacje, pomijanie rnic w odstpach
@cindex tabulacje i spacje, pomijanie rnic w odstpach
@cindex odstpy, pomijanie rnic

Opcje @samp{-b} i @samp{--ignore-space-change} ignoruj biae znaki na kocu
linii i uwaaj wszystkie inne sekwencje jednego lub wicej biaych znakw
(odstpw) za rwnowane.  Uruchomiony z tymi opcjami @code{diff} uwaa
ponisze dwie linie za rwnowane (uyty tu @samp{$} oznacza koniec linii):

@example
Here lyeth  muche rychnesse  in lytell space.   -- John Heywood$
Here lyeth muche rychnesse in lytell space. -- John Heywood   $
@end example

Opcje @samp{-w} i @samp{--ignore-all-space} s mocniejsze ni @samp{-b}.
Ignoruj rnic nawet jeli w jednym z plikw jest odstp w miejscu, gdzie
w drugim go nie ma.  @dfn{Biae znaki} obejmuj tabulacj, znak nowej linii,
tabulacj pionow, wysuw strony, powrt karetki i spacj.
Niektre z definicji ustawie regionalnych (locale) mog jako biae znaki
definiowa inne dodatkowe znaki.
Uruchomiony z tymi opcjami @code{diff} uwaa ponisze dwie linie za
rwnowane (uyty tu @samp{$} oznacza koniec linii, a @samp{^M} - powrt
karetki):

@example
Here lyeth  muche  rychnesse in lytell space.--  John Heywood$
  He relyeth much erychnes  seinly tells pace.  --John Heywood   ^M$
@end example

@node Puste linie, Wielko liter, Odstpy, Porwnanie
@section Pomijanie rnic o puste linie
@cindex puste linie, pomijanie rnic

Opcje @samp{-B} i @samp{--ignore-blank-lines} ignoruj wstawienia czy
usunicia pustych linii.  Normalnie dotycz tylko linii, ktre s cakiem
puste; nie maj wpywu na linie wygldajce na puste, lecz zawierajce
znaki spacji czy tabulacji.  Z tymi opcjami, na przykad, plik zawierajcy
@example
1.  Punkt to to, co nie posiada czci.

2.  Linia ma nieskoczon dugo.
-- Euklides, Elementy, I
@end example
@noindent
jest uwaany za identyczny z plikiem zawierajcym
@example
1.  Punkt to to, co nie posiada czci.
2.  Linia ma nieskoczon dugo.


-- Euklides, Elementy, I
@end example

@node Wielko liter, Pomijanie podanych, Puste linie, Porwnanie
@section Pomijanie rnic w wielkoci liter
@cindex wielko liter, pomijanie rnic

GNU @code{diff} moe traktowa mae litery jako rwnowane ich duym
odpowiednikom, wic, na przykad, uwaa wszystkie @samp{Funky Stuff},
@samp{funky STUFF} i @samp{fUNKy stuFf} za takie same.
Wymuszamy to stosujc opcj @samp{-i} lub @samp{--ignore-case}.

@node Pomijanie podanych, Krtko, Wielko liter, Porwnanie
@section Pomijanie linii pasujcych do wyraenia regularnego.
@cindex wyraenia regularne, pomijanie
@cindex regexp, pomijanie

Wstawienia i usunicia linii pasujcych do zadanego wyraenia regularnego
ignorujemy korzystajc z opcji @samp{-I @var{regexp}}
(lub @samp{--ignore-matching-lines=@var{regexp}}.  Wyraenia, ktre zawieraj
metaznaki powoki powinny by cytowane, by uchroni je przed rozwiniciem
przez powok.  Na przykad, @samp{diff -I '^[0-9]'} pomija wszystkie zmiany
w liniach zaczynajcych si od cyfry.

Jednak @samp{-I} pomija wstawienia i usunicia linii zawierajcych
dane wyraenie regularne tylko wtedy jeli kada ze zmienionych linii
w porcji -- kade wstawienie i kade usunicie --  pasuje do tego wyraenia.
Inaczej mwic, dla kadej nie dajcej si zignorowa zmiany @code{diff}
wypisuje peny zbir zmian w jej otoczeniu, cznie z ignorowanymi.

Stosujc wicej ni jedn opcj @samp{-I} moemy wskaza wicej ni jedno
wyraenie regularne do ignorowania linii.  @code{diff} usiuje dopasowa
kad lini do kadego wyraenia, poczynajc od ostatniego podanego.

@node Krtko, Binarnie, Pomijanie podanych, Porwnanie
@section Podsumowywanie, ktre pliki si rni
@cindex podsumowywanie, ktre pliki si rni
@cindex krtkie zestawienia rnic

Gdy chcemy si tylko dowiedzie, czy pliki s rne, a nie obchodzi nas,
jakie to s rnice, stosujemy podsumowujcy, skrcony format wyjciowy.
W tym formacie, zamiast pokazywa rnice midzy plikami, @code{diff}
po prostu informuje, czy pliki si rni czy nie.  Formaty sumaryczny
wybieraj opcje @samp{-q} i @samp{--brief}.

Format podsumowujcy jest szczeglnie przydatny przy porwnywaniu zawartoci
dwu katalogw.  Jest te znacznie szybszy ni wykonywanie zwykych porwna
linia po linii, poniewa @code{diff} moe przesta analizowa plik jak tylko
zauway jak rnic.

Krtkie wskazanie czy dwa pliki si rni mona te uzyska stosujc
@code{cmp}.  Dla plikw, ktre s identyczne @code{cmp} nie tworzy adnego
wyjcia.  Gdy pliki si rni, domylnie, wypisuje offset bajtowy
i numer linii, gdzie wystpuje pierwsza rnica.  Do pominicia tej
informacji mona uy opcji @samp{-s}.  Wwczas @code{cmp} nie tworzy adnego
wyjcia, a informuje czy pliki si rni wycznie za pomoc swego kodu
zakoczenia (@pxref{Wywoanie cmp}).

@c Fix this.
W przeciwiestwie do @code{diff}, @code{cmp} nie potrafi porwnywa
katalogw; umie tylko porwna dwa pliki.

@node Binarnie, , Krtko, Porwnanie
@section Pliki binarne i wymuszanie porwna tekstowych
@cindex binarne pliki a diff
@cindex tekstowe a binarne, typ plikw a diff

Jeli @code{diff} stwierdzi, e ktry z dwu porwnywanych plikw jest
binarny (plik nie-tekstowy), normalnie traktuje tak par plikw tak samo,
jakby wybrano podsumowujcy format wyjcia (@pxref{Krtko}), i zgasza tylko,
e pliki binarne s rne.  Jest to spowodowane tym, e porwnania linia po
linii dla plikw binarnych nie maj zwykle sensu.

@code{diff} okrela, czy plik jest tekstowy czy binarny przez sprawdzenie
pewnej iloci jego pierwszych bajtw; dokadna liczba badanych bajtw
zaley od systemu, ale typowo jest to kilka tysicy.  Jeli kady bajt w tej
czci pliku jest niezerowy (nie rwny null), to @code{diff} uwaa plik za
tekstowy, w przeciwnym razie - za binarny.

Czasami chcemy zmusi @code{diff}, by traktowa pliki jako tekstowe.
Na przykad, by moe porwnujemy pliki tekstowe, ktre zawieraj znaki null.
Wwczas @code{diff} bdnie zdecydowaby, e s one plikami nie-tekstowymi.
Albo porwnujemy dokumenty zapisane w formacie stosowanym przez system
przetwarzania tekstu, ktry uywa znakw null do wskazania specjalnego
formatowania.  Mona zmusi @code{diff} do uwaania wszystkich plikw
za tekstowe i porwnywania ich linia po linii stosujc opcj @samp{-a}
lub @samp{--text}.  Jeeli pliki, ktre porwnujemy przy wykorzystaniu
tej opcji w rzeczywistoci nie zawieraj tekstu, to i tak prawdopodobnie
bd zawiera troch znakw nowej linii, a wyjcie z @code{diff} bdzie
si skada z porcji pokazujcych rnice pomidzy dugimi liniami jakich
tam znakw zawartych w pliku.

Mona te zmusi @code{diff}, by traktowa pliki jako binarne i informowa
tylko czy si rni (ale nie jak).  Uywamy do tego opcji @samp{--brief}.

W systemach operacyjnych rozrniajcych pliki tekstowe i binarne @code{diff}
normalnie czyta i zapisuje wszystkie dane jako tekst.  Do wymuszenia odczytu
i zapisu binarnego suy opcja @samp{--binary}.  Ta opcja nie ma adnego
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 @code{diff} normalnie ignoruje powroty karetki na wejciu
i generuje je na kocu kadej linii wyjciowej, ale z opcj @samp{--binary}
traktuje powrt karetki jak kady inny znak wejciowy i nie dokada go na
kocu tworzonych linii.  Moe to by przydatne do operowania na plikach
nie-tekstowych, ktre maj by wymieniane z systemami POSIX-owymi.

Chcc porwna dwa pliki bajt po bajcie, korzystamy z programu @code{cmp}
z opcj @samp{-l}, pokazujc wartoci wszystkich rnicych si bajtw.
Stosujc GNU @code{cmp} mona rwnie skorzysta z opcji @samp{-c},
pokazujcej reprezentacj ASCII tych bajtw.
@xref{Wywoanie cmp}, gdzie podano szczegy.

Jeli @code{diff3} sdzi, e ktry z porwnywanych plikw jest binarny
(nie-tekstowy), normalnie zgasza bd, gdy porwnania takie na og
s nieprzydatne.  @code{diff3} do rozstrzygnicia, czy plik jest binarny
uywa tego samego testu.  Tak jak w @code{diff}, jeli pliki wejciowe
zawieraj jakie nie-tekstowe znaki, ale poza tym s plikami tekstowymi,
moemy za pomoc opcji @samp{-a} lub @samp{--text} zmusi @code{diff3},
by traktowa wszystkie pliki jak tekstowe i porwnywa je linia po linii.

@node Formaty wyjciowe, Porwnywanie katalogw, Porwnanie, Top
@chapter Formaty wyjciowe @code{diff}
@cindex wyjcie, formaty
@cindex format wyjcia @code{diff}

@code{diff} ma kilka wzajemnie wykluczajcych si opcji sterujcych formatem
wyjciowym.  W poniszych sekcjach opisano wszystkie formaty, ilustrujc
jak @code{diff} raportuje rnice midzy dwoma przykadowymi plikami
wejciowymi.

@menu
* Przykadowe wejcie diff::	Pliki wejciowe do przykadw @code{diff}.
* Normalny::			Pokazanie rnic bez okalajcego tekstu.
* Kontekstowy::	 		Pokazanie rnic z okalajcym je tekstem.
* Dwukolumnowy::        	Pokazanie rnic obok siebie, w dwu kolumnach.
* Skrypty::  			Generowanie skryptw dla innych programw.
* If-then-else::     		Scalanie plikw z uyciem if-then-else.
@end menu

@node Przykadowe wejcie diff, Normalny, , Formaty wyjciowe
@section Dwa przykadowe pliki wejciowe
@cindex @code{diff}, przykadowe wejcie
@cindex przykadowe pliki wejciowe dla @code{diff}

Oto dwa przykadowe pliki, z ktrych korzystamy w licznych przykadach
do pokazania wyjcia uzyskiwanego z @code{diff} i tego, jak zmienia si ono
w zalenoci od rnych opcji.

To jest plik @file{lao}:

@example
Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
Bezimienne jest pocztkiem nieba i ziemi,
Nazwane jest matk wszystkich rzeczy.
Przeto, kto trwale pozbawion jest pragnie wszelakich,
  potrafi dojrze subteln istot tao,
za, kto niezmiennie tkwi w ptach swych pragnie,
  moe tylko ujrze zewntrzn pozorno rzeczy.
Te dwie strony tao wywodz si
ze wsplnego rda,
  lecz nosz odmienne nazwy.
@end example

To jest plik @file{tsy}:

@example
Bezimienne jest pocztkiem nieba i ziemi,
nazwane jest matk wszystkich rzeczy.

Przeto, kto trwale pozbawion jest pragnie wszelakich,
  potrafi dojrze subteln istot tao,
za, kto niezmiennie tkwi w ptach swych pragnie,
  moe tylko ujrze zewntrzn pozorno rzeczy.
Te dwie strony tao wywodz si
ze wsplnego rda,
  lecz nosz odmienne nazwy.
To, co w nich wsplne, nazywamy wielk tajemnic,
tajemnic nad tajemnicami,
bram do poznania wszelakich cudownoci.
@end example

W tym przykadzie, pierwsza porcja skada si tylko z dwu pierwszych linii
@c              opposing the second
z @file{lao}, druga zawiera czwart lini @file{lao} porwnan
z drug i trzeci lini @file{tsy}, a ostatnia porcja - ostatnie trzy
linie @file{tsy}.

@node Normalny, Kontekstowy, Przykadowe wejcie diff, Formaty wyjciowe
@section Pokazanie rnic bez kontekstu
@cindex normalny format wyjciowy
@cindex @samp{<}, format wyjciowy

``Normalny'' format wyjcia @code{diff} pokazuje kad porcj rnic bez
otaczajcych j linii kontekstu.  Czasem takie wyjcie najczytelniej
pokazuje, jak si zmieniy linie, bez rozpraszajcych ssiednich
niezmienionych linii (cho podobne rezultaty mona osign z formatem
kontekstowym lub zunifikowanym stosujc 0 linii kontekstu).  Format ten
jednake przesta ju by szeroko uywany do rozsyania at; w tym
zastosowaniu przewysza go format kontekstowy (@pxref{Format kontekstowy})
i format zunifikowany (@pxref{Format zunifikowany}).  Format normalny jest
formatem domylnym z powodu zgodnoci ze starszymi wersjami @code{diff}
i standardem Posix.

@menu
* Szczegy normalnego::   Szczegowy opis normalnego formatu wyjciowego.
* Przykad normalnego::	   Przykadowe wyjcie w formacie normalnym.
@end menu

@node Szczegy normalnego, Przykad normalnego, , Normalny
@subsection Szczegowy opis normalnego formatu wyjciowego

Normalny format wyjciowy skada si z co najmniej jednej porcji rnic.
Kada pokazuje jeden obszar, w ktrym pliki si rni.  Porcje formatu
normalnego wygldaj tak:

@example
@var{polecenie-zmiany}
< @var{linia-pliku-rdowego}
< @var{linia-pliku-rdowego}@dots{}
---
> @var{linia-pliku-docelowego}
> @var{linia-pliku-docelowego}@dots{}
@end example

Wystpuj trzy rodzaje polece zmiany.  Kade skada si z numeru linii
lub zakresu oddzielonych przecinkami linii z pierwszego pliku, pojedynczego
znaku wskazujcego rodzaj zmiany, jaka powinna zosta wykonana, i numeru
linii lub zakresu oddzielonych przecinkami linii z drugiego pliku.
Wszystkie numery linii s numerami pierwotnych linii plikw.
Typy polece zmiany:

@table @samp
@item @var{l}a@var{r}
Dodanie (add) linii z zakresu @var{r} drugiego pliku po linii @var{l}
pierwszego pliku.  Na przykad, @samp{8a12,15} oznacza doczenie linii
12--15 pliku 2 po linii 8 pliku 1; albo, jeli zmieniamy plik 2 na plik 1,
usunicie linii 12--15 pliku 2.

@item @var{f}c@var{t}
Zastpienie (change - zmiana) linii z zakresu @var{f} pierwszego pliku
liniami z zakresu @var{t} drugiego pliku.  Przypomina poczenie dodawania
z usuwaniem, lecz jest bardziej zwize.  Na przykad, @samp{5,7c8,10}
@c               file 1 to read as lines 8--10
oznacza zmian linii 5--7 pliku 1 na zawarto linii 8--10
pliku 2; albo, jeli zmieniamy plik 2 na plik 1, zmiana linii 8--10 pliku 2
na tre linii 5--7 pliku 1.

@item @var{r}d@var{l}
Usunicie (delete) linii z zakresu @var{r} z pierwszego pliku.  Linia @var{l}
wskazuje miejsce, gdzie pojawiyby si one w drugim pliku, gdyby nie zostay
usunite.  Na przykad, @samp{5,7d3} oznacza usunicie linii 5--7 pliku 1;
albo, jeli zmieniamy plik 2 na plik 1, doczenie linii 5--7 pliku 1
po linii 3 pliku 2.
@end table

@node Przykad normalnego, , Szczegy normalnego, Normalny
@subsection Przykad formatu normalnego

Oto wynik dziaania polecenia @samp{diff lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw).
Zauwa, e pokazuje ono tylko te linie, ktre s rne w obu plikach.

@example
1,2d0
< Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
< Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
4c2,3
< Nazwane jest matk wszystkich rzeczy.
---
> nazwane jest matk wszystkich rzeczy.
> 
11a11,13
> To, co w nich wsplne, nazywamy wielk tajemnic,
> tajemnic nad tajemnicami,
> bram do poznania wszelakich cudownoci.
@end example

@node Kontekstowy, Dwukolumnowy, Normalny, Formaty wyjciowe
@section Pokazanie rnic wewntrz ich kontekstu
@cindex context, format wyjciowy
@cindex kontekstowy, format wyjciowy
@cindex @samp{!}, format wyjciowy

Zazwyczaj, gdy ogldamy rnice midzy plikami, chcemy te widzie
czci plikw w pobliu rnicych si linii. Pomaga to zrozumie dokadnie,
co si zmienio.  Czci plikw ssiadujce z danymi liniami nazywane s
@dfn{kontekstem} @dfn{context}.

GNU @code{diff} obsuguje dwa formaty wyjciowe pokazujce kontekst wok
rnicych si linii: @dfn{format kontekstowy} (@dfn{context format})
i @dfn{format zunifikowany} (@dfn{unified format}).  Opcjonalnie moe
pokaza, w jakiej funkcji lub sekcji pliku znaleziono rnice si linie.

Do rozpowszechniania nowych wersji plikw w postaci wyjcia z @code{diff}
powinnimy uywa jednego z formatw pokazujcych kontekst, by odbiorcy
mogli zaaplikowa rnice nawet jeli poczynili w swoich wasnych plikach
niewielkie zmiany.  W tym przypadku @code{patch} nakada at szukajc
w plikach linii kontekstu wok linii rnic. Jeli linie kontekstu s
faktycznie nieco dalej, ni wskazuje plik rnicowy, to @code{patch} umie
dopasowa odpowiednio numery linii i nadal poprawnie zastosowa at.
@xref{Niedoskonae}, gdzie szerzej opisano wykorzystanie @code{patch} do
@c                      imperfect diffs.
nakadania niedokadnie pasujcych at.

@menu
* Format kontekstowy::	Format wyjciowy pokazujcy otaczajce linie.
* Format zunifikowany::	Bardziej skondensowany format wyjciowy z kontekstem.
* Sekcje::		Pokazanie, w ktrych sekcjach plikw s rnice.
* Nazwy zastpcze::	Pokazanie w nagwkach kontekstowych zastpczych
			nazw plikw.
@end menu

@node Format kontekstowy, Format zunifikowany, , Kontekstowy
@subsection Format kontekstowy

Kontekstowy format wyjcia pokazuje wok linii, ktre si rni kilka
linii kontekstu.  Jest to standardowy format do dystrybucji uaktualnie
kodu rdowego.
Wybiera si go za pomoc opcji @samp{-C @var{linie}},
@samp{--context@r{[}=@var{linie}@r{]}} lub @samp{-c}.  Argument @var{linie},
pobierany przez cz z nich, wskazuje, ile linii kontekstu ma by pokazane.
Jeli nie podamy @var{linie}, zostanie uyta warto domylna - trzy.
Do prawidowego dziaania @code{patch} potrzebuje na og co najmniej dwu
linii kontekstu.

@menu
* Szczegy kontekstowego::	Szczegowy opis formatu kontekstowego.
* Przykad kontekstowego::	Przykadowe wyjcie w formacie kontekstowym.
* Mniej kontekstu::		Inny przykad z mniejszym kontekstem.
@end menu

@node Szczegy kontekstowego, Przykad kontekstowego, , Format kontekstowy
@subsubsection Szczegowy opis formatu kontekstowego

Format kontekstowy zaczyna si od dwulinijkowego nagwka, ktry wyglda tak:

@example
*** @var{plik-rdowy} @var{czas-modyfikacji-pliku-rdowego}
--- @var{plik-docelowy} @var{czas-modyfikacji-pliku-docelowego}
@end example

@noindent
Zawarto nagwka zmieniamy opcj @samp{-L @var{etykieta}} lub
@samp{--label=@var{etykieta}}; zob. @ref{Nazwy zastpcze}.

Dalej nastpuje przynajmniej jedna porcja rnic; kada z nich pokazuje
jeden obszar, w ktrym pliki si rni.  Porcje w formacie kontekstowym
wygldaj tak:

@example
***************
*** @var{zakres-linii-pliku-rdowego} ****
  @var{linia-pliku-rdowego}
  @var{linia-pliku-rdowego}@dots{}
--- @var{zakres-linii-pliku-docelowego} ----
  @var{linia-pliku-docelowego}
  @var{linia-pliku-docelowego}@dots{}
@end example

Linie kontekstu wok linii, ktrymi rni si pliki zaczynaj si dwiema
spacjami.  Linie, ktrymi rni si pliki zaczynaj si jednym z poniszych
znacznikw, po ktrym nastpuje znak spacji:

@table @samp
@item !
Linia, bdca czci grupy linii, ktre si zmieniy midzy oboma plikami.
W tej samej porcji istnieje grupa odpowiadajcych im linii drugiego pliku,
take oznaczonych wykrzyknikiem @samp{!}.

@item +
``Wstawiona'' linia w drugim pliku, ktra nie ma odpowiednika w pierwszym
pliku.

@item -
``Usunita'' linia w pierwszym pliku, ktra nie ma odpowiednika w drugim
pliku.
@end table

Jeli wszystkie zmiany w porcji s wstawieniami, linie pliku
@var{pliku-rdowego} s pomijane.  Jeli wszystkie zmiany s usuniciami,
pomijane s linie @var{pliku-docelowego}.

@node Przykad kontekstowego, Mniej kontekstu, Szczegy kontekstowego, Format kontekstowy
@subsubsection Przykad formatu kontekstowego

Oto wynik dziaania polecenia @samp{diff -c lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw).
Zauwa, e przed i po kadej rnicej si linii pokazane s trzy
(co najwyej) linie z ni ssiadujce.  S to linie kontekstu.
Zauwa te, e pierwsze dwie porcje id razem, gdy ich zawarto si
nakada.

@example
*** lao	Sat Jan 26 23:30:39 1991
--- tsy	Sat Jan 26 23:30:50 1991
***************
*** 1,7 ****
- Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
- Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
  Bezimienne jest pocztkiem nieba i ziemi,
! Nazwane jest matk wszystkich rzeczy.
  Przeto, kto trwale pozbawion jest pragnie wszelakich,
    potrafi dojrze subteln istot tao,
  za, kto niezmiennie tkwi w ptach swych pragnie,
--- 1,6 ----
  Bezimienne jest pocztkiem nieba i ziemi,
! nazwane jest matk wszystkich rzeczy.
! 
  Przeto, kto trwale pozbawion jest pragnie wszelakich,
    potrafi dojrze subteln istot tao,
  za, kto niezmiennie tkwi w ptach swych pragnie,
***************
*** 9,11 ****
--- 8,13 ----
  Te dwie strony tao wywodz si
  ze wsplnego rda,
    lecz nosz odmienne nazwy.
+  To, co w nich wsplne, nazywamy wielk tajemnic,
+  tajemnic nad tajemnicami,
+  bram do poznania wszelakich cudownoci.
@end example

@node Mniej kontekstu, , Przykad kontekstowego, Format kontekstowy
@subsubsection Przykad formatu kontekstowego z mniejszym kontekstem

Oto wynik dziaania polecenia @samp{diff --context=1 lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw).
Zauwa, e tutaj zgaszana jest co najwyej jedna linia kontekstu.

@example
*** lao	Sat Jan 26 23:30:39 1991
--- tsy	Sat Jan 26 23:30:50 1991
***************
*** 1,5 ****
- Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
- Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
  Bezimienne jest pocztkiem nieba i ziemi,
! Nazwane jest matk wszystkich rzeczy.
  Przeto, kto trwale pozbawion jest pragnie wszelakich,
--- 1,4 ----
  Bezimienne jest pocztkiem nieba i ziemi,
! nazwane jest matk wszystkich rzeczy.
! 
  Przeto, kto trwale pozbawion jest pragnie wszelakich,
***************
*** 11 ****
--- 10,13 ----
    lecz nosz odmienne nazwy.
+  To, co w nich wsplne, nazywamy wielk tajemnic,
+  tajemnic nad tajemnicami,
+  bram do poznania wszelakich cudownoci.
@end example

@node Format zunifikowany, Sekcje, Format kontekstowy, Kontekstowy
@subsection Format zunifikowany
@cindex zunifikowany format wyjciowy
@cindex @samp{+-}, format wyjciowy

Zunifikowany format wyjciowy jest odmian formatu kontekstowego, bardziej
zwart, gdy pomija zbyteczne linie kontekstu.
Wybiera si go za pomoc opcji @samp{-U @var{linie}},
@samp{--unified@r{[}=@var{linie}@r{]}} lub @samp{-u}.  Argument @var{linie},
pobierany przez cz z nich, wskazuje, ile linii kontekstu ma by pokazane.
Jeli nie podamy @var{linie}, zostanie uyta warto domylna - trzy.

Obecnie tylko GNU @code{diff} potrafi utworzy taki format i tylko GNU
@code{patch} umie automatycznie stosowa aty tego formatu.  Do poprawnego
dziaania @code{patch} zwykle potrzebuje przynajmniej dwu linii kontekstu.

@menu
* Szczegy zunifikowanego::	Szczegowy opis formatu zunifikowanego.
* Przykad zunifikowanego::	Przykadowe wyjcie w formacie zunifikowanym.
@end menu

@node Szczegy zunifikowanego, Przykad zunifikowanego, , Format zunifikowany
@subsubsection Szczegowy opis formatu zunifikowanego

Format zunifikowany zaczyna si od dwulinijkowego nagwka, ktry wyglda 
tak:

@example
--- @var{plik-rdowy} @var{czas-modyfikacji-pliku-rdowego}
+++ @var{plik-docelowy} @var{czas-modyfikacji-pliku-docelowego}
@end example

@noindent
Zawarto nagwka zmieniamy opcj @samp{-L @var{etykieta}} lub
@samp{--label=@var{etykieta}}; zob. @ref{Nazwy zastpcze}.

Dalej nastpuje co najmniej jedna porcja rnic; kada z nich pokazuje
jeden obszar, w ktrym pliki si rni.  Porcje w formacie zunifikowanym
wygldaj tak:

@example
@@@@ @var{zakres-linii-pliku-rdowego} @var{zakres-linii-pliku-
docelowego} @@@@
 @var{linia-z-jednego-z-plikw}
 @var{linia-z-jednego-z-plikw}@dots{}
@end example

Linie wsplne obu plikom zaczynaj si od znaku spacji.  Linie, ktre
faktycznie odrniaj od siebie pliki maj w lewej kolumnie jeden
z poniszych znacznikw:

@table @samp
@item +
Linia zostaa tu dodana do pierwszego pliku.

@item -
Linia zostaa tu usunita a pierwszego pliku.
@end table

@node Przykad zunifikowanego, , Szczegy zunifikowanego, Format zunifikowany
@subsubsection Przykad formatu zunifikowanego

Oto wynik dziaania polecenia @samp{diff -u lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw):

@example
--- lao	Sat Jan 26 23:30:39 1991
+++ tsy	Sat Jan 26 23:30:50 1991
@@@@ -1,7 +1,6 @@@@
-Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
-Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
 Bezimienne jest pocztkiem nieba i ziemi,
-Nazwane jest matk wszystkich rzeczy.
+nazwane jest matk wszystkich rzeczy.
+
 Przeto, kto trwale pozbawion jest pragnie wszelakich,
   potrafi dojrze subteln istot tao,
 za, kto niezmiennie tkwi w ptach swych pragnie,
@@@@ -9,3 +8,6 @@@@
 Te dwie strony tao wywodz si
 ze wsplnego rda,
   lecz nosz odmienne nazwy.
+To, co w nich wsplne, nazywamy wielk tajemnic,
+tajemnic nad tajemnicami,
+bram do poznania wszelakich cudownoci.
@end example

@node Sekcje, Nazwy zastpcze, Format zunifikowany, Kontekstowy
@subsection Pokazanie, w ktrych sekcjach plikw s rnice
@cindex nagwki sekcji
@cindex sekcje, nagwki

Czasem chcielibymy wiedzie, w ktrej czci pliku wypada kada ze zmian.
Jeli pliki s kodem rdowym, moemy przez to rozumie, ktra funkcja si
zmienia.  Jeli pliki s dokumentami, moemy mie na myli, ktry rozdzia
czy dodatek si zmieni.  GNU @code{diff} potrafi to pokaza wywietlajc
najblisz lini nagwka sekcji poprzedzajc linie rnic.
Jakie linie s ``nagwkami sekcji'' okrela si za pomoc wyraenia
regularnego.

@menu
* Podane nagwki::    Pokazanie nagwkw pasujcych do wyraenia regularnego.
* Nagwki funkcji C:: Pokazanie nagwkw funkcji C.
@end menu

@node Podane nagwki, Nagwki funkcji C, , Sekcje
@subsubsection Pokazanie linii pasujcych do wyraenia regularnego.
@cindex podawanie nagwkw
@cindex wyraenie regularne dopasowujce nagwki
@cindex regexp dopasowujce nagwki

W celu wskazania, w ktrych sekcjach plikw, nie bdcych kodem rdowym C
czy podobnych jzykw, wystpuj rnice korzystamy z opcji
@samp{-F @var{regexp}} lub @samp{--show-function-line=@var{regexp}}.
@code{diff} uwaa linie pasujce do argumentu @var{regexp} za pocztek
kolejnej sekcji pliku.  Oto sugerowane wyraenia regularne dla kilku
popularnych jzykw programowania:

@c Please add to this list, e.g. Fortran, Pascal.
@table @samp
@item ^[A-Za-z_]
C, C++, Prolog
@item ^(
Lisp
@item ^@@\(chapter\|appendix\|unnumbered\|chapheading\)
Texinfo
@end table

Opcja dopasowywania nagwka nie wybiera automatycznie formatu wyjciowego.
By z niej skorzysta, trzeba wybra format kontekstowy
(@pxref{Format kontekstowy}) lub zunifikowany (@pxref{Format zunifikowany}).
Uyta przy innych formatach wyjciowych nie ma adnych skutkw.

Opcje @samp{-F} i @samp{--show-function-line} dla kadej z porcji rnic
szukaj najbliszej niezmienionej linii, ktra j poprzedza i pasuje
do zadanego wyraenia regularnego.  Nastpnie dodaj t lini na koniec linii
gwiazdek w formacie kontekstowym lub linii z @samp{@@@@} w zunifikowanym.
Jeli nie istnieje pasujca linia, to wyjcie wyprowadzane dla tej porcji
pozostaje bez zmian.  Jeli linia ma ponad 40 znakw, to wypisywane jest
tylko 40 pocztkowych znakw.  Dla takich linii mona poda wicej ni jedno
wyraenie regularne.  @code{diff} usiuje dopasowa kad lini do kadego
wyraenia, poczynajc od ostatniego podanego.  To znaczy, e mona stosowa
rwnoczenie opcje @samp{-p} i @samp{-F}.

@node Nagwki funkcji C, , Podane nagwki, Sekcje
@subsubsection Pokazanie nagwkw funkcji C
@cindex nagwki funkcji C
@cindex C, nagwki funkcji
@cindex funkcje C, nagwki

W celu wskazania, w ktrych funkcjach C czy podobnych jzykw,
wystpuj rnice korzystamy z opcji @samp{-p} lub
@samp{--show-c-function}.  Ta opcja, inaczej ni @samp{-F}, automatycznie
domylnie stosuje kontekstowy format wyjciowy (@pxref{Format kontekstowy}),
z domyln liczb linii kontekstu.  Liczb t mona przesoni wasn
wartoci za pomoc @samp{-C @var{linie}} w innym miejscu wiersza polece.
Mona te zastpi zarwno domylny format, jak i ilo linii kontekstu,
stosujc w wierszu polece dodatkowo @samp{-U @var{linie}}.

Opcje @samp{-p} i @samp{--show-c-function} s rwnowane
@samp{-F'^[_a-zA-Z$]'} jeli podano format zunifikowany lub
@samp{-c -F'^[_a-zA-Z$]'} w przeciwnym razie  (@pxref{Podane nagwki}).
GNU @code{diff} udostpnia je ze wzgldu na wygod uywania.

@node Nazwy zastpcze, , Sekcje, Kontekstowy
@subsection Pokazanie zastpczych nazw plikw
@cindex zastpcze nazwy plikw
@cindex nazwy plikw, zastpcze

Porwnujc dwa pliki o nic nie mwicych lub niewiele mwicych nazwach
zapewne chcielibymy, by @code{diff} w nagwku formatu kontekstowego czy
zunifikowanego pokaza jakie ich nazwy zastpcze.
Suy do tego opcja @samp{-L @var{etykieta}} lub
@samp{--label=@var{etykieta}}.  Przy pierwszym podaniu tej opcji, jej
argument zastpuje w nagwku nazw i dat pierwszego pliku.  Drugie uycie
opcji zastpuje argumentem nazw i dat drugiego pliku.  Jeli opcj podamy
wicej ni dwa razy, @code{diff} zgosi bd.  Opcja @samp{-L} nie ma wpywu
na nazwy plikw w nagwku @code{pr} (tworzonym gdy korzystamy z opcji
@samp{-l} lub @samp{--paginate} (@pxref{Stronicowanie}).

Oto dwie pierwsze linie wyjcia polecenia @samp{diff -C2 -Lpierwotny
-Lzmieniony lao tsy}:

@example
*** pierwotny
--- zmieniony
@end example

@node Dwukolumnowy, Skrypty, Kontekstowy, Formaty wyjciowe
@section Pokazanie rnic obok siebie
@cindex obok siebie
@cindex dwukolumnowe, wyjcie
@cindex kolumnowe, wyjcie

@code{diff} potrafi utworzy wykaz rnic umieszczonych obok siebie.
Pliki s wypisywane w dwu kolumnach, z odstpem midzykolumnowym.
@c                             the gutter
Odstp midzy kolumnami zawiera jeden z poniszych znacznikw:

@table @asis
@item biay znak
Odpowiednie linie s wsplne.  To znaczy, albo linie s identyczne, albo
rnica jest ignorowana z powodu jednej z opcji @samp{--ignore}
(@pxref{Odstpy}).

@item @samp{|}
Odpowiednie linie rni si i s albo obie kompletne albo obie niekompletne.

@item @samp{<}
Pliki si rni i tylko pierwszy z nich zawiera t lini.

@item @samp{>}
Pliki si rni i tylko drugi z nich zawiera t lini.

@item @samp{(}
Tylko pierwszy plik zawiera t lini, ale rnica jest ignorowana.

@item @samp{)}
Tylko drugi plik zawiera t lini, ale rnica jest ignorowana.

@item @samp{\}
Odpowiednie linie rni si, a tylko pierwsza linia jest niekompletna.

@item @samp{/}
Odpowiednie linie rni si, a tylko druga linia jest niekompletna.
@end table

Normalnie, linia wyjciowa jest niekompletna wtedy i tylko wtedy gdy linie,
z jakich si skada s niekompletne @xref{Niekompletne linie}.  Jednak, gdy
linia wyjciowa reprezentuje dwie rnice si linie, jedna z nich moe by
niekompletna, a druga nie.  W tym przypadku linia wyjciowa jest kompletna,
ale odstp midzy jej kolumnami jest oznakowany @samp{\} jeli niekompletna
jest pierwsza linia lub @samp{/} jeli druga.

Format dwukolumnowy jest czasem atwiejszy w czytaniu, ale ma ograniczenia.
Tworzy due szersze wyjcie ni zwykle i obcina linie, ktre si nie
@c                               relies on lining up output 
mieszcz.  Ponadto, znacznie bardziej ni zwyke formaty, opiera si
na wyrwnywaniu wyjcia, przez co wyniki wygldaj szczeglnie le gdy
korzystamy z czcionek zmiennej szerokoci, niestandardowych tabulatorw czy
znakw niedrukowalnych.

Do interaktywnego scalania rnic pokazanych obok siebie uywa si programu
@code{sdiff}.  @xref{Interaktywne scalanie}, gdzie bliej opisano scalanie
plikw.

@menu
* Format dwukolumnowy::		Sterowanie wyjciem formatu dwukolumnowego.
* Przykad dwukolumnowy::	Przykad wyjcia dwukolumnowego.
@end menu

@node Format dwukolumnowy, Przykad dwukolumnowy, , Dwukolumnowy
@section Sterowanie formatem dwukolumnowym
@cindex side-by-side, format wyjciowy
@cindex dwukolumnowy format wyjciowy
@cindex kolumnowy format wyjciowy

Format o liniach obok siebie wybierany jest opcj @samp{-y} lub
@samp{--side-by-side}.  Poniewa linie wyjciowe zawieraj dwie linie wejcia
obok siebie, s szersze ni zwykle.  Normalnie maj 130 kolumn, co powinno
si zmieci w tradycyjnej linii drukarki.  Dugo linii wyjciowych ustawia
si opcj @samp{-W @var{kolumny}} lub @samp{--width=@var{kolumny}}.
Linia wyjciowa podzielona jest na dwie powki jednakowej dugoci,
rozdzielone niewielk przestrzeni do zaznaczania rnic.  Prawa powka
wyrwnana jest do tabulatora, tak, e tabulacje s wyrwnane.  Linie
wejciowe, ktre s zbyt dugie, by zmieci si w powce linii wyjciowej
s w wyniku obcinane.

Opcja @samp{--left-column} dla dwu wsplnych linii wypisuje tylko lew
kolumn.  Opcja @samp{--suppress-common-lines} cakowicie eliminuje wsplne
linie.

@node Przykad dwukolumnowy, , Format dwukolumnowy, Dwukolumnowy
@subsection Przykad formatu dwukolumnowego

Oto wynik dziaania polecenia @samp{diff -y -W 72 lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw).

@example
Tao, ktre mona wyrazi sowami   <
Nazwa, ktr mona je okreli,    <
Bezimienne jest pocztkiem nieba        Bezimienne jest pocztkiem nieba
Nazwane jest matk wszystkich rz   |    nazwane jest matk wszystkich rz
                                   >
Przeto, kto trwale pozbawion jes        Przeto, kto trwale pozbawion jes
  potrafi dojrze subteln istot          potrafi dojrze subteln istot
za, kto niezmiennie tkwi w pta        za, kto niezmiennie tkwi w pta
  moe tylko ujrze zewntrzn p          moe tylko ujrze zewntrzn p
Te dwie strony tao wywodz si          Te dwie strony tao wywodz si
ze wsplnego rda,                    ze wsplnego rda,
  lecz nosz odmienne nazwy.              lecz nosz odmienne nazwy.
                                   >    To, co w nich wsplne, nazywamy
                                   >      tajemnic nad tajemnicami,
                                   >    bram do poznania wszelakich cud
@end example

@node Skrypty, If-then-else, Dwukolumnowy, Formaty wyjciowe
@section Tworzenie skryptw edycyjnych
@cindex formaty wyjciowe tworzce skrypty
@cindex skryptowe formaty wyjciowe

Kilka trybw wyprowadzania wyjcia tworzy skrypty polece redagujce
@var{plik-rdowy} tak, by otrzyma @var{plik-docelowy}.

@menu
* Skrypty ed::	Stosowanie @code{diff} do tworzenie polece dla @code{ed}.
* Forward ed::	Tworzenie skryptw @code{ed} skierowanych w przd.
* RCS::	      	Specjalny format wyjcia @code{diff} uywany przez RCS.
@end menu

@node Skrypty ed, Forward ed, , Skrypty
@subsection Skrypty @code{ed}
@cindex skrypt @code{ed}, format wyjciowy
@cindex @code{ed}, skryptowy format wyjciowy

@code{diff} moe tworzy polecenia, ktre kieruj edytorem tekstu @code{ed}
tak, aby przeksztaci pierwszy plik w drugi.  Dawno temu by to jedyny tryb
wyjciowy nadajcy si do automatycznej zmiany jednego pliku w drugi.
Obecnie, z @code{patch}, jest on niemal przestarzay.  Do wyboru tego
formatu wyjciowego suy opcja @samp{-e} lub @samp{--ed}.

Podobnie jak format normalny (@pxref{Normalny}), ten format wyjciowy nie
pokazuje kontekstu.  Inaczej ni format normalny, nie zawiera
informacji niezbdnych do odwrotnego zastosowania rnicy (do utworzenia
pierwszego pliku jeli mamy tylko drugi plik i rnic).

Jeli plik  @file{d} zawiera wyjcie polecenia @samp{diff -e stary nowy},
to polecenia @samp{(cat d && echo w) | ed - stary} modyfikuje @file{stary}
tak, by zrobi z niego kopi @file{nowego}.  Bardziej oglnie: jeli
@file{d1}, @file{d2}, @dots{}, @file{dN} zawieraj, odpowiednio, wyniki z
@samp{diff -e stary nowy1}, @samp{diff -e nowy1 nowy2}, @dots{},
@samp{diff -e nowyN-1 nowyN}, to polecenie @samp{(cat d1 d2 @dots{}
dN && echo w) | ed - stary} modyfikuje @file{stary} tak, by zrobi z niego
kopi @file{nowyN}.

@menu
* Szczegy ed::	Szczegowy opis formatu @code{ed}.
* Przykad ed::		Przykadowy skrypt @code{ed}.
@end menu

@node Szczegy ed, Przykad ed, , Skrypty ed
@subsubsection Szczegowy opis formatu @code{ed}

Format wyjciowy @code{ed} skada si z co najmniej jednej porcji rnic.
Zmiany najblisze koca pliku wystpuj jako pierwsze, tak e polecenia
zmieniajce ilo linii nie maj wpywu na sposb interpretacji przez
@code{ed} numerw nastpnych polece.  W formacie @code{ed} porcje wygldaj
tak:

@example
@var{polecenie-zmiany}
@var{linia-pliku-docelowego}
@var{linia-pliku-docelowego}@dots{}
.
@end example

Poniewa @code{ed} uywa pojedynczej kropki w linii do wskazania koca
wejcia, GNU @code{diff} chroni linie zmian zawierajce pojedyncz kropk.
Wpisuje zamiast niej dwie kropki, a nastpnie dodaje kolejne polecenie
@code{ed} zmieniajce dwie kropki w jedn.  Format @code{ed} nie potrafi
przedstawi niekompletnej linii, wic jeli drugi plik koczy si zmienion
niekompletn lini, @code{diff} zgasza bd, a nastpnie udaje, e dodano
znak nowej linii.

Istniej trzy typy polece zmiany.  Kade skada si z numeru linii
(lub zakresu oddzielonych przecinkami linii) w pierwszym pliku i pojedynczego
znaku wskazujcego na rodzaj zmian do wykonania.  Wszystkie numery linii
s pierwotnymi numerami linii pliku.  Typy polece zmiany:

@table @samp
@item @var{l}a
Dodanie (add) tekstu z drugiego pliku po linii numer @var{l} w pierwszym
pliku.  Na przykad, @samp{8a} oznacza dodanie wymienionych niej linii
po smej linii pliku 1.

@item @var{r}c
Zastpienie (change - zmiana) linii z zakresu @var{r} pierwszego pliku
liniami wymienionymi niej.  Przypomina poczenie dodawania z usuwaniem,
lecz jest bardziej zwize.  Na przykad, @samp{5,7c} oznacza zmian linii
5--7 pliku 1 tak, by byy rwne tekstowi z pliku 2.

@item @var{r}d
Usunicie (delete) linii z zakresu @var{r} z pierwszego pliku.  Na przykad,
@samp{5,7d} oznacza usunicie linii 5--7 pliku 1.
@end table

@node Przykad ed, , Szczegy ed, Skrypty ed
@subsubsection Przykad skryptu @code{ed}

Oto wynik dziaania polecenia @samp{diff -e lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw):

@example
11a
To, co w nich wsplne, nazywamy wielk tajemnic,
tajemnic nad tajemnicami,
bram do poznania wszelakich cudownoci.
.
4c
nazwane jest matk wszystkich rzeczy.

.
1,2d
@end example

@node Forward ed, RCS, Skrypty ed, Skrypty
@subsection Skrypty @code{ed} skierowane w przd (forward @code{ed})
@cindex skrypt @code{ed} w przd, format wyjciowy
@cindex @code{ed} w przd, skryptowy format wyjciowy
@cindex forward @code{ed}, skryptowy format wyjciowy

@code{diff} moe tworzy wyjcie podobne do skryptu @code{ed}, ale z porcjami
uporzdkowanymi w przd (od pocztku pliku ku kocowi).  Format polece jest
nieco zmieniony: znaki polece wystpuj przed liniami, ktrych dotycz,
w zakresach numery linii s oddzielane spacjami, w porcjach nie prbuje si
usuwa niejednoznacznoci linii skadajcych si z pojedynczej kropki.
Podobnie jak format @code{ed}, format @code{ed} uporzdkowany w przd
(forward) nie potrafi przedstawi niekompletnych linii.

Wyjcie typu forward @code{ed} jest niezbyt przydatne, gdy ani @code{ed}
ani @code{patch} nie potrafi nakada at w tym formacie.
Istnieje on gwnie z uwagi na zgodno ze starszymi wersjami @code{diff}.
Do wyboru tego formatu wyjciowego suy opcja @samp{-f}
lub @samp{--forward-ed}.


@node RCS, , Forward ed, Skrypty
@subsection Skrypty RCS
@cindex skrypt RCS, format wyjciowy
@cindex RCS, skryptowy format wyjciowy

Format wyjciowy RCS zaprojektowano specjalnie do stosowania z systemem
kontroli wersji RCS (Revision Control System), bdcym zestawem wolnych
programw uywanych do organizacji i zarzdzania rnymi wersjami plikw.
Do wyboru tego formatu wyjciowego suy opcja @samp{-n} lub @samp{--rcs}.
Przypomina format forward @code{ed} (@pxref{Forward ed}), ale potrafi
przedstawi dowolne zmiany zawartoci pliku, gdy unika problemw tamtego
formatu (z niekompletnymi liniami i liniami skadajcymi si z jednej
kropki).  Zamiast koczy partie tekstu lini zoon z pojedynczej kropki,
kade z polece okrela liczb linii, ktrych dotyczy: zamiast polece
@samp{c} uywane s kombinacje @samp{a} i @samp{d}.  Oprcz tego, jeli
drugi plik koczy si zmienion niekompletn lini, to wyjcie rwnie
koczy si niekompletn lini.

Oto wynik dziaania polecenia @samp{diff -n lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw):

@example
d1 2
d4 1
a4 2
nazwane jest matk wszystkich rzeczy.

a11 3
To, co w nich wsplne, nazywamy wielk tajemnic,
tajemnic nad tajemnicami,
bram do poznania wszelakich cudownoci.
@end example

@node If-then-else, , Skrypty, Formaty wyjciowe
@section Scalanie plikw za pomoc If-then-else
@cindex scalajcy format wyjciowy
@cindex if-then-else, format wyjciowy
@cindex C if-then-else, format wyjciowy
@cindex @code{ifdef}, format wyjciowy

@code{diff} mona wykorzysta do scalenia dwu plikw z kodem rdowym C.
Wyjcie w tym formacie zawiera wszystkie linie obu plikw.  Linie wsplne
obu plikom s wypisywane tylko raz; czci rnice pliki s rozdzielane
dyrektywami preprocesora C @code{#ifdef @var{nazwa}} lub
@code{#ifndef @var{nazwa}}, @code{#else}, and @code{#endif}.
Podczas kompilacji takiego wyjcia podan wersj wybieramy albo definiujc
albo pozostawiajc niezdefiniowane makro @var{nazwa}.

Do scalania plikw wywouje si @code{diff} z opcj @samp{-D @var{nazwa}}
lub @samp{--ifdef=@var{nazwa}}.  Argument @var{nazwa} jest identyfikatorem C,
jaki ma zosta uyty w dyrektywach @code{#ifdef} i @code{#ifndef}.

Na przykad, jeli zmienimy wystpienie @code{wait (&s)} na
@code{waitpid (-1, &s, 0)}, a nastpnie scalimy stary i nowy plik za pomoc
opcji @samp{--ifdef=HAVE_WAITPID}, to cz kodu objta zmianami moe
wyglda mniej wicej tak:

@example
    do @{
#ifndef HAVE_WAITPID
        if ((w = wait (&s)) < 0  &&  errno != EINTR)
#else /* HAVE_WAITPID */
        if ((w = waitpid (-1, &s, 0)) < 0  &&  errno != EINTR)
#endif /* HAVE_WAITPID */
            return w;
    @} while (w != child);
@end example

Mona te okrela formaty dla jzykw innych ni C, stosujc formaty
grup linii i formaty linii, jak opisano w kolejnych sekcjach.

@menu
* Formaty grup linii::		Formaty oglne grup linii if-then-else.
* Formaty linii::		Formaty poszczeglnych linii w grupie.
* Szczegy If-then-else::	Szczegowy opis formatu if-then-else.
* Przykadowy If-then-else::	Przykadowy format wyjciowy if-then-else.
@end menu

@node Formaty grup linii, Formaty linii, , If-then-else
@subsection Formaty grup linii
@cindex formaty grup linii
@cindex formaty dla grup linii if-then-else

Formaty grup linii pozwalaj na podanie formatw stosownych dla wielu
aplikacji, ktre dopuszczaj wejcie typu if-then-else, cznie z jzykami
programowania i jzykami formatowania tekstu.
Format grup linii okrela format wyjciowy dla cigej grupy podobnych linii.

Na przykad, ponisze polecenie porwnuje TeX-owe pliki @file{stary}
i @file{nowy} i wypisuje scalony plik, w ktrym stare miejsca ujte s
pomidzy linie @samp{\begin@{em@}}-@samp{\end@{em@}}, a nowe midzy linie
@samp{\begin@{bf@}}-@samp{\end@{bf@}}.

@example
diff \
   --old-group-format='\begin@{em@}
%<\end@{em@}
' \
   --new-group-format='\begin@{bf@}
%>\end@{bf@}
' \
   stary nowy
@end example

Ponisze polecenie jest rwnowane powyszemu przykadowi, ale troch
@c        it spells out the default line group formats.
rozwleklejsze, gdy przytacza dla jasnoci domylne formaty grup linii.

@example
diff \
   --old-group-format='\begin@{em@}
%<\end@{em@}
' \
   --new-group-format='\begin@{bf@}
%>\end@{bf@}
' \
   --unchanged-group-format='%=' \
   --changed-group-format='\begin@{em@}
%<\end@{em@}
\begin@{bf@}
%>\end@{bf@}
' \
   stary nowy
@end example

Oto bardziej rozbudowany przykad, w ktrym wypisywana jest lista rnic
z nagwkami zawierajcymi numery linii i opisy w ``zwykym angielskim''.
[tum.: bardziej skomplikowana polszczyzna nie daje si wtoczy w tak
proste konstrukcje]

@example
diff \
   --unchanged-group-format='' \
   --old-group-format='-------- %dn line%(n=1?:s) deleted at %df:
%<' \
   --new-group-format='-------- %dN line%(N=1?:s) added after %de:
%>' \
   --changed-group-format='-------- %dn line%(n=1?:s) changed at %df:
%<-------- to:
%>' \
   old new
@end example

Do podania formatu grupy linii uywa si @code{diff} z jedn z wymienionych
niej opcji.  Mona poda do czterech formatw grup linii, po jednym dla
kadego rodzaju grup.  @var{format} powinien by cytowany, gdy zwykle
zawiera metaznaki powoki.

@table @samp
@item --old-group-format=@var{format}
Te grupy to porcje zawierajce linie tylko z pierwszego pliku.
Domylny format grup starych linii jest taki sam, jak format grup
linii zmienionych, jeli takowy zosta podany; w przeciwnym razie format
ten wypisuje grup linii dosownie, bez zmian czy dodatkw.

@item --new-group-format=@var{format}
Te grupy to porcje zawierajce linie tylko z drugiego pliku.
Domylny format grup nowych linii jest taki sam, jak format grup
linii zmienionych, jeli takowy zosta podany; w przeciwnym razie format
ten wypisuje grup linii dosownie, bez zmian czy dodatkw.

@item --changed-group-format=@var{format}
Te grupy s porcjami zawierajcymi linie z obu plikw.
Domylny format grup zmienionych linii jest zczeniem (konkatenacj)
formatw grup nowych i starych linii.

@item --unchanged-group-format=@var{format}
Te grupy zawieraj skadaj si z linii wsplnych obu plikom.
Domylnym formatem grup niezmienionych linii jest format wypisujcy
grup linii dosownie.
@end table

W formatach okrelajcych sposb wypisania grupy linii zwyke znaki oznaczaj
same siebie; specyfikacje konwersji zaczynaj si od znaku procentu @samp{%}
i maj jedn z poniszych postaci:

@table @samp
@item %<
oznacza linie z pierwszego pliku, cznie z kocowym znakiem nowej linii.
Kada linia jest formatowana zgodnie z formatem starych linii
(@pxref{Formaty linii}).

@item %>
oznacza linie z drugiego pliku, cznie z kocowym znakiem nowej linii.
Kada linia jest formatowana zgodnie z formatem nowych linii

@item %=
oznacza linie wsplne dla obu plikw, cznie z kocowym znakiem nowej linii.
Kada linia jest formatowana zgodnie z formatem linii niezmienionych.

@item %%
oznacza pojedynczy dosowny znak procentu @samp{%}.

@item %c'@var{C}'
gdzie @var{C} jest pojedynczym znakiem, oznacza @var{C}.
Nie moe to by odwrotny ukonik ani apostrof.
Na przykad, @samp{%c':'} oznacza dwukropek,, nawet wewntrz czci then
formatu if-then-else, ktr dwukropek normalnie koczy.

@item %c'\@var{O}'
gdzie @var{O} jest acuchem 1, 2 lub 3 cyfr semkowych, oznacza znak
o kodzie semkowym @var{O}.
Na przykad, @samp{%c'\0'} oznacza znak null.

@item @var{F}@var{n}
gdzie @var{F} jest specyfikacj konwersji @code{printf}, a @var{n} jest
jedn z niej wymienionych liter, oznacza warto okrelon przez @var{n}
sformatowan za pomoc @var{F}.

@table @samp
@item e
Numer linii dla linii bezporednio poprzedzajcej dan grup w starym pliku.

@item f
Numer linii dla pierwszej linii w grupie w starym pliku.
Rwny @var{e} + 1.

@item l
Numer linii dla ostatniej linii w grupie w starym pliku.

@item m
Numer linii dla linii wystpujcej bezporednio po grupie w starym pliku.
Rwny @var{l} + 1.

@item n
Liczba linii w grupie w starym pliku.
Rwny @var{l} - @var{f} + 1.

@item E, F, L, M, N
Podobnie, dla linii w nowym pliku.

@end table

Specyfikacj konwersji @code{printf} moe by @samp{%d}, @samp{%o},
@samp{%x} lub @samp{%X}, okrelajce odpowiednio: wyjcie dziesitne,
semkowe, szesnastkowe maymi literami lub szesnastkowe duymi literami.
Po znaku procentu @samp{%} mog si pojawi kolejno nastpujce opcje:
@samp{-} okrelajcy wyrwnanie do lewej, liczba cakowita podajca
minimaln szeroko pola i kropka z nastpujc po niej opcjonaln liczb
cakowit podajc minimaln ilo cyfr [uamkowych].
Na przykad, @samp{%5dN} wypisuje liczb nowych linii w danej grupie
w polu o szerokoci z znakw, stosujc uywany przez @code{printf}
format @code{"%5d"}.

@item (@var{A}=@var{B}?@var{T}:@var{E})
Jeeli @var{A} jest rwne @var{B}, to @var{T}, w przeciwnym razie @var{E}.
@var{A} i @var{B} s albo obie staymi podanymi dziesitnie albo pojedynczymi
literami, interpretowanymi jak wyej.
Ta specyfikacja formatu jest rwnowana @var{T} jeli warto @var{A} jest
rwna wartoci @var{B}; w przeciwnym razie jest rwnowana @var{E}.

Na przykad, @samp{%(N=0?no:%dN) line%(N=1?:s)} jest rwnowane formatowi
@samp{no lines} jeli @var{N} (liczba linii w grupie w nowym pliku)
@c          Bd oryginau:  in the group in the the
jest rwne 0, formatowi @samp{1 line} jeli @var{N} jest rwne 1,
a formatowi @samp{%dN lines} w pozostaych przypadkach.
@end table

@node Formaty linii, Szczegy If-then-else, Formaty grup linii, If-then-else
@subsection Formaty linii
@cindex formaty linii

Formaty linii reguluj, w jaki sposb kada z linii pobranych z pliku
wejciowego zostanie wypisana jako cz grupy linii w formacie if-then-else.

Na przykad, poniszej polecenie wypisuje tekst z umieszczonym po lewej
jednokolumnowym wskanikiem zmian.  I tak: pierwsza kolumn wyjcia jest
@samp{-} dla linii usunitych, @samp{|} dla dodanych, a spacja dla
niezmienionych.  Formaty zawieraj znaki nowej linii tam, gdzie s one
podane w wyjciu.

@example
diff \
   --old-line-format='-%l
' \
   --new-line-format='|%l
' \
   --unchanged-line-format=' %l
' \
   stary nowy
@end example

Do podania formatu linii uywa si jednej z poniszych opcji.  Wskazany
@var{format} powinien by cytowany, gdy czsto zawiera metaznaki powoki.

@table @samp
@item --old-line-format=@var{format}
formatuje linie tylko z pierwszego pliku.

@item --new-line-format=@var{format}
formatuje linie tylko z drugiego pliku.

@item --unchanged-line-format=@var{format}
formatuje linie wsplne obu plikom.

@item --line-format=@var{format}
formatuje wszystkie linie; w efekcie nadaje warto rwnoczenie
wszystkim trzem powyszym opcjom.
@end table

W formacie okrelajcym sposb wypisania linii zwyke znaki oznaczaj
same siebie;
specyfikacje konwersji zaczynaj si od znaku procentu @samp{%} i maj jedn
z poniszych postaci:

@table @samp
@item %l
oznacza zawarto danej linii, bez koczcego j znaku nowej linii
(jeli jest takowy).  Ten format ignoruje czy linia jest niekompletna czy
poprawnie zakoczona.
@xref{Niekompletne linie}.

@item %L
oznacza zawarto danej linii, cznie z koczcym j znakiem nowej linii
(jeli jest takowy).  Jeeli linia jest niekompletna, to zachowuje t
niekompletno.

@item %%
oznacza dosowny znak procentu @samp{%}.

@item %c'@var{C}'
gdzie @var{C} jest pojedynczym znakiem, oznacza @var{C}.
@var{C} nie moe by odwrotnym ukonikiem ani apostrofem.
Na przykad, @samp{%c':'} oznacza dwukropek.

@item %c'\@var{O}'
gdzie @var{O} jest acuchem 1, 2 lub 3 cyfr semkowych, oznacza znak
o kodzie semkowym @var{O}.
Na przykad, @samp{%c'\0'} oznacza znak null.

@item @var{F}n
gdzie @var{F} jest specyfikacj konwersji @code{printf},
oznacza numer linii sformatowany za pomoc @var{F}.
Na przykad, @samp{%.5dn} wypisuje numer linii uywajc formatu
@code{"%.5d"} dla @code{printf}.
@xref{Formaty grup linii}, gdzie bliej omwiono specyfikacje konwersji
printf.

@end table

Domylnym formatem linii jest @samp{%l}, po ktrym wystpuje znak nowej
linii.

Jeeli wejcie zawiera znaki tabulacji i jest istotne, by w wyjciu byy
one odpowiednio wyrwnane, powinnimy upewni si, e @samp{%l} lub @samp{%L}
w formacie linii wystpuje bezporednio po tabulatorze (np.@: poprzedzajc
@samp{%l} czy @samp{%L} tabulacj) albo uy opcji @samp{-t} lub
@samp{--expand-tabs}.

Razem wzite, formaty linii i formaty grup linii pozwalaj na okrelenie
wielu rnych formatw.  Na przykad, ponisze polecenie korzysta z formatu
zblionego do normalnego formatu @code{diff}.  Mona je sobie dostosowa,
by uzyska precyzyjn kontrol nad wyjciem produkowanym przez @code{diff}.

@example
diff \
   --old-line-format='< %l
' \
   --new-line-format='> %l
' \
   --old-group-format='%df%(f=l?:,%dl)d%dE
%<' \
   --new-group-format='%dea%dF%(F=L?:,%dL)
%>' \
   --changed-group-format='%df%(f=l?:,%dl)c%dF%(F=L?:,%dL)
%<---
%>' \
   --unchanged-group-format='' \
   old new
@end example

@node Szczegy If-then-else, Przykadowy If-then-else, Formaty linii, If-then-else
@subsection Szczegowy opis formatu If-then-else

Do linii wsplnych dla obu plikw, @code{diff} stosuje format niezmienionych
grup linii.  Dla kadej porcji rnic w formacie scalonego wyjcia, jeli
porcja zawiera tylko linie z pierwszego pliku, @code{diff} stosuje format
grup starych linii; jeli porcja zawiera tylko linie z drugiego pliku,
@code{diff} stosuje format grup nowych linii; w pozostaych przypadkach
stosowany jest format grup zmienionych.

Formaty starych, nowych i zmienionych linii okrelaj, odpowiednio, format
wyjciowy linii z pierwszego pliku, linii z drugiego pliku i linii wsplnych
dla obu plikw.

Opcja @samp{--ifdef=@var{nazwa}} jest rwnowana nastpujcej sekwencji
opcji zapisanej w skadni powoki:

@example
--old-group-format='#ifndef @var{nazwa}
%<#endif /* not @var{nazwa} */
' \
--new-group-format='#ifdef @var{nazwa}
%>#endif /* @var{nazwa} */
' \
--unchanged-group-format='%=' \
--changed-group-format='#ifndef @var{nazwa}
%<#else /* @var{nazwa} */
%>#endif /* @var{nazwa} */
'
@end example

Naley uwanie sprawdzi wyjcie utworzone przez @code{diff} pod
ktem poprawnoci zagniede.  Na przykad, stosujc opcj
@c              HQ: Bd oryginau:  using the the @samp{-D @var{name}}
@samp{-D @var{nazwa}} lub @samp{--ifdef=@var{nazwa}}, powinno si sprawdzi,
e jeli rnice si linie zawieraj ktr z dyrektyw preprocesora C:
@samp{#ifdef}, @samp{#ifndef}, @samp{#else}, @samp{#elif} lub @samp{#endif},
to s dyrektywy te poprawnie zagniedone i powizane.  Jeli tak nie jest,
poprawki musz by dokonane rcznie.  Tak czy owak warto uwanie sprawdza
powstay kod, by upewni si, e faktycznie robi to, czego chcemy.
W zalenoci od sposobu utworzenia plikw wejciowych, wyjcie moe zawiera
powielony lub w inny sposb niepoprawny kod.

Wystpujca w @code{patch} opcja @samp{-D @var{nazwa}} zachowuje si tak,
jak opcja @samp{-D @var{nazwa}} programu @code{diff}, z wyjtkiem tego, e
dziaa na pliku i acie, by utworzy scalony plik.  @xref{Opcje patch}.

@node Przykadowy If-then-else, , Szczegy If-then-else, If-then-else
@subsection Przykad formatu If-then-else

Oto wynik dziaania polecenia @samp{diff -DDWA lao tsy}
(@pxref{Przykadowe wejcie diff}, gdzie podano pen posta uytych plikw):

@example
#ifndef DWA
Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
#endif /* not DWA */
Bezimienne jest pocztkiem nieba i ziemi,
#ifndef DWA
Nazwane jest matk wszystkich rzeczy.
#else /* DWA */
nazwane jest matk wszystkich rzeczy.

#endif /* DWA */
Przeto, kto trwale pozbawion jest pragnie wszelakich,
  potrafi dojrze subteln istot tao,
za, kto niezmiennie tkwi w ptach swych pragnie,
  moe tylko ujrze zewntrzn pozorno rzeczy.
Te dwie strony tao wywodz si
ze wsplnego rda,
  lecz nosz odmienne nazwy.
#ifdef DWA
To, co w nich wsplne, nazywamy wielk tajemnic,
tajemnic nad tajemnicami,
bram do poznania wszelakich cudownoci.
#endif /* DWA */
@end example

@node Porwnywanie katalogw, Dostosowywanie wyjcia, Formaty wyjciowe, Top
@chapter Porwnywanie katalogw

@code{diff} mona wykorzysta do porwnania niektrych lub wszystkich plikw
z zadanych dwu drzew katalogowych.  Gdy oba argumenty programu okrelajce
nazwy plikw s katalogami, porwnuje on kady z plikw, ktry zawieraj
oba katalogi.  Nazwy plikw s badane w kolejnoci alfabetycznej.
Normalnie @code{diff} milczy, jeli dana para plikw nie rni si, ale
jeli posuymy si opcj @samp{-s} lub @samp{--report-identical-files},
to pary plikw identycznych bd sygnalizowane.  Normalnie @code{diff}
zgasza tylko podkatalogi wsplne dla obu zadanych katalogw bez porwnywania
plikw z podkatalogw, ale jeli posuymy si opcj @samp{-r} lub
@samp{--recursive}, to bd porwnywane wszystkie odpowiadajce sobie
pary plikw w drzewach katalogowych, tyle poziomw w gb, ile zawieraj.

Dla plikw, ktre istniej tylko w jednym z katalogw, @code{diff}
normalnie nie pokazuje zawartoci pliku: zgasza tylko, e plik istnieje
w danym katalogu, a nie istnieje w drugim.  Mona sprawi by program dziaa
tak, jakby plik w drugim katalogu istnia, ale by pusty, po to, eby zostaa
wypisana caa zawarto istniejcego pliku.  (Zostanie wypisany albo jako
wstawienie albo jako usunicie, w zalenoci od tego czy jest w pierwszym
czy w drugim z podanych katalogw.)  Uywa si w tym celu opcji @samp{-N}
lub @samp{--new-file}.

Jeli starszy katalog zawiera jakie wielkie pliki, ktrych nie ma w nowszym
katalogu, mona zmniejszy at zamiast opcji @samp{-N} wykorzystujc
@samp{-P} lub @samp{--unidirectional-new-file}.  Dziaa podobnie jak
@samp{-N}, ale wstawia tylko zawarto plikw, ktre wystpuj w drugim
katalogu, lecz nie w pierwszym (to znaczy, plikw, ktre zostay dooone).
Na pocztku pliku aty powinno si dopisa instrukcje dla uytkownika, ktry
bdzie nakada at, by przez jej uyciem skasowa usunite w starej wersji
pliki.  @xref{Tworzenie at}, gdzie dokadniej omwiono tworzenie at
w celu rozpowszechniania.

Do ignorowania niektrych plikw podczas porwnywania katalogw suy opcja
@samp{-x @var{wzorzec}} lub @samp{--exclude=@var{wzorzec}}.  Ignoruje ona
wszystkie pliki i podkatalogi, ktrych gwna cz nazwy pasuje do wzorca
powoki @var{wzorzec}.  Inaczej ni w powoce, kropka na pocztku gwnej
czci nazwy pasuje do maski na pocztku wzorca.  @var{wzorzec} powinien
by ujty w znaki cytowania, eby powoka go nie rozwina.  Na przykad,
opcja @samp{-x '*.[ao]'} ignoruje wszystkie pliki o nazwach koczcych
si na @samp{.a} lub @samp{.o}.

Jeli podamy j wicej ni raz, dziaanie tej opcji kumuluje si.
Na przykad, uycie opcji @samp{-x 'RCS' -x '*,v'} powoduje ignorowanie
plikw i podkatalogw o nazwie @samp{RCS} lub nazwie koczcej si
na @samp{,v}.

Jeli chcemy poda t opcj wielokrotnie, wygodniej jest zamiast tego
zapisa wzorce w pliku, po jednym w linii, i skorzysta z opcji
@samp{-X @var{plik}} lub @samp{--exclude-from=@var{plik}}.

Jeli porwnywalimy dwa katalogi i przerwalimy sprawdzanie w trakcie
pracy, moemy pniej kontynuowa je od miejsca, w ktrym je porzucilimy.
Robi si to stosujc opcj @samp{-S @var{plik}} lub
@samp{--starting-file=@var{plik}}.  Porwnuje ona tylko @var{plik}
i wszystkie alfabetycznie wystpujce po nim pliki z katalogu najwyszego
poziomu.

@node Dostosowywanie wyjcia, Wydajno diff, Porwnywanie katalogw, Top
@chapter Upikszanie wyjcia @code{diff}

@code{diff} dostarcza kilku sposobw dostosowania wygldu tworzonego wyjcia.
Mona je stosowa do dowolnego formatu wyjciowego.

@menu
* Tabulatory::		Zachowywanie wyrwnania tabulatorw.
* Stronicowanie::	Numerowanie stron i datowanie wyjcia @code{diff}.
@end menu

@node Tabulatory, Stronicowanie, , Dostosowywanie wyjcia
@section Zachowywanie wyrwnania do tabulatorw
@cindex tabulatory, wyrwnywanie
@cindex wyrwnywanie tabulatorw

W niektrych formatach wyjciowych @code{diff} linie tekstu poprzedzone s
jednym bd dwoma znakami, wskazujcymi czy tekst zosta wstawiony, usunity
czy zmieniony.  Dooenie tych znakw moe spowodowa, e tabulacje przesun
@c                        throwing off the alignment of columns
si na nastpn pozycj tabulacyjn, burzc wyrwnanie kolumn w linii. 
GNU @code{diff} zapewnia dwie metody uzyskania poprawnego ustawienia
kolumn wyrwnanych tabulacjami.

Pierwszy sposb polega na konwersji, przed ich wypisaniem, wszystkich znakw
tabulacji na poprawn liczb spacji.  Metod t wybiera si opcj @samp{-t}
lub @samp{--expand-tabs}.  Program zakada, e pozycje tabulacyjne
(tabulatory) ustawione s co 8 kolumn.  Chcc uy tej postaci wyjcia
z @code{patch}, trzeba poda mu opcj @samp{-l}
lub @samp{--ignore-white-space}
(@pxref{Zmienione odstpy}, gdzie podano szczegy).

Inn metod poprawnego ustawienia tabulacji jest dodanie na pocztku linii,
po znaku wskazujcym rodzaj zmiany, znaku tabulacji zamiast spacji.
Dziki temu wszystkie nastpne tabulacje bd na pewno w tym samym
pooeniu wzgldem tabulatorw, w ktrym byy w pierwotnych plikach,
zatem wyjcie bdzie poprawnie wyrwnane.  Wad tego rozwizania jest to,
e niekiedy z dugich linii powstaj linie zbyt dugie, by zmieciy si
w pojedynczym wierszu ekranu czy na papierze.  Poza tym, nie dziaa ono
z formatem zunifikowanym, w ktrym nie ma spacji po znaku wskazujcym typ
zmiany.  Metod t wybiera si opcj @samp{-T} lub @samp{--initial-tab}.

@node Stronicowanie, , Tabulatory, Dostosowywanie wyjcia
@section Stronicowanie wyjcia @code{diff}
@cindex stronicowanie wyjcia @code{diff}

W dugim pliku wyjciowym wygodnie mie numeracj stron i dat utworzenia.
Robi to opcje @samp{-l} i @samp{--paginate}, przepuszczajc wyjcie
z @code{diff} przez program @code{pr}.  Tak mgby wyglda nagwek strony
dla @samp{diff -lc lao tsy}:

@example
Mar 11 13:37 1991  diff -lc lao tsy Page 1
@end example

@node Wydajno diff, Porwnanie trzech plikw, Dostosowywanie wyjcia, Top
@chapter Kompromisy wydajnoci @code{diff}
@cindex wydajno @code{diff}

GNU @code{diff} pracuje cakiem wydajnie; jednak, w pewnych warunkach
mona spowodowa, by dziaa szybciej lub tworzy zbir zmian o mniejszych
rozmiarach.  S dwie metody wpywania na wydajno GNU @code{diff} przez
zmian sposobu, w jaki porwnuje pliki.

Wydajno mona rozpatrywa z rnych punktw widzenia.  Te opcje poprawiaj
jeden aspekt wydajnoci kosztem innego lub poprawiaj wydajno w pewnych
przypadkach cho szkodz jej w innych.

Sposb, w jaki GNU @code{diff} okrela, ktre linie si zmieniy, zawsze
prowadzi do zbioru rnic bliskiego minimalnemu.  Do celw praktycznych
to zwykle wystarcza.
Jeli otrzymane wyjcie jest bardzo due, mona spowodowa, by program
uy zmodyfikowanego algorytmu, ktry czasem daje mniejszy zbir rnic.
Wykonuje to opcja @samp{-d} lub @samp{--minimal}.  Moe ona jednak
spowodowa take, e @code{diff} bdzie pracowa wolniej niz zwykle,
wic nie jest to zachowanie domylne.

Gdy porwnywane pliki s due, a maj mae grupy zmian rozrzucone
po caej zawartoci, uywa si opcji @samp{-H} lub
@samp{--speed-large-files}, wprowadzajcej inn zmian do algorytmu
uywanego przez @code{diff}.  Jeli pliki wejciowe maj stae mae
zagszczenie zmian, to opcja ta przyspiesza porwnania, nie zmieniajc
tworzonego wyjcia.
Jeli nie, to program moe utworzy wikszy zbir rnic;
jednak wyjcie bdzie nadal poprawne.

Normalnie @code{diff} odrzuca przedrostek i przyrostek wsplny obu plikom
przed prb znalezienia minimalnego zbioru rnic.  Dziki temu program
dziaa szybciej, ale sporadycznie moe tworzy wyjcie, ktre nie jest
minimalne.  Opcja @samp{--horizon-lines=@var{linie}} przeciwdziaa odrzucaniu
przez @code{diff} ostatnich @var{linie} linii przedrostka i pierwszych
@var{lines} linii przyrostka pliku.  Daje to programowi dodatkowe okazje
do znalezienia minimalnego wyjcia.

@node Porwnanie trzech plikw, Scalanie diff3, Wydajno diff, Top
@chapter Porwnanie trzech plikw
@cindex porwnywanie trzech plikw
@cindex format wyjcia @code{diff3}

Program @code{diff3} stosuje si do porwnywania trzech plikw i pokazania
rnic midzy nimi.  (Moe te scala pliki -- zob. @ref{Scalanie diff3}).

``Normalny'' format wyjciowy @code{diff3} pokazuje kad porcj rnic bez
otaczajcego j kontekstu.  Porcje s oznaczone zalenie od tego, czy s
dwu- czy trjstronne, a linie opatrzone komentarzem wskazujcym ich
pooenie w plikach wejciowych.

@xref{Wywoanie diff3}, gdzie bliej opisano sposb uruchamiania @code{diff3}.

@menu
* Przykadowe wejcie diff3::	Plik wejciowy do przykadw @code{diff3}.
* Szczegy normalnego diff3::	Szczegowy opis normalnego formatu wyjciowego..
* Porcje diff3::   		Format normalnego wyjcia diff3.
* Przykadowy normalny diff3::	Przykadowe wyjcie w formacie normalnym.
@end menu

@node Przykadowe wejcie diff3, Szczegy normalnego diff3, , Porwnanie trzech plikw
@section Trzeci przykadowy plik wejciowy
@cindex @code{diff3}, przykadowe wejcie
@cindex przykadowe pliki wejciowe dla @code{diff3}

Oto trzeci przykadowy plik wejciowy, ktry bdzie uywany w przykadach
do pokazania wyjcia uzyskiwanego z @code{diff3} i tego, jak zmienia si ono
w zalenoci od rnych opcji.  Pierwsze dwa pliki to te same, ktrych
uywalimy przy omawianiu @code{diff} (@pxref{Przykadowe wejcie diff}).
A to trzeci plik przykadowy, o nazwie @file{tao}:

@example
Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
Bezimienne jest pocztkiem nieba i ziemi,
nazwane jest matk wszystkich rzeczy.

Przeto, kto trwale pozbawion jest pragnie wszelakich,
  potrafi dojrze subteln istot tao,
za, kto niezmiennie tkwi w ptach swych pragnie,
  moe tylko ujrze skoczono rzeczy.
Te dwie strony tao wywodz si
ze wsplnego rda,
  lecz nosz odmienne nazwy.

  -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
@end example

@node Szczegy normalnego diff3, Porcje diff3, Przykadowe wejcie diff3, Porwnanie trzech plikw
@section Szczegowy opis normalnego formatu wyjciowego @code{diff3}

Kada porcja zaczyna si od linii oznaczonej @samp{====}.  Porcje
trjstronne maj zwyke linie @samp{====}, a dwustronne -- z doczonym
@samp{1}, @samp{2} lub @samp{3}, okrelajcym, ktre z trzech plikw
wejciowych rni si w tej porcji.  Porcje skadaj si z kopii dwu lub
trzech zbiorw linii wejciowych, z ktrych kady poprzedzony jest jednym
lub dwoma poleceniami identyfikujcymi pochodzenie linii.

Normalnie, kad kopi linii wejciowej poprzedzaj dwie spacje,
do odrnienia jej od polece.  Ale z opcj @samp{-T} lub
@samp{--initial-tab}, @code{diff3} uywa tabulacji zamiast dwu spacji;
wyrwnuje to poprawnie tabulacje.
@xref{Tabulatory}, gdzie podano szczegy.

Polecenia przyjmuj ponisz posta:

@table @samp
@item @var{plik}:@var{l}a
Ta porcja pojawia si po linii @var{l} pliku @var{plik} i nie zawiera
adnych linii tego pliku.  Zmieniajc ten plik, by zawiera to, co pozostae
pliki, naley dopisa do linie porcji (wzite z tych plikw).
Na przykad, @samp{1:11a} oznacza, e dana porcja wystpuje po linii 11
pierwszego pliku i nie zawiera linii z tego pliku.

@item @var{plik}:@var{r}c
Ta porcja skada si z linii z zakresu @var{r} pliku @var{plik}.
Zakres @var{r} jest par rozdzielonych przecinkiem numerw linii lub
pojedynczym numerem jeli zakres zawiera jedn lini.  Zmieniajc ten plik,
by zawiera to, co pozostae pliki, naley zmieni wskazane linie tak, by
byy liniami wzitymi z tych plikw.
Na przykad, @samp{2:11,13c} oznacza, e dane porcja zawiera linie
od 11 do 13 z drugiego pliku.
@end table

Jeli ostatnia linia zbioru linii wejciowych jest niekompletna
(@pxref{Niekompletne linie}), to w tworzonym wyjciu jest ona wyrniona,
w stosunku penej linii, przez nastpn lini, ktra zaczyna si od @samp{\}.

@node Porcje diff3, Przykadowy normalny diff3, Szczegy normalnego diff3, Porwnanie trzech plikw
@section Porcje @code{diff3}
@cindex porcje @code{diff3}
@cindex @code{diff3}, porcje

Grupy linii, ktre si rni w dwu lub trzech plikach wejciowych s zwane
@dfn{porcjami diff3} (@dfn{diff3 hunks}), przez analogi do porcji
@code{diff} (@pxref{Porcje}).  Jeeli w porcji @code{diff3} wszystkie trzy
pliki wejciowe rni si od siebie, to porcj tak nazywamy @dfn{porcj
trjstronn} (@dfn{three-way hunk}); jeli rni si tylko dwa pliki,
to jest to @dfn{porcja dwustronna} (@dfn{two-way hunk}).

Tak jak w @code{diff}, moliwe jest kilka rozwiza.  Przy porwnywaniu
plikw @samp{A}, @samp{B} i @samp{C}, @code{diff3} normalnie tworzy
porcje @code{diff3} scalajc porcje dwustronne wypisywane przez dwa
polecenia: @samp{diff A B} i @samp{diff A C}.  Niekoniecznie minimalizuje
to rozmiar wyjcia, lecz wyjtki powinny wystpowa rzadko.

Na przykad, zamy, e @file{F} skada si z trzech linii: @samp{a},
@samp{b}, @samp{f}, @file{G} skada si z @samp{g}, @samp{b}, @samp{g},
za @file{H} -- z @samp{a}, @samp{b}, @samp{h}.
Wynik dziaania @samp{diff3 F G H} wyglda tak:

@example
====2
1:1c
3:1c
  a
2:1c
  g
====
1:3c
  f
2:3c
  g
3:3c
  h
@end example

@noindent
poniewa znaleziono dwustronn porcj zawierajc @samp{a} w pierwszym
i trzecim pliku, a @samp{g} w drugim pliku, potem pojedyncz lini
@samp{b} wspln dla wszystkich plikw, a nastpnie trjstronn porcj
zawierajc ostatni lini z kadego z plikw.

@node Przykadowy normalny diff3, , Porcje diff3, Porwnanie trzech plikw
@section Przykad normalnego formatu wyjciowego @code{diff3}

Oto wynik dziaania polecenia @samp{diff3 lao tsy tao}
(@pxref{Przykadowe wejcie diff3}, gdzie podano pen posta uytych plikw).
Zauwa, e pokazuje ono tylko te linie, ktre s rne w obu plikach.

@example
====2
1:1,2c
3:1,2c
  Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
  Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
2:0a
====1
1:4c
  Nazwane jest matk wszystkich rzeczy.
2:2,3c
3:4,5c
  nazwane jest matk wszystkich rzeczy.
  
====3
1:8c
2:7c
    moe tylko ujrze zewntrzn pozorno rzeczy.
3:9c
    moe tylko ujrze skoczono rzeczy.
====
1:11a
2:11,13c
  To, co w nich wsplne, nazywamy wielk tajemnic,
  tajemnic nad tajemnicami,
  bram do poznania wszelakich cudownoci.
3:13,14c
  
    -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
@end example

@node Scalanie diff3, Interaktywne scalanie, Porwnanie trzech plikw, Top
@chapter Scalanie wedug wsplnego przodka
@cindex scalanie wedug wsplnego przodka

Gdy dwie osoby wprowadziy zmiany na kopiach tego samego pliku, @code{diff3}
potrafi utworzy scalone wyjcie, ktre zawiera oba zestawy poprawek razem
z ostrzeeniami o konfliktach.

Mona sobie wyobrazi programy o nazwach typu @code{diff4} i @code{diff5}
do porwnywania wicej ni trzech plikw rwnoczenie, ale w praktyce rzadko
pojawia si taka potrzeba.  Do poczenia wicej ni dwu zestaww zmian
danego pliku mona uy @code{diff3}, scalajc po dwa zestawy zmian na raz.

@code{diff3} potrafi wcieli zmiany z dwu zmienionych wersji do wsplnej
pierwotnej wersji.  Pozwala to na scalanie zestaww zmian reprezentowanych
przez dwa nowsze pliki.  Podaje si wwczas wspln, pierwotn wersj jako
drugi argument, a dwie nowsze -- jako pierwszy i trzeci, w ten sposb:

@example
diff3 @var{mj} @var{starszy} @var{twj}
@end example

@noindent
Kolejno argumentw atwo zapamita gdy zauwaymy, e wystpuj
w kolejnoci alfabetycznej.

@cindex konflikt
@cindex zakadka
@cindex nakadanie si
Moemy to interpretowa jako odejmowanie @var{starszego} od @var{twojego}
i dodanie wyniku do @var{mojego}, albo jako ujcie w @var{moim} zmian,
ktre przeksztaciyby @var{starszy} w @var{twj}.  Takie scalanie jest
precyzyjnie zdefiniowane dopki @var{mj} i @var{twj} pasuj do siebie
w ssiedztwie takiej zmiany.  Nie sprawdza si jednak gdy wszystkie trzy
pliki rni si od siebie lub gdy rni si tylko @var{starszy};
mwimy wwczas o @dfn{konflikcie}.  Kiedy wszystkie trzy pliki s rne,
konflikt taki nazywamy @dfn{zakadk} (@dfn{overlap}).

@code{diff3} dostarcza kilku sposobw obsugi zakadek i konfliktw.
Mona je pomin, wybra tylko zakadki albo oznaczy konflikty specjalnymi
liniami @samp{<<<<<<<} i @samp{>>>>>>>}.

@code{diff3} potrafi wypisa wyniki scalania w postaci skryptu @code{ed},
ktry mona zastosowa do pierwszego pliku, by uzyska scalone wyjcie.
Jednak zwykle jest lepiej, gdy @code{diff3} bezporednio tworzy scalone
wyjcie.  Obchodzimy wwczas pewne problemy z @code{ed}.

@menu
* Jakie zmiany::		Wybr zmian do wcielenia.
* Oznaczanie konfliktw::	Oznaczanie konfliktw.
* Pomijanie ed::		Bezporednie tworzenie scalonego wyjcia.
* Scalanie niekompletnych linii::  Jak @code{diff3} scala niekompletne linie.
* Zachowywanie zmienionego pliku:: Emulowanie zachowania System V.
@end menu

@node Jakie zmiany, Oznaczanie konfliktw, , Scalanie diff3
@section Wybr zmian, jakie maj zosta wcielone
@cindex nakadajca si zmiana, wybr
@cindex zakadka, wybr
@cindex niescalona zmiana
@cindex niedoczona zmiana

Za pomoc opcji @samp{-e} lub @samp{--ed} wybieramy do scalania
w @var{moim} wszystkie niescalone zmiany midzy @var{starszym} a @var{twoim}.
Opcj @samp{-3} lub @samp{--easy-only} wybieramy scalanie tylko
nienakadajcych si niescalonych zmian, a opcj @samp{-x} lub
@samp{--overlap-only} tylko zmian, ktre si nakadaj.

W opcjach @samp{-e}, @samp{-3} i @samp{-x} wybierane s tylko
@dfn{niescalone zmiany}, tj.@: zmiany, gdzie rni si @var{mj} i @var{twj};
ignorowane s zmiany midzy @var{starszym} a @var{twoim}, gdzie @var{mj}
i @var{twj} s identyczne, gdy zakada si, e takie zmiany zostay ju
@c                 assumption
scalone.  Jeeli takie zaoenie nie jest bezpieczne, powinnimy uy opcji
@samp{-A} lub @samp{--show-all} (@pxref{Oznaczanie konfliktw}).

Oto wyjcie polecenia @code{diff3} z kad z tych trzech opcji

(@pxref{Przykadowe wejcie diff3}, gdzie podano pen posta uytych plikw).
Zauwa, e @samp{-e} daje sum rozcznych zbiorw zmian wypisywanych
przez @samp{-3} i @samp{-x}.

Wynik dziaania @samp{diff3 -e lao tsy tao}:
@example
11a

  -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
.
8c
  moe tylko ujrze skoczono rzeczy.
.
@end example

Wynik dziaania @samp{diff3 -3 lao tsy tao}:
@example
8c
  moe tylko ujrze skoczono rzeczy.
.
@end example

Wynik dziaania @samp{diff3 -x lao tsy tao}:
@example
11a

  -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
.
@end example

@node Oznaczanie konfliktw, Pomijanie ed, Jakie zmiany, Scalanie diff3
@section Oznaczanie konfliktw
@cindex oznaczanie konfliktw
@cindex konflikty, oznaczanie
@cindex @samp{<<<<<<<} do oznaczania konfliktw

@code{diff3} moe zaznacza konflikty w scalonym wyjciu, ujmujc je midzy
specjalne linie znacznikowe.  Konflikt pomidzy dwoma plikami @var{A}
a @var{B} oznaczany jest tak:

@example
<<<<<<< @var{A}
@r{linie z @var{A}}
=======
@r{linie z @var{B}}
>>>>>>> @var{B}
@end example

Konflikt midzy trzema plikami @var{A}, @var{B} i @var{C} jest oznaczany tak:

@example
<<<<<<< @var{A}
@r{linie z @var{A}}
||||||| @var{B}
@r{linie z @var{B}}
=======
@r{linie z @var{C}}
>>>>>>> @var{C}
@end example

Opcja @samp{-A} lub @samp{--show-all} dziaa tak, jak opcja @samp{-e},
z wyjtkiem tego, e ujmuje konflikty midzy linie znacznikowe i wypisuje
wszystkie zmiany midzy @var{starszym} a @var{twoim}, a nie tylko zmiany
niescalone.  Zatem, przy przykadowych plikach wejciowych
(@pxref{Przykadowe wejcie diff3}), @samp{diff3 -A lao tsy tao} wstawia nawiasy
ostroktne wok konfliktw, gdzie rni si tylko @file{tsy}:

@example
<<<<<<< tsy
=======
Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
>>>>>>> tao
@end example

A konflikty trjstronne wypisuje tak:

@example
<<<<<<< lao
||||||| tsy
To, co w nich wsplne, nazywamy wielk tajemnic,
tajemnic nad tajemnicami,
bram do poznania wszelakich cudownoci.
=======

  -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
>>>>>>> tao
@end example

Opcja @samp{-E} lub @samp{--show-overlap} wypisuje mniej informacji ni
@samp{-A} (@samp{--show-all}), gdy podaje tylko zmiany niescalone, a nigdy
nie wypisuje zawartoci drugiego pliku.  Std te @samp{-E} dziaa jak
@samp{-e}, prcz tego, e ujmuje w znaczniki pierwszy i trzeci plik
z trjstronnych nakadajcych si zmian.  Podobnie, @samp{-X} dziaa
jak @samp{-x}, poza tym, e ujmuje w znaczniki wszystkie (niekoniecznie
nakadajce si) zmiany.  Na przykad, dla powyszej trjstronnej
nakadajcej si zmiany, opcje @samp{-E} i @samp{-X} wypisz:

@example
<<<<<<< lao
=======

  -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
>>>>>>> tao
@end example

Porwnujc dwa pliki o nic nie mwicych lub niewiele mwicych nazwach,
zapewne chcielibymy, by @code{diff3} w nawiasach @samp{<<<<<<<},
@samp{|||||||} i @samp{>>>>>>>} pokaza jakie ich nazwy zastpcze.
Suy do tego opcja @samp{-L @var{etykieta}} lub
@samp{--label=@var{etykieta}}. Moe zosta podana do trzech razy, po jednym
na kady plik wejciowy.   Zatem @samp{diff3 -A -L X -L Y -L Z A B C}
dziaa tak, jak @samp{diff3 -A A B C}, poza tym, e wyjcie wyglda, jakby
zostao otrzymane z plikw o nazwach @samp{X}, @samp{Y} i @samp{Z}, a nie
@samp{A}, @samp{B} i @samp{C}.

@node Pomijanie ed, Scalanie niekompletnych linii, Oznaczanie konfliktw, Scalanie diff3
@section Bezporednie tworzenie scalonego wyjcia
@cindex scalajcy format @code{diff3}

Z opcj @samp{-m} lub @samp{--merge} @code{diff3} wprost wypisuje scalony
plik.  Jest to efektywniejsze ni stosowanie do jego utworzenia programu
@code{ed} i dziaa nawet z plikami nie-tekstowymi, ktre @code{ed} by
odrzuci.  Jeli podamy @samp{-m} bez opcji skryptu @code{ed}, to przyjmowane
jest @samp{-A} (@samp{--show-all}).

Na przykad, polecenie @samp{diff3 -m lao tsy tao}
(@pxref{Przykadowe wejcie diff3}, gdzie pokazano pliki wejciowe) wypisze:

@example
<<<<<<< tsy
=======
Tao, ktre mona wyrazi sowami, nie jest prawdziwym tao.
Nazwa, ktr mona je okreli, nie jest niezmienn nazw.
>>>>>>> tao
Bezimienne jest pocztkiem nieba i ziemi,
Nazwane jest matk wszystkich rzeczy.
Przeto, kto trwale pozbawion jest pragnie wszelakich,
  potrafi dojrze subteln istot tao,
za, kto niezmiennie tkwi w ptach swych pragnie,
  moe tylko ujrze skoczono rzeczy.
Te dwie strony tao wywodz si
ze wsplnego rda,
  lecz nosz odmienne nazwy.
<<<<<<< lao
||||||| tsy
To, co w nich wsplne, nazywamy wielk tajemnic,
tajemnic nad tajemnicami,
bram do poznania wszelakich cudownoci.
=======

  -- Lao-tsy, Tao-te-king (Ksiga Drogi i Cnoty)
>>>>>>> tao
@end example

@node Scalanie niekompletnych linii, Zachowywanie zmienionego pliku, Pomijanie ed, Scalanie diff3
@section Jak @code{diff3} scala niekompletne linie
@cindex scalanie niekompletnych linii
@cindex niekompletne linie, scalanie

Z @samp{-m}, niekompletne linie (@pxref{Niekompletne linie}) s po prostu
kopiowane na wyjcie, tak jak je zastano. Jeli scalane wyjcie koczy si
konfliktem, a jeden z plikw wejciowych koczy si niekompletn lini,
to nastpujce po niej znaczniki @samp{|||||||}, @samp{=======} lub
@samp{>>>>>>>} pojawi si gdzie indziej ni na pocztku linii, gdy
zostan dopisane do niekompletnej linii.

Bez @samp{-m}, jeli podano opcj skryptu @code{ed} a zostaa napotkana
niekompletna linia, @code{diff3} generuje ostrzeenie i dziaa tak, jakby
znak nowej linii by obecny.

@node Zachowywanie zmienionego pliku, , Scalanie niekompletnych linii, Scalanie diff3
@section Zachowywanie zmienionego pliku
@cindex zgodno @code{diff3} z System V
@cindex System V, zgodno @code{diff3}

Tradycyjny uniksowy @code{diff3} tworzy skrypt @code{ed} bez kocowych
@c      HQ: bd oryginau:   trailing @samp{w} and and @samp{q}
polece @samp{w} i @samp{q}, ktre zapisuj zmiany pliku.
@code{diff3} z System V generuje te dodatkowe polecenia.  GNU @code{diff3}
normalnie zachowuje si tak, jak tradycyjna uniksowa wersja, ale z opcj
@samp{-i} dziaa jak @code{diff3} z System V i dokada @samp{w} i @samp{q}.

Opcja @samp{-i} wymaga jednej z opcji tworzcych skrypt @code{ed}:
@samp{-AeExX3}, i jest nie wsppracuje z opcj scalania wyjcia @samp{-m}.

@node Interaktywne scalanie, Scalanie z patch, Scalanie diff3, Top
@chapter Interaktywne scalanie za pomoc @code{sdiff}
@cindex rnice, scalanie
@cindex scalanie rnic
@cindex interaktywne scalanie

Za pomoc @code{sdiff}, mona interaktywnie scali dwa pliki, na podstawie
ich porwnania w formacie dwukolumnowym @samp{-y} (@pxref{Dwukolumnowy}).
Do podania, gdzie ma zosta umieszczony scalony tekst uywamy opcji
@samp{-o @var{plik}} lub @samp{--output=@var{plik}}.
@xref{Wywoanie sdiff}, gdzie szczegowo opisano opcje @code{sdiff}.

Inn metod interaktywnego scalania plikw jest uycie pakietu @code{emerge}
dla Emacs Lisp.
@xref{emerge, , emerge, emacs, The GNU Emacs Manual}, gdzie podano szczegy.

@menu
* Zestawienie opcji sdiff::	Zestawienie opcji @code{sdiff}.
* Polecenia scalania::	 	Interaktywne scalanie dwu plikw.
@end menu

@node Zestawienie opcji sdiff, Polecenia scalania, , Interaktywne scalanie
@section Podawanie opcji @code{diff} dla @code{sdiff}
@cindex format wyjcia @code{sdiff}

Ponisze opcje @code{sdiff} maj to samo znaczenie, co w @code{diff}.
@xref{Opcje diff}, gdzie podano ich zastosowanie.

@example
-a -b -d -i -t -v
-B -H -I @var{regexp}

--ignore-blank-lines  --ignore-case
--ignore-matching-lines=@var{regexp}  --ignore-space-change
--left-column  --minimal  --speed-large-files
--suppress-common-lines  --expand-tabs
--text  --version  --width=@var{columns}
@end example

Z powodw historycznych @code{sdiff} dla niektrych opcji posiada nazwy
alternatywne.  Opcja @samp{-l} jest rwnowana @samp{--left-column}.
Podobnie, @samp{-s} jest rwnowane @samp{--suppress-common-lines}.
Znaczenie opcji @samp{-w} i @samp{-W} jest w @code{sdiff} zamienione
w stosunku do @code{diff}: dla @code{sdiff}, @samp{-w @var{kolumny}} jest
rwnowanikiem @samp{--width=@var{kolumny}}, a @samp{-W} -- rwnowanikiem
@samp{--ignore-all-space}.  @code{sdiff} bez opcji @samp{-o} jest rwnowane
@code{diff} z opcj @samp{-y} lub @samp{--side-by-side}
(@pxref{Dwukolumnowy}).

@node Polecenia scalania, , Zestawienie opcji sdiff, Interaktywne scalanie
@section Polecenia scalania
@cindex scalanie, polecenia
@cindex polecenia scalania
@cindex scalanie interaktywne

Grupy wsplnych linii (pokazywanych z pustym miejscem midzy kolumnami)
kopiowane s z pierwszego pliku na wyjcie.  Po kadej grupie
rnicych si linii, @code{sdiff} wypisuje znak zachty @samp{%}
i oczekuje na jedno z poniszych polece.  Po kadym z nich naley
nacisn @key{RET}.

@table @samp
@item e
Odrzucenie obu wersji.
Wywouje edytor tekstw z pustym plikiem tymczasowym, a nastpnie kopiuje
powstay plik na wyjcie.

@item eb
Skleja obie wersje, przesya wynik do edycji w pliku tymczasowym,
nastpnie kopiuje zmieniony wynik na wyjcie.

@item el
Podaje do edycji kopi lewej wersji, nastpnie kopiuje wynik na wyjcie.

@item er
Podaje do edycji kopi prawej wersji, nastpnie kopiuje wynik na wyjcie.

@item l
Kopiuje lew wersj na wyjcie.

@item q
Koczy dziaanie programu.

@item r
Kopiuje praw wersj na wyjcie.

@item s
Kopiuje wsplnie linie bez powiadamiania.

@item v
Kopiuje wsplne linie komunikujc o tym.  Zachowanie domylne.
@end table

Wywoywany edytor tekstw okrelony jest zmienn rodowiska @code{EDITOR},
jeli jest ustawiona.  Domylny edytor zaley od systemu.

@node Scalanie z patch, Tworzenie at, Interaktywne scalanie, Top
@chapter Scalanie za pomoc @code{patch}

@code{patch} pobiera wyjcie z porwnania dokonanego przez @code{diff}
i wprowadza rnice do kopii oryginalnego pliku, tworzc zaatan wersj.
Za pomoc @code{patch} mona dystrybuowa tylko zmiany jakiego zestawu
plikw, zamiast rozpowszechniania caoci plikw.  Odbiorcy mog zastosowa
@code{at} do aktualizacji swoich egzemplarzy plikw do naszych zmian.
@code{patch} automatycznie rozpoznaje typ pliku rnicy, pomija ewentualne
pocztkowe i kocowe nagwki i korzysta z nagwka do stwierdzenia, ktry
plik naley zaata.  Umoliwia to naszym odbiorcom podawanie artykuw czy
wiadomoci zawierajcych listing rnic wprost do @code{patch}.

@code{patch} wykrywa typowe problemy, jak np. aty odwrcone, i ostrzega
o nich.  Zachowuje oryginalne wersje atanych plikw i zapisuje wszystkie
aty, ktrych nie dao si naoy.  Potrafi take prowadzi plik
@c            bd oryginau??: file to ensures that your correspondents
@code{patchlevel.h}, by zagwarantowa, e odbiorcy zastosuj aty w poprawnej
kolejnoci.

@code{patch} przyjmuje ze swego standardowego wejcia cig rnic, zwykle
rozdzielonych nagwkami, podajcymi jaki plik ma by zaatany.  Stosuje
porcje @code{diff} (@pxref{Porcje}) jedn po drugiej.  Jeli porcja nie pasuje
dokadnie do oryginalnego pliku, wwczas, starajc si jak najlepiej
go zaata, stosuje algorytm heurystyczny.  Jeli nie uda si znale
przyblionego dopasowania, program odrzuca t porcj i przechodzi
do nastpnej.  Normalnie @code{patch} kady atany plik @var{f} zastpuje
jego now wersj, pierwotn zachowuje w @samp{@var{f}.orig}, za odrzucone
porcje (jeli wystpiy) w @samp{@var{f}.rej}.

@xref{Wywoanie patch}, gdzie podano szczegowy opis opcji @code{patch}.
@xref{Kopie zapasowe}, gdzie dokadniej opisano, w jaki sposb @code{patch} nazywa
pliki kopii zapasowych.  @xref{Odrzucenia}, gdzie dokadniej opisano, gdzie
@code{patch} umieszcza odrzucone porcje.

@menu
* Wejcie patch::	Wybr typu wejcia @code{patch}.
* Niedoskonae::     	Praca z niedoskonaymi atami.
* Puste pliki::		Usuwanie pustych plikw po zaataniu.
* Wielokrotne aty::	Specjalna obsuga wielu at w pliku.
* Komunikaty patch::	Komunikaty i pytania tworzone przez @code{patch}.
@end menu

@node Wejcie patch, Niedoskonae, , Scalanie z patch
@section Wybr formatu wejciowego @code{patch}
@cindex format wejcia @code{patch}

@code{patch} normalnie ustala, ktrego formatu @code{diff} uywa plik aty
badajc jego zawarto.  Dla plikw at zawierajcych szczeglnie mylcy
tekst pocztkowy do wymuszenia poprawnej interpretacji formatu rnicy
moe zaj potrzeba uycia jednej z niej wymienionych opcji.  Podane tu
formaty wyjciowe s jedynymi, jakie potrafi rozpozna @code{patch}.

@table @samp
@item -c
@itemx --context
rnica kontekstowa.

@item -e
@itemx --ed
skrypt @code{ed}.

@item -n
@itemx --normal
normalny format rnicowy.

@item -u
@itemx --unified
rnica zunifikowana.
@end table

@node Niedoskonae, Puste pliki, Wejcie patch, Scalanie z patch
@section Nakadanie niedoskonaych at
@c                @cindex imperfect patch application
@c                 niepenych ???  - uwaga!! -niej te!!
@cindex nakadanie niedoskonaych at
@cindex niedoskonae aty, nakadanie

@code{patch} usiuje pomin ewentualny tekst pocztkowy z pliku aty,
naoy rnic, a nastpnie pomin tekst kocowy.  Dziki temu mona
przekaza artyku z grupy dyskusyjnej czy wiadomo pocztow wprost
do @code{patch}, i powinno to dziaa.  Jeli cao rnicy jest wcita
o sta ilo biaych znakw, wcicie jest ignorowane automatycznie.

Jednak pewne inne rodzaje niedoskonaoci wejcia wymagaj interwencji
uytkownika.

@menu
* Zmienione odstpy::	Gdy tabulacje i spacje nie pasuj dokadnie.
* Odwrcone aty::	Poprawne nakadanie odwrconych at.
* Niedokadne::		Pomoc @code{patch} w znalezieniu lepszych dopasowa.
@end menu

@node Zmienione odstpy, Odwrcone aty, , Niedoskonae
@subsection Nakadanie at przy zmienionych odstpach
@cindex biae znaki w atach

Czasami programy pocztowe, edytory czy inne programy wymieniaj spacje
na tabulacje lub odwrotnie.  Jeli zdarzy si to plikowi aty albo
wejciowemu, to mog one wyglda tak samo jak wczeniej, ale @code{patch}
nie bdzie mg ich poprawnie dopasowa.  Jeli pojawi si taki problem,
naley zastosowa opcj @samp{-l} lub @samp{--ignore-white-space}, ktra
@c                                      loosely
powoduje, e program mniej rygorystycznie porwnuje biae znaki, tak e
dowolny cig biaych znakw z pliku aty pasuje do dowolnego cigu biaych
znakw pliku wejciowego.  Znaki nie bdce biaymi znakami w dalszym cigu
musz pasowa dokadnie.  Kada linia kontekstu musi nadal odpowiada
odpowiedniej linii w pliku wejciowym.

@node Odwrcone aty, Niedokadne, Zmienione odstpy, Niedoskonae
@subsection Nakadanie odwrconych at
@cindex aty odwrcone
@cindex odwrcone aty

Zdarza si, e ludzie uruchamiaj @code{diff} z nowym plikiem jako pierwszym
parametrem, zamiast jako drugim.  Tworzy to at, ktra jest ``odwrcona''
(``reversed'').  W celu naoenia takiej aty naley poda @code{patch}
opcj @samp{-R} lub @samp{--reverse}.  Program prbuje wwczas zamieni
@c                     to swap each hunk around 
znaczenie kadej porcji przed jej naoeniem.  Odrzucenia wychodz
w formacie zamienionym.  Opcja @samp{-R} nie dziaa ze skryptami @code{ed},
gdy zawieraj zbyt mao danych do zrekonstruowania operacji odwrotnej.

Czsto @code{patch} potrafi si domyle, e ata jest odwrcona.  Jeli
pierwszej porcji z aty nie udaje si naoy, program odwraca t porcj,
by sprawdzi, czy da si jej uy w ten sposb.  Jeli tak, to pyta
uytkownika, czy chce on uaktywnienia opcji @samp{-R}.  Jeeli si nie
da -- ata bdzie nakadana dalej w normalny sposb.  Ta metoda nie jest
w stanie wykry aty odwrconej jeli rnica ma format normalny,
a pierwszym poleceniem jest dopisanie (a powinno to by usunicie).
Jest tak dlatego, e dopisanie zawsze dziaa, gdy pusty kontekst pasuje
wszdzie. Szczliwym trafem, wiele at raczej dodaje lub zmienia linie
ni je usuwa, wic wikszo odwrconych rnic typu normal zaczyna si
od usunicia, ktre si nie udaje, dziki czemu @code{patch} moe zauway
odwrcenie.

Jeli nakadamy at, ktra ju wczeniej zostaa naoona, @code{patch}
sdzi, e jest to ata odwrcona i proponuje jej zdjcie.  Mona to
interpretowa jako zaplanowan cech programu.  Jeeli zrobilimy to
niechccy i nie chcemy zdejmowa aty, wystarczy odpowiedzie @samp{n}
na t propozycj i nastpujce po niej pytanie ``naoy mimo to''
(``apply anyway'') -- lub nacisn @kbd{C-c}, by przerwa proces
@code{patch}.

@node Niedokadne, , Odwrcone aty, Niedoskonae
@subsection Pomoc @code{patch} w znalezieniu niedokadnych dopasowa
@c                  inexact patches
@cindex niedokadne aty
@cindex aty, niedokadne
@cindex wspczynnik rozmycia przy ataniu
@cindex fuzz factor, atanie

Dla rnic kontekstowych, i w mniejszym stopniu normalnych, @code{patch}
potrafi wykry wystpienie w acie niepoprawnych numerw linii i prbuje
znale waciwe miejsca do naoenia poszczeglnych porcji.  Jako pierwsz
prb bierze lini o numerze podanym w acie plus lub minus ewentualne
przesunicie zastosowane przy nakadaniu poprzedniej porcji.  Jeli nie trafi
w poprawne miejsce, to przeglda plik w przd i wstecz szukajc zestawu
linii pasujcych do kontekstu podanego w porcji.

@code{patch} pocztkowo szuka miejsca, do ktrego pasuj wszystkie linie
kontekstu.  Jeli nie moe go znale i ma do czynienia z rnic kontekstow
lub zunifikowan, za maksymalny wspczynnik rozmycia ma warto co
najmniej 1, to wykonuje kolejne wyszukiwanie ignorujc pierwsz i ostatni
lini kontekstu.  Jeli si i to zawiedzie, a maksymalny wspczynnik
rozmycia jest rwny co najmniej 2, to wykonuje nastpne wyszukiwanie,
tym razem ignorujc dwie pierwsze i dwie ostatnie linie kontekstu.
Dalej postpuje podobnie jeli wspczynnik rozmycia jest wikszy.

Opcja @samp{-F @var{linie}} lub @samp{--fuzz=@var{linie}} nadaje maksymalnemu
wspczynnikowi rozmycia warto @var{linie}.  Opcja ta ma zastosowanie tylko
rnic kontekstowych i zunifikowanych.  Powoduje ignorowanie do @var{linie}
linii podczas szukania miejsca do zainstalowania porcji.  Naley pamita,
e wikszy wspczynnik rozmycia podnosi ryzyko bdnego zaatania.
Domylnie wspczynnik rozmycia wynosi 2. Nie mona mu przypisa wartoci
wikszej ni ilo linii kontekstu w pliku rnicy, zwykle 3.

Jeeli @code{patch} nie moe znale miejsca, w ktrym powinien zainstalowa
porcj aty, zapisuje tak porcj do pliku odrzuce (@pxref{Odrzucenia},
gdzie dokadniej opisano, jak nazywane s pliku odrzuce).  Odrzucone porcje
zapisywane s w formacie kontekstowym, niezalenie od postaci aty
wejciowej.
Jeli ma ona format normalny lub skryptu @code{ed}, wiele kontekstw bdzie
po prostu pustych.  Numery linii w pliku odrzuce mog by inne ni w acie.
Pokazuj przyblione miejsca w nowym pliku, do ktrych, jak przypuszcza
@code{patch}, nale wadliwe porcje.  Numery linii nie odnosz si do
pooenia w starym pliku.

Po zakoczeniu obrbki kadej porcji, @code{patch} informuje, czy udao si
j zaaplikowa czy nie. A jeli nie, to w ktrej linii (w nowym pliku)
powinna si ona, wedug niego, znale.  Jeli numer tej linii jest inny
ni numer linii podany w pliku rnicy, pokazywane jest przesunicie
(offset).  Pojedyncze due przesunicie @emph{moe} wskazywa na to,
e @code{patch} zainstalowa porcj w zym miejscu.  Jeli do dopasowania
program skorzysta ze wspczynnika rozmycia, to rwnie o tym powiadamia,
gdy wwczas take powinnimy by troszk podejrzliwi.

@code{patch} nie umie stwierdzi, czy w skrypcie @code{ed} wyczono numery
linii.  Potrafi wykry bdne numery linii w rnicy normalnej tylko wtedy,
gdy znajdzie polecenie zmiany lub usunicia.  Moe mie takie same kopoty
z rnic kontekstow stosujc wspczynnik rozmycia rwny liczbie linii
kontekstu pokazanych w rnicy (standardowo 3) lub wikszy.
W tych przypadkach powinno si zapewne obejrze rnic kontekstow
midzy oryginalnym plikiem wejciowym a zaatanym, by stwierdzi czy zmiany
maj sens.  Bezbdna kompilacja pliku jest cakiem dobr wskazwk, e
at naoono poprawnie, ale nie daje gwarancji.

@code{patch} zwykle tworzy poprawne wyniki, nawet jeli musi wielokrotnie
@c              make many guesses.
korzysta z szacunkw.  Jednak wyniki s na pewno dobre tylko wtedy,
gdy ata jest nakadana na dokadn kopi pliku, z ktrego zostaa
wygenerowana.

@node Puste pliki, Wielokrotne aty, Niedoskonae, Scalanie z patch
@section Usuwanie pustych plikw
@cindex puste pliki, usuwanie
@cindex usuwanie pustych plikw

Czasem podczas porwnywania dwu katalogw zdarza si, e pierwszy
z nich zawiera plik, ktrego nie ma w drugim.  Jeli podamy @code{diff}
opcj @samp{-N} lub @samp{--new-file}, to wypisze rnic, ktra usuwa
zawarto tego pliku.  Domylnie, @code{patch} po przetworzeniu takiej
rnicy pozostawia pusty plik.  Uycie @code{patch} z opcj @samp{-E} lub
@samp{--remove-empty-files} powoduje usunicie plikw wyjciowych, ktre
po naoeniu aty s puste.

@node Wielokrotne aty, Komunikaty patch, Puste pliki, Scalanie z patch
@section Wiele at w pliku
@cindex wielokrotne aty

Jeeli plik aty zawiera wicej ni jedn at, to @code{patch} usiuje
zastosowa kad z nich tak, jakby pochodziy z osobnych plikw at.
Oznacza to, e program okrela nazw pliku do zaatania osobno dla kadej
aty i bada tekst przed kad z nich szukajc nazw plikw i wymaganych
wstpnie numerw wersji (@pxref{Tworzenie at}, gdzie jest wicej
na ten temat).

Dla drugiej i kolejnych at w pliku mona poda opcje i zastpcz nazw
oryginalnego pliku oddzielajc ich listy argumentw znakiem plus @samp{+}.
Lista argumentw dla drugiej i nastpnych at nie moe jednak wskazywa
nowego pliku aty, gdy nie ma to sensu.

Na przykad, chcc nakaza @code{patch} wycicie pierwszych trzech ukonikw
z nazwy pierwszej aty w pliku, a niewycinanie ich w ogle z kolejnych, oraz
uycie @file{code.c} jako pierwszego pliku wejciowego, stosujemy:

@example
patch -p3 code.c + -p0 < plikaty
@end example

Opcja @samp{-S} lub @samp{--skip} powoduje, e program ignoruje aktualnie
rozpatrywan at, ale dalej szuka kolejnej aty w pliku.
Zatem, do zignorowania pierwszej i trzeciej aty w pliku at uywamy:

@example
patch -S + + -S + < plikaty
@end example

@node Komunikaty patch, , Wielokrotne aty, Scalanie z patch
@section Komunikaty i pytania programu @code{patch}
@cindex komunikaty i pytania programu @code{patch}
@cindex diagnostyka programu @code{patch}
@cindex komunikaty @code{patch}

@code{patch} moe dawa rozmaite komunikaty, szczeglnie, jeli ma kopoty
@c                      In a few situations
z odczytaniem i zrozumieniem podanego mu wejcia.  W nielicznych sytuacjach,
gdy nie jest pewien, jak postpi, normalnie prosi o podanie z klawiatury
dodatkowych informacji.  Istniej opcje wyczajce wypisywanie komunikatw
(jeli bdy nie s krytyczne) i oczekiwanie na dane z klawiatury.

Komunikat @samp{Hmm...} wskazuje, e @code{patch} wanie czyta tekst z pliku
atajcego, usiujc stwierdzi, czy jest w nim ata, a jeli tak, to jakiego
rodzaju.

Opcja @samp{-s}, @samp{--quiet} lub @samp{--silent} zakazuje wysyania
na terminal wszelkiego wyjcia, chyba e pojawi si bd.

S dwa sposoby powstrzymania @code{patch} od zadawania pyta.
Opcja opcj @samp{-f} lub @samp{--force} wymusza zaoenie, e uytkownik
dokadnie wie co robi.  Program dziaa wwczas wedug poniszych regu:

@itemize @bullet
@item
pomija aty, ktre nie zawieraj w nagwkach nazw plikw;

@item
ata pliki nawet mimo tego, e maj z wersj w stosunku do
wyznaczonej lini @samp{Prereq:} aty;

@item
zakada, e aty nie s odwrcone, nawet jeli na takowe wygldaj.
@end itemize

Opcja @samp{-t} lub @samp{--batch} jest podobna do @samp{-f}, gdy
rwnie eliminuje pytania, ale powoduje przyjcie nieco innych zaoe:

@itemize @bullet
@item
pomija aty, ktre nie zawieraj w nagwkach nazw plikw
(tak samo, jak @samp{-f});

@item
pomija aty dla plikw ze zymi wersjami @samp{Prereq:};

@item
zakada, e aty s odwrcone, jeli na takie wygldaj.
@end itemize

@code{patch} koczy dziaanie z niezerowym kodem zakoczenia jeli
utworzy jakie pliki odrzuce.  Nakadajc w ptli zestaw at,
powinno si sprawdza kod zakoczenia, by nie naoy pniejszej aty
na plik tylko czciowo zaatany.

@node Tworzenie at, Wywoanie cmp, Scalanie z patch, Top
@chapter Wskazwki, jak tworzy rozsyane aty
@cindex tworzenie at, wskazwki
@cindex wskazwki, tworzenie at

Oto kilka rzeczy, o ktrych powiniene pamita, jeli zamierzasz
rozsya aty aktualizujce jaki pakiet oprogramowania.

Upewnij si, e poprawnie podae nazwy plikw, albo w nagwku rnicy
kontekstowej, albo lini @samp{Index:}.  Jeli atasz pliki w podkatalogu,
upewnij si, e powiadomie uytkownika, by poda opcj @samp{-p} lub
@samp{--strip}.  Uwaaj by nie wysya at odwrotnych, gdy powoduje to,
e ludzie zastanawiaj si czy ju naoyli at.

Moesz oszczdzi ludziom wielu problemw zwizanych z naoeniem aty,
ktra powinna by zastosowana po innych, wczeniejszych atach.
Wystarczy, e pierwsza rnica w wysyanym pliku bdzie aktualizowa
plik o nazwie typu @file{patchlevel.h}, zawierajcy poziom aty
(patch level).
Jeli plik wejciowy bdzie zawiera nieodpowiedni numer, @code{patch}
natychmiast zaprotestuje.

@c An even clearer way to prevent this
Znacznie czystsz metod zapobieenia temu problemowi jest wstawienie
przed rnic linii z napisem @samp{Prereq:}.  Jeli pocztkowy tekst
w pliku zawiera lini zaczynajc si od @samp{Prereq:}, to @code{patch}
pobiera z tej linii nastpne sowo (zwykle numer wersji).  Nastpnie
sprawdza, czy nastpny plik wejciowy je zawiera, przy czym przed tym
sowem i po nim powinien wystpowa albo biay znak albo znak nowej linii.
Jeli program nie znajdzie tego sowa w atanym pliku, to przed
kontynuacj dziaania prosi o potwierdzenie.  Utrudnia to przypadkowe
naoenie at w zej kolejnoci.

Poniewa @code{patch} nie obsuguje poprawnie niekompletnych linii,
przy kadym wypuszczeniu nowej wersji upewniaj si, e wszystkie pliki
rdowe twojego programu kocz si znakiem nowej linii.

Tworzenie aty zmieniajcej starsz wersj pakietu w nowsz zacznij
od utworzenia kopii starszej wersji w jakim katalogu tymczasowym.
Zwykle robi si to rozpakowujc archiwum @code{tar} lub @code{shar}
tej wersji.

Czasem mona zredukowa rozmiar aty przemianowujc lub przesuwajc
niektre pliki przed jej utworzeniem.  Jeli starsza wersja pakietu
zawiera jakie pliki, ktrych nie ma w nowszej, lub jeli pomidzy
obiema wersjami zmieniono nazwy jakich plikw, powiniene przygotowa
dla uytkownika list polece @code{rm} lub @code{mv}, ktre powinien
wykona w katalogu starej wersji przed naoeniem aty.  Nastpnie
w katalogu tymczasowym uruchom je sam.

Jeli masz jakie pliki, ktrych nie musisz wcza do aty, gdy atwo
mona je odtworzy z innych (na przykad, @file{TAGS} czy wyjcie z
@code{yacc} bd @code{makeinfo}), zastp ich wersje w tymczasowym katalogu
nowszymi, za pomoc @code{rm} i @code{ln} lub @code{cp}.

Teraz moesz utworzy at. Standardem de-facto formatu @code{diff}
stosowanym w dystrybucji at jest format kontekstowy o dwu liniach
kontekstu, tworzony przez podanie @code{diff} opcji @samp{-C 2}.
Nie stosuj mniej ni dwu linii kontekstu, gdy @code{patch} na og
do poprawnego dziaania potrzebuje co najmniej dwu.  Wywoujc @code{diff}
uyj opcji @samp{-P} na wypadek, gdyby nowsza wersja pakietu zawieraa
pliki, ktrych nie byo w starszej.  Upewnij si, e jako pierwszy
podajesz tymczasowy katalog, a nowszy jako drugi.

Na pocztku aty dodaj objanienie dla uytkownika, jakie polecenia
@code{rm} czy @code{mv} powinien uruchomi przed jej uyciem. Teraz
ju moesz usun tymczasowy katalog.

@node Wywoanie cmp, Wywoanie diff, Tworzenie at, Top
@chapter Wywoanie @code{cmp}
@cindex wywoanie @code{cmp}
@cindex @code{cmp}, wywoanie

Polecenie @code{cmp} porwnuje dwa pliki i, jeli si rni, wskazuje
numer bajtu i linii, gdzie wystpuje pierwsza rnica.
Posiada nastpujce argumenty:

@example
cmp @var{opcje}@dots{} @var{plik1} @r{[}@var{plik2}@var{]}
@end example

Nazwa pliku @samp{-} oznacza zawsze standardowe wejcie.
@code{cmp} uywa te standardowego wejcia jeli pominito jedn
z nazw plikw.

Zwracany kod zakoczenia 0 oznacza, e nie odnaleziono rnic,
1 napotkanie rnic, a 2 kopoty.

@menu
* Opcje cmp::		Zestawienie opcji @code{cmp}.
@end menu

@node Opcje cmp, , , Wywoanie cmp
@section Opcje @code{cmp}
@cindex @code{cmp}, opcje
@cindex opcje @code{cmp}

Poniej znajduje si podsumowanie wszystkich opcji akceptowanych przez
GNU @code{cmp}.  Wikszo opcji posiada dwie rwnowane formy, jedn
z nich jest pojedyncza litera poprzedzona kresk @samp{-}, a drug pena
nazwa poprzedzona przez @samp{--}.  Wiele pojedynczych liter opcji (pod
warunkiem, e nie wymagaj argumentu) mona poczy w pojedyncze sowo:
@samp{-cl} jest rwnowane @samp{-c -l}.

@table @samp
@item -c
@itemx --print-chars
Wypisuje rnice si znaki.  Znaki sterujce pokazywane s w postaci
@samp{^} plus litera, a znaki z ustawionym bardziej znaczcym bitem (high bit)
poprzedzane s przedrostkiem @samp{M-} (oznaczajcym ``meta'').

@item -i @var{ile}
@item --ignore-initial=@var{ile}
Ignoruje wszelkie rnice w @var{ile} pocztkowych bajtach kadego z plikw.
Traktuje pliki zawierajce mniej ni @var{ile} bajtw jakby byy puste.

@item -l
@itemx --verbose
Dla kadej rnicy wypisuje numer bajtu (dziesitnie) i wartoci rnicych
si bajtw (semkowo).

@item --quiet
@itemx -s
@itemx --silent
Nic nie wypisuje.  Zwraca tylko kod zakoczenia wskazujcy, czy pliki
si rni.

@item -v
@item --version
Wypisuje numer wersji @code{cmp}.
@end table

@node Wywoanie diff, Wywoanie diff3, Wywoanie cmp, Top
@chapter Wywoanie @code{diff}
@cindex wywoanie @code{diff}
@cindex @code{diff}, wywoanie

Format uruchomienia polecenia @code{diff}:

@example
diff @var{opcje}@dots{} @var{plik1} @var{plik2}
@end example

W najprostszym przypadku @code{diff} porwnuje zawarto dwch plikw,
@var{plik1} i @var{plik2}.  Nazwa pliku @samp{-} oznacza tekst odczytywany
ze standardowego wejcia.  W specjalnym przypadku: @samp{diff --} porwnuje
kopi standardowego wyjcia ze samym sob.

Jeli @var{plik1} jest katalogiem a @var{plik2} nie, @code{diff} porwnuje
plik z katalogu @var{plik1}, ktrego nazwa jest taka sama, jak @var{plik2},
i odwrotnie.  Plik nie bdcy katalogiem nie moe by @samp{-}.

Jeli zarwno @var{plik1} jak i @var{plik2} s katalogami, @code{diff}
porwnuje odpowiednie pliki w obu katalogach, w kolejnoci alfabetycznej.
To porwnanie nie jest rekurencyjne, chyba e podano opcj @samp{-r} lub
@samp{--recursive}.  @code{diff} 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''.

Opcje @code{diff} na og zaczynaj si od @samp{-}, wic zwykle nazwy
plikw @var{plik1} oraz @var{plik2} nie mog zaczyna si od @samp{-},
jednak argument @samp{--} traktuje pozostae argumenty jako nazwy plikw,
nawet jeli zaczynaj si one od @samp{-}.

Zwracany kod zakoczenia 0 oznacza, e nie odnaleziono rnic,
1 napotkanie rnic, a 2 kopoty.

@menu
* Opcje diff::	Zestawienie opcji @code{diff}.
@end menu

@node Opcje diff, , , Wywoanie diff
@section Opcje @code{diff}
@cindex @code{diff}, opcje
@cindex opcje @code{diff}

Poniej znajduje si podsumowanie wszystkich opcji akceptowanych przez
GNU @code{diff}.  Wikszo opcji posiada dwie rwnowane formy, jedn
z nich jest pojedyncza litera poprzedzona kresk @samp{-}, a drug pena
nazwa poprzedzona przez @samp{--}.  Wiele pojedynczych liter opcji (pod
warunkiem, e nie wymagaj argumentu) mona poczy w pojedyncze sowo:
@samp{-ac} jest rwnowane @samp{-a -c}.  Opcje w formie penej nazwy mog
by skracane do dowolnego unikalnego przedrostka.
Nawiasy kwadratowe (@samp{[} i @samp{]}) oznaczaj, e opcja pobiera
opcjonalny argument.

@table @samp
@item -@var{linie}
Wypisuje ilo linii kontekstu podan w @var{linie} (warto cakowita).
Ta opcja nie ustala formatu wyjciowego.  Nie ma adnego efektu jeli
wystpuje bez opcji @samp{-c} (@pxref{Format kontekstowy}) lub @samp{-u}
(@pxref{Format zunifikowany}).  Ta opcja jest przestarzaa.  Do prawidowego
dziaania @code{patch} standardowo potrzebuje co najmniej dwch linii
kontekstu.

@item -a
@itemx --text
Traktuje wszystkie pliki jak tekstowe i porwnuje je linia po linii,
nawet jeli nie wygldaj one na pliki tekstowe.  @xref{Binarnie}.

@item -b
@itemx --ignore-space-change
Ignoruje zmiany w iloci odstpw (biaych znakw).  @xref{Odstpy}.

@item -B
@itemx --ignore-blank-lines
Ignoruje zmiany, ktre jedynie wstawiaj lub usuwaj puste linie.
@xref{Puste linie}.

@item --binary
Czyta i zapisuje dane w trybie binarnym.  @xref{Binarnie}.

@item -q
@itemx --brief
Informuje jedynie o tym, czy pliki si rni, bez podawania szczegw
na temat rnic.  @xref{Krtko}.

@item -c
Uywa kontekstowego formatu wyjciowego.  @xref{Format kontekstowy}.

@item -C @var{linie}
@itemx --context@r{[}=@var{linie}@r{]}
Uywa kontekstowego formatu wyjciowego, pokazujc @var{linie} (warto
cakowita) linii kontekstu, lub trzy jeli nie podano liczby @var{linii}.
Do prawidowego dziaania @code{patch} potrzebuje co najmniej dwch linii
kontekstu.

@item --changed-group-format=@var{format}
Uywa formatu wyjciowego @var{format} do wypisania grupy linii
zawierajcych rnice si linie z obu plikw.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if-then-else.
@xref{Formaty grup linii}.

@item -d
@itemx --minimal
Zmienia algorytm na taki, ktry moe czasami znale mniejsz liczb zmian.
Spowalnia to dziaania @code{diff} (czasami bardzo znacznie).
@xref{Wydajno diff}.

@item -D @var{nazwa}
@itemx --ifdef=@var{nazwa}
Tworzy poczone wyjcie w formacie @samp{#ifdef}, zalenym od makra
preprocesora @var{nazwa}.  @xref{If-then-else}.

@item -e
@itemx --ed
Tworzy wyjcie, ktre jest poprawnym skryptem @code{ed}.  @xref{Skrypty ed}.

@item -x @var{wzorzec}
@itemx --exclude=@var{wzorzec}
Podczas porwnywania katalogw ignoruje pliki i podkatalogi, ktrych
nazwy pasuj do wzorca @var{wzorzec}.  @xref{Porwnywanie katalogw}.

@item -X @var{plik}
@itemx --exclude-from=@var{plik}
Podczas porwnywania katalogw ignoruje pliki i podkatalogi, ktrych
nazwa pasuje do jednego z wzorcw podanych w @var{pliku}.
@xref{Porwnywanie katalogw}.

@item -t
@itemx --expand-tabs
Rozszerza tabulatory do spacji na wyjciu, aby zachowa oryginalne
wyrwnanie tabulatorw pliku wejciowego.  @xref{Tabulatory}.

@item -f
@itemx --forward-ed
Tworzy wyjcie, ktre wyglda prawie tak jak skrypt @code{ed}, ale
zawiera modyfikacje w kolejnoci pojawiania si zmian w pliku.
@xref{Forward ed}.

@item -F @var{regexp}
@itemx --show-function-line= regexp
W formacie kontekstowym lub zunifikowanym dla kadej porcji rnic pokazuje
ostatni poprzedzajc lini, ktra pasuje do wyraenia regularnego
@var{regexp}.  @xref{Podane nagwki}.

@item -h
Ta opcja aktualnie nie ma adnego efektu, ale istnieje dla zgodnoci
z systemem Unix.

@item -H
@itemx --speed-large-files
Uywa algorytmw heurystycznych aby przyspieszy przeszukiwanie duych
plikw ze znaczn liczb rozrzuconych maych zmian.
@xref{Wydajno diff}.

@item --horizon-lines=@var{linie}
Nie odrzuca ostatnich @var{linie} linii wsplnego przedrostka oraz
pierwszych @var{linie} linii wsplnego przyrostka.  @xref{Wydajno diff}.

@item -i
@itemx --ignore-case
Ignoruje zmiany zmian w wielkoci liter, due i mae litery s uznawane
za rwnowane.  @xref{Wielko liter}.

@item -I @var{regexp}
@itemx --ignore-matching-lines=@var{regexp}
Ignoruje zmiany, ktre jedynie wstawiaj lub usuwaj linie pasujce do
wyraenia regularnego @var{regexp}.  @xref{Pomijanie podanych}.

@item -w
@itemx --ignore-all-space
Ignoruje wszystkie odstpy (biae znaki) przy porwnywaniu plikw.
@xref{Odstpy}.

@item -T
@itemx --initial-tab
Wyprowadza tabulator zamiast spacji przed tekstem linii w formacie
normalnym lub kontekstowym. Powoduje to normalny wygld tabulatorw w linii.
@xref{Tabulatory}.

@item -l
@itemx --paginate
Przesya wyjcie przez @code{pr}, aby podzieli je na strony.
@xref{Stronicowanie}.

@item -L @var{etykieta}
@itemx --label=@var{etykieta}
Uywa tekstu @var{etykieta} w miejsce nazwy plikw w nagwku formatu
kontekstowego (@pxref{Format kontekstowy}) i zunifikowanego
(@pxref{Format zunifikowany}).  @xref{RCS}.

@item --left-column
Wywietla jedynie lew kolumn z dwch wsplnych w formacie jedna obok
drugiej.  @xref{Format dwukolumnowy}.

@item --line-format=@var{format}
Uywa formatu @var{format} do wyprowadzenia wszystkich linii.
To samo, co rwnoczesne uycie wszystkich opcji formatowania linii
(@samp{--old-line-format}, @samp{--new-line-format},
@samp{--unchanged-line-format}) z tym samym formatem.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu if-then-else.
@xref{Formaty linii}.

@item -n
@itemx --rcs
Wyprowadza rnice w formacie RCS, tak jak @samp{-f}, z tym wyjtkiem,
e kada komenda wyszczeglnia numer linii, ktrej dotyczy.  @xref{RCS}.

@item -N
@itemx --new-file
Jeli podczas porwnywania katalogw plik istnieje jedynie w jednym
z katalogw, bdzie traktowany tak, jakby by obecny w drugim katalogu,
ale pusty.  @xref{Porwnywanie katalogw}.

@item --new-group-format=@var{format}
Uywa formatu @var{format} do wyprowadzenia grupy linii wzitej jedynie
z drugiego pliku.  Pomocne w tworzeniu plikw wynikowych o konstrukcji
typu if-then-else.  @xref{Formaty grup linii}.

@item --new-line-format=@var{format}
Uywa formatu @var{format} do wyprowadzenia linii wzitej jedynie
z drugiego pliku.  Pomocne w tworzeniu plikw wynikowych o konstrukcji
typu if-then-else.  @xref{Formaty linii}.

@item --old-group-format=@var{format}
Uywa formatu @var{format} do wyprowadzenia grupy linii wzitej jedynie
z pierwszego pliku.  Pomocne w tworzeniu plikw wynikowych o konstrukcji
typu if-then-else.  @xref{Formaty grup linii}.

@item --old-line-format=@var{format}
Uywa formatu @var{format} do wyprowadzenia linii wzitej jedynie
z pierwszego pliku.  Pomocne w tworzeniu plikw wynikowych o konstrukcji
typu if-then-else.  @xref{Formaty linii}.

@item -p
@itemx --show-c-function
Pokazuje, do jakiej funkcji C naley kada ze zmian.
@xref{Nagwki funkcji C}.

@item -P
@itemx --unidirectional-new-file
Jeli podczas porwnywania katalogw plik istnieje jedynie w drugim katalogu,
bdzie traktowany tak, jakby by obecny w pierwszym katalogu, ale pusty.
@xref{Porwnywanie katalogw}.

@item -r
.B \-\-recursive
Rekurencyjnie porwnuje wszystkie podkatalogi, jeli porwnywane
s katalogi.  @xref{Porwnywanie katalogw}.

@item -s
@itemx --report-identical-files
Informuje, jeli oba pliki s identyczne.
@xref{Porwnywanie katalogw}.

@item -S @var{plik}
@itemx --starting-file= plik
Podczas porwnywania katalogw rozpoczyna od pliku @var{plik}.
Opcja ta jest uyteczna podczas wznawiania przerwanego porwnania.
@xref{Porwnywanie katalogw}.

@item --sdiff-merge-assist
Wywietla dodatkowe informacji pomocne dla @code{sdiff}.  @code{sdiff}
korzysta z tej opcji gdy uruchamia @code{diff}. Uytkownicy nie powinni
korzysta z tej opcji bezporednio.

@item -y
@itemx --side-by-side
Uywa formatu wyjciowego jeden obok drugiego.  @xref{Format dwukolumnowy}.

@item --suppress-common-lines
Nie wypisuje wsplnych linii w formacie jedna obok drugiej.
@xref{Format dwukolumnowy}.

@item -u
Uywa zunifikowanego formatu wyjciowego.  @xref{Format zunifikowany}.

@item --unchanged-group-format=@var{format}
Uywa formatu @var{format} do wyprowadzenia grupy wsplnych linii, wzitych
z obu plikw.  Pomocne w tworzeniu plikw wynikowych o konstrukcji typu
if-then-else.  @xref{Formaty grup linii}.

@item --unchanged-line-format=@var{format}
Uycie formatu @var{format} do wyprowadzenia linii wsplnej dla obu plikw.
Pomocne w tworzeniu plikw wynikowych o konstrukcji typu
if-then-else.  @xref{Formaty linii}.

@item -U @var{linie}
@itemx --unified@r{[}=@var{linie}@r{]}
Uywa zunifikowanego formatu wyjciowego, wypisujc @var{linie} (warto
cakowita) linii kontekstu , lub trzy jeli nie podano @var{linii}.
Do prawidowego dziaania @code{patch} potrzebuje co najmniej

@item -v
@itemx --version
Wypisuje numer wersji @code{diff}.

@item -w
@itemx --ignore-all-space
Ignoruje wszystkie odstpy (biae znaki) przy porwnywaniu plikw.
@xref{Odstpy}.

@item -W @var{kolumny}
@itemx --width=@var{kolumny}
Uywa szerokoci wyjcia @var{kolumny} w formacie jedna obok drugiej.
@xref{Format dwukolumnowy}.
@end table

@node Wywoanie diff3, Wywoanie patch, Wywoanie diff, Top
@chapter Wywoanie @code{diff3}
@cindex wywoanie @code{diff3}
@cindex @code{diff3}, wywoanie

Polecenie @code{diff3} porwnuje trzy pliki i podaje opisy rnic pomidzy
nimi.  Posiada nastpujce argumenty:

@example
diff3 @var{opcje}@dots{} @var{mj} @var{starszy} @var{twj}
@end example

Porwnywanymi plikami s @var{mj}, @var{starszy} i @var{twj}.
Co najwyej jedn z tych trzech nazw moe by @samp{-},
mwica @code{diff3} by zamiast tego pliku czyta standardowe wejcie.

Zwracany kod zakoczenia 0 oznacza pomylnie ukoczon prac @code{diff3},
1 napotkanie konfliktw, a 2 kopoty.

@menu
* Opcje diff3::		Zestawienie opcji @code{diff3}.
@end menu

@node Opcje diff3, , , Wywoanie diff3
@section Opcje @code{diff3}
@cindex @code{diff3}, opcje
@cindex opcje @code{diff3}

Poniej podano podsumowanie wszystkich opcji akceptowanych przez
GNU @code{diff3}.  Mona czy kilka opcji jednoliterowych (chyba
e pobieraj argument) w pojedynczy argument wiersza polece.

@table @samp
@item -a
@itemx --text
Traktuje wszystkie pliki jak tekstowe i porwnuje je linia po linii,
nawet jeli nie wygldaj na tekstowe.  @xref{Binarnie}.

@item -A
@itemx --show-all
Nanosi wszystkie zmiany powstae midzy @var{starszy} a @var{twj}
do pliku @var{mj}, ujmujc wynike konflikty pomidzy linie zawierajce
cigi nawiasw ostrych (@samp{>}, @samp{<}).  @xref{Oznaczanie konfliktw}.

@item -e
@itemx --ed
Tworzy skrypt programu @code{ed}, ktry nanosi zmiany pomidzy
@var{starszy} a @var{twj} do pliku @var{mj}.  @xref{Jakie zmiany}.

@item -E
@itemx --show-overlap
Jak @samp{-e}, ale dodatkowo obejmuje nakadajce si zmiany parami linii
nawiasw ostrych.  @xref{Oznaczanie konfliktw}.
Z opcj @samp{-E}, nakadajca si zmiana wyglda tak:

@example
<<<<<<< @var{mj}
@r{linie z @var{mj}}
=======
@r{linie z @var{twj}}
>>>>>>> @var{twj}
@end example

@item -3
@itemx --easy-only
Jak @samp{-e}, z wyjtkiem tego, e wypisuje tylko zmiany nienakadajce si.
@xref{Jakie zmiany}.

@item -i
Na kocu skryptu @code{ed} generuje polecenia @samp{w} i @samp{q},
by by zgodny z System V.  Opcja ta musi by uyta z jedn z opcji
@samp{-AeExX3}, a nie moe by czona z @samp{-m}.
@xref{Zachowywanie zmienionego pliku}.

@item -T
@itemx --initial-tab
Zamiast dwu spacji przed tekstem linii normalnego formatu wypisuje
tabulacj.  Powoduje to, e wyrwnanie tabulacji w linii wyglda normalnie.
@xref{Tabulatory}.

@item -L @var{etykieta}
@itemx --label=@var{etykieta}
W liniach nawiasw ostrych wypisywanych przez opcje
@samp{-A}, @samp{-E} i @samp{-X} uywa etykiety @var{etykieta} w miejscu
nazwy pliku.  Opcj t mona poda do trzech razy, po jednym dla kadego
pliku wejciowego.  Domylne etykiety s nazwami plikw wejciowych.
Zatem @samp{diff3 -L X -L Y -L Z -m A B C} dziaa jak @samp{diff3 -m A B C},
z wyjtkiem tego, e wynik wyglda jakby pochodzi z plikw o nazwach
@samp{X}, @samp{Y} i @samp{Z}, a nie z plikw nazywajcych si @samp{A},
@samp{B} i @samp{C}.  @xref{Oznaczanie konfliktw}.

@item -m
@itemx --merge
Za porednictwem skryptu edycyjnego wprowadza zmiany do pierwszego pliku
i wysya wynik na standardowe wyjcie.  W przeciwiestwie do przesyania
potokiem wyjcia z @code{diff3} do @code{ed}, dziaa nawet z plikami
binarnymi i niekompletnymi liniami.  Jeli nie podano adnej z opcji
skryptu edycyjnego, to przyjmowana jest @samp{-A}.  @xref{Pomijanie ed}.

@item -x
@itemx --overlap-only
Jak @samp{-e}, ale wypisuje tylko zmiany nakadajce si.
@xref{Jakie zmiany}.

@item -X
Jak @samp{-E}, ale wypisuje tylko zmiany, ktre si nakadaj.
Inaczej mwic, jak @samp{-x}, tylko obejmuje zmiany w nawiasy ostre,
jak w @samp{-E}.  @xref{Oznaczanie konfliktw}.

@item -v
@itemx --version
Wypisuje numer wersji @code{diff3}.
@end table

@node Wywoanie patch, Wywoanie sdiff, Wywoanie diff3, Top
@chapter Wywoanie @code{patch}
@cindex wywoanie @code{patch}
@cindex @code{patch}, wywoanie

Normalnie @code{patch} jest wywoywany tak:

@example
patch <@var{plikatajcy}
@end example

Peny format wywoania @code{patch} jest nastpujcy:

@example
patch @var{opcje}@dots{} @r{[}@var{plikoryginalny}
@r{[}@var{plikatajcy}@r{]}@r{]} @r{[}+ @var{opcje}@dots{}
@r{[}@var{plikoryginalny}@r{]}@r{]}@dots{}
@end example

Jeli @var{plikatajcy} jest pominity lub jest mylnikiem @samp{-}, to
ata (czyli wyjcie @code{diff}) bdzie czytana ze standardowego wejcia.

Jako argumenty @var{plikoryginalny} mona poda kilka plikw pierwotnych.
Wwczas kady z nich, wraz z opcjami do jego interpretacji, oddzielany jest
od pozostaych znakiem plus @samp{+}.  @xref{Wielokrotne aty}, gdzie
podano szczegy.

Jeeli w wierszu polece nie zostanie podany plik wejciowy, to @code{patch}
usiuje wydedukowa, ktry plik zmienia, z @dfn{poprzedzajcego tekstu}
(tekstu, jaki ewentualnie wystpuje w acie przed wyjciem @code{diff}).
W nagwku rnicy kontekstowej bd zunifikowanej szuka w liniach
zaczynajcych si od @samp{***}, @samp{---} lub @samp{+++}; wybiera z nich
najkrtsz nazw istniejcego pliku.  W pozostaych przypadkach, jeli
w poprzedzajcym rnice tekcie istnieje linia @samp{Index:}, to usiuje
uy nazwy pliku z tej linii.  Jeeli @code{patch} nie potrafi wydedukowa
nazwy istniejcego pliku z poprzedzajcego tekstu, to prosi uytkownika
o podanie nazwy pliku do zaatania.

Jeli plik wejciowy nie istnieje lub jest przeznaczony tylko dla odczytu,
a istniej odpowiednie pliki RCS lub SCCS, to program usiuje pobra (get)
lub zaktualizowa (check out) plik przed przetwarzaniem.

Domylnie, @code{patch} wersja zaatana jest podstawiana na miejsce
oryginau, po uprzednim przemianowaniu go na plik kopii zapasowej
(@pxref{Kopie zapasowe}, gdzie opisano, jak @code{patch} nazywa kopie zapasowe).
Mona te okreli, gdzie powinien by umieszczony wynik atania.
Robi si to opcj @samp{-o @var{plik-wyjciowy}}
lub @samp{--output=@var{plik-wyjciowy}}.

@menu
* Katalogi patch::	Zmiana katalogu i ucinanie nazw katalogw.
* Kopie zapasowe::	Nazwy plikw kopii zapasowych.
* Odrzucenia::		Nazwy plikw odrzuce.
* Opcje patch::		Sumaryczne zestawieni opcji @code{patch}.
@end menu

@node Katalogi patch, Kopie zapasowe, , Wywoanie patch
@section Nakadanie at w innych katalogach
@cindex katalogi i atanie
@cindex atanie katalogw

Opcja @samp{-d @var{katalog}} lub @samp{--directory=@var{katalog}}
polecenia @code{patch} powoduje, e podany @var{katalog} jest traktowany
jak katalog biecy przy interpretacji zarwno nazw plikw w pliku aty,
jak i nazw plikw podanych jako argumenty innych opcji (jak @samp{-B} czy
@samp{-o}).  Na przykad, podczas pracy z czytnikiem grup dyskusyjnych mona
zaata plik w katalogu @file{/usr/src/emacs} wprost z artykuu zawierajcego
at, w ten sposb:

@example
| patch -d /usr/src/emacs
@end example

Czasami nazwy plikw podane w acie zawieraj na pocztku katalogi, ale
przechowujemy swoje pliki w katalogu innym ni ten, ktry podano w acie.
W takiej sytuacji mona posuy si opcj @samp{-p@r{[}@var{liczba}@r{]}}
lub @samp{--strip@r{[}=@var{liczba}@r{]}}, do ustalenia liczby ukonikw
obcinanych z nazw plikw.  Liczba ta podaje programowi, ile ukonikw, razem
z nazwami katalogw midzy nimi, powinien odci z pocztku nazwy pliku.
@samp{-p} bez podania @var{liczby} jest rwnowane @samp{-p0}.  Domylnie,
@code{patch} ucina wszystkie pocztkowe katalogi, pozostawiajc tylko
gwn nazw pliku, z wyjtkiem sytuacji, gdy w acie podano wzgldn nazw
pliku a wszystkie jej pocztkowe katalogi ju istniej.  Wwczas wystpujce
na pocztku nazwy katalogi nie s odcinane.
(@dfn{Wzgldna} nazwa pliku to taka, ktra nie rozpoczyna si od ukonika.)

Po odciciu ewentualnych ukonikw, @code{patch} szuka pliku w biecym
katalogu albo, jeli uyto opcji @samp{-d @var{katalog}}, w katalogu przez
ni wskazanym.

Na przykad, zamy nazw pliku w acie jest @file{/gnu/src/emacs/etc/NEWS}.
Uycie opcji @samp{-p} lub @samp{-p0} daje niezmienion nazw, @samp{-p1}
daje @file{gnu/src/emacs/etc/NEWS} (bez pocztkowego ukonika), @samp{-p4}
daje @file{etc/NEWS}, a niepodanie @samp{-p} w ogle -- @file{NEWS}.

@node Kopie zapasowe, Odrzucenia, Katalogi patch, Wywoanie patch
@section Nazwy plikw kopii zapasowych
@cindex kopie zapasowe, nazwy

Normalnie @code{patch} przemianowuje pierwotny plik wejciowy na kopi
zapasow dopisujc do jego nazwy rozszerzenie @samp{.orig} (lub @samp{~}
w systemach nie obsugujcych dugich nazw plikw).  Opcja @samp{-b
@var{przyrostek-kopii}} lub @samp{--suffix=@var{przyrostek-kopii}} uywa
zamiast nich @var{przyrostka-kopii}, jako rozszerzenia kopii zapasowej.

Przyrostek kopii mona te okreli za pomoc zmiennej rodowiska
@code{SIMPLE_BACKUP_SUFFIX}, ktra jest przesaniana przez te opcje.

@code{patch} moe te tworzy kopie numerowane, tak jak robi to GNU Emacs.
W tej metodzie, zamiast posiadania pojedynczej kopii dla kadego pliku,
@code{patch} tworzy nowy plik kopii bezpieczestwa za kadym razem gdy ata
plik.  Na przykad, kopie pliku o nazwie @file{sink} bd si nazywa,
kolejno, @file{sink.~1~}, @file{sink.~2~}, @file{sink.~3~}, itd.

Opcja @samp{-V @var{metoda}} lub @samp{--version-control=@var{metoda}}
jako argument przyjmuje metod tworzenia nazw plikw zapasowych.
Rodzaje robionych kopii zapasowych mona rwnie poda w zmiennej
rodowiskowej @code{PATCH_VERSION_CONTROL} (lub, jeli nie jest ustawiona,
zmienn @code{VERSION_CONTROL}), ktra jest przesaniana przez t opcj.
Warto @var{metody} jest podobna jak zmiennej @code{version-control}
GNU Emacsa (@pxref{Backups, , Backups, emacs, The GNU Emacs Manual}, gdzie bliej
omwiono wersje kopii w Emacsie).  Oba te programy rozpoznaj te
ich bardziej opisowe synonimy.  Poprawne wartoci to (przyjmowane s
rozrnialne skrty):

@table @samp
@item t
@itemx numbered
Tworzy zawsze numerowane kopie zapasowe.

@item nil
@itemx existing
Tworzy numerowane kopie zapasowe plikw, ktre ju je maj, a zwyke kopie
dla pozostaych. Tak jest domylnie.

@item never
@itemx simple
Zawsze robi zwyke kopie zapasowe.
@end table

Mona take nakaza @code{patch} uycie przedrostka, jak na przykad
nazwy katalogu, do tworzenia nazw plikw zapasowych.  Opcja @samp{-B
@var{przedrostek-kopii}} lub @samp{--prefix=@var{przedrostek-kopii}} tworzy
pliki zapasowe poprzedzajc ich nazwy @var{przedrostkiem-kopii}.
jeli zostanie ona uyta, to @code{patch} ignoruje podan rwnoczenie
opcj @samp{-b}.

Jeeli plik kopii ju istnieje, program tworzy now nazw pliku zapasowego
zmieniajc pierwsz zmieniajc pierwsz ma liter ostatniej skadowej
nazwy pliku na du.  Jeli nie ma ju wicej maych liter, usuwa
pierwszy znak z nazwy.  Proces ten jest powtarzany, a nie znajdzie si
nazwa pliku, ktry jeszcze nie istnieje.

Jeli opcj @samp{-o} zostanie podana nazwa pliku wyjciowego, to tworzona
jest kopia zapasowa tego pliku, a nie pliku wejciowego.

@node Odrzucenia, Opcje patch, Kopie zapasowe, Wywoanie patch
@section Nazwy plikw odrzuce
@cindex odrzucenia, nazwy plikw

Nazwy plikw odrzuce (plikw zawierajcych aty, dla ktrych @code{patch}
nie znalaz miejsca do naoenia) s normalnie nazwami odpowiedniego pliku
wyjciowego z dopisan kocwk @samp{.rej} (lub @samp{#} w systemach, ktre
nie obsuguj dugich nazw plikw).

Mona take nakaza @code{patch}, by umieci wszystkie odrzucone aty
w jednym pliku.  Opcja @samp{-r @var{plik-odrzuce}} lub
@samp{--reject-file=@var{plik-odrzuce}} umieszcza wszystkie odrzucone
rnice w @var{pliku-odrzuce}, a nie w domylnych plikach odrzuce.

@node Opcje patch, , Odrzucenia, Wywoanie patch
@section Opcje @code{patch}
@cindex @code{patch}, opcje
@cindex opcje @code{patch}

Oto zestawienie wszystkich opcji akceptowanych przez @code{patch}.
Starsze wersje @code{patch} nie przyjmuj opcji o penej nazwie
(zaczynajcych si od @samp{--}) ani opcji @samp{-t}, @samp{-E}
lub @samp{-V}.

Kilka opcji jednoliterowych, ktre nie pobieraj argumentu mona czy
w pojedynczy argument wiersza polece (z jednym tylko mylnikiem).
Nawiasy kwadratowe (@samp{[} i @samp{]}) oznaczaj, e opcja pobiera
opcjonalny argument.

@table @samp
@item -b @var{przyrostek-kopii}
@itemx --suffix=@var{przyrostek-kopii}
Uywa @var{przyrostka-kopii} jako rozszerzenia kopii zapasowych zamiast
@samp{.orig} lub @samp{~}.  @xref{Kopie zapasowe}.

@item -B @var{przedrostek-kopii}
@itemx --prefix=@var{przedrostek-kopii}
Uywa @var{przedrostka-kopii} jako przedrostka nazwy pliku zapasowego.
Jeli podano t opcj, to opcja @samp{-b} jest ignorowana.  @xref{Kopie zapasowe}.

@item -t
@itemx --batch
Nie zadaje adnych pyta.  @xref{Komunikaty patch}.

@item -c
@itemx --context
Interpretuje plik aty jako rnic kontekstow.  @xref{Wejcie patch}.

@item -d @var{katalog}
@itemx --directory=@var{katalog}
Powoduje, e podany @var{katalog} jest traktowany jak katalog biecy
przy interpretacji zarwno nazw plikw w pliku aty, jak i nazw plikw
podanych jako argumenty innych opcji.  @xref{Katalogi patch}.

@item -D @var{nazwa}
@itemx --ifdef=@var{nazwa}
@c  Make merged if-then-else output using @var{format} HQ: ??? 
Tworzy scalone wyjcie, ze zmianami oznaczonymi przez @samp{#ifdef...#endif}.
@var{nazwa} bdzie symbolem rnicujcym.  @xref{If-then-else}.

@item --debug=@var{liczba}
@itemx -x @var{liczba}
Ustawia wewntrzne flagi debuggowe. Ma to znaczenie tylko dla ataczy
programu @code{patch}.

@item -e
@itemx --ed
Wymusza interpretacj pliku z at jako skryptu @code{ed}.
@xref{Wejcie patch}.

@item -E
@itemx --remove-empty-files
Powoduje, e usuwane s pliki wyjciowe, ktre po zaaplikowaniu at s puste.
@xref{Puste pliki}.

@item -f
@itemx --force
Wymusza zaoenie, e uytkownik dokadnie wie co robi i powoduje
niezadawanie pyta.  @xref{Komunikaty patch}.

@item -F @var{linie}
@itemx --fuzz=@var{linie}
Ustawia wspczynnik maksymalnego rozmycia na @var{linie} linii.
@xref{Niedokadne}.

@item -N
@itemx --forward
Powoduje ignorowanie at, ktre wydaj si by odwrcone lub ju
zaaplikowane.  Zobacz te @samp{-R}.  @xref{Odwrcone aty}.

@item -l
@itemx --ignore-white-space
Powoduje, e dowolny cig biaych znakw w pliku aty pasuje do dowolnego
cigu biaych znakw w pliku wejciowym.  @xref{Zmienione odstpy}.

@item -n
@itemx --normal
Powoduje, e plik z at jest interpretowany jak rnica typu `normal'.
@xref{Wejcie patch}.

@item -o @var{pliku-wyjciowego}
@itemx --output=@var{pliku-wyjciowego}
Uywa @var{pliku-wyjciowego} jako nazwy pliku wyjciowego.
@xref{Opcje patch}.

@item -p@r{[}@var{liczba}@r{]}
@itemx --strip@r{[}=@var{liczba}@r{]}
Wyznacza @var{liczb} pocztkowych ukonikw odcinanych z nazwy pliku.
@xref{Katalogi patch}.

@item -s
@itemx --quiet
@itemx --silent
Powoduje, e @code{patch} dziaa cicho, chyba e pojawi si bd.
@xref{Komunikaty patch}.

@item -r @var{plik-odrzuce}
@itemx --reject-file=@var{plik-odrzuce}
Uywa @var{pliku-odrzuce} jako nazwy dla pliku odrzuconych poprawek.
@xref{Odrzucenia}.

@item -R
@itemx --reverse
Zakada, e dana ata zostaa utworzona przy zamienionych miejscami
plikach: starym i nowym.  @xref{Odwrcone aty}.

@item -S
@itemx --skip
Powoduje ignorowanie tej aty z pliku z at, lecz kontynuowanie
szukania nastpnej.  @xref{Wielokrotne aty}.

@item -u
@itemx --unified
Wymusza interpretacj aty jako zunifikowanej rnicy kontekstowej.
@xref{Wejcie patch}.

@item -V @var{metoda}
@itemx --version=control=@var{metoda}
Okrela rodzaj tworzonych kopii zapasowych.  @xref{Kopie zapasowe}.

@item --help
Wypisuje list rozpoznawanych przez @code{patch} opcji, po czym
koczy dziaanie.

@item -v
@itemx --version
Wypisuje numer wersji programu @code{patch}.
@end table

@node Wywoanie sdiff, Niekompletne linie, Wywoanie patch, Top
@chapter Wywoanie @code{sdiff}
@cindex wywoanie @code{sdiff}
@cindex @code{sdiff}, wywoanie

Polecenie @code{sdiff} scala dwa pliki i interaktywnie wypisuje wynik.
Ma nastpujce argumenty:

@example
sdiff -o @var{plik-wyjciowy} @var{opcje}@dots{} @var{plik1} @var{plik2}
@end example

Scala to @var{plik1} z @var{plik2}, umieszczajc wynik
w @var{pliku-wyjciowym}. Jeli @var{plik1} jest katalogiem a @var{plik2}
nie, to @code{sdiff} bdzie porwnywa znajdujcy si w katalogu @var{plik1}
plik o tej samej nazwie, co @var{plik2}, i odwrotnie.  Oba argumenty
@var{plik1} i @var{plik2} nie mog by rwnoczenie katalogami.

Opcje @code{sdiff} zaczynaj si od @samp{-}, wic normalnie nazwy
@var{plik1} ani @var{plik2} nie mog si zaczyna od kreski.
Jednak uycie argumentu @samp{--} powoduje, e wystpujce po nim
argumenty wiersza polece s traktowane jak nazwy plikw, nawet jeli
zaczynaj si kresk. Nie mona uy @samp{-} jako pliku wejciowego.

Zwracany kod zakoczenia 0 oznacza, e nie odnaleziono rnic,
1 napotkanie rnic, a 2 kopoty.

@code{sdiff} bez @samp{-o} (lub @samp{--output}) tworzy rnic wywietlan
w rwnolegych kolumnach.  Skadnia ta jest przestarzaa; zamiast niej naley
stosowa @samp{diff --side-by-side}.

@menu
* Opcje sdiff::		Zestawienie opcji @code{diff}.
@end menu

@node Opcje sdiff, , , Wywoanie sdiff
@section Opcje @code{sdiff}
@cindex @code{sdiff}, opcje
@cindex opcje @code{sdiff}

Poniej znajduje si podsumowanie wszystkich opcji akceptowanych przez
GNU @code{sdiff}.  Wikszo opcji posiada dwie rwnowane formy, jedn
z nich jest pojedyncza litera poprzedzona kresk @samp{-}, a drug pena
nazwa poprzedzona przez @samp{--}.  Wiele pojedynczych liter opcji (pod
warunkiem, e nie wymagaj argumentu) mona poczy w pojedyncze sowo.
Opcje w formie penej nazwy mog by skracane do dowolnego unikalnego
przedrostka.

@table @samp
@item -a
@itemx --text
Traktuje wszystkie pliki jako pliki tekstowe i porwnuje je linia po linii,
nawet jeli nie wygldaj one na pliki tekstowe.  @xref{Binarnie}.

@item -b
@itemx --ignore-space-change
Ignoruje zmiany w iloci odstpw (biaych znakw).  @xref{Odstpy}.

@item -B
@itemx --ignore-blank-lines
Ignorowanie zmian, ktre jedynie dodaj lub usuwaj puste linie.
@xref{Puste linie}.

@item -d
@itemx --minimal
Zmiana algorytmu na taki, ktry moe czasami znale mniejsz liczb zmian.
Spowalnia to dziaania @code{sdiff} (czasami bardzo znacznie).
@xref{Wydajno diff}.

@item -H
@itemx --speed-large-files
Uywa algorytmw heurystycznych aby przyspieszy przeszukiwanie duych
plikw ze znaczn liczb rozrzuconych maych zmian.
@xref{Wydajno diff}.

@item -t
@itemx --expand-tabs
Rozszerza tabulatory do spacji na wyjciu, aby zachowa oryginalne
uoenie tabulatorw pliku wejciowego.  @xref{Tabulatory}.

@item -i
@itemx --ignore-case
Ignoruje zmiany w wielkoci liter, due i mae litery s uznawane za
rwnowane.
@xref{Wielko liter}.

@item -I @var{regexp}
@itemx --ignore-matching-lines=@var{regexp}
Ignoruje zmiany, ktre jedynie dodaj lub usuwaj linie pasujce do
wyraenia regularnego @var{regexp}.  @xref{Pomijanie podanych}.

@item -W
@itemx --ignore-all-space
Ignoruje wszystkie odstpy przy porwnywaniu plikw.
Warto pamita, e, z przyczyn historycznych, opcja ta nazywa si
@samp{-w} w programie @code{diff}, za @samp{-W} w @code{sdiff}.
@xref{Odstpy}.

@item -l
@itemx --left-column
Wypisuje jedynie lew kolumn z dwch wsplnych w formacie jedna obok
drugiej.  @xref{Format dwukolumnowy}.

@item -o @var{plik}
@itemx --output=@var{plik}
Wstawia scalone wyjcie do @var{pliku}.  Wymagana do scalania.

@item -s
@itemx --suppress-common-lines
Powoduje, e wsplne linie nie bd wypisywane.
@xref{Format dwukolumnowy}.


@item -w @var{kolumny}
@itemx --width=@var{kolumny}
Uycie szerokoci wyjcia @var{kolumny} w formacie jedna obok drugiej.
Warto pamita, e, z przyczyn historycznych, opcja ta nazywa si
@samp{-W} w programie @code{diff}, za @samp{-w} w @code{sdiff}.

@item -v
@itemx --version
Wypisuje numer wersji programu @code{sdiff}.
@end table

@node Niekompletne linie, Plany, Wywoanie sdiff, Top
@chapter Niekompletne linie
@cindex niekompletne linie
@cindex pene linie
@cindex nowe linie, sposb traktowania przez @code{diff}

Jeli plik wejciowy koczy si znakiem innym ni znak nowej linii, ostatni
jego lini nazywamy @dfn{niekompletn lini}, gdy nie jest zakoczona
znakiem nowej linii.  Wszystkie pozostae nazywamy @dfn{penymi liniami}
i kocz si one znakiem nowej linii.  Niekompletne linie nie pasuj do
penych, chyba e rnice, co do biaych znakw s ignorowane.
(@pxref{Odstpy}).

Normalnie niekompletna linia odrniana jest w produkowanym wyjciu
od penej przez nastpn lini, zaczynajc si wwczas od @samp{\}.
Jednak format RCS (@pxref{RCS}) wypisuje niekompletn lini w postaci
niezmienionej, bez koczenia jej znakiem nowej linii czy zmiany w kolejnej.
Format dwukolumnowy normalnie przedstawia niekompletne linie tak, jak
wystpuj, ale w niektrych przypadkach stosuje znacznik midzykolumnowy
@samp{\} lub @samp{/}.  Format linii if-then-else zachowuje niekompletno
linii przy @samp{%L}, a usuwa znak nowej linii przy @samp{%l};
@xref{Formaty linii}.  Na koniec, w formatach wyjciowych @code{ed}
i @code{ed} uporzdkowanym w przd (forward @code{ed}) @code{diff}
nie potrafi przedstawi niekompletnej linii, wic udaje, e by znak
nowej linii i zgasza bd.

Na przykad, zamy, e @file{F} i @file{G} s jednobajtowymi plikami, ktre
zawieraj tylko, odpowiednio, @samp{f} i @samp{g}.  Wwczas @samp{diff F G}
wypisze

@example
1c1
< f
\ No newline at end of file
---
> g
\ No newline at end of file
@end example

@noindent
(faktyczny komunikat moe by inny, w zalenoci jzyka ustawionego
za porednictwem mechanizmu locale.)
@samp{diff -n F G} wypisze ponisze bez kocowego znaku nowej linii:

@example
d1 1
a1 1
g
@end example

@samp{diff -e F G} zgosi dwa bdy i wypisze:

@example
1c
g
.
@end example

@node Plany, Indeks poj, Niekompletne linie, Top
@chapter Przysze plany

A oto kilka pomysw na ulepszenie GNU @code{diff} i @code{patch}.
W projekcie GNU wskaza kilka ulepsze jako potencjalne projekty
programistyczne dla ochotnikw.  Moesz te dopomc zgaszajc znalezione
w programach bdy.

Jeli jeste programist i zechciaby wnie co do projektu GNU,
zastanw si, prosz, nad zgoszeniem si do jednego z tych projektw.
Jeli powanie rozwaasz prac, napisz prosz
do @samp{gnu@@prep.ai.mit.edu}, by skoordynowa dziaania z innymi
ochotnikami.

@menu
* Niedocignicia::	Sugerowane projekty usprawnie.
* Bdy::		Zgaszanie bdw.
@end menu

@node Niedocignicia, Bdy, , Plany
@section Sugerowane projekty usprawnienia GNU @code{diff} i @code{patch}
@cindex projekty zwizane z katalogami

Powinno si mc uy GNU @code{diff} do wygenerowania aty z pary dowolnych
drzew katalogowych, a majc tak at i jedno z takich drzew - zastosowa
@code{patch} do utworzenia wiernej kopii drugiego.  Niestety, niektrych
zmian w drzewie katalogw nie da si przedstawi za pomoc obecnych formatw
at. Ponadto, @code{patch} nie rozpoznaje niektrych z istniejcych formatw.
Z powodu tych wad zasugerowano ponisze projekty.

@menu
* Zmiana struktury::	Obsuga zmian struktury katalogu.
* Pliki specjalne::	Obsuga dowiza symbolicznych, plikw urzdze itd.
* Niezwyke nazwy::	Obsuga nazw plikw zawierajcych niezwyke znaki.
* Narzucone ograniczenia::	atanie plikw nie-tekstowych.
* Due pliki::		Obsuga plikw nie mieszczcych si w pamici.
* Ignorowanie zmian::	Ignorowanie pewnych zmian, pokazywanie pozostaych.
@end menu

@node Zmiana struktury, Pliki specjalne, , Niedocignicia
@subsection Obsuga zmian struktury katalogu
@cindex katalogi, zmiany struktury

@code{diff} i @code{patch} nie obsuguj niektrych zmian struktury katalogu.
Na przykad, zamy, e jedno drzewo katalogowe zawiera katalog o nazwie
@samp{D}, w ktrym znajduj si jakie pliki, a inne drzewo zawiera plik
o tej samej nazwie @samp{D}.  @samp{diff -r} nie wypisuje wystarczajcej
informacji, by @code{patch} mg wykona przeksztacenie poddrzewa
katalogowego w plik.

Powinna istnie metoda wskazania, e plik zosta usunity bez koniecznoci
przytaczania caej jego zawartoci w pliku aty.  Powinno by te moliwe
wskazanie programowi @code{patch}, e jaki plik zmieni nazw, nawet jeli
nie ma sposobu, w jaki @code{diff} mgby wygenerowa tak informacj.

Problemy te mona rozwiza poszerzajc format wyjciowy @code{diff}
tak, by odzwierciedla zmiany w strukturze katalogu i rozbudowujc
@code{patch} tak, by rozumia owe rozszerzenia.

@node Pliki specjalne, Niezwyke nazwy, Zmiana struktury, Niedocignicia
@subsection Pliki nie bdce ani katalogami ani zwykymi plikami
@cindex pliki specjalne

Niektre pliki nie s ani katalogami ani zwykymi plikami - s to
niecodzienne pliki, jak dowizania symboliczne, pliki specjalne urzdze,
potoki nazwane i gniazda.  Obecnie @code{diff} traktuje dowizania
symboliczne jak zwyke pliki, a inne pliki specjalne tak jak zwyke pliki
jeli wskazano je na najwyszym poziomie, ale tylko zgasza ich istnienie
@c                          @code{patch}, czy @code{diff} ?!!
przy porwnywaniu katalogw.  Znaczy to, e @code{patch} nie potrafi
przedstawi zmian takich plikw.  Na przykad, jeli zmienimy wskazanie
pliku symbolicznego, to @code{diff} wypisze rnic pomidzy dwoma
wskazywanymi przeze plikami, a nie zmian dowizania.

@c This might not be a good idea; is it wise for root to install devices
@c this way?
@code{diff} powinien opcjonalnie w specjalny sposb zgasza zmiany 
plikw specjalnych, za @code{patch} naleaoby poszerzy, by rozumia
takie rozszerzenie.

@node Niezwyke nazwy, Narzucone ograniczenia, Pliki specjalne, Niedocignicia
@subsection Nazwy plikw zawierajce niezwyke znaki
@cindex nazwy plikw z niezwykymi znakami

Jeli nazwa pliku zawiera jaki niezwyky znak, jak na przykad znak nowej
linii czy odstpu, @samp{diff -r} tworzy at, ktrej @code{patch} nie
potrafi przeanalizowa.  Problem ley po stronie formatu wyjcia @code{diff},
a samego @code{patch}, gdy odpowiednio udziwnione nazwy plikw mog
spowodowa, e @code{diff} utworzy at poprawn skadniowo, ale atajc
niewaciwe pliki.  Do poprawnego obsugiwania wszelkich moliwych nazw
plikw trzeba by odpowiednio poszerzy format wyjcia tworzonego przez
@code{diff}.

@node Narzucone ograniczenia, Due pliki, Niezwyke nazwy, Niedocignicia
@subsection Narzucone ograniczenia
@cindex binarne pliki, atanie
@cindex atanie plikw binarnych

GNU @code{diff} potrafi analizowa dowolnie dugie linie i pliki koczce
si niekompletnymi liniami.  Jednak @code{patch} nie umie ata takich
plikw.  Wewntrzne ograniczenie dugoci linii dla @code{patch} powinno
zosta usunite a program poszerzony tak, by poprawnie analizowa zgaszanie
przez @code{diff} niekompletnych linii.

@node Due pliki, Ignorowanie zmian, Narzucone ograniczenia, Niedocignicia
@subsection Obsuga plikw nie mieszczcych si w pamici
@cindex pliki, bardzo due
@cindex bardzo due pliki

@code{diff} dzia wczytujc oba pliki do pamici. Metoda ta zawodzi jeli
pliki s zbyt due, a @code{diff} powinien mie zabezpieczenie.

Jednym ze sposobw takiego zabezpieczenia jest sekwencyjne przegldnicie
plikw w celu wyliczenia skrtw (kodw mieszajcych) linii i przypisanie
linii do klasy rwnowanoci w oparciu tylko o skrt.  Potem porwnanie
tych plikw w zwyky sposb.  Da to troch faszywych dopasowa.

Nastpnie ponowne przegldnicie sekwencyjnie obu plikw, ze sprawdzeniem
czy kade z dopasowa wystpuje w rzeczywistoci.  Jeli linie faktycznie
nie pasuj do siebie, to zaznaczenie obu ``pasujcych'' jako zmienionych.
Nastpnie utworzenie skryptu edycyjnego, tak jak zwykle.

Procedury wyjcia musiayby by zmienione, by sekwencyjnie przeglday
pliki szukajc tekstu do wypisania.

@node Ignorowanie zmian,, Due pliki, Niedocignicia
@subsection Ignorowanie pewnych zmian

Byoby mio mie moliwo podania dwu acuchw, jednego z @var{pliku1}
i jednego z @var{pliku2}, ktre byyby uwaane za pasujce do siebie.
Wwczas, jeli tymi dwoma acuchami byyby @samp{foo} i @samp{bar},
to jeeli dwie linie rniyby si tylko tym, e w miejscu @samp{foo}
w pierwszym pliku wystpowaoby @samp{bar} w drugim, to linie byyby
traktowane jak identyczne.

Nie wiadomo dokadnie, jak oglna mogaby by, czy powinna by,
ta cecha, ani jaka powinna by dla niej skadnia.

@node Bdy, , Niedocignicia, Plany
@section Zgaszanie bdw
@cindex zgaszanie bdw
@cindex bdy, zgaszanie

Jeli uwaasz, e znalaze bd w GNU @code{cmp}, @code{diff},
@code{diff3}, @code{sdiff} lub @code{patch}, prosz zgo go piszc
na adres @samp{bug-gnu-utils@@prep.ai.mit.edu}.  Wylij moliwie
najdokadniejszy opis problemu, cznie z przykadowymi plikami wejciowymi,
ktre spowodoway bd, jeli s istotne.

Poniewa Larry Wall od poowy 1998 nie wypuci nowej wersji @code{patch},
a od tego czasu zostaa zmieniona wersja GNU tego programu, prosz wysya
zgoszenia bdw dotyczce @code{patch} zarwno do
@samp{bug-gnu-utils@@prep.ai.mit.edu}, jak i do @samp{lwall@@netlabs.com}.

@node Indeks poj, , Plany, Top
@unnumbered Skorowidz poj

@printindex cp

@shortcontents
@contents
@bye