Yeni üstdüzey dağıtım (gerçekçi)

Paketleri Debian arşivi için hazırlarken, oluşan paketleri ayrıntılı bir şekilde kontrol etmelisiniz. Burada bunun daha gerçekçi bir örneği var:

Yeni üstdüzey kaynaktaki değişiklikleri doğrulayın:
- Yeni üstdüzey sürümün changelog, NEWS ve yeni sürümle birlikte dağıtılmış her ne başka belgelesi varsa okuyunuz.
- diff -urN'yi kullanarak eski ve yeni sürüm arasındaki değişikliklerin esas olarak nerelerde yapılmış olduğunu anlamaya çalışın ve ayrıca, şüpheli gördüğünüz herşeye bir göz atın.
Eski Debian paketini yenisine uyarlayın:
- Kaynak tar paketini açın ve kaynak ağacının kökünü <paketismi>-<üstdüzey_sürümü>/ olarak yeniden isimlendirin, cd ile dizinin içine girin.
- Sıkıştırılmış tar dosyasını üst dizine kopyalayın ve ismini <paketismi>_<üstdüzey_sürümü>.orig.tar.gz olarak değiştirin.
- Eski kaynak ağacına yaptığınız benzer değişiklikleri yeni kaynak ağacına da yapın. Olası yöntemler şunlar olabilir:
  - zcat /dosya/yolu/<paketismi>_<eski_sürüm>.diff.gz | patch -p1 komutu,
  - uupdate komutu,
  - Eğer kaynak kod yönetimi için bir Subversion deposunu kullanıyorsanız, svn merge komutu kullanın veya
  - eğer dpatch ile paketlendiyse basitçe eski kaynak kodundaki debian/ dizinini kopyalayın
- Eski changelog kayıtlarını koruyun (sesler geliyor... ama bazen kazalar olabiliyor...)
- Yeni paket sürümü, üstdüzey sürüm numarasına -1 Debian yayım numarası eklenmesiyle elde edilen yeni sürüm numarası olacaktır, örn., 0.9.13-1.
- debian/changelog dosyasının başına bu yeni sürümü "New Upstream Release" (Yeni üstdüzey dağıtım) şeklinde bir girdi olarak ekleyin. Örneğin, dch -v 0.9.13-1.
- Özlü bir şekilde, yeni sürümde bildirilmiş hataları gidermek üzere yaptığınız değişiklikleri açıklayın ve changelog dosyasında bu hataları kapatın.
- Özlü bir şekilde, yeni sürümde bildirilmiş hataları gidermek üzere üstdüzey geliştiricinin yaptığı değişiklikleri açıklayın ve changelog dosyasında bu hataları kapatın.
- Eğer yama/birleştir (patch/merge) temiz bir şekilde uygulanmazsa, neyin hatalı gitmiş olabileceğini araştırın (ipuçları .rej dosyalarındadır). Genellikle sorun, yaptığınız yamanın üstdüzey kodlara zaten uygulanmış olması nedeniye yamanın ilgisiz kalmasıdır.
- Yeni sürüme geçiş sessiz ve rahatsız etmeden olmalıdır (var olan kullanıcılar yeni sürüme geçişi, eski hataların düzeltildiğini ve yeni özelliklerinin eklendiğini farketmeleri dışında farketmemelidir).^[58]
- Eğer silinmiş şablon dosyaları herhangi bir nedenle eklemek ihtiyacı duyarsanız, dh_make komutunu -o seçeneği ile zaten debianlaşmış dizinde çalıştırıp daha sonra da bunları düzenleyiniz.
- Mevcut Debian değişiklikleri yeniden değerlendirilmelidir; aksini zorlayan nedenler olmadıkça üstdüzey sürümün (öyla ya da böyle) zaten sağladığı elemanları atın, yoksa onları saklamayı unutmayın.
- Eğer derleme sistemine özgü herhangi bir değişiklik yapıldıysa (bunu 1. adımdan bileceksiniz), debian/rules ve debian/control dosyalarını derleme bağımlılıkları açısından gerekliyse güncelleyin.
Yeni paketi debuild komutu veya pbuilder paketi bölümünde açıklandığı gibi derleyiniz. Bunun için pbuilder kullanımı da tercih edilebilir.
Yeni paketlerin olması gerektiği gibi derlendiğini doğrulayın:
- Paketin hatalara karşı denetimi bölümündekileri uygulayın.
- Paket yükseltiminin doğrulanması bölümündekileri uygulayın.
- Debian Hata İzleme Sisteminde hala açık olan fakat giderilmiş hatalar var mı diye tekrar kontrol edin.
- Paketin doğru dağıtıma gönderildiğinden, uygun hata kapatmalarının Closes: alanında listelendiğinden, Maintainer: ve Changed-By: alanlarının eşleştiğinden ve dosyanın GPG imzalı olduğundan, v.s. emin olmak için .changes dosyasının içeriğini kontrol edin.
Paketleme sırasında birşeyi düzeltmek için bir değişiklik yaparsanız, 2. adıma dönerek herşey aklınıza yatana kadar işlemleri tekrarlayın.
Eğer paketinizin sponsorlarca desteklenmesi gerekiyorsa, derleme aşamasında özel seçenekler kullanılması gerekliyse (dpkg-buildpackage -sa -v ... gibi) bunları not alın ve sponsorlarınızın paketi düzgün şekilde oluşturmaları için onları bilgilendirin.
Paketi arşive kendiniz gönderecekseniz, Paketin Debian'a gönderilmesi bölümünde açıklananları uygulayın.

^[58] Please make your package properly updates the config file upon upgrades using well designed postinst etc., so that it doesn't do things not wanted by the user! These are the enhancements that explain why people choose Debian. When the upgrade is necessarily intrusive (eg., config files scattered through various home directories with totally different structure), you may consider to set package to the safe default (e.g., disabled service) and provide proper documentations required by the policy (README.Debian and NEWS.Debian ) as the last resort. But don't bother with the debconf note.