Debian Entwicklerreferenz

Debian Entwicklerreferenz Team <developers-reference@packages.debian.org>

• Copyright © 2019 - 2023 Holger Levsen

• Copyright © 2015 - 2020 Hideki Yamane

• Copyright © 2008 - 2015 Lucas Nussbaum

• Copyright © 2004 - 2007 Andreas Barth

• Copyright © 2002 - 2009 Raphaël Hertzog

• Copyright © 1998 - 2003 Adam Di Carlo

• Copyright © 1997 - 1998 Christian Schwarz

Dieses Handbuch ist freie Software, sie können es nach den Bedingungen der GNU General Public License wie von der Free Software Foundation veröffentlicht, Version 2 oder (nach ihrer Option) später verteilen oder verändern .

Dies wird in der Hoffnung verteilt, dass es nützlich sein wird, jedoch ohne jegliche Garantie; ohne auch nur die implizite Garantie der Marktgängigkeit oder Eignung für einen bestimmten Zweck. Weitere Informationen finden Sie in der GNU General Public License.

Eine Kopie der GNU General Public License ist in der Debian Distribution abgelegt unter /usr/share/common-licenses/GPL-2 oder im WWW auf der GNU Webseite. Sie erhalten diese es auch schriftlich bei der Free Software Foundation, Inc., 51 Franklin Street, 5. Stock, Boston, MA 02110-1301, USA.

Dies ist die Debian Entwicklerreferenz Version 13.15, veröffentlicht am 2024-11-04.

Wenn Sie diese Referenz ausdrucken möchten, sollten Sie die PDF-Version als Basis verwenden. Dieses Handbuch ist auch in einigen anderen Sprachen verfügbar.

• 1. Geltungsbereich dieses Dokuments
• 2. Bewerbung auf eine Mitgliedschaft
  • 2.1. Erste Schritte
  • 2.2. Debian-Mentoren und -Sponsoren
  • 2.3. Registrierung als Debian Mitglied
• 3. Pflichten von Debian-Entwicklern
  • 3.1. Pflichten von Paketbetreuern
    • 3.1.1. Auf die nächste Stable-Veröffentlichung hinarbeiten
    • 3.1.2. Pakete in Stable betreuen
    • 3.1.3. Verwalten Release-kritischer Fehler
    • 3.1.4. Abstimmung mit Originalautoren
  • 3.2. Verwaltungspflichten
    • 3.2.1. Verwaltung Ihrer Debian-Informationen
    • 3.2.2. Verwalten Ihres öffentlichen Schlüssels
    • 3.2.3. Abstimmungen
    • 3.2.4. Elegant Urlaub machen
    • 3.2.5. Sich zurückziehen
    • 3.2.6. Nach dem Ausscheiden zurückkehren
• 4. Ressourcen für Debian Mitglieder
  • 4.1. Mailinglisten
    • 4.1.1. Grundregeln für die Benutzung
    • 4.1.2. Haupt-Entwickler-Mailinglisten
    • 4.1.3. Spezielle Listen
    • 4.1.4. Antrag auf neue entwicklungsbezogene Listen
  • 4.2. IRC-Kanäle
  • 4.3. Dokumentation
  • 4.4. Debian-Maschinen
    • 4.4.1. Der Bug-Tracking-Server
    • 4.4.2. Der FTP-Master-Server
    • 4.4.3. Der WWW-Master-Server
    • 4.4.4. Der people-Webserver
    • 4.4.5. salsa.debian.org: Git Repositorys und kollaborative Entwicklungsplattform
    • 4.4.6. GitHub.com: Senden von Pull-Anfragen an Upstream-Repositorys
    • 4.4.7. Chroots auf andere Distributionen
  • 4.5. Die Entwicklerdatenbank
  • 4.6. Das Debian-Archiv
    • 4.6.1. Bereiche
    • 4.6.2. Architekturen
    • 4.6.3. Pakete
    • 4.6.4. Distributionen
      • 4.6.4.1. Stable, testing und unstable
      • 4.6.4.2. Weitere Informationen über die Testing-Distribution
      • 4.6.4.3. Experimental
    • 4.6.5. Codenamen der Veröffentlichungen
  • 4.7. Debian-Spiegel
  • 4.8. Das Incoming-System
  • 4.9. Paketinformationen
    • 4.9.1. Im Web
    • 4.9.2. Das Hilfswerkzeug dak ls
  • 4.10. Das Debian-Paketverfolgungssystem
  • 4.11. Paketübersicht des Entwicklers
  • 4.12. Debians FusionForge-Installation: Alioth
  • 4.13. Goodies für Debian Mitglieder
• 5. Pakete verwalten
  • 5.1. Neue Pakete
  • 5.2. Änderungen im Paket aufzeichnen
  • 5.3. Das Paket testen
  • 5.4. Layout des Quellpakets
  • 5.5. Eine Distribution auswählen
    • 5.5.1. Sonderfall Uploads in die Distributionen Stable und Oldstable
    • 5.5.2. Sonderfall stable-updates Suite
    • 5.5.3. Sonderfall Uploads nach testing/testing-proposed-updates
  • 5.6. Ein Paket hochladen
    • 5.6.1. Source und Binär Uploads
    • 5.6.2. Hochladen nach ftp-master
    • 5.6.3. Verzögerte Uploads
    • 5.6.4. Sicherheits-Uploads
    • 5.6.5. Andere Upload-Warteschlangen
    • 5.6.6. Benachrichtigungen
  • 5.7. Angabe des Paketbereichs, des Unterbereichs und der Priorität
  • 5.8. Fehlerbehandlung
    • 5.8.1. Fehlerüberwachung
    • 5.8.2. Auf Fehler antworten
    • 5.8.3. Verwaltung von Fehlerberichten
    • 5.8.4. Wann Fehler durch neue Uploads geschlossen werden
    • 5.8.5. Handhabung von sicherheitsrelevanten Fehlern
      • 5.8.5.1. Debian Security Tracker
      • 5.8.5.2. Vertraulichkeit
      • 5.8.5.3. Sicherheitsankündigungen
      • 5.8.5.4. Pakete vorbereiten, um Sicherheitsthemen anzugehen
      • 5.8.5.5. Hochladen eines korrigierten Pakets
  • 5.9. Verschieben, Entfernen, Verwaisen, Adoptieren und Wiedereinführen von Paketen
    • 5.9.1. Pakete verschieben
    • 5.9.2. Pakete entfernen
      • 5.9.2.1. Entfernen von Paketen aus Incoming
    • 5.9.3. Umbenennen oder Ersetzen von Paketen
    • 5.9.4. Verwaisen von Paketen
    • 5.9.5. Adoption eines Pakets
    • 5.9.6. Wiedereinführen vom Paketen
  • 5.10. Portieren und portiert werden
    • 5.10.1. Seien Sie freundlich zu Portierern
    • 5.10.2. Leitlinien für Uploads von Portierern
      • 5.10.2.1. Neu kompilieren oder rein binärer NMU
      • 5.10.2.2. Wann Sie als Portierer ein Quell-NMU durchführen sollten
    • 5.10.3. Portierungs-Infrastruktur und -Automatisierung
      • 5.10.3.1. Mailinglisten und Web-Seiten
      • 5.10.3.2. Werkzeuge der Portierer
      • 5.10.3.3. wanna-build
    • 5.10.4. Wenn Ihr Paket nicht portierbar ist
    • 5.10.5. Unfreie Pakete als automatisch erstellbar kennzeichnen
  • 5.11. Non-Maintainer Uploads (NMUs)
    • 5.11.1. Wann und wie ein NMU durchgeführt wird
    • 5.11.2. NMUs und debian/changelog
    • 5.11.3. Benutzung der Warteschlange DELAYED/
    • 5.11.4. NMUs aus Sicht des Paketbetreuers
    • 5.11.5. Quell-NMUs gegenüber rein binären NMUs (binNMUs)
    • 5.11.6. NMUs gegenüber QS-Uploads
    • 5.11.7. NMUs gegenüber Team-Uploads
  • 5.12. Pakete bergen
    • 5.12.1. Wann es berechtigt ist, ein Paket zu bergen
    • 5.12.2. Wie man Pakete birgt
  • 5.13. Gemeinschaftliche Verwaltung
  • 5.14. Die Distribution Testing
    • 5.14.1. Grundlagen
    • 5.14.2. Aktualisierungen von Unstable
      • 5.14.2.1. Veraltet
      • 5.14.2.2. Entfernen aus Testing
      • 5.14.2.3. Zirkulare Abhängigkeiten
      • 5.14.2.4. Beeinflussen eines Pakets in Testing
      • 5.14.2.5. Einzelheiten
    • 5.14.3. Direkte Aktualisierungen für Testing
    • 5.14.4. Häufig gestellte Fragen
      • 5.14.4.1. Was sind veröffentlichungskritische Fehler und wie werden diese gezählt?
      • 5.14.4.2. Wie kann das Installieren eines Pakets in Testing andere Pakete möglicherweise beschädigen?
  • 5.15. Das Archive von Stable Backports
    • 5.15.1. Grundlagen
    • 5.15.2. Ausnahmen von der erst-testing Regel
    • 5.15.3. Wer kann Pakete im Stable-Backports Archiv verwalten?
    • 5.15.4. Wann kann man damit beginnen Pakete nach stable-backports hoch zu laden?
    • 5.15.5. Wie lange muss ein Paket betreut werden wenn es nach stable-backports geladen worden ist?
    • 5.15.6. Wie oft sollte man ein Paket nach stable-backport hochladen?
    • 5.15.7. Wie kann man mehr über das Zurückportieren erfahren?
• 6. Optimale Vorgehensweise beim Paketieren
  • 6.1. Optimale Vorgehensweisen für debian/rules
    • 6.1.1. Helferskripte
    • 6.1.2. Unterteilen Sie Ihre Patches in mehrere Dateien
    • 6.1.3. Pakete mit mehreren Binärdateien
  • 6.2. Optimale Vorgehensweisen für debian/control
    • 6.2.1. Allgemeine Leitlinien für Paketbeschreibungen
    • 6.2.2. Die Paketübersicht oder Kurzbeschreibung
    • 6.2.3. Die ausführliche Beschreibung
    • 6.2.4. Homepage der Originalautoren
    • 6.2.5. Ort des Versionsverwaltungssystems
      • 6.2.5.1. Vcs-Browser
      • 6.2.5.2. Vcs-*
  • 6.3. Optimale Vorgehensweisen für debian/changelog
    • 6.3.1. Verfassen nützlicher Änderungsprotokolleinträge
    • 6.3.2. Auswahl Dringlichkeit des Uploads
    • 6.3.3. Häufige Missverständnisse über Änderungsprotokolleinträge
    • 6.3.4. Häufige Fehler in Änderungsprotokolleinträgen
    • 6.3.5. Änderungsprotokolle mit NEWS.Debian-Dateien ergänzen
  • 6.4. Optimale Vorgehensweisen rund um Sicherheit
  • 6.5. Optimale Vorgehensweisen für Betreuerskripte
  • 6.6. Konfigurationsverwaltung mit debconf
    • 6.6.1. Missbrauchen Sie debconf nicht
    • 6.6.2. Allgemeine Empfehlungen für Autoren und Übersetzer
      • 6.6.2.1. Schreiben Sie korrektes Englisch
      • 6.6.2.2. Seien Sie freundlich zu Übersetzern
      • 6.6.2.3. Entfernen Sie die fuzzy-Markierungen in vollständigen Übersetzungen, wenn Sie Tipp- und Rechtschreibfehler korrigieren
      • 6.6.2.4. Treffen Sie keine Annahmen über Schnittstellen
      • 6.6.2.5. Reden Sie nicht in der ersten Person
      • 6.6.2.6. Formulieren Sie geschlechtsneutral
    • 6.6.3. Definition von Vorlagenfeldern
      • 6.6.3.1. Typen
      • 6.6.3.2. Description: Kurze und erweiterte Beschreibung
      • 6.6.3.3. Choices
      • 6.6.3.4. Default
    • 6.6.4. Gestaltungsrichtlinie für Vorlagenfelder
      • 6.6.4.1. Feld "Type"
      • 6.6.4.2. Feld "Description"
      • 6.6.4.3. Das Feld "Choices"
      • 6.6.4.4. Das Feld "Default"
  • 6.7. Internationalisierung
    • 6.7.1. Handhabung von Debconf-Übersetzungen
    • 6.7.2. Internationalisierte Dokumentation
  • 6.8. Häufig vorkommende Paketierungssituationen
    • 6.8.1. Pakete benutzen autoconf/automake
    • 6.8.2. Bibliotheken
    • 6.8.3. Dokumentation
    • 6.8.4. Besondere Pakettypen
    • 6.8.5. Architekturunabhängige Daten
    • 6.8.6. Eine bestimmte Locale wird während des Paketbaus benötigt
    • 6.8.7. Machen Sie Übergangspakete deborphan-konform
    • 6.8.8. Optimale Vorgehensweisen für .orig.tar.{gz,bz2,xz}-Dateien
      • 6.8.8.1. Unberührter Quellcode
      • 6.8.8.2. Neu paketierter Originalquellcode
      • 6.8.8.3. Ändern binärer Dateien
    • 6.8.9. Optimale Vorgehensweisen für Debug-Pakete
      • 6.8.9.1. Automatisch erstellte Debug-Pakete
      • 6.8.9.2. Manuelle -dbg Pakete
    • 6.8.10. Optimale Vorgehensweisen für Meta-Pakete
• 7. Jenseits von Paketierung
  • 7.1. Fehler berichten
    • 7.1.1. Viele Fehler auf einmal berichten (Masseneinreichung von Fehlern)
      • 7.1.1.1. Usertags
  • 7.2. Qualitätssicherungsbestreben
    • 7.2.1. Tägliche Arbeit
    • 7.2.2. Treffen zur gemeinschaftlichen Behebung von Fehlern (Bug-Squashing-Partys)
  • 7.3. Andere Paketbetreuer kontaktieren
  • 7.4. Sich mit inaktiven und/oder nicht erreichbaren Paketbetreuern beschäftigen
  • 7.5. Zusammenwirken mit zukünftigen Debian-Entwicklern
    • 7.5.1. Pakete sponsern
      • 7.5.1.1. Ein neues Paket sponsern
      • 7.5.1.2. Eine Aktualisierung eines existierenden Pakets sponsern
    • 7.5.2. Einrichten von Uploadberechtigungen für DM
    • 7.5.3. Neue Entwickler befürworten
    • 7.5.4. Handhabung von Bewerbungen neuer Betreuer
• 8. Internationalisierung und Übersetzungen
  • 8.1. Wie Übersetzungen in Debian gehandhabt werden
  • 8.2. I18N & L10N FAQ für Paketbetreuer
    • 8.2.1. Wie ein vorliegender Text übersetzt wird
    • 8.2.2. Wie eine vorliegende Übersetzung überprüft wird
    • 8.2.3. Wie eine vorliegende Übersetzung aktualisiert wird
    • 8.2.4. Wie Fehlerberichte gehandhabt werden, die eine Übersetzung betreffen
  • 8.3. I18n- & L10n-FAQ für Übersetzer
    • 8.3.1. Wie man bei Übersetzungsbemühungen helfen kann
    • 8.3.2. Wie eine Übersetzung zur Eingliederung in ein Paket bereitgestellt wird
  • 8.4. Beste aktuelle Vorgehensweise bezüglich L10n

Appendix

• 1. Überblick über die Werkzeuge der Debian-Betreuer
  • 1.1. Hauptwerkzeuge
    • 1.1.1. dpkg-dev
    • 1.1.2. debconf
    • 1.1.3. fakeroot
  • 1.2. Lint-Werkzeuge für Pakete
    • 1.2.1. lintian
    • 1.2.2. lintian-brush
    • 1.2.3. piuparts
    • 1.2.4. debdiff
    • 1.2.5. diffoscope
    • 1.2.6. duck
    • 1.2.7. adequate
    • 1.2.8. i18nspector
    • 1.2.9. cme
    • 1.2.10. licensecheck
    • 1.2.11. blhc
  • 1.3. Helferskripte für debian/rules
    • 1.3.1. debhelper
    • 1.3.2. dh-make
    • 1.3.3. equivs
  • 1.4. Werkzeuge zum Paketbau
    • 1.4.1. git-buildpackage
    • 1.4.2. debootstrap
    • 1.4.3. pbuilder
    • 1.4.4. sbuild
  • 1.5. Programme zum Hochladen von Paketen
    • 1.5.1. dupload
    • 1.5.2. dput
    • 1.5.3. dcut
  • 1.6. Automatisierung der Verwaltungsaufgaben
    • 1.6.1. devscripts
    • 1.6.2. reportbug
    • 1.6.3. autotools-dev
    • 1.6.4. dpkg-repack
    • 1.6.5. alien
    • 1.6.6. dpkg-dev-el
    • 1.6.7. dpkg-depcheck
    • 1.6.8. debputy
  • 1.7. Portierungswerkzeuge
    • 1.7.1. dpkg-cross
  • 1.8. Dokumentation und Information
    • 1.8.1. debian-policy
    • 1.8.2. doc-debian
    • 1.8.3. developers-reference
    • 1.8.4. maint-guide
    • 1.8.5. debmake-doc
    • 1.8.6. packaging-tutorial
    • 1.8.7. how-can-i-help
    • 1.8.8. docbook-xml
    • 1.8.9. debiandoc-sgml
    • 1.8.10. debian-keyring
    • 1.8.11. debian-el