Podręcznik deweloperów Debiana

Prawa autorskie

copyright © 1998—2003 Adam Di Carlo
copyright © 2002—2003 Raphaël Hertzog
copyright © 1997, 1998 Christian Schwarz

Niniejszy podręcznik jest wolnym oprogramowaniem; możesz go rozpowszechniać i/lub modyfikować na warunkach Powszechnej Licencji Publicznej GNU wydanej przez Fundację Wolnego Oprogramowania - według wersji 2-giej tej Licencji lub którejś z późniejszych.

Podręcznik ten rozpowszechniany jest z nadzieją, iż będzie on użyteczny, jednak bez jakiejkolwiek gwarancji; nawet domyślnej gwarancji przydatności handlowej lub przydatności do określonych zastosowań. W celu uzyskania bliższych informacji - patrz Powszechna Licencja Publiczna GNU.

Kopia Powszechnej Licencji Publicznej GNU dostępna jest jako /usr/share/common-licenses/GPL w dystrybucji Debian GNU/Linux lub w Internecie na stronie GNU. Możesz otrzymać ją także pisząc na adres Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Polskie tłumaczenie ukazało się nakładem sił następujących osób z projektu PDDP:

• Kalina Detko

• Bartosz Feński

• Radosław Grzanka

• Marcin Kuras

• Tomasz Z. Napierała

• Oskar Ostafin

• Jacek Politowski

• Sławomir Siejka

• Artur Szymański

• Piotr Złocki

Tłumaczenie dostępne jest na tych samych zasadach co oryginał.

Spis treści

• 1 Zawartość tego dokumentu
• 2 Zgłoszenie chęci zostania Opiekunem Debiana
• 2.1 Jak zacząć?
• 2.2 Rejestrowanie się jako rozwijający Debiana.
• 2.3 Mentorzy i sponsorzy Debiana
• 3 Obowiązki dewelopera Debiana
• 3.1 Opieka nad swoimi informacjami
• 3.2 Opieka nad swoimi kluczami
• 3.3 Głosowanie
• 3.4 Krótka przerwa deweloperów
• 3.5 Koordynacja prac z zewnętrznymi deweloperami
• 3.6 Opieka nad błędami krytycznymi dla wydania
• 3.7 Rezygnacja
• 4 Zasoby dla deweloperów Debiana
• 4.1 Listy dyskusyjne
• 4.1.1 Podstawowe zasady używania
• 4.1.2 Główne listy dyskusyjne deweloperów
• 4.1.3 Listy specjalne
• 4.1.4 Prośba o nową listę dla deweloperów
• 4.2 Kanały IRC
• 4.3 Dokumentacja
• 4.4 Maszyny Debiana
• 4.4.1 Serwer błędów
• 4.4.2 Serwer ftp-master
• 4.4.3 Serwer non-US
• 4.4.4 Serwer www-master
• 4.4.5 Serwer ,,ludzie Debiana''
• 4.4.6 Serwer CVS
• 4.5 Baza danych deweloperów
• 4.6 Archiwum Debiana
• 4.6.1 Sekcje
• 4.6.2 Architektury
• 4.6.3 Pakiety
• 4.6.4 Dystrybucje
• 4.6.5 Nazwy kodowe dystrybucji Debiana
• 4.7 Serwery lustrzane Debiana
• 4.8 System Incoming
• 4.8.1 Odraczanie pakietów przychodzących
• 4.9 Informacje dotyczące pakietów
• 4.9.1 Strony internetowe
• 4.9.2 Narzędzie madison
• 4.10 System Śledzienia Pakietów
• 4.10.1 Interfejs pocztowy systemu PTS
• 4.10.2 Filtrowanie listów PTS
• 4.10.3 Przekazywanie potwierdzeń CVS w PTS
• 4.10.4 Interfejs WWW do PTS
• 4.11 Przegląd pakietów deweloperów
• 4.12 Debian *Forge: Alioth
• 5 Zarządzanie pakietami
• 5.1 Nowe pakiety
• 5.2 Zapisywanie zmian w pakiecie
• 5.3 Testowanie pakietu
• 5.4 Wygląd pakietu źródłowego
• 5.5 Dobieranie dystrybucji
• 5.5.1 Przypadek specjalny: umieszczanie w stable
• 5.5.2 Przypadek specjalny: umieszczanie w dystrybucji testing-proposed-updates
• 5.6 Umieszczanie pakietów w archiwum
• 5.6.1 Przesyłanie do ftp-master
• 5.6.2 Przesyłanie do non-US
• 5.6.3 Przesyłanie przez chiark
• 5.6.4 Przesyłanie przez erlangen
• 5.6.5 Inne kolejki przesyłania
• 5.6.6 Informacja o zainstalowaniu nowego pakietu
• 5.7 Wybieranie sekcji i priorytetu pakietu.
• 5.8 Obsługa błędów
• 5.8.1 Monitorowanie błędów
• 5.8.2 Odpowiadanie na błędy
• 5.8.3 Gospodarowanie błędami
• 5.8.4 Kiedy błąd jest zamykany przez nowy przesył
• 5.8.5 Obsługa błędów związanych z bezpieczeńswtem
• 5.9 Przenoszenie, zmiana nazwy, adopcja i osierocanie pakietów
• 5.9.1 Przenoszenie pakietów
• 5.9.2 Usuwanie pakietów
• 5.9.3 Podmiana lub zmiana nazwy pakietów
• 5.9.4 Osierocanie pakietu
• 5.9.5 Adopcja pakietu
• 5.10 Przenoszenie na inne architektury
• 5.10.1 Ułatwianie pracy portującym
• 5.10.2 Wskazówki dla przesyłania portów
• 5.10.3 Infrastruktura portów i automatyzacja
• 5.11 Przesyłanie pakietów przez nieoficjalnego opiekuna (Non-Maintainer Uploads (NMU))
• 5.11.1 Terminologia
• 5.11.2 Kto może wykonać NMU
• 5.11.3 Kiedy robić NMU źródłowe
• 5.11.4 Jak zrobić NMU źródłowe
• 5.11.5 Potwierdzanie NMU
• 5.12 Współpraca nad pakietami
• 6 Najlepsze metody pakietowania
• 6.1 Najlepsze zwyczaje dla debian/rules
• 6.1.1 Skrypty pomocnicze
• 6.1.2 Rozdzielanie łatek na wiele plików
• 6.1.3 Pakiety z wieloma binariami
• 6.2 Najlepsze zwyczaje dla debian/control
• 6.2.1 Ogólne zalecenia dotyczące opisów pakietów
• 6.2.2 Streszczenie, krótki opis pakietu
• 6.2.3 Długi opis
• 6.2.4 Zewnętrzna strona domowa
• 6.3 Najlepsze zwyczaje dla debian/changelog
• 6.3.1 Tworzenie użytecznych wpisów changelog
• 6.3.2 Główne błędy związane z wpisami w changelogu
• 6.3.3 Powszechne błędy we wpisach changeloga
• 6.4 Najlepsze zwyczaje dla skryptów opiekuna
• 6.5 Zarządzanie konfiguracją z użyciem debconf
• 6.6 Umiędzynarodowienie
• 6.6.1 Obsługa tłumaczeń debconf
• 6.6.2 Międzynarodowa dokumentacja
• 6.7 Sytuacje powszechne przy tworzeniu pakietów
• 6.7.1 Pakiety używające autoconf/automake
• 6.7.2 Biblioteki
• 6.7.3 Dokumentacja
• 6.7.4 Specyficzne typy pakietów
• 6.7.5 Dane niezależne od architektury
• 7 Prace poza tworzeniem pakietów
• 7.1 Zgłaszanie błędów
• 7.1.1 Zgłaszanie wielu błędów na raz
• 7.2 Zapewnienie Jakości
• 7.2.1 Praca codzienna
• 7.2.2 Imprezy znajdowania błędów
• 7.3 Kontaktowanie się z innymi opiekunami
• 7.4 Postępowanie z nieaktywnymi i/lub nieosiągalnymi opiekunami
• 7.5 Interakcja z przyszłymi deweloperami Debiana
• 7.5.1 Sponsorowanie pakietów
• 7.5.2 Utrzymywanie sponsorowanych pakietów
• 7.5.3 Popieranie nowych deweloperów
• 7.5.4 Obsługa podań nowych opiekunów
• A Przegląd narzędzi opiekuna Debiana
• A.1 Podstawowe narzędzia
• A.1.1 dpkg-dev
• A.1.2 debconf
• A.1.3 fakeroot
• A.2 Narzędzia lintujące pakiety
• A.2.1 lintian
• A.2.2 linda
• A.2.3 debdiff
• A.3 Narzędzia pomocnicze dla debian/rules
• A.3.1 debhelper
• A.3.2 debmake
• A.3.3 dh-make
• A.3.4 yada
• A.3.5 equivs
• A.4 Narzędzia do budowania pakietów
• A.4.1 cvs-buildpackage
• A.4.2 debootstrap
• A.4.3 pbuilder
• A.4.4 sbuild
• A.5 Narzędzia do przesyłania pakietów
• A.5.1 dupload
• A.5.2 dput
• A.6 Automatyzacja zarządzania pakietami
• A.6.1 devscripts
• A.6.2 autotools-dev
• A.6.3 dpkg-repack
• A.6.4 alien
• A.6.5 debsums
• A.6.6 dpkg-dev-el
• A.6.7 dpkg-depcheck
• A.7 Narzędzia do przenoszenia pakietów na inne architektury
• A.7.1 quinn-diff
• A.7.2 dpkg-cross
• A.8 Dokumentacja i informacja
• A.8.1 debiandoc-sgml
• A.8.2 debian-keyring
• A.8.3 debview

Podręcznik deweloperów Debiana