Ubuntu Manpage: diff - iki dosya arasındaki farklılıkları bulur

İSİM

       diff - iki dosya arasındaki farklılıkları bulur

KULLANIM

       diff [ seçenekler ] 1.dosya 2.dosya

AÇIKLAMA

diff, en basit tabiri ile, iki farklı dosyanın içeriğini karşılaştırır. Dosya ismi olarak
- verilmişse, diff standart girdiyi okur. Özel bir durum olarak, diff - - şeklinde komut
kullanımı, standart girdi ile bir kopyasını karşılaştırır.

Şayet 1.dosya bir dizin ve 2.dosya değilse, diff komutu, 1.dosya ile verilen dizin
içindeki 2.dosya ile aynı isimli dosyayı karşılaştırır; bu durum tersi için de geçerlidir.
Dizin olmayan dosya mutlaka - olmalıdır.

Şayet her iki girdi de dizin ise, diff, alfabetik sıra ile, eşleşen bütün dosyaları
karşılaştırır. Bu karşılaştırma alt dizinlerde yapılmaz. Şayet alt dizinlerdeki
dosyalarında karşılaştırılmasını -r veya -recursive seçeneğini belirtmeniz gerekir. diff,
asla bir dizinin asıl içeriğini bir dosyaymış gibi karşılaştırmaz. Standart girdi isimsiz
olduğundan, tamamen tanımlanmış bir dosyaya standart girdi muamelesi yapılmaz ve "aynı
isimli dosya" fikri buraya uygulanamaz.

diff seçenekleri - ile başlar. Bu nedenle 1.dosya ve 2.dosya isimleri - ile başlayamaz.
Bunun yanında, -- şeklinde kullanım ile bu sorunu aşabilirsiniz. -- işaretinden sonra
gelen argümanlar - ile başlasa bile dosya ismi olarak değerlendirilir.

Seçenekler
Aşağıda, GNU diff'in kabul ettiği bütün komutların bir özetini bulacaksınız. Pek çok
seçenek iki eşdeğer isme sahiptir. Birincisi - ile başlayan tek bir harften oluşur, diğeri
ise -- ile başlayan uzun bir isimden meydana gelmektedir. Çok sayıda tek harfli seçenek
(bir argüman almadıkça), -ac gibi yanyana yazılabilir: -ac, -a ve -c anlamına gelir. Uzun
isimli seçenekler de başlangıçtan itibaren kendilerinden başka bir seçenekle karışmayacak
şekilde kısaltılarak kullanılabilirler. Köşeli parantezler içindeki argümanlar, gerekli
değilse verilmeyebileceği anlamına gelir.

-satır_sayısı
Dosya içeriğin tamsayı cinsinden satır sayısı (-5 gibi belirtilir). Bu seçenek
kendi başına bir çıktı biçimi tanımlamaz. -c veya -u ile birlikte kullanılmadığı
sürece bir etkisi yoktur. Bu seçenek eskidir. patch komutunun düzgün çalışması için
içerikte en az iki satır olması gerekir.

-a, --text
Metin dosyası olmasalar bile, bütün dosyaları metin dosyaları olarak kabul eder ve
onları satır satır karşılaştırır.

-b, --ignore-space-change
Karşılaştırmada ara boşluklarındaki farklar dikkate alınmaz.

-B Karşılaştımada boş satırlardaki farklar dikkate alınmaz.

-c Bağlamsal çıktı biçimi kullanılır.

-C satır_sayısı, --context[=satır_sayısı]
Bağlamın satır_sayısı satırı gösterilerek bağlamsal çıktı biçimi kullanılır.
satır_sayısı belirtilmezse üç satır gösterilir. patch komutunun düzgün çalışması
için içerikte en az iki satır olması gerekir.

--changed-group-format=biçim
Her iki dosyadaki if-then-else biçimindeki farklı satırları içeren satır
gruplarını çıktılarken biçim kullanılır.

-d, --minimal
En küçük değişikliği bile bulmak için algoritma değiştirilir. Bu seçenek diff'in
yavaş çalışmasına (bazan oldukça yavaş) sebep olur.

-D isim
isim önişlemci makrosunun koşullarına uygun olarak katıştırılmış if-then-else
biçimli çıktı üretir.

-e, -ed
Çıktıyı bir ed betiği olarak üretir.

-f, --forward-ed
Çıktı bir ed betiği gibi karışık olur ancak farklar dosyadaki sırasına uygun
çıktılanır.

-F düzifd, --show-function-line=düzifd
Bağlamsal veya tekilleştirilmiş biçimde, her bir değişiklik parçası için, önceki
satırdan düzifd ile eşleşen kısmı gösterir.

-h Bu seçenek herhangi bir etkiye sahip değildir, Unix uyumluluğu için vardır.

-H
--speed-large-files
Pek çok küçük değişikliğe sahip büyük dosyaların karşılaştırılmasında işlemini
hızlandırmak için buluşsal yöntemler (heuristics) kullanılır.

--horizon-lines=satır_sayısı
Farklılıklardan önceki ortak satırların son satır_sayısı satırını ve
farklılıklardan sonraki ortak satırların ilk satır_sayısı satırını iptal etmez.

-i, --ignore-case
Büyük ve küçük harf kullanımından kaynaklanan farklar gözönüne alınmaz, aynı kabul
edilir.

--ifdef=isim
isim önişlemci makrosunun koşullarına uygun olarak katıştırılmış if-then-else
biçimli çıktı üretir.

-I düzifd, --ignore-matching-lines=düzifd
düzifd ile eşleşen satırlar diğer dosyada olsa da olmasada yok sayılır.

--ignore-blank-lines
Satırları karşılaştırırken boş satırları yoksayar.

-l, --paginate
Çıktıyı sayfalamak için pr komutundan geçirir.

-L etiket, --label=etiket
Bağlamsal ya da tekilleştirilmiş biçimli başlıklarda dosya ismi yerine etiket
kullanılır.

--left-column
Yanyana çıktılama biçiminde iki ortak satırdan sadece soldakini basar.

--line-format=biçim
if-then-else biçimli tüm girdi satırlarını çıktılarken biçim kullanılır.

-n, -rcs
RCS biçimli çıktı verir; her komutun etkilenen satır sayısını belirtmesi dışında -f
ile aynıdır.

-N, --new-file
Dizinleri karşılaştırırken, bir dosyanın sadece tek bir dizin içinde bulunduğu
durumlarda; bu dosyayı diğer dizin içinde de, içi boş olarak, varmış gibi kabul
eder.

--new-group-format=biçim
İkinci dosyadaki if-then-else biçimli girdi satırı gruplarını çıktılarken biçim
kullanılır.

--new-line-format=biçim
İkinci dosyadaki if-then-else biçimli bir girdi satırını çıktılarken biçim
kullanılır.

--old-group-format=biçim
Birinci dosyadaki if-then-else biçimli girdi satırı gruplarını çıktılarken biçim
kullanılır.

--old-line-format=biçim
Birinci dosyadaki if-then-else biçimli bir girdi satırını çıktılarken biçim
kullanılır.

-p, --show-c-function
Her bir değişikliğin hangi C işlevi içinde olduğunu gösterir.

-P, --unidirectional-new-file
Dizinleri karşılaştırırken, bir dosyanın sadece ikinci dizin içinde bulunduğu
durumlarda; bu dosyayı diğer dizin içinde de, içi boş olarak, varmış gibi kabul
eder.

-q, --brief
Dosyalar farklıysa sadece raporlar, farkları bulmaz.

-r, --recursive
Dizinleri karşılaştırırken, bulunan bütün alt dizinlerin içindekileri de
karşılaştır.

-s
--report-identical-files
Dosyalar aynıysa raporlar.

-S dosya, --starting-file=dosya
Dizinleri karşılaştırırken, dosya ile belirtilen dosyadan başlar. Böylece yarıda
kalmış bir kıyaslamayı devam ettirebilirsiniz.

--from-file=dosya
Tüm terimleri dosya ile karşılaştırır. dosya bir dizin olabilir.

--to-file=dosya
dosyayı tüm terimlerle karşılaştırır. dosya bir dizin olabilir.

--sdiff-merge-assist
sdiff'e yardım için ek bilgiler basar. sdiff, bu bilgileri diff'i çalıştırırken
kullanır. Bu seçenek, kullanıcıların doğrudan kullanması için tasarlanmamıştır.

--suppress-common-lines
Yan yana çıktı biçiminde ortak satırlar çıktılanmaz.

-t
--expand-tabs
Girdi dosyalarındaki sekmelerin eşitliğini sağlamak için; çıktılarken sekmeleri
boşluklara çevirir.

-T
--initial-tab
Normal ya da bağlamsal biçimdeki bir satırın metninden önceki boşlukları sekmelerle
değiştirir. Böylece, satırların sekmelerle hizalanarak düzgün görünmesi sağlanır.

-u Tekilleştirilmiş dosya biçimi kullanılır.

--unchanged-group-format=biçim
Her iki dosyadan da alınmış if-then-else biçimindeki bir ortak satır grubunu biçim
biçiminde çıktılar.

--unchanged-line-format=biçim
Her iki dosyadan da alınmış if-then-else biçimindeki bir ortak satırı biçim
biçiminde çıktılar.

-U satır_sayısı, --unified[=satır_sayısı]
Bağlamın satır_sayısı satırı gösterilerek tekilleştirilmiş çıktı biçimi kullanılır.
satır_sayısı belirtilmezse üç satır gösterilir. patch komutunun düzgün çalışması
için içerikte en az iki satır olması gerekir.

-v, --version
diff'in sürüm numarasını basar.

-w
--ignore-all-space
Satırları karşılaştırırken boşlukları atlar.

-W krk_sayısı, --width=krk_sayısı
Yanyana çıktı biçiminde krk_sayısı ile belirtilen genişlikte sütunlar kullanılır.

-x şablon, --exclude=şablon
Dizinleri kıyaslarken, şablon ile eşleşen sahip alt dizinleri ve dosyaları
yoksayar.

-X dosya, --exclude-from=dosya
Dizinleri kıyaslarken, dosya içindeki şablonlar ile eşleşen sahip alt dizinleri ve
dosyaları yoksayar.

-y, --side-by-side
Yan yana çıktı biçimi kullanılır.

İLGİLİ BELGELER

       cmp(1), comm(1), diff3(1), ed(1), patch(1)), pr(1), sdiff(1).

ÇIKIŞ DURUMU

       Çıkış durumu olarak 0'ın anlamı, hiçbir  farklılık  bulunamadığıdır.  Bazı  farklılıkların
       olduğu durumlarda 1 ile çıkar. Şayet 2 ile çıkarsa, bir sorun var demektir.

ÇEVİREN

       Yalçın Kolukısa <yalcink01 (at) yahoo.com>, Aralık 2003