Guide de référence pour Debian

Équipe du guide de référence pour Debian <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

Ce manuel est un logiciel libre; vous pouvez le redistribuer et le modifier selon les termes de la Licence Publique Générale GNU telle que l'a publiée la Free Software Foundation (fondation pour le logiciel libre), soit selon la version2, soit (à votre choix) selon toute autre version ultérieure.

Il est distribué dans l'espoir qu'il sera utile, mais sans aucune garantie; sans même une garantie implicite de qualité loyale et marchande ni aptitude à un quelconque usage. Voyez la Licence Publique Générale GNU pour plus de détails.

Une copie de la Licence Publique Générale GNU est disponible dans /usr/share/common-licenses/GPL-2 dans la distribution Debian ou sur le World Wide Web sur le site Web de GNU. Vous pouvez aussi l'obtenir en écrivant à la Free Software Foundation, Inc., 51Franklin Street, Fifth Floor, Boston, MA02110-1301, USA.

Ceci est la version 13.15, publiée le 2024-11-04, du guide de référence du développeur pour Debian.

Si vous souhaitez imprimer ce guide, vous devriez utiliser la version PDF. Ce manuel est aussi disponible dans d'autres langues.

• 1. Portée de ce document
• 2. Candidater pour devenir membre du projet
  • 2.1. Entrée en matière
  • 2.2. Mentors et parrains Debian
  • 2.3. Enregistrement comme responsable Debian
• 3. Devoirs du développeur Debian
  • 3.1. Devoirs du responsable de paquet
    • 3.1.1. Œuvrer pour la prochaine publication stable
    • 3.1.2. Maintenance de paquets dans stable
    • 3.1.3. Gestion des bogues critiques pour la publication
    • 3.1.4. Coordination avec les développeurs amont
  • 3.2. Devoirs administratifs
    • 3.2.1. Mise à jour des renseignements auprès de Debian
    • 3.2.2. Gestion de clé publique
    • 3.2.3. Votes
    • 3.2.4. Départ en vacances poli
    • 3.2.5. Démission
    • 3.2.6. Revenir après démission
• 4. Ressources pour les membres de Debian
  • 4.1. Listes de diffusion
    • 4.1.1. Règles d'utilisation fondamentales
    • 4.1.2. Principales listes de diffusion pour les responsables
    • 4.1.3. Listes particulières
    • 4.1.4. Demander une nouvelle liste pour le développement
  • 4.2. Canaux IRC
  • 4.3. Documentation
  • 4.4. Serveurs Debian
    • 4.4.1. Serveur de suivi des bogues (BTS)
    • 4.4.2. Serveur FTP principal ftp-master
    • 4.4.3. Serveur web principal www-master
    • 4.4.4. Serveur web pour pages personnelles people
    • 4.4.5. salsa.debian.org : dépôts Git et plateforme de développement collaborative
    • 4.4.6. GitHub.com: Submitting pull requests to upstream repositories
    • 4.4.7. Chroots de différentes distributions
  • 4.5. Base de données des développeurs
  • 4.6. Archive Debian
    • 4.6.1. Sections
    • 4.6.2. Architectures
    • 4.6.3. Paquets
    • 4.6.4. Distributions
      • 4.6.4.1. Stable, testing, et unstable
      • 4.6.4.2. Informations complémentaires sur la distribution testing
      • 4.6.4.3. Experimental
    • 4.6.5. Noms de code des distributions
  • 4.7. Miroirs Debian
  • 4.8. Système « Incoming »
  • 4.9. Informations sur un paquet
    • 4.9.1. Sur le web
    • 4.9.2. Utilitaire dak ls
  • 4.10. Suivi de paquets Debian (Debian Package Tracker)
  • 4.11. Vue d'ensemble des paquets d'un développeur
  • 4.12. FusionForge pour Debian : Alioth
  • 4.13. Cadeaux pour les membres de Debian
• 5. Gestion des paquets
  • 5.1. Nouveaux paquets
  • 5.2. Enregistrement des modifications
  • 5.3. Tests du paquet
  • 5.4. Agencement du paquet source
  • 5.5. Choix de distribution
    • 5.5.1. Cas particulier : distributions stable et oldstable
    • 5.5.2. Cas particulier : la publication stable-updates
    • 5.5.3. Cas particulier : testing/testing-proposed-updates
  • 5.6. Envois de paquets
    • 5.6.1. Source and binary uploads
    • 5.6.2. Envois sur ftp-master
    • 5.6.3. Envois différés
    • 5.6.4. Envois de sécurité
    • 5.6.5. Les autres files d'envoi
    • 5.6.6. Notifications
  • 5.7. Section, sous-section et priorité de paquet
  • 5.8. Manipulation des bogues
    • 5.8.1. Supervision des bogues
    • 5.8.2. Réponses aux bogues
    • 5.8.3. Gestion des bogues
    • 5.8.4. Fermeture des rapports de bogue lors des mises à jour
    • 5.8.5. Gestion des bogues de sécurité
      • 5.8.5.1. Gestionnaire de sécurité Debian (« Debian Security Tracker »)
      • 5.8.5.2. Confidentialité
      • 5.8.5.3. Annonces de sécurité
      • 5.8.5.4. Préparation de paquets pour les problèmes de sécurité
      • 5.8.5.5. Mise à jour du paquet corrigé
  • 5.9. Manipulation de paquet dans l'archive
    • 5.9.1. Déplacement de paquet
    • 5.9.2. Suppression de paquet
      • 5.9.2.1. Suppression de paquet d'Incoming
    • 5.9.3. Remplacement et changement de nom de paquet
    • 5.9.4. Abandon de paquet
    • 5.9.5. Adoption de paquet
    • 5.9.6. Réintroduction de paquet
  • 5.10. Portage
    • 5.10.1. Courtoisie avec les porteurs
    • 5.10.2. Conseils aux porteurs pour les mises à jour
      • 5.10.2.1. Recompilation ou mise à jour indépendante binaire (binNMU)
      • 5.10.2.2. Quand utiliser une NMU source pour un portage
    • 5.10.3. Infrastructure de portage et automatisation
      • 5.10.3.1. Listes de diffusion et pages web
      • 5.10.3.2. Outils pour les porteurs
      • 5.10.3.3. wanna-build
    • 5.10.4. Paquet non portable
    • 5.10.5. Paquets non libres pouvant être automatiquement construits
  • 5.11. Mises à jour indépendantes (NMU)
    • 5.11.1. NMU : quand et comment
    • 5.11.2. NMU et debian/changelog
    • 5.11.3. Utilisation de la file d'attente DELAYED/
    • 5.11.4. NMU d'un point de vue du responsable
    • 5.11.5. Mise à jour indépendante source (NMU) vs binaire (binNMU)
    • 5.11.6. NMU et envoi de QA
    • 5.11.7. NMU et envoi d'équipe
  • 5.12. Sauvetage de paquets
    • 5.12.1. Quand un paquet devient-il éligible au sauvetage de paquet ?
    • 5.12.2. Comment sauver un paquet ?
  • 5.13. Maintenance collective
  • 5.14. La distribution testing
    • 5.14.1. Bases
    • 5.14.2. Mise à jour depuis unstable
      • 5.14.2.1. Désynchronisation
      • 5.14.2.2. Suppression de testing
      • 5.14.2.3. Dépendances circulaires
      • 5.14.2.4. Influence d'un paquet dans testing
      • 5.14.2.5. Détails
    • 5.14.3. Mises à jour directes dans testing
    • 5.14.4. Foire aux questions
      • 5.14.4.1. Quels sont les bogues bloquant l'intégration dans la version stable et comment sont-ils pris en compte ?
      • 5.14.4.2. Comment l'installation d'un paquet dans testing peut-elle casser d'autres paquets ?
  • 5.15. The Stable backports archive
    • 5.15.1. Bases
    • 5.15.2. Exception to the testing-first rule
    • 5.15.3. Who can maintain packages in the stable-backports archive?
    • 5.15.4. When can one start uploading to stable-backports?
    • 5.15.5. How long must a package be maintained when uploaded to stable-backports?
    • 5.15.6. How often shall one upload to stable-backports?
    • 5.15.7. How can one learn more about backporting?
• 6. Meilleures pratiques d'empaquetage
  • 6.1. Meilleures pratiques pour debian/rules
    • 6.1.1. Scripts d'assistance
    • 6.1.2. Séparation des correctifs (« patches ») en plusieurs fichiers
    • 6.1.3. Paquets binaires multiples
  • 6.2. Meilleures pratiques pour debian/control
    • 6.2.1. Conseils généraux pour les descriptions de paquets
    • 6.2.2. Résumé, ou description courte, d'un paquet
    • 6.2.3. Description longue
    • 6.2.4. Page d'accueil amont
    • 6.2.5. Emplacement du système de gestion de versions
      • 6.2.5.1. Vcs-Browser
      • 6.2.5.2. Vcs-*
  • 6.3. Meilleures pratiques pour debian/changelog
    • 6.3.1. Entrées de journalisation utiles
    • 6.3.2. Sélection de l’urgence du téléversement
    • 6.3.3. Idées reçues sur les entrées de journalisation
    • 6.3.4. Erreurs usuelles dans les entrées de journalisation
    • 6.3.5. Complément des journaux de modifications dans les fichiers NEWS.Debian
  • 6.4. Best practices around security
  • 6.5. Meilleures pratiques pour les scripts du responsable
  • 6.6. Gestion de la configuration avec debconf
    • 6.6.1. Proscrire les abus de debconf
    • 6.6.2. Recommandations générales pour les auteurs et les traducteurs
      • 6.6.2.1. Utilisation d'un anglais correct
      • 6.6.2.2. Courtoisie avec les traducteurs
      • 6.6.2.3. Correction (« unfuzzy ») des traductions pour des erreurs typographiques ou de frappe
      • 6.6.2.4. Proscrire toute supposition sur les interfaces utilisateurs
      • 6.6.2.5. Proscrire l'utilisation de la première personne
      • 6.6.2.6. Neutralité en genre
    • 6.6.3. Définition des champs de modèles (« templates »).
      • 6.6.3.1. Type
      • 6.6.3.2. Description : descriptions courte et étendue
      • 6.6.3.3. Choices
      • 6.6.3.4. Default
    • 6.6.4. Guide de style spécifique à certains champs de modèle
      • 6.6.4.1. Champ Type
      • 6.6.4.2. Champ Description
      • 6.6.4.3. Champ Choices
      • 6.6.4.4. Champ Default
  • 6.7. Internationalisation
    • 6.7.1. Gestion des traductions debconf
    • 6.7.2. Documentation internationalisée
  • 6.8. Situations courantes de gestion de paquets
    • 6.8.1. Paquets utilisant autoconf ou automake
    • 6.8.2. Bibliothèques
    • 6.8.3. Documentation
    • 6.8.4. Catégories particulières de paquets
    • 6.8.5. Données indépendantes de l'architecture
    • 6.8.6. Besoin de paramètres régionaux spécifiques lors de la construction
    • 6.8.7. Paquets de transition conformes à deborphan
    • 6.8.8. Meilleures pratiques pour les fichiers .orig.tar.{gz,bz2,xz}
      • 6.8.8.1. Source originelle (« pristine »)
      • 6.8.8.2. Source amont reconstruite
      • 6.8.8.3. Modification de fichier binaire
    • 6.8.9. Meilleures pratiques pour les paquets de débogage
      • 6.8.9.1. Paquets de débogage créés automatiquement
      • 6.8.9.2. Paquets -dbg manuels
    • 6.8.10. Meilleures pratiques pour les métapaquets
• 7. Au-delà de l'empaquetage
  • 7.1. Signalement de bogues
    • 7.1.1. Signalement d'un grand nombre de bogues en une fois (mass bug filing)
      • 7.1.1.1. Étiquettes d'utilisateur (Usertags)
  • 7.2. Effort d'assurance qualité
    • 7.2.1. Travail quotidien
    • 7.2.2. Chasses aux bogues
  • 7.3. Contact avec d'autres responsables
  • 7.4. Gestion des responsables non joignables
  • 7.5. Interaction avec de futurs développeurs Debian
    • 7.5.1. Parrainage de paquets
      • 7.5.1.1. Parrainage d'un nouveau paquet
      • 7.5.1.2. Parrainage de la mise à jour d'un paquet existant
    • 7.5.2. Granting upload permissions to DMs
    • 7.5.3. Recommandation d'un nouveau développeur
    • 7.5.4. Gestion des nouvelles candidatures
• 8. Internationalisation et traduction
  • 8.1. Gestion des traductions au sein de Debian
  • 8.2. FAQ I18N et L10N pour les responsables
    • 8.2.1. Comment faire en sorte qu'un texte soit traduit
    • 8.2.2. Comment faire en sorte qu'une traduction donnée soit relue
    • 8.2.3. Comment faire en sorte qu'une traduction donnée soit mise à jour
    • 8.2.4. Comment gérer un rapport de bogue concernant une traduction
  • 8.3. FAQ I18N et L10N pour les traducteurs
    • 8.3.1. Comment aider l'effort de traduction
    • 8.3.2. Comment fournir une traduction pour inclusion dans un paquet
  • 8.4. Meilleures pratiques actuelles concernant la l10n

Annexe

• 1. Aperçu des outils du responsable Debian
  • 1.1. Outils de base
    • 1.1.1. dpkg-dev
    • 1.1.2. debconf
    • 1.1.3. fakeroot
  • 1.2. Contrôle de paquets (« lint »)
    • 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. Assistance pour debian/rules
    • 1.3.1. debhelper
    • 1.3.2. dh-make
    • 1.3.3. equivs
  • 1.4. Construction de paquets
    • 1.4.1. git-buildpackage
    • 1.4.2. debootstrap
    • 1.4.3. pbuilder
    • 1.4.4. sbuild
  • 1.5. Envoi de paquets
    • 1.5.1. dupload
    • 1.5.2. dput
    • 1.5.3. dcut
  • 1.6. Automatisation de la maintenance
    • 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. Outils de portage
    • 1.7.1. dpkg-cross
  • 1.8. Documentation et 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