git-format-patch - Bulutta Çevrimiçi

Program:

ADI

git-format-patch - E-posta gönderimi için yamalar hazırlayın

SİNOPSİS

git biçim yama [-k] [(-o|--çıktı dizini) | --stdout]
[--iş parçacığı yok | --thread[= ]]
[(--ek|--satır içi)[= ] | --bağlanmaz]
[-s | --bitirmek]
[--imza= | --imzasız]
[--imza-dosyası= ]
[-n | --numaralı | -N | --numarasız]
[--başlangıç-numarası ] [--numaralı dosyalar]
[--in-reply-to=Mesaj Kimliği] [--sonek=. ]
[--in-in-upstream'de yoksay]
[--subject-prefix=Konu-Önek] [(--reroll-count|-v) ]
[--to= ] [--cc= ]
[--[no-]kapak mektubu] [--sessiz] [--notlar[= ]]
[ ]
[ | ]

TANIM

Her bir taahhüdü, yaması ile birlikte, UNIX'e benzeyecek şekilde biçimlendirilmiş, taahhüt başına bir dosyada hazırlayın
posta kutusu biçimi. Bu komutun çıktısı, e-posta gönderimi veya kullanım için uygundur.
ile git am.

Hangi taahhütlerin üzerinde çalışılacağını belirtmenin iki yolu vardır.

1. Tek bir taahhüt, , akımın ucuna yol açan taahhütlerin
yol açan tarihte olmayan dal çıktı olmak.

2. Genel ifadesi (bkz. "REVİZYONLARI BELİRLEME" bölümü)
gitrevizyonlar(7)), belirtilen aralıktaki taahhütler anlamına gelir.

Tek bir durumda birinci kural önceliklidir. . İkincisini uygulamak için
kural, yani, tarihin başlangıcından bugüne kadar her şeyi biçimlendirin , kullan
--kök seçenek: git format-patch --root . Yalnızca biçimlendirmek istiyorsanız
bunu git format-patch -1 ile yapabilirsiniz. .

Varsayılan olarak, her çıktı dosyası sırayla 1'den numaralandırılmıştır ve ilk satırını kullanır.
dosya adı olarak taahhüt mesajı (yol adı güvenliği için masaj yapılır). İle
--numbered-files seçeneği, çıktı dosyası adları ilk olmadan yalnızca sayılar olacaktır.
taahhüdün satırı eklendi. Çıktı dosyalarının adları standart çıktıya yazdırılır,
--stdout seçeneği belirtilmedikçe.

-o belirtilirse, çıktı dosyaları şurada oluşturulur: . Aksi takdirde, içinde oluşturulurlar
geçerli çalışma dizini.

Varsayılan olarak, tek bir yamanın konusu "[YAMA] " şeklindedir ve ardından
taahhüt mesajından ilk boş satıra kadar olan satırlar (bkz.
git-taahhüt(1)).

Birden fazla yama çıktısı alındığında, konu öneki bunun yerine "[PATCH n/m]" olacaktır. NS
1/1'i tek bir yama için eklenmeye zorlayın, -n kullanın. Konudan yama numaralarını çıkarmak için,
-N'yi kullanın.

--thread verilirse, git-format-patch, In-Reply-To ve References başlıklarını oluşturacak
ikinci ve sonraki yama postalarının ilk postaya yanıt olarak görünmesini sağlayın; bu da
başvurulacak bir Message-Id başlığı oluşturur.

SEÇENEKLER

-p, --istatistik yok
Herhangi bir fark durumu olmadan düz yamalar oluşturun.

-s, --yama yok
Fark çıktısını bastır. Yamayı gösteren git show gibi komutlar için kullanışlıdır.
varsayılan olarak veya --patch'in etkisini iptal etmek için.

-U , --birleşik=
ile farklar oluştur her zamanki üç yerine bağlam satırları.

--en az
Mümkün olan en küçük farkın üretildiğinden emin olmak için fazladan zaman harcayın.

--sabır
"Sabır farkı" algoritmasını kullanarak bir fark oluşturun.

--histogram
"Histogram diff" algoritmasını kullanarak bir fark oluşturun.

--diff-algoritma={sabır|minimal|histogram|myers}
Bir fark algoritması seçin. Varyantlar aşağıdaki gibidir:

varsayılan, myers
Temel açgözlü fark algoritması. Şu anda, bu varsayılandır.

en az
Mümkün olan en küçük farkın üretildiğinden emin olmak için fazladan zaman harcayın.

sabır
Yamaları oluştururken "sabır farkı" algoritmasını kullanın.

Histogram
Bu algoritma, sabır algoritmasını "düşük oluşumlu yaygın
elementler".

Örneğin, diff.algorithm değişkenini varsayılan olmayan bir değere yapılandırdıysanız ve
varsayılanı kullanmak istiyorsanız, --diff-algorithm=default seçeneğini kullanmanız gerekir.

--stat[= [, [, ]]]
Bir diffstat oluşturun. Varsayılan olarak, gerekli olduğu kadar çok alan kullanılacaktır.
dosya adı bölümü ve geri kalanı grafik bölümü için. Terminal için maksimum genişlik varsayılanları
genişlik veya bir terminale bağlı değilse 80 sütun ve geçersiz kılınabilir .
Dosya adı bölümünün genişliği, başka bir genişlik verilerek sınırlandırılabilir.
virgülden sonra. Grafik parçasının genişliği kullanılarak sınırlandırılabilir.
--stat-graph-width= (bir istatistik grafiği oluşturan tüm komutları etkiler) veya
diff.statGraphWidth ayarı= (git biçim yamasını etkilemez). vererek
üçüncü parametre , çıktıyı ilkiyle sınırlayabilirsiniz çizgiler, takip edildi
tarafından ... daha fazla varsa.

Bu parametreler ayrıca --stat-width= ile ayrı ayrı ayarlanabilir. ,
--stat-name-width= ve --stat-count= .

--numstat
--stat'a benzer, ancak eklenen ve silinen satırların sayısını ondalık gösterimde gösterir ve
daha makine dostu hale getirmek için kısaltma olmadan yol adı. İkili dosyalar için,
0 0 demek yerine iki çıktı verir.

--kısa durum
Toplam değiştirilme sayısını içeren --stat biçiminin yalnızca son satırını çıktılayın
dosyaların yanı sıra eklenen ve silinen satırların sayısı.

--dirstat[= ]
Her alt dizin için göreli değişiklik miktarının dağılımını çıkarın. NS
--dirstat davranışı, virgülle ayrılmış bir liste geçirilerek özelleştirilebilir.
parametreler. Varsayılanlar, diff.dirstat yapılandırma değişkeni tarafından kontrol edilir
(görmek git-config(1)). Aşağıdaki parametreler mevcuttur:

değişiklikler
Kaldırılan satırları sayarak dirstat sayılarını hesaplayın.
kaynak veya hedefe eklendi. Bu, saf kod miktarını yok sayar
Bir dosya içindeki hareketler. Başka bir deyişle, bir dosyadaki satırları yeniden düzenlemek,
diğer değişiklikler kadar sayılır. Bu, parametre olmadığında varsayılan davranıştır.
verilmiş.

hatları
Normal satır tabanlı fark analizi yaparak dirstat sayılarını hesaplayın ve
kaldırılan/eklenen satır sayılarının toplanması. (İkili dosyalar için 64 baytlık parçaları sayın
bunun yerine, ikili dosyaların doğal bir çizgi kavramı olmadığından). Bu daha fazla
pahalı --dirstat davranışı, değişiklik davranışından daha fazladır, ancak sayılır
diğer değişiklikler kadar bir dosya içinde yeniden düzenlenmiş satırlar. Ortaya çıkan çıktı
diğer --*stat seçeneklerinden elde ettiğinizle tutarlı.

Dosyaları
Değiştirilen dosya sayısını sayarak dirstat sayılarını hesaplayın. Her biri değişti
dosya, dirstat analizinde eşit olarak sayılır. Bu hesaplama açısından en ucuzu
--dirstat davranışı, çünkü dosya içeriğine hiç bakmak zorunda değildir.

birikimli
Bir alt dizindeki değişiklikleri üst dizin için de sayın. Bunu not et
kümülatif kullanıldığında, rapor edilen yüzdelerin toplamı %100'ü geçebilir. NS
varsayılan (kümülatif olmayan) davranış, birikimli olmayan davranışla belirtilebilir.
parametre.


Bir tamsayı parametresi, bir kesme yüzdesi (varsayılan olarak %3) belirtir. dizinler
Bu yüzdeden daha az katkıda bulunan değişiklikler çıktıda gösterilmez.

Örnek: Aşağıdakiler, daha az dizin içeren dizinleri yok sayarken, değiştirilen dosyaları sayar.
toplam değiştirilen dosya miktarının %10'undan fazlası ve biriken alt dizin sayıları
üst dizinlerde: --dirstat=files,10,cumulative.

--Özet
Oluşturmalar, yeniden adlandırmalar gibi genişletilmiş başlık bilgilerinin özet bir özetini çıktılayın
ve mod değişiklikleri.

--no-yeniden adlandırma
Yapılandırma dosyası yapılacak varsayılanı verse bile yeniden adlandırma algılamayı kapatın
böylece.

--tam-indeks
İlk bir avuç karakter yerine, görüntü öncesi ve sonrası blob'un tamamını gösterin
yama biçimi çıktısı oluşturulurken "indeks" satırındaki nesne adları.

--ikili
--full-index'e ek olarak, git-apply ile uygulanabilecek bir ikili fark çıktısı alın.

--kısaltma[= ]
40 baytlık onaltılık nesne adının tamamını farklı ham biçim çıktısında göstermek yerine
ve fark ağacı başlık satırları yalnızca kısmi bir önek gösterir. Bu, aşağıdakilerden bağımsızdır:
--fark düzeltme eki çıktı biçimini kontrol eden yukarıdaki tam dizin seçeneği. Varsayılan olmayan
basamak sayısı --abbrev= ile belirtilebilir .

-B[ ][/ ], --break-rewrites[=[ ][/ ]]
Tam yeniden yazma değişikliklerini silme ve oluşturma çiftlerine ayırın. Bu iki hizmet eder
amaçları:

Seri olarak değil, bir dosyanın tamamen yeniden yazılması anlamına gelen bir değişikliğin şeklini etkiler.
eşleşen çok az satırla karıştırılmış silme ve ekleme
metinsel olarak bağlam olarak, ancak eski her şeyin tek bir silinmesi ve ardından bir
yeni olan her şeyin bir kez eklenmesi ve m sayısı -B'nin bu yönünü kontrol eder
seçeneği (varsayılan olarak %60'tır). -B/70%, orijinalin %30'undan azının
Git'in tamamen yeniden yazma olarak kabul etmesi için sonuçta kalır (yani, aksi takdirde
sonuçta ortaya çıkan yama, bağlamla karıştırılmış bir dizi silme ve ekleme olacaktır.
çizgiler).

-M ile birlikte kullanıldığında, tamamen yeniden yazılmış bir dosya da bir dosyanın kaynağı olarak kabul edilir.
yeniden adlandır (genellikle -M, yalnızca yeniden adlandırmanın kaynağı olarak kaybolan bir dosyayı dikkate alır),
ve n sayısı -B seçeneğinin bu yönünü kontrol eder (varsayılan olarak %50'dir). -B20%
%20 veya daha fazlasına kıyasla ekleme ve silme ile bir değişikliğin olduğunu belirtir.
dosyanın boyutu, olası bir yeniden adlandırma kaynağı olarak alınmaya uygundur.
başka bir dosya.

-M[ ], --find-yeniden adlandırır[= ]
Yeniden adlandırmaları algıla. n belirtilirse, benzerlik indeksinde bir eşik değeridir (ör.
dosyanın boyutuna kıyasla ekleme/silme miktarı). Örneğin, -M90% şu anlama gelir:
Git, dosyanın %90'ından fazlası varsa, silme/ekleme çiftini yeniden adlandırma olarak değerlendirmelidir.
değişmedi. % işareti olmadan, sayı bir kesir olarak okunmalıdır.
ondan önceki ondalık nokta. Yani, -M5 0.5 olur ve bu nedenle -M50% ile aynıdır.
Benzer şekilde, -M05, -M5% ile aynıdır. Algılamayı tam yeniden adlandırmalarla sınırlamak için -M100% kullanın.
Varsayılan benzerlik indeksi %50'dir.

-C[ ], --bul-kopyalar[= ]
Yeniden adlandırmanın yanı sıra kopyaları algılayın. Ayrıca --find-copies-harder'a bakın. n belirtilirse,
-M ile aynı anlama sahiptir .

--bul-kopyaları-daha zor
Performans nedenleriyle, varsayılan olarak -C seçeneği, yalnızca orijinal dosya varsa kopyaları bulur.
kopyası aynı değişiklik kümesinde değiştirildi. Bu bayrak komutun incelenmesini sağlar
kopya kaynağı için aday olarak değiştirilmemiş dosyalar. Bu çok pahalı
büyük projeler için çalıştırma, bu yüzden dikkatli kullanın. Birden fazla -C seçeneği verilmesi
aynı etkiye sahiptir.

-D, --geri döndürülemez-silme
Silmeler için ön görüntüyü atlayın, yani yalnızca başlığı yazdırın, ancak arasındaki farkı değil
ön görüntü ve /dev/null. Ortaya çıkan yama, yama veya yama ile uygulanmamalıdır.
git uygula; bu yalnızca, yalnızca içeriği gözden geçirmeye konsantre olmak isteyenler içindir.
değişiklikten sonra metin. Ek olarak, çıktı açıkça yeterli bilgiden yoksundur.
böyle bir yamayı manuel olarak bile tersine uygulayın, bu nedenle seçeneğin adı.

-B ile birlikte kullanıldığında, a'nın silme kısmındaki ön resmi de atlayın.
çifti sil/oluştur.

-l
-M ve -C seçenekleri, O(n^2) işlem süresini gerektirir; burada n,
potansiyel yeniden adlandırma/kopyalama hedefleri. Bu seçenek, yeniden adlandırma/kopyalama algılamasının çalışmasını engeller
yeniden adlandırma/kopyalama hedeflerinin sayısı belirtilen sayıyı aşarsa.

-Ö
Yamanın çıktısını, belirtilen sırada , bir kabuk küresi olan
satır başına desen. Bu, diff.orderFile yapılandırma değişkenini geçersiz kılar (bkz. git-
yapılandırma(1)). diff.orderFile'ı iptal etmek için -O/dev/null kullanın.

-bir metin
Tüm dosyaları metin olarak ele alın.

--eol-at-boşluğu görmezden gelin
EOL'de boşluktaki değişiklikleri yok sayın.

-b, --ignore-boşluk-değişimi
Boşluk miktarındaki değişiklikleri yoksayın. Bu, satır sonundaki boşlukları yok sayar ve
bir veya daha fazla boşluk karakterinin diğer tüm dizilerini eşdeğer olarak kabul eder.

-w, --tüm alanı göz ardı et
Çizgileri karşılaştırırken boşlukları dikkate almayın. Bu, bir satırda olsa bile farklılıkları yok sayar.
diğer satırın olmadığı boşluk.

--ignore-boş-satırlar
Tüm satırları boş olan değişiklikleri yoksay.

--ara-parça-bağlam=
Belirtilen satır sayısına kadar, fark parçaları arasındaki bağlamı gösterin, böylece
birbirine yakın olan iri parçaları kaynaştırıyor.

-W, --fonksiyon bağlamı
Değişikliklerin tüm çevreleyen işlevlerini göster.

--ext-diff
Harici bir fark yardımcısının yürütülmesine izin verin. Harici bir fark sürücüsü ayarlarsanız
git özellikleri(5), bu seçeneği aşağıdakilerle kullanmanız gerekir: git günlüğü(1) ve arkadaşlar.

--ext-fark yok
Harici fark sürücülerine izin verme.

--textconv, --no-textconv
İkili dosyaları karşılaştırırken harici metin dönüştürme filtrelerinin çalıştırılmasına izin verin (veya izin vermeyin)
Dosyalar. Görmek git özellikleri(5) ayrıntılar için. Çünkü textconv filtreleri tipik olarak bir
tek yönlü dönüştürme, ortaya çıkan fark insan tüketimi için uygundur, ancak olamaz
uygulanacaktır. Bu nedenle, textconv filtreleri varsayılan olarak yalnızca git-
fark(1) ve git günlüğü(1), ancak için değil git-format-yama(1) veya farklı tesisat komutları.

--ignore-alt modüller[= ]
Diff neslinde alt modüllerde yapılan değişiklikleri yok sayın. "yok" olabilir,
Varsayılan olan "izlenmeyen", "kirli" veya "tümü". "Hiçbiri" kullanılması,
alt modül, izlenmeyen veya değiştirilmiş dosyalar veya HEAD'i içerdiğinde değiştirilir
süper projede kaydedilen taahhütten farklıdır ve herhangi birini geçersiz kılmak için kullanılabilir
ayarları aldırmamak seçeneği git-config(1) veya gitmodüller(5). "İzlenmemiş" olduğunda
kullanılmış alt modüller, yalnızca izlenmeyen içerik içerdiğinde kirli kabul edilmez (ancak
hala değiştirilmiş içerik için taranırlar). "Kirli" kullanmak, tüm değişiklikleri yok sayar.
alt modüllerin çalışma ağacı, yalnızca süper projede depolanan taahhütlerdeki değişiklikler
gösterildi (bu, 1.7.0'a kadar olan davranıştı). "Tümü" kullanımı, tüm değişiklikleri gizler.
alt modüller.

--src öneki=
"a/" yerine verilen kaynak önekini gösterin.

--dst-ön ek=
"b/" yerine verilen hedef önekini göster.

--ön ek yok
Herhangi bir kaynak veya hedef önek göstermeyin.

Bu yaygın seçenekler hakkında daha ayrıntılı açıklama için ayrıca bkz. gitdiffcore(7).

-
Yamaları en baştan hazırlayın taahhüt eder.

-Ö , --çıktı-dizini
Kullanmak mevcut çalışma dizini yerine ortaya çıkan dosyaları depolamak için.

-n, --numaralı
Ad çıktısı [YAMA sayı/a] format, tek bir yama ile bile.

-N, --numarasız
Ad çıktısı [YAMA] biçimi.

--başlangıç ​​numarası
Yamaları numaralandırmaya başlayın 1 yerine

--numaralı-dosyalar
Çıktı dosyası adları, varsayılan ilk satır olmadan basit bir sayı dizisi olacaktır.
taahhüt eklendi.

-k, --keep-konu
soyma/ekleme [YAMA] taahhüt günlüğü mesajının ilk satırından.

-s, --signoff
Signed-off-by: satırını taahhüt edenin kimliğini kullanarak taahhüt mesajına ekleyin.
kendin. Şuradaki oturum kapatma seçeneğine bakın: git-taahhüt(1) daha fazla bilgi için.

--stdout
Tüm taahhütleri standart çıktıya bir dosya oluşturmak yerine mbox formatında yazdırın
her biri için.

--ekle[= ]
İlk kısmı taahhüt mesajı olan çok parçalı/karma ek oluşturun ve
yamanın kendisi, Content-Disposition: ek ile ikinci bölümde.

--bağlanmaz
Yapılandırma ayarını geçersiz kılarak ek oluşturmayı devre dışı bırakın.

--inline[= ]
İlk kısmı taahhüt mesajı olan çok parçalı/karma ek oluşturun ve
yamanın kendisi, Content-Disposition: satır içi ile ikinci bölümde.

--thread[= ], --no-thread
İkinci ve ikinci yapmak için In-Reply-To ve References başlıklarının eklenmesini kontrol eder.
sonraki postalar ilkine yanıt olarak görünür. oluşumunu da kontrol eder.
Başvurulacak Message-Id başlığı.

isteğe bağlı argument can be either shallow or deep. sığ diş açma
her posta, başlığın kapaktan seçildiği dizinin başına bir cevap
mektup, --in-cevap-ve ilk yama postası bu sırayla. derin threading
her postayı bir öncekine yanıt yapar.

Varsayılan, --no-thread şeklindedir. format.iş parçacığı yapılandırma ayarlandı. Eğer -- iş parçacığı
bir stil olmadan belirtilirse, varsayılan olarak tarafından belirtilen stile geçer. format.iş parçacığı if
herhangi biri, yoksa sığ.

için varsayılan olduğuna dikkat edin git eposta gönder e-postaların kendisini göndermektir. git istersen
format-patch iş parçacığıyla ilgilenmek için, iş parçacığının olduğundan emin olmak isteyeceksiniz
git send-email için devre dışı bırakıldı.

--in-reply-to=Mesaj Kimliği
İlk postayı (veya --no-thread içeren tüm postaları) verilen yanıt olarak görünmesini sağlayın
Yeni bir yama serisi sağlamak için iş parçacıklarının kopmasını önleyen Message-Id.

--in-in-upstream'de yoksay
Bir taahhütle eşleşen bir yama eklemeyin .. . Bu inceleyecek
tüm yamalar erişilebilir ama ondan değil ve onlarla karşılaştırın
yamalar oluşturulur ve eşleşen herhangi bir yama yoksayılır.

--konu öneki=
standart yerine [YAMA] konu satırında önek kullanmak yerine
[ ]. Bu, bir yama serisinin faydalı bir şekilde adlandırılmasına izin verir ve
--numaralı seçeneğiyle birlikte.

-v , --reroll-sayısı=
dizi olarak işaretle -konunun tekrarı. Çıktı dosya adlarında v var
önlerine eklenir ve konu öneki (varsayılan olarak "PATCH"), ancak şu şekilde yapılandırılabilir:
--subject-prefix seçeneği) `v'ye sahiptir ' ektedir. Örneğin --reroll-count=4 mayıs
"Konu: [PATCH v4 0001/4] Ekle" içeren v1-20-add-makefile.patch dosyası oluşturun
makefile" içinde.

--to=
E-posta başlıklarına bir Kime: başlığı ekleyin. Bu, yapılandırılmış üstbilgilere ek olarak,
ve birden çok kez kullanılabilir. Olumsuzlanan --no-to formu, tüm To: başlıklarını atar
şimdiye kadar eklendi (config veya komut satırından).

--cc=
E-posta başlıklarına bir Cc: başlığı ekleyin. Bu, yapılandırılmış üstbilgilere ek olarak,
ve birden çok kez kullanılabilir. Olumsuzlanan --no-cc formu tüm Cc: başlıklarını atar
şimdiye kadar eklendi (config veya komut satırından).

--dan, --dan=
Her bir taahhüt e-postasının Kimden: başlığında ident kullanın. Taahhüdün yazar kimliği ise
sağlanan kimlikle metinsel olarak aynı değilse, gövdeye bir From: başlığı yerleştirin
asıl yazarla mesaj. Kimlik verilmezse, taahhüt eden kimliğini kullanın.

Bu seçeneğin yalnızca e-postaları gerçekten gönderiyorsanız ve
kendinizi gönderen olarak tanımlamak, ancak orijinal yazarı korumak (ve git am will
gövde içi başlığı doğru şekilde alın). Ayrıca git send-email'in zaten işlediğini unutmayın.
bu dönüşüm sizin için ve besliyorsanız bu seçenek kullanılmamalıdır.
git send-email'in sonucu.

--add-header=
E-posta başlıklarına isteğe bağlı bir başlık ekleyin. Bu, yapılandırılmış herhangi bir
başlıklar ve birden çok kez kullanılabilir. Örneğin, --add-header="Organizasyon:
git-foo". Olumsuzlanan --no-add-header formu atılır herşey (Kime:, Bilgi: ve özel) üstbilgileri
yapılandırma veya komut satırından şimdiye kadar eklendi.

--[no-]kapak mektubu
Yamalara ek olarak, şubeyi içeren bir kapak mektubu dosyası oluşturun.
açıklama, kısa günlük ve genel fark durumu. Bir açıklamayı doldurabilirsiniz
Dosyayı göndermeden önce.

--notlar[= ]
Notları ekleyin (bkz. git notları(1)) üç çizgiden sonraki taahhüt için.

Bunun beklenen kullanım durumu, taahhüt için destekleyici bir açıklama yazmaktır.
uygun taahhüt günlüğü mesajına ait değil ve onu yamaya dahil et
teslimiyet. Format-patch çalıştırıldıktan sonra bu açıklamalar basitçe yazılabilir.
ancak göndermeden önce, bunları Git notları olarak tutmak, aralarında muhafaza edilmelerini sağlar.
yama serisinin sürümleri (ancak note.rewrite tartışmasına bakın)
yapılandırma seçenekleri git notları(1) bu iş akışını kullanmak için).

--[hayır]-imza=
Üretilen her mesaja bir imza ekleyin. RFC 3676 uyarınca imza şundan ayrılır:
gövdesi üzerinde '--' olan bir çizgi ile. İmza seçeneği atlanırsa imza
varsayılan olarak Git sürüm numarasıdır.

--imza-dosyası=
İmzanın bir dosyadan okunması dışında --signature gibi çalışır.

--sonek=.
Oluşturulan dosya adları için son ek olarak .patch kullanmak yerine, belirtilen soneki kullanın. A
ortak alternatif --suffix=.txt'dir. Bunu boş bırakmak .patch son ekini kaldıracaktır.

Baştaki karakterin nokta olması gerekmediğini unutmayın; örneğin, kullanabilirsiniz
--suffix=-patch 0001-description-of-my-change-patch'i almak için.

-q, --sessiz
Oluşturulan dosyaların adlarını standart çıktıya yazdırmayın.

--no-ikili
İkili dosyalardaki değişikliklerin içeriklerini çıktı olarak vermeyin, bunun yerine bir uyarı görüntüleyin.
dosyalar değişti. Bu seçenek kullanılarak oluşturulan yamalar düzgün uygulanamaz, ancak
kod incelemesi için hala kullanışlıdırlar.

--sıfır-taahhüt
Her yamanın From başlığında, taahhüdün karması yerine tamamen sıfır bir karma çıktı alın.

--kök
Revizyon argümanını bir , sadece tek bir taahhüt olsa bile
(bu normalde bir ). Kök taahhütlerinin içerdiğini unutmayın.
belirtilen aralık, bu işaretten bağımsız olarak her zaman oluşturma yamaları olarak biçimlendirilir.

YAPILANDIRMA

Her mesaja eklenecek fazladan posta başlık satırları belirtebilirsiniz;
konu öneki ve dosya soneki, birden fazla yama çıktısı alırken yamaları numaralandır, ekle
"Kime" veya "Bilgi:" üstbilgileri, ekleri yapılandırın ve yapılandırmayla yamaları kapatın
değişkenler.

[biçim]
headers = "Organizasyon: git-foo\n"
konuÖnek = DEĞİŞTİR
sonek = .txt
numaralı = otomatik
için =
cc =
[ = mime-sınır-dizesi] ekle
imza Kapalı = doğru
kapak mektubu = otomatik

TARTIŞMA

Tarafından üretilen yama git biçim yama sabit bir "sihir" ile UNIX posta kutusu biçimindedir
dosyanın gerçek bir dosyadan ziyade format-yamasından çıktığını belirtmek için zaman damgası
posta kutusu, şöyle:

From 8f72bad1baf19a53459661343e21d6491c3908d3 Mon Sep 17 00:00:00 2001
Gönderen: Tony Luck[e-posta korumalı]>
Tarih: 13 Temmuz 2010 Salı 11:42:54 -0700
Subject: [PATCH] =?UTF-8?q?[IA64]=20Put=20ia64=20config=20files=20on=20the=20?=
=?UTF-8?q?Uwe=20Kleine-K=C3=B6nig=20diet?=
MIME-Version: 1.0
İçerik Türü: metin/düz; karakter kümesi=UTF-8
Content-Transfer-Encoding: 8bit

Arch/arm yapılandırma dosyaları bir python betiği kullanılarak inceltildi
(See commit c2330e286f68f1c408b4aa6515ba49d57f05beae comment)

Aynısını ia64 için yapın, böylece şık ve ince bir görünüme sahip olabiliriz
...

Tipik olarak, bir MUA'nın taslaklar klasörüne yerleştirilecek ve zamanında yorum eklemek için düzenlenecektir.
üç tire işaretinden sonra değişiklik günlüğüne girmemeli ve ardından
örneğimizde body, "arch/arm config files was..." ile başlar. Alıcı tarafta,
okuyucular, ilginç yamaları bir UNIX posta kutusuna kaydedebilir ve bunları git am(1).

Bir yama devam eden bir tartışmanın parçası olduğunda, yama tarafından oluşturulan yama git biçim yama yapabilmek
yararlanmak için ince ayar yapmak git am --makas özellik. cevabınıza cevap verdikten sonra
tartışma yalnızca "-- >8 --" (makas ve perforasyon) içeren bir satır gelir,
ardından gereksiz başlık alanlarının kaldırıldığı yama gelir:

...
> O halde şöyle şöyle yapmalıyız.

Bana mantıklı geldi. Bu yamaya ne dersin?

-- >8 --
Konu: [IA64] Uwe Kleine-König diyetine ia64 yapılandırma dosyalarını koyun

Arch/arm yapılandırma dosyaları bir python betiği kullanılarak inceltildi
...

Bu şekilde bir yama gönderirken, çoğu zaman kendi yamanızı gönderirsiniz, bu nedenle ek olarak
"$SHA1'den $magic_timestamp" işaretçisine Gönderen: ve Tarih: satırlarını atlamanız gerekir.
yama dosyası. Yama başlığı muhtemelen tartışmanın konusundan farklı olacak
yama yanıt veriyor, bu nedenle Konuyu tutmak isteyebilirsiniz:
satır, yukarıdaki örnekte olduğu gibi.

Denetleme için yama rüşvet
Birçok e-posta, düzgün şekilde ayarlanmazsa boşlukları bozar. İşte iki yaygın tür
yolsuzluk:

· İçermeyen boş bağlam satırları herhangi Beyaz boşluk.

· Başında fazladan bir boşluk bulunan boş olmayan bağlam satırları.

MUA'nızın doğru kurulup kurulmadığını test etmenin bir yolu:

· Kime: ve Cc: satırları dışında yamayı kendinize tam olarak istediğiniz şekilde gönderin
listeyi ve bakımcı adresini içermeyen.

· Bu yamayı UNIX posta kutusu biçiminde bir dosyaya kaydedin. Bir.patch olarak adlandırın, söyleyin.

· Uygulayın:

$ git getir master:test-uygula
$ git ödeme testi-uygula
$ git sıfırlama -- zor
$ git bir.patch'im

Doğru uygulanmıyorsa bunun çeşitli nedenleri olabilir.

· Yamanın kendisi temiz bir şekilde uygulanmıyor. Yani kötü ama pek alakası yok
senin MUA'n. Yamayı yeniden temel almak isteyebilirsiniz git-rebase(1) yeniden oluşturmadan önce
bu durumda.

· MUA yamanızı bozdu; "am", yamanın uygulanmadığından şikayet ederdi. Bakmak
.git/rebase-apply/ alt dizininde ne olduğunu görün yama dosya içerir ve kontrol edin
yukarıda bahsedilen yaygın yolsuzluk kalıpları.

· Bu sırada, kontrol edin bilgi ve son taahhüt dosyaları da. içinde ne varsa son taahhüt
taahhüt günlüğü mesajında ​​tam olarak görmek isteyeceğiniz şey değil, büyük olasılıkla
alıcının, yamanızı uygularken günlük mesajını elle düzenlemeye son vereceğini.
Yama e-postasındaki "Merhaba, bu benim ilk yamam.\n" gibi şeyler
taahhüt mesajının sonunu gösteren üç çizgili çizgi.

MUA'YA ÖZEL İPUÇLARI

Yamaları çeşitli postalar kullanarak başarılı bir şekilde satır içi olarak nasıl göndereceğinize dair bazı ipuçları.

GMail
GMail'in web arayüzünde satır kaydırmayı kapatmanın herhangi bir yolu yoktur, bu nedenle
gönderdiğiniz e-postaları yönetin. Ancak "git send-email"i kullanabilir ve
GMail SMTP sunucusu aracılığıyla yamaları veya herhangi bir IMAP e-posta istemcisini kullanarak
google IMAP sunucusu ve e-postaları bunun üzerinden iletin.

Kullanım ipuçları için git eposta gönder Yamalarınızı GMail SMTP sunucusu aracılığıyla göndermek için, bkz.
ÖRNEK bölümü git-gönder-e-posta(1).

IMAP arayüzünü kullanarak gönderime ilişkin ipuçları için, bkz. ÖRNEK bölümü git-imap-
göndermek(1).

Thunderbird
Varsayılan olarak, Thunderbird hem e-postaları sarar hem de onları olduğu gibi işaretler. biçim=akışmış,
her ikisi de ortaya çıkan e-postayı Git tarafından kullanılamaz hale getirecektir.

Üç farklı yaklaşım vardır: satır sarmaları kapatmak için bir eklenti kullanın,
Yamaları karıştırmayacak veya Thunderbird'ü korumak için harici bir düzenleyici kullanmayacak
yamaları karıştırmak.

Yaklaşım #1 (Ayriyeten)
Şuradan edinilebilen Toggle Word Wrap eklentisini yükleyin
https://addons.mozilla.org/thunderbird/addon/toggle-word-wrap/ Bir menü girişi ekler
Bestecinin "Seçenekler" menüsünde işaretleyebileceğiniz "Kelime Sarmayı Etkinleştir". Şimdi yapabilirsin
mesajı başka türlü yaptığınız gibi oluşturun (kes + yapıştır, git biçim yama | git
imap-gönder, vb), ancak girdiğiniz herhangi bir metne manuel olarak satır sonları eklemeniz gerekir.
yazın.

Yaklaşım #2 (yapılandırma)
Üç adım:

1. Posta sunucusu kompozisyonunuzu düz metin olarak yapılandırın: Düzenle...Hesap
Ayarlar...Kompozisyon ve Adresleme, "Mesajları HTML'de Oluştur" seçeneğinin işaretini kaldırın.

2. Genel kompozisyon pencerenizi kaydırılmayacak şekilde yapılandırın.

Thunderbird 2: Edit..Preferences..Composition'da, düz metin mesajlarını 0'a sarın

Thunderbird 3'te: Edit..Preferences..Advanced..Config Editor. Aramak
"mail.wrap_long_lines". Yanlış olarak ayarlandığından emin olmak için değiştirin. Ayrıca, ara
"mailnews.wraplength" için ve değeri 0 olarak ayarlayın.

3. format=flowed kullanımını devre dışı bırakın: Edit..Preferences..Advanced..Config Editor.
"mailnews.send_plaintext_flowed" için arama yapın. olarak ayarlandığından emin olmak için değiştirin.
yanlış.

Bu yapıldıktan sonra, aksi halde yaptığınız gibi e-posta oluşturabilmeniz gerekir (kes +
yapıştırmak, git biçim yama | git imap-gönder, vb) ve yamalar karıştırılmayacaktır.

Yaklaşım #3 (harici editör)
Aşağıdaki Thunderbird uzantıları gereklidir: AboutConfig from
http://aboutconfig.mozdev.org/ ve Harici Editör
http://globs.org/articles.php?lng=tr&pg=8

1. Seçtiğiniz yöntemi kullanarak yamayı bir metin dosyası olarak hazırlayın.

2. Bir oluşturma penceresi açmadan önce, "Oluştur" seçeneğinin işaretini kaldırmak için Düzenle→Hesap Ayarları'nı kullanın.
"Kompozisyon ve Adresleme" panelindeki "HTML formatındaki mesajlar" ayarı
yamayı göndermek için kullanılacak hesap.

3. Thunderbird ana penceresinde, önce yama için oluşturma penceresini açarsınız,
aşağıdakileri belirtilen değerlere ayarlamak için Tools→about:config'i kullanın:

mailnews.send_plaintext_flowed => yanlış
mailnews.wraplength => 0

4. Bir oluşturma penceresi açın ve harici düzenleyici simgesine tıklayın.

5. Harici düzenleyici penceresinde yama dosyasını okuyun ve düzenleyiciden çıkın
normalde.

Yan not: 2. adımı about:config ve aşağıdakilerle yapmak mümkün olabilir
ayarlar ancak henüz kimse denemedi.

mail.html_compose => yanlış
mail.identity.default.compose_html => yanlış
mail.identity.id?.compose_html => yanlış

Contrib/thunderbird-patch-inline içinde, eklemenize yardımcı olabilecek bir komut dosyası var.
Thunderbird ile kolay bir şekilde yamalar. Kullanmak için yukarıdaki adımları uygulayın ve ardından
komut dosyasını harici düzenleyici olarak kullanın.

KMail
Bu, KMail kullanarak satır içi yamalar göndermenize yardımcı olacaktır.

1. Yamayı bir metin dosyası olarak hazırlayın.

2. Yeni Posta'ya tıklayın.

3. Besteci penceresinde "Seçenekler"in altına gidin ve "Kelime kaydırma"nın ayarlanmadığından emin olun.

4. Mesaj → Dosya ekle... seçeneğini kullanın ve yamayı ekleyin.

5. Oluştur penceresine dönün: mesaja istediğiniz diğer metni ekleyin, tamamlayın
adres ve konu alanlarını girin ve gönder tuşuna basın.

ÖRNEKLER

· R1 ve R2 revizyonları arasındaki taahhütleri çıkarın ve bunları mevcut revizyonun üzerine uygulayın
kullanarak şube git am onları seçmek için:

$ git format-patch -k --stdout R1..R2 | git am -3 -k

· Geçerli dalda bulunan ancak Origin dalında olmayan tüm taahhütleri çıkarın:

$ git format-yama kaynağı

Her bir taahhüt için geçerli dizinde ayrı bir dosya oluşturulur.

· Şuna yol açan tüm taahhütleri çıkarın köken projenin başlangıcından bu yana:

$ git format-patch --root orijini

· Bir öncekiyle aynı:

$ git format-patch -M -B kaynağı

Ek olarak, yeniden adlandırmaları algılar ve işler ve yeniden yazma işlemlerini akıllıca tamamlar.
bir yeniden adlandırma yaması oluşturun. Yeniden adlandırma yaması, metin çıktı miktarını azaltır ve
genellikle incelemeyi kolaylaştırır. Git dışı "yama" programlarının
yeniden adlandırma yamalarını anlayın, bu nedenle yalnızca alıcının Git'i
yamanızı uygulayın.

· Mevcut daldan en üstteki üç taahhütü çıkarın ve e-postayla gönderilebilir olarak biçimlendirin
yamalar:

$ git format-yama -3

onworks.net hizmetlerini kullanarak git-format-patch'i çevrimiçi kullanın