Ubuntu Manpage: patch - bir yama dosyasını orjinaline uygular

İSİM

       patch - bir yama dosyasını orjinaline uygular

KULLANIM

       patch [seçenekler] [orjinal [yama]]
       genellikle şöyle kullanılır:

       patch -psayı <yama

AÇIKLAMA

patch, diff(1) ile üretilmiş bir fark listesi içeren bir yama dosyası alır ve bu yama
dosyasındaki farkları bir veya daha fazla orjinal dosyaya uygulayarak orjinallerin yamalı
sürümlerini üretir. Normalde yamalı sürümler orjinal dosyalara yazılarak oluşturulur.
Yedekler oluşturulabilir; -b ve --backup seçeneklerine bakınız. Yamanacak dosyaların
isimleri normalde yama dosyasından alınır, ancak eğer sadece bir yamanacak dosya varsa
ismi komut satırında orjinal olarak belirtilebilir.

patch çalıştırıldığında fark listesinin türü -c (--context), -e (--ed), -n (--normal) veya
-u (--unified) seçenekleri ile belirtilmemişse önce fark listesinin türünü saptamaya
çalışır. ed fark dosyaları bir boruhattı ile ed(1) metin düzenleyicisi üzerinden
uygulanırken, bağlamsal fark dosyaları (eski, yeni ve birleşik) ve normal fark dosyaları
doğrudan patch tarafından uygulanır.

patch yama dosyasındaki olası bozuk alanları atlayarak yamayı uygulamaya çalışır. Bu
özelliğinden yararlanarak yama dosyası içine bir açıklama yerleştirebilirsiniz ve buna
rağmen yama uygulanır. Eğer diff dosyasının içeriği sürekli aynı biçimde girintilenmişse
veya bir bağlamsal fark dpsyasında satırlar CRLF ile bitiyorsa ya da Internet RFC 934'de
"-" için belirtildiği gibi "-" ile başlayan satırlar varsa bunlar hesaba katılır.

Bağlamsal fark dosyaları ile ve bir daha az genişletme yapan normal fark dosyaları ile
patch, yama içindeki satır numaraları yanlış olduğunda bunu saptayabilir ve yama
listesinin her elemanının uygulanacağı doğru yeri bulmaya çalışır. Önce listedeki her
eleman ile ilgili satır numaralarını alır ve yamanın uygulanmasında kullanılan artı ve
eksi ile belirlenmiş satırlara bakar. Eğer satır numaraları doğru yeri belirtmiyorsa, eksi
ile belirtilmiş satırları bulmak üzere metni ileri ve geri her iki yönde tarar. patch ilk
taramada değiştirilecek satırların tamamı için bir eşleşme arar. Böyle bir eşleşme
bulamazsa, yama dosyası bir bağlamsal yama dosyası ise ve belirsizlik faktörü de 1 ise
değiştirilecek satırların ilkini ve sonuncusunu yok sayarak bir arama daha yapar.
Bulamazsa ve belirsizlik faktörü 2 veya 2 den büyükse bu kez ilk ve son iki satırı yok
sayarak bir arama daha yapar. (Öntanımlı belirsizlik faktörü 2'dir.) patch yamanın
uygulanacağı yeri bulamazsa, uygulayamadığı bölümü bir red dosyasına yazar. Bu dosyanın
ismi normalde yama dosyasının ismine .rej eklenerek elde edilir. Eğer .rej eki çok uzun
bir dosya ismi oluşturacaksa dosya isminin sonuna # eklenir, bu karakter de fazla
geliyorsa dosya isminin son karakteri # ile değiştirilir. (Rededdilen kısım yamanın
biçiminden bağımsız olarak sıradan bağlamsal fark biçiminde çıktılanır. Eğer girdi bir
normal fark dosyası ise bağlamın çoğu basitçe boş olur.) Red dosyasındaki reddedilen
kısımlarla ilgili satır numaraları yama dosyasındaki satır numaralarından farklı olabilir:
yeni satır numaraları yamanın eski dosyada değil de yeni (yamanmış) dosyada bulunabileceği
yaklaşık yeri belirtecek şekilde oluşturulur.

Her yama parçası tamamlandığında, eğer parçanın uygulanması başarısız olmuşsa (yeni
dosyadaki) hangi satırdan itibaren devam edeceğini size bildirilir. Eğer yama parçası fark
dosyasında belirtilen satırdan farklı numaralı bir satıra uygulanmışsa size yeni konumu
bildirir. Yeni konumun çok farklı olması parçanın yanlış yeri yamamakta kullanıldığını
belirtebilir. Bir eşleşme bulunurken belirsizlik faktörü kullanmak gerekmişse, biraz kuşku
duyasınız diye bu da ayrıca bildirilir. --verbose seçeneğini belirtmişseniz başarıyla
uygulanan yama parçaları hakkında da bilgi verilir.

Komut satırında orjinal dosya belirtilmemişse patch, yama dosyasındaki yama olarak
uygulanabilecek alanların dışındaki alanları değerlendirerek aşağıdaki kurallara bağlı
olarak yamanın uygulanacağı dosyanın ismini tespit etmeye çalışır.

Önce, aday dosya isimlerinin listesini elde etmeye çalışır. Bunu şöyle yapar:

· Başlık bir bağlamsal fark dosyası başlığı ise, patch eski ve yeni dosya isimlerini
başlıktan alır. Eğer isimdeki bölü çizgilerinin sayısı -psayı veya --strip=sayı
seçenekleri ile belirtilen kadar değilse bu isim yoksayılır. /dev/null ismi de ayrıca
yoksayılır.

· Yama olarak uygulanacak alanların dışında Index: ile başlayan satırlar varsa ve hem
yeni hem de eski dosya isimleri belirtilmemişse veya patch POSIX uyumlu ise, patch
dosya isimlerini Index: ile başlayan satırlardan alır.

· Bundan sonraki kurallara uygun olmak üzere, aday dosya isimlerinin, başlıkta
göründükleri sıraya bakılmaksızın, (eski, yeni, Index) düzeninde olacakları varsayılır.

patch bir dosya ismini aday dosya listesinden şu kurallara göre seçer:

· Bazı isimli dosyalar mevcutsa, patch POSIX uyumluysa ilk dosya ismi değilse eniyi isim
seçilir.

· Eğer patch RCS, ClearCase ve SCCS'yi yoksaymıyorsa (-g sayı veya --get=sayı
seçeneklerine bakınız) ve isimli bir dosya mevcut değilse ama bir RCS, ClearCase veya
SCCS ana dosyası varsa patch ilk isimli dosyayı RCS, ClearCase veya SCCS ana dosyası
ile seçer.

· İsimli dosya mevcut değilse, bir RCS, ClearCase veya SCCS ana dosyası da yoksa ama bazı
dosya isimleri verilmişse, patch POSIX uyumlu değilse ve yamanın bir dosya oluşturması
gerekiyorsa, patch en az dizin oluşturulacak şekilde en iyi dosya ismini seçer.

· Şimdiye dek bahsedilen kurallarla hal bir dosya ismi seçilememişse, yamanacak dosyanın
ismi size sorulur ve patch dosya ismini buna göre seçer.

İsimli dosyalar listesinden "eniyi" dosya ismi şöyle seçilir: önce en az sayıda dizini
dosya yolu olarak alır, bundan sonra, uzantısız en kısa dosya isimleri, bundlardan sonra
en kısa isimlerin tümü ve son olarak da kalan ilk isim alınır.

Ek olarak, Yama olarak uygulanacak alanların dışında Prereq: ile başlayan bir satır varsa,
patch bu öngereklilikler satırındaki ilk sözcüğü (normalde bir sürüm numaraasıdır) alır ve
orjinal dosyaya bu sözcük var mı diye bakar. Yoksa patch işine devam etmeden önce bir
doğrulama isteği yapar.

Tüm bunların nihayetinde, şöyle bir bildirim de yapabilirsiniz:

| patch -d /usr/src/local/blurfl

ve, blurfl dizinindeki bir dosya yama dosyasıyla yamanır.

Eğer yama dosyası bir yamadan fazlasını içeriyorsa patch onların herbirini farklı birer
yama dosyasından geliyormuşçasına uygular. Yama olarak uygulanabilecek her satır grubundan
önce gelen satırlarda bulunan dosya isimleri ve sürüm numaralarından yukarıda bahsedildiği
gibi yamanacak dosyanın ismi saptanarak bu işlem gerçekleştirilir.

SEÇENEKLER

-b, --backup
Dosyaların yedeğini oluşturur. Bir dosya yamanırken orjinal dosya silinmez, ya başka
bir yere kopyalanır ya da ismi değiştirilir. Mevcut olmayan bir dosyanın yedeği
yapılırken, olmayan dosyayı belirtmek için sadece ismi olan cismi olmayan (boş) bir
dosya oluşturulur. Yedek dosya isimlerinin nasıl oluşturulduğu -V veya
--version-control seçeneklerinin açıklamalarında bulunabilir.

--backup-if-mismatch
Yama bir dosya ile tam uyuşmazsa ve yedekleme istenmese de dosya yedeklenir. patch
POSIX uyumlu değilse bu seçenek öntanımlı olarak uygulanır.

--no-backup-if-mismatch
Yama bir dosya ile tam uyuşmazsa ve yedekleme istense de dosya yedeklenmez. patch POSIX
uyumlu değilse bu seçenek öntanımlı olarak uygulanır.

-B önek, --prefix=önek
Basit yedek dosya ismi oluşturulurken dosya isminin önüne önek getirilir. Örneğin, -B
/junk/ ile dosya ismi src/patch/util.c olan bir dosyanın basit yedeği yapılırken dosya
ismi /junk/src/patch/util.c yapılır.

--binary
Standart çıktı veya /dev/tty dışında tüm dosyalar için okuma ve yazma işlemleri iklik
kipte yapılır. Bu seçenek POSIX uyumlu sistemlerde etkisizdir. DOS benzeri sistemlerde
ise bu seçeneğin bir fark oluşturması için yama diff -a --binary ile üretilmiş
olmalıdır.

-c, --context
Yama dosyası sıradan bir bağlamsal fark dosyası olarak yorumlanır.

-d dizin, --directory=dizin
Hiçbir şey yapmadan, hemen dizin dizinine geçilir.

-D tanım, --ifdef=tanım
Değişiklikleri işaretlemede #ifdef ... #endif yapısı tanım farklılaştırma sembolü ile
kullanılır.

--dry-run
Hiçbir dosyada değişiklik yapmaksızın uygulanan yamaların sonuçları basılır.

-e, --ed
Yama dosyası bir ed betiği olarak yorumlanır.

-E, --remove-empty-files
Yama uygulandıktan sonra boşalan dosyalar silinir. Aslında, bu seçenek gereksizdir,
çünkü patch yamadıktan sonra dosyanın varolup olmayacağını saptamak için başlıktaki
tarih damgasını inceler. Buna rağmen, girdi bir bağlamsal fark dosyası değilse ya da
patch POSIX uyumlu ise, patch bu seçenek verilmedikçe yamandıktan sonra boşalan
dosyaları silmez. patch böyle bir dosyayı sildikten sonra boşalmışsa dosyanın bulunduğu
dizini de silmeye çalışır.

-f, --force
Kullanıcının ne yaptığını tam olarak bildiği varsayılır ve kullanıcıya herhangi bir
soru yöneltilmez. Hangi dosyaların yamanacağını belirtmeyen başlıklar içeren yamalar
atlanır; Prereq: ile başlayan satırlarda yanlış sürüm bilgisi olsa bile dosya yamanır;
eski ve yeni dosyaların yer değiştirilmesi gerekse bile yamaların bu işlem yapılmadan
uygulanacağı varsayılır. Bu seçenek açıklamaları engellemez, bunun için -s seçeneğine
bakınız.

-F sayı, --fuzz=sayı
En büyük belirsizlik faktörünü belirtmekte kullanılır. Bu seçenek sadece bağlamsal fark
dosyalarına uygulanır ve patch yamanacak yeri bulurken yama olarak kullanılacak
satırların baştan ve sondan bu kadarını yoksayar. Çok büyük belirsizlik faktörlerinin
yamanın başarısızlığını arttıracağını unutmayın. Öntanımlı belirsizlik faktörü 2'dir ve
bağlamsal fark dosyalarında bağlamsal satır sayısından daha yüksek bir değer (genelde
3'tür) atanmamalıdır.

-g sayı, --get=sayı
Bir dosya RCS veya SCCS denetimindeyken, böyle bir dosya yoksa veya salt-okunursa ya da
öntanımlı sürümüyle eşleşiyorsa; veya ClearCase denetimindeyken, böyle bir dosya yoksa,
bu seçenek, patch'in eylemlerini denetlemekte kullanılır. sayı pozitifse, patch dosyayı
sürüm denetim sisteminden alır; sıfırsa, RCS, SCCS veya ClearCase yoksayılır ve dosya
alınmaz; negatifse dosyanın alınıp alınmayacağı kullanıcıya sorulur. Bu seçeneğin
öntanımlı değeri eğer atanmışsa, PATCH_GET ortam değişkeninden alınır; atanmamışsa ve
patch POSIX uyumluysa öntanımlı değer sıfır, aksi takdirde negatiftir.

--help
Seçeneklerin bir özetini basar ve çıkar.

-i yamadosyası, --input=yamadosyası
Yama yamadosyası dosyasından okunur. yamadosyası olarak - verilmişse öntanımlı olarak
standart girdi okunur.

-l, --ignore-whitespace
Yamanacak dosyaların içindeki sekmeler ve boşluklar için yama içindeki boşluklarla
birebir eşleşme aranmaz, ancak herhangi bir uzunlukta boşluğun her iki dosyada da
karşılıklı varlığı şarttır, satır sonlarındaki boşluklar eşleşme açısından yoksayılır.
Normal karakterler tam olarak eşleştirilir. Bağlamsal her satır yamanacak dosyadaki
satırlarla daima eşleştirilir.

-n, --normal
Yama dosyası normal bir yama dosyası olarak yorumlanır.

-N, --forward
Eski ve yeni dosyaların yer değiştirileceği görünen veya zaten uygulanmış yamalar
yoksayılır. -R seçeneğine de bakınız.

-o çıktıdosyası, --output=çıktıdosyası
Dosyaların yerinde yamanması yerine çıktı, çıktıdosyası dosyasına gönderilir.

-p sayı, --strip=sayı
Yama dosyasında bulunan her dosya isminin başından sayı ile belirtilen sayıda bölü
çizgisi içeren dizge yoksayılır. Birden fazla yanyana bölü çizgisi varsa bunlar tek bir
bölü çizgisi sayılır. Yama dosyasının yamanacak dosyalardan farklı bir dizinde
tutulması durumunda yamanacak dosyaların nasıl bulunacağını belirtmek amacıyla
kullanılır. Örneğin, yama dosyasında yamanacak dosya isminin şöyle verildiğini
varsayalım:

/u/howard/src/blurfl/blurfl.c
Seçenek -p0 olarak verilirse bu dizge olduğu gibi ele alınır, -p1 verilirse,

u/howard/src/blurfl/blurfl.c
baştaki bölü çizgisi atılır, -p4 verilirse,

blurfl/blurfl.c
olur. -p hiç belirtilmezse sonuç blurfl.c olacaktır. Bu durumda dosya yamanın bulunduğu
dizinde aranacağından dosya daha farklı bir yerdeyse bu da -d seçeneği ile
belirtilebilir.

--posix
POSIX standardına kesinlikle uyulur:

· Fark dosyası başlıklarından dosya isimleri öğrenilirken, listedeki (eski, yeni,
birleşik) ilk mevcut dosya alınır.

· Yamandıktan sonra boşalan dosyalar silinmez.

· RCS, ClearCase veya SCCS'deki dosyalar için alınacak mı diye sormaz.

· Komut satırında seçeneklerin dosyalardan önce verilmesi gerekir.

· Eşleşmeyen dosyaların yedeklemesi yapılmaz.

--quoting-style=sözcük
Çıktılanan isimler sarmalanırken sözcük ile belirtilen tarz kullanılır. sözcük
şunlardan biri olabilir:

literal
İsimler olduğu gibi çıktılanır.

shell İsimler kabuk metakarakterleri içeriyorsa kabuk için sarmalanır yoksa anlamı
belirsiz çıktılama yapılır.

shell-always
Normalde sarmalanmaları gerekmese bile isimler daima kabuk için sarmalanır.

c İsimler C dilinde dizgelere uygulandığı gibi sarmalanır.

escape İsimler çevreleyen çifttırnakların ihmal edilmesi dışında c tarzındaki gibi
sarmalanır.

--quoting-style seçeneği için öntanımlı değeri QUOTING_STYLE ortam değişkeninde
belirtebilirsiniz. Bu ortam değikeni atanmamışsa öntanımlı değer shell'dir.

-r reddosyası, --reject-file=reddosyası
Bu yamanın eski ve yeni dosyalar yer değiştirilerek uygulanacağı varsayılır. Yama
olarak kullanılacak her bölümdeki eski ve yeni satırlar yer değiştirilerek uygulanmaya
çalışılır. Yer değiştirildiğinde anlamsız olan kısımlar reddedilir. -R seçeneği ed fark
betikleri ile çalışmaz, çünkü yer değiştirme işlemini gerçekleştirmek için çok az bilgi
içerirler.

Yama içindeki kısımlardan ilkinin uygulanması başarısız olursa, patch bu kısmın eski ve
yeni satırlarını yer değiştirerek böyle uygulanabiliyor mu diye bakar. Böyle
uygulanabiliyorsa kullanıcıya -R seçeneğinin uygulanmasını isteyip istemediğini sorar.
Uygulanamıyorsa, patch normal olarak uygulamaya devam eder. (Bilgi: Eğer yama bir
normal yama ise ve boş bir içerik bile daima eşleşeceğinden ilk komut yamanın bir ek
uygulanacağını belirtiyorsa bu yöntem yer değiştirmeli yamayı saptayamaz. Tesadüfen,
çoğu yama bir satırın tamamen silinmesini değil ya bir ek ya da bir değişiklik
yapılmasını gerektirir, bu durumda yer değiştirmeli normal fark dosyalarından silme
işlemi ile başlayanlar başarıyı arttıran kuralların uygulanmasına bağlı olarak
başarısız olur.)

-s, --silent, --quiet
Bir hata oluşmadıkça bilgilendirici hiçbir şey çıktılanmaz.

-t, --batch
-f seçeneğinde olduğu gibi sorular engellenir ama bu biraz farklı kabulllerle yapılır:
başlıklarında dosya isimlerini içermeyen yamalar atlanır (-f ile aynı); yamanın Prereq:
satırında yanlış sürüm belirtilen dosyalar için yamalar atlanır; ve yer değiştirme
uygulanması gerekliliği saptanan yamaların yer değiştirme ile uygulanacağı varsayılır.

-T, --set-time
Yamanmış dosyaların erişim ve değiştirme zamanları, bağlamsal fark dosyalarının
başlıklarındaki zaman bilgisinin yerel zamanı gösterdiği varsayımıyla bu zamana
ayarlanır. Bu seçeneğin kullanılması önerilmez, çünkü yerel zaman kullanılarak
uygulanan yamaları diğer zaman dilimlerindeki kulanıcılar kolayca kullanamazlar, ayrıca
yaz saati uygulamasından dolayı yerel zaman damgaları yamanın geçmişte uygulanması gibi
tuhaflıklara sebep olabilir. Bu seçenek yerine -Z veya --set-utc seçeneklerini
kullanarak zamanı UTC'ye göre belirtmeyi tercih edin.

-u, --unified
Yama dosyası birleşik bağlamsal fark dosyası olarak yorumlanır.

-v, --version
patch'in sürüm başlığını ve ama seviyesini basar ve çıkar.

-V yöntem, --version-control=yöntem
Yedek dosya isimleri saptanırken yöntem kullanılır. Bu yöntem ayrıca bu seçenek ile
gerektiğinde değiştirilmek üzere PATCH_VERSION_CONTROL (veya bu atanmamışsa
VERSION_CONTROL) ortam değişkeni ile atanabilir. Burada bir yöntemin atanması yedekleme
yapılacağı anlamına gelmez, sadece yedekleme yapılacaksa yedek dosyalarının ismi bu
yöntem kullanılarak saptanır.

yöntem değeri GNU Emacs'ın `version-control' değişkeni gibidir; farklı olarak patch
daha açıklayıcı olan eşanlamlılarını da tanır. Geçerli yöntem değerleri şunlardır
(eşsiz kısaltmalar da kabul edilir):

existing, nil
Zaten varolan dosyaların numaralı yedekleri yapılır, aksi takdirde basit
yedekleme yapılır. Bu öntanımlıdır.

numbered, t
Numaralı yedekleme yapılır. F dosyasının yedek dosyası N sürüm numarasını
belirtmek üzere F.~N~ biçiminde isimlendirilir.

simple, never
Basit yedekleme yapılır. -B (--prefix), -Y (--basename-prefix) ve -z (--suffix)
seçenekleri ile basit yedek dosyası ismi belirtilebilir. Bu seçeneklerin hiçbiri
belirtilmemişse, basit yedekleme soneki kullanılır; sonek değeri
SIMPLE_BACKUP_SUFFIX ortam değişkeni ile belirtilmemişse öntanımlı olarak .orig
soneki kullanılır.

Numaralı ve basit yedeklemede dosya ismi çok uzun olursa bunlar yerine sonek olarak ~
kullanılır, bu işlem de dosya isminin çok uzun olmasına sebep oluyorsa dosya ismindeki
son karakter ~ karakteri ile değiştirilir.

--verbose
Yapılan işlem hakkında daha ayrıntılı bilgi verilir.

-x sayı, --debug=sayı
Sadece patch yamacılarını ilgilendiren hata ayıklama seçeneklerini belirtmek için
kullanılır.

-Y önek, --basename-prefix=önek
Basit yedek dosyası ismi oluşturulurken dizinlerden arındırılmış dosya isminin önüne
önek getirilir. Örneğin basit yedek dosya ismi -Y .del/ ile belirtilmişse
src/patch/util.c dosyasının ismi src/patch/.del/util.c yapılır.

-z sonek, --suffix=sonek
Basit yedek dosyası ismi oluşturulurken dosya isminin sonuna sonek getirilir. Örneğin
basit yedek dosya ismi -z - ile belirtilmişse src/patch/util.c dosyasının ismi
src/patch/util.c- yapılır. Yedekleme soneki gerektiğinde bu seçenek ile değiştirilmek
üzere SIMPLE_BACKUP_SUFFIX ortam değişkeni ile de atanabilir.

-Z, --set-utc
Yamanmış dosyaların erişim ve değiştirme zamanları, bağlamsal fark dosyalarının
başlıklarındaki zaman bilgisinin koordinatlı evrensel zamanı (UTC; GMT olarak da
bilinir) gösterdiği varsayımıyla bu zamana ayarlanır. Ayrıca -T veya --set-time
seçeneklerinin açıklamasına da bakınız.

Dosyanın orjinal zamanı yama başlığında belirtilen zamanla eşleşmezse ya da onun
içeriği yama ile tam olarak eşleşmezse, -Z (--set-utc) ve -T (--set-time) seçenekleri
bir dosyanın zamanını ayarlamaktan kaçınır. Buna rağmen -f (--force) seçeneği
belirtilmişse dosyanın zamanı ne olursa olsun ayarlanır.

diff çıktı biçiminin sınırlamalarından dolayı, dosyaları içeriği değiştirilmeyecekse,
bu seçeneklerle bu dosyaların zamanı güncellenemez. Ayrıca, bu seçenekleri
kullandığınız takdirde, zamanları güncellenmiş dosyalara bağımlı dosyaları
kaldırmalısınız (make clean gibi). Böylece sonraki make çağrılarında yamanmış
dosyaların zamanlarından dolayı hatalarla/uyarılarla karşılaşmazsınız.

ORTAM DEĞİŞKENLERİ

       PATCH_GET
          Eksik  ya  da  salt-okunur  dosyaların   RCS,  ClearCase veya SCCS'den öntanımlı olarak
          alınıp alınmayacağını belirtmek için kullanılır. -g  (--get)  seçeneğinin  açıklamasına
          bakınız.

       POSIXLY_CORRECT
          Bu değişken atanmışsa patch öntanımlı olarak POSIX standardına uyumlu davranır. --posix
          seçeneğinin açıklamasına bakınız.

       QUOTING_STYLE
          --quoting-style seçeneğinin öntanımlı değeridir.

       SIMPLE_BACKUP_SUFFIX
          Bu  ortam  değişkeninin  değeri  basit  yedekleme  dosyalarında  .orig  soneki   yerine
          kullanılacak sonektir.

       TMPDIR, TMP, TEMP
          Geçici  dosyaları  konulacağı  dizindir.  patch bu listeden atanmış değerlerden ilkinin
          değeri kullanır. Hiçbiri atanmamışsa sisteme bağlı  öntanımlı  değer  kullanılır.  Unix
          makinalar için bu değer normalde /tmp dizinidir.

       VERSION_CONTROL, PATCH_VERSION_CONTROL
          Sürüm   denetim  tarzını  belirtir.  -v  (--version-control)  seçeneğinin  açıklamasına
          bakınız.

İLGİLİ DOSYALAR

       /dev/tty
          denetim uçbirimi; kullanıcıya sorulan soruların yanıtlarını almak için kullanılır.

       $TMPDIR/p*
          geçici dosyalar

İLGİLİ BELGELER

       diff(1), ed(1).

       Marshall T. Rose ve Einar A. Stefferud, Proposed Standard for Message Encapsulation,
       Internet RFC 934 <URL: ftp://ftp.isi.edu/innotes/rfc934.txt> (1985-01).

YAMA GÖNDERENLER İÇİN

Yama göndermeye hazırlanıyorsanız, hatırlamanız gereken bir sürü şey olacaktır.

Yamanızı sistemli olarak oluşturmalısınız. İyi bir yöntem
diff -Naur eski yeni komutunu kullanmaktır. Burada eski ve yeni ile eski ve yeni dizin
isimleri belirtilir. Bu isimler herhangi bir bölü çizgisi içermemelidir. diff komutunun
başlıkları yama uygulayıcıların yamayı -Z (--set-utc) seçeneği ile uygulayabilecekleri
şekilde Evrensel Zamanda geleneksel Unix tarih ve zaman biçiminde içermelidir. Bu örnekte,
komut Bourne kabuğu (bash) sözdizimiyle yazılmıştır:

LC_ALL=C TZ=UTC0 diff -Naur gcc-2.7 gcc-2.8

Yamanızı uygulayacak olanlara hangi dizine geçip hangi patch seçeneğini kullanacağını
söyleyin. Seçenek dizgesi olarak -Np1 önerilir. Yaptığınız yamayı kendinizi yamayı
alacakların yerine koyarak deneyin, yani orjinal dosyaların bir kopyasına bu yamayı
uygulayın.

İlk diff'e göre yama seviyesini arttırmak için yamanmış bir patchlevel.h dosyası tutmaktan
dolayı çok üzgün kişileri gönderdiğiniz yama sayesinde kazanabilirsiniz. Yama içine bir
Prereq: satırı koyarsanız onların sıradışı yamaları uygularken bazı uyarılar almamasını
sağlamış olursunuz.

Bir dosyanın yama uygulanırken oluşturulmasını isterseniz, oluşturulacak dosyayı /dev/null
ile ya da zaman damgası Unix çağ başlangıcına (Epoch: 1970-01-01 00:00:00 UTC) ayarlanmış
boş bir dosya ile karşılaştırılarak yapılmış bir fark dosyası ile bunu sağlayabilirsiniz.
Bu sadece, oluşturulacak dosya hedef dizinde yoksa çalışır. Tersine, yama uygulanıren
mevcut bir dosyanın silinmesini isterseniz, silinecek dosyayı yine zaman damgası Unix çağ
başlangıcına ayarlanmış boş bir dosya ile karşılaştırılarak yapılmış bir fark dosyası ile
bunu sağlayabilirsiniz. Silinmesini istediğiniz dosya, patch POSIX uyumlu değilse ve -E
(--remove-empty-files) seçeneği verilmişse, silinecektir. Dosyaları oluşturan ya da silen
yamalar üretmenin kolay bir yolu GNU diff'in -N (--new-file) seçeneğini kullanmaktır.

Alıcıların -pN seçeneğini kullanacağını varsayıyorsanız, bunun gibi bir çıktıya sahip yama
göndermeyin:

diff -Naur v2.0.29/prog/README prog/README
--- v2.0.29/prog/README Mon Mar 10 15:13:12 1997
+++ prog/README Mon Mar 17 14:58:22 1997

Çünkü burada eski ve yeni dosya isimleri farklı sayıda bölü çizgisi içermektedir ve
patch'in farklı sürümleri dosya isimlerini farklı yorumlarlar. Karışıklığı önlemek için
böyle bir çıktı üreten yamalar gönderin:

diff -Naur v2.0.29/prog/README v2.0.30/prog/README
--- v2.0.29/prog/README Mon Mar 10 15:13:12 1997
+++ v2.0.30/prog/README Mon Mar 17 14:58:22 1997

README.orig gibi yedek dosya ismi olarak kullanılabilecek bir dosya ismi ile
karşılaştırılarak üretilmiş yamalar göndermekten kaçının. Böyle bir yama patch'in gerçek
dosyayı değil yedekleme dosyasını yamamasına yol açabilir. Bunun yerine old/README ve
new/README gibi farklı dizinlerde bulunan aynı isimli iki dosyayı karşılaştırın.

Yer değiştirmeli yamalar göndermemeye çalışın. Böyle bir yama zaten uygulanmış bir yama
gibi görüneceğinden insanları şaşırtır.

Yamanızın türetilerek elde edilen dosyaları yamamasına dikkat edin (makefile'ınızın içinde
configure: configure.in diye bir satır var diye configure dosyasını yamamak gibi.).
Alıcılar bu tür türetilerek elde edilen dosyaları zaten kendileri türetebilmelidir.
Türetilen dosyalar için fark dosyaları göndermek zorundaysanız, fark dosyalarını UTC
kullanarak üretin. Böylece alıcılar yamayı -Z (--set-utc) seçeneği ile uygulayıp yamanmış
dosyalara bağımlı yamanmamış dosyaları kaldırmak zorunda kalırlar (make clean yapmak
gibi).

Beşyüzbilmemkaç farklık bir listeyi tek bir dosyaya koymaktan kaçınmak iyi olurdu.
Birbiriyle ilgileri nedeniyle gruplanabilen dosyalarla ilgili yamaları farklı dosyalara
koymak akıllıca olur.

TANI İLETİLERİ

       Tanı iletilerinin varlığı genellikle patch'in yama dosyanızı çözümleyemediğini belirtir.

       --verbose  seçeneği verilmişse bir Hmm... iletisi, yama dosyasında işlenemeyen bir metinin
       varlığını ve patch'in bu metin içinde bir yama var mı acaba, varsa bu ne tür  bir  yamadır
       acaba diye bir saptama yapmaya çalıştığını gösterir.

       patch'in  çıkış  durumu  0 ise, listedeki yamaların hepsi başarıyla uygulanmış demektir. 1
       ise bazıları uygulanamamıştır. 2 ise biraz daha fazla sorun vardır. Bir döngü  içinde  çok
       sayıda  yama  uyguluyorsanız  her  seferinde  bu çıkış durumuna bakmanız icabeder, böylece
       kısmen yamanmış dosyalara sonraki yamayı uygulamamış olursunuz.

YETERSİZLİKLER

Bağlamsal fark dosyaları boş dosyaların ve boş dizinlerin ya da sembolik bağ gibi özel
dosyaların oluşturulması ve silinmesi için güvenilir bir içerik sunamazlar. Sahiplik,
dosya izinleri gibi dosyaların temel verilerinde bir değişiklik bilgisi sunamadıkları gibi
bir dosyanın başka bir dosyaya sabit bağ mı olacağı gibi bilgileri de içeremezler. Bu tür
değişiklikler gerekliyse, bunları gerçekleştirecek bir betik yamaya eşlik etmelidir.

patch, bir ed betiğinde olmayan satır numaraları hakkında birşey söyleyemediği gibi, bir
normal fark dosyasında da sadece bir değişiklik ya da silme işlemi bulursa hatalı satır
numaralarını saptayabilir. Belirsizlik faktörü olarak 3 verildiğinde bağlamsal fark
dosyaları da sorun yaratabilir. Elverişli bir etkileşimli arayüz eklenene kadar, bir
bağlamsal fark dosyasının böyle bir durumda sorun çıkarıp çıkarmayacağını kendiniz
saptamalısınız. Şüphesiz, hatasız gerçekleşen bir derleme işlemi yamanın hatasız
uygulandığını gösteriyor gibi görünse de bu daima böyle olmaz.

patch, bazan biraz fazla tahmin yapması gerekse bile genellikle doğru sonuçlar üretir.
Yine de, yamanın üretildiği dosya ile yamanın uygulandığı dosya aynı sürüme ait olduğu
zaman sonuçların doğru olacağı garanti edilmiştir.

UYUMLULUK BİLGİLERİ

POSIX standardı, patch'in geleneksel davranışından farklı davranışlar belirtir. patch'in
POSIX uyumluluğu olmayan 2.1 ve daha önceki sürümleri ile çalışmak zorundaysanız bu
farklardan haberdar olmanız gerekir.

· Geleneksel patch'de -p seçeneğinin terimi isteğe bağlıdır. Yalnız başına -p seçeneği
-p0'a eşdeğerdir. Şimdiki durumda ise -p seçeneğinin bir terime sahip olması zorunludur
ve -p 0 seçeneği -p0 seçeneğine eşdeğerdir. En yüksek derecede uyumluluk adına seçeneği
-p0 ve -p1 gibi kullanın.

Ayrıca, geleneksel patch dosya yolunu saptarken bölü çizgilerinin sayısına bakarken
yeni sürümleri dosya yolunu oluşturan elemanların sayısına bakmaktadır. Bundan dolayı,
birden fazla yanyana bölü çizgisi tek bir bölü çizgisi olarak ele alınmaktadır. En
yüksek derecede uyumluluk adına gönderilen yamaların içindeki dosya isimlerinde //
olmamasına dikkat edin.

· Geleneksel patch'de yedekleme öntanımlı olarak etkindir. Bu davranış şimdi sadece -b
(--backup) seçeneği ile etkin kılınabilmektedir.

Bunun tersine, POSIX patch'de bir eşleşmeme olsa bile yedekleme asla yapılmaz. GNU
patch'de bu davranış --posix seçeneği kullanılarak yahut POSIXLY_CORRECT ortam
değişkeninin varlığı sayesinde POSIX uyumluluğu sağlanarak aksi takdirde
--no-backup-if-mismatch seçeneği ile etkinleştirilir.

Geleneksel patch'in -b sonek seçeneği ile GNU patch'in -b -z sonek seçenekleri
eşdeğerdir.

· Geleneksel patch yama başlığından yamanacak dosyanın ismini öğrenmek için karmaşık (ve
iyi belgelenmemiş) bir yöntem kullanır. Bu yöntem POSIX ile uyumlu olmadığı gibi,
birkaç yanlış gibi görünmeyen yanlış içerir. Şimdi patch aynı karmaşıklıkta (ama daha
iyi belgelenmiş) ve isteğe bağlı olarak POSIX uyumlu olabilen bir yöntem
kullanmaktadır; onun artık daha az yanlış gibi görünmeyen yanlış içerdiğini
düşünüyoruz. Bağlamsal fark dosyasının başlığında ve Index: satırında dosya
isimlerinden önek ayırması yapıldıktan sonra kalan dosya isimleri aynı ise bu iki
yöntem birbiriyle uyumludur. Yamanız, her başlıktaki dosya isimleri eşit sayıda bölü
çizgisi içeriyorsa, normal olarak uyumludur.

· Geleneksel patch kullanıcıya bir soru yönelteceği zaman soruyu standart hataya gönderir
ve yanıtı bir uçbirim olarak sırayla şu dosyalarda arar: standart hata, standart çıktı,
/dev/tty ve standard girdi. Şimdi ise patch soruyu standart çıtıya gönderip yanıtı
/dev/tty'den okur. Bazı soruların öntanımlı yanıtları değiştirilmiştir, böyle öntanımlı
yanıtları olan sorularda patch artık sonsuz bir döngüye girip yanıt beklememektedir.

· Geleneksel patch gerçek bir hata durumunda 1 ile dönerken, uygulanamayan yamalar
olduğunda bunların sayısını belirten bir çıkış değeri ile döner. Şimdi ise patch
uygulanamayan yamalar olduğunda 1 ile, gerçek bir sorun olması durumunda 2 çıkış değeri
ile döner.

· GNU patch, geleneksel patch ve POSIX uyumlu patch için ortak olan seçeneklerle
kendinizi sınırlarsanız iyi olur. Bu seçenekler aşağıda listelenmiştir. Terimli
seçeneklerde terimler zorunludur ve terim ile seçenek arasındaki boşluğun olup olmaması
önemlidir.

-c
-d dizin
-D tanım
-e
-l
-n
-N
-o çıktıdosyası
-psayı
-R
-r reddosyası

YAZILIM HATALARI

       Yazılım hatalarını lütfen eposta ile <bug-gnu-utils (at) gnu.org> adresine bildiriniz.

       patch kısmî eşleşmelerde, aşırı kaymış başlangıç konumlarında ve yer değiştirmelerde  daha
       çevik olmalıydı ama bu işlemler ek bir geçiş gerektiriyor.

       Kod  eğer  yinelenmişse  (örneğin, #ifdef ESKİKOD ... #else ...  #endif ile) patch her iki
       sürümüde  yamayamayacatır  ve  bu  her  ikisi  için  de  uygulanabiliyorsa,  yanlış  sürüm
       yamanabilecek ve size işlemin başarılı olduğunu söylececektir.

       Evvelce  uygulanmış  bir  yamayı  uygularsanız, patch yamanın yer değiştirmeli yama olarak
       uygulanacağını varsayabilir ve size bu yamayı uygulamamayı teklif  eder.  Bu  bir  özellik
       olarak yorumlanabilirdi.

KOPYALAMA

       Telif Hakkı © 1984, 1985, 1986, 1988 Larry Wall.
       Telif  Hakkı ©  1989,  1990,  1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998 Free Software
       Foundation, Inc.

       Bu kılavuzun harfi harfine kopyalanmasına ve dağıtılmasına telif hakkı  uyarısının  ve  bu
       izin uyarısının tüm kopyalarında bulunması şartıyla izin verilmiştir.

       Bu kılavuzun değiştirilmiş kopyalarının kopyalanması ve dağıtılması, türetilmiş çalışmanın
       sonuçlarının tamamı, harfi harfine kopyalamanın koşullarını içererek ve buna  eşdeğer  bir
       izin uyarısı da sağlandığı takdirde izin verilmiştir.

       Bu kılavuzun diğer dillere çevirilerinin kopyalanması ve dağıtılmasına, bu izin uyarısının
       bulunduğu orjinal ingilizce sürümdeki telif  hakkı  sahipleri  tarafından  onaylanmış  bir
       çeviri   değilse,  yukarıda  açıklanan  değiştirilmiş  sürümlerinin  koşulları  sağlandığı
       takdirde izin verilmiştir.

COPYING

       Copyright 1984, 1985, 1986, 1988 Larry Wall.
       Copyright  1989,  1990,  1991, 1992, 1993, 1994, 1995,  1996,  1997,  1998  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 included in translations approved by the copyright holders  instead  of   in
       the  original English.

YAZARLAR

       patch'in  orjinal  sürümü  Larry  Wall  tarafından yazılmıştır. Paul Eggert patch'in keyfî
       sınırlarını kaldırdı; ikilik dosyaların  desteklenmesi,  dosya  zamanlarının  ayarlanması,
       dosyaları  silinmesi  özelliklerini  ekledi;  ve  daha iyi POSIX uyumluluğu sağladı. Diğer
       destekleyicilerden Wayne  Davison  unidiff  desteğini,  David  MacKenzie  yapılandırma  ve
       yedekleme desteklerini sağladı.

ÇEVİREN

       Nilgün Belma Bugüner <nilgun (at) belgeler·gen·tr>, Ağustos 2004