<!DOCTYPE debiandoc PUBLIC "-//DebianDoc//DTD DebianDoc//EN" [
<!-- include version information so we don't have to hard code it
within the document -->
- <!entity % versiondata SYSTEM "version.ent"> %versiondata;
+ <!ENTITY % versiondata SYSTEM "version.ent"> %versiondata;
<!-- common, language independant entities -->
- <!entity % commondata SYSTEM "common.ent" > %commondata;
- <!-- CVS revision of this document -->
- <!entity cvs-rev "$Revision: 1.11 $">
+ <!ENTITY % commondata SYSTEM "common.ent" > %commondata;
- <!-- if you are translating this document, please notate the RCS
+ <!-- CVS revision of this document -->
+ <!ENTITY cvs-rev "$Revision: 1.38 $">
+ <!-- if you are translating this document, please notate the CVS
revision of the developers reference here -->
<!--
- <!entity cvs-en-rev "1.63">
+ <!ENTITY cvs-en-rev "1.216">
-->
-]>
-<debiandoc>
-<!--
- TODO:
- - bugs in upstream versions should be reported upstream!
- - add information on how to get accounts on different architectures
- - talk about CVS access, other ways to submit problems
- - add information on how you can contribute w/o being an official
- developer
- - "official port maintainer" ? (cf. glibc-pre2.1)
- -->
-
-<book>
-<title>Manuel de référence du développeur Debian
+ <!-- how to mark a section that needs more work -->
+ <!ENTITY FIXME "<em>FIXME:</em> ">
-<author>Adam Di Carlo, responsable actuel <email>aph@debian.org</email>
-<author>Christian Schwarz <email>schwarz@debian.org</email>
-<author>Ian Jackson <email>ijackson@gnu.ai.mit.edu</email>
-<author>
-<author>version française par Antoine Hulin <email>antoine.hulin@origan.fdn.fr</email>
-<author>avec la participation de Alain Meessen
-<author>et des membres de la liste
-<email>debian-l10n-french@lists.debian.org</email>
-<version>version &version;, &date-fr;
+]>
+<debiandoc>
-<copyright>
+ <book>
+ <title>Référence du développeur Debian
-<copyrightsummary>
- Copyright ©1998 – 2001 Adam Di Carlo</copyrightsummary>
-<copyrightsummary>
-Copyright ©1997, 1998 Christian Schwarz.</copyrightsummary>
+ <author>L'équipe de la Référence du développeur &email-devel-ref;
+ <author>Adam Di Carlo, éditeur
+ <author>Raphaël Hertzog
+ <author>Christian Schwarz
+ <author>Ian Jackson
+ <author>
+ <translator>version française par Antoine Hulin</translator>
+ <translator>et Frédéric Bothamy (traducteur actuel)</translator>
+ <translator>et les membres de la liste <email>debian-l10n-french@lists.debian.org</email></translator>
+ <version>Version &version;, &date-fr; (version française 20030718).</version>
+ <copyright>
+ <copyrightsummary>Copyright © 1998—2003 Adam Di Carlo</copyrightsummary>
+ <copyrightsummary>Copyright © 2002—2003 Raphaël Hertzog</copyrightsummary>
+ <copyrightsummary>Copyright © 1997, 1998 Christian Schwarz.</copyrightsummary>
<p>
-Ce manuel est un logiciel libre ; il peut être redistribué et/ou modifié selon
-les termes de la licence grand public du projet GNU (GNU GPL), telle que
-publiée par la « Free Software Foundation » (version 2 ou toute
-version supérieure).
+Ce manuel est un logiciel libre ; il peut être redistribué et/ou modifié
+selon les termes de la licence publique générale du projet GNU (GNU GPL), telle
+que publiée par la « Free Software Foundation » (version 2 ou toute
+version postérieure).
<p>
Il est distribué dans l'espoir qu'il sera utile, mais <em>sans aucune
garantie</em>, sans même la garantie implicite d'une possible valeur marchande
-ou d'une adéquation à un besoin particulier. Consultez la licence grand public
-du projet GNU pour plus de détails.
-
-<p>
-Une copie de la licence grand public du projet GNU est disponible dans le
-fichier &file-GPL; de la distribution Debian GNU-Linux ou sur la toile : <url
-id="&url-gpl" name="la licence grand public du projet GNU">. Vous pouvez
-également l'obtenir en écrivant à la &fsf-addr;.
-
-
+ou d'une adéquation à un besoin particulier. Consultez la licence publique
+générale du projet GNU pour plus de détails.
+<p>Une copie de la licence publique générale du projet GNU est disponible dans
+le fichier &file-GPL; de la distribution &debian-formal; ou sur la toile :
+<url id="&url-gpl" name="la licence publique générale du projet GNU">. Vous
+pouvez également l'obtenir en écrivant à la &fsf-addr;.
- <toc detail="sect2">
+ <toc detail="sect1">
-
-
-
- <chapt id="scope">Introduction
-
- <sect>Portée de ce document
+ <chapt id="scope">Portée de ce document
<p>
-Le but de ce document est de donner une vue d'ensemble des procédures à
-suivre et des ressources mises à la disposition des développeurs Debian.
+Le but de ce document est de donner une vue d'ensemble des procédures à suivre
+et des ressources mises à la disposition des développeurs Debian.
+<!-- FIXME: rewrites -->
<p>
-Les procédures décrites ci-après expliquent entre autre comment devenir
-responsable Debian (<ref id="new-maintainer">), comment installer des nouveaux
-paquets dans l'archive (<ref id="upload">), quand et comment faire un portage
-ou une mise à jour du paquet d'un autre responsable (<ref id="nmu">), comment
-déplacer, effacer ou abandonner un paquet (<ref id="archive-manip">) et
-comment gérer les bogues (<ref id="bug-handling">).
+Les procédures décrites ci-après expliquent comment devenir responsable Debian
+(<ref id="new-maintainer">), comment créer de nouveaux paquets (<ref
+id="newpackage">) et comment les installer dans l'archive (<ref id="upload">),
+comment gérer les rapports de bogues (<ref id="bug-handling">), comment
+déplacer, effacer ou abandonner un paquet (<ref id="archive-manip">), comment
+faire le portage d'un paquet (<ref id="porting">), quand et comment faire la
+mise à jour du paquet d'un autre responsable (<ref id="nmu">).
<p>
-Les ressources présentées dans ce manuel incluent les listes de diffusion et
-les serveurs (<ref id="servers">), une présentation de la structure de
-l'archive Debian (<ref id="archive">), des explications sur les serveurs qui
-acceptent les mises à jour de paquets (<ref id="upload-ftp-master">) et une
-présentation des outils qui peuvent aider un responsable à améliorer la
-qualité de ses paquets (<ref id="tools">).
+Les ressources présentées dans ce manuel incluent les listes de diffusion (<ref
+id="mailing-lists">) et les serveurs (<ref id="server-machines">), une
+présentation de la structure de l'archive Debian (<ref id="archive">), des
+explications sur les serveurs qui acceptent les mises à jour de paquets (<ref
+id="upload-ftp-master">) et une présentation des outils qui peuvent aider un
+responsable à améliorer la qualité de ses paquets (<ref id="tools">).
<p>
Ce manuel de référence ne présente pas les aspects techniques liés aux paquets
-Debian. Il ne décrit pas non plus comment les créer. Il ne décrit pas
-non plus les règles que doivent respecter les paquets Debian. Cette
-information est disponible dans le <url id="&url-debian-policy;" name="Debian
-Policy Manual">.
+Debian, ni comment les créer. Il ne décrit pas non plus les règles que doivent
+respecter les paquets Debian. Cette information est disponible dans la <url
+id="&url-debian-policy;" name="charte Debian">.
<p>
-De plus ce document <em>n'est pas l'expression d'une politique
-officielle</em>. Il contient de la documentation sur le système Debian et des
-conseils pratiques largement suivis. C'est une sorte de guide pratique.
-
-
-
-
+De plus ce document <em>n'est pas l'expression d'une politique officielle</em>.
+Il contient de la documentation sur le système Debian et des conseils pratiques
+largement suivis. C'est une sorte de guide pratique.
<sect>Introduction à la version française
<sect1>Avertissement
<p>
-Bien que ce document soit en français, l'activité de responsable Debian
-implique une maîtrise de la langue anglaise. Le projet Debian est un projet
-international auquel participent des japonais, néo-zélandais, américains,
-allemands, finlandais, français, espagnols, danois...
+Bien que ce document soit en français, l'activité de responsable Debian implique
+une maîtrise de la langue anglaise. Le projet Debian est un projet international
+auquel participent des japonais, néo-zélandais, américains, allemands,
+finlandais, français, espagnols, danois, etc.
<p>
-En conséquence la langue utilisée dans toutes les listes de diffusion
-destinées aux développeurs est l'anglais et les rapports de bogue doivent être
-rédigés en anglais. En fait, sauf exception rare, tout dialogue avec les
-autres responsables Debian se fera en anglais quelque soit le média.
+En conséquence, la langue utilisée dans toutes les listes de diffusion destinées
+aux développeurs (à l'exception de la liste
+<email>debian-devel-french@&lists-host;</email>) est l'anglais et les rapports
+de bogue doivent être rédigés en anglais. En fait, sauf exception rare, tout
+dialogue avec les autres responsables Debian se fera en anglais quel que soit le
+média.
<sect1>Glossaire
<p>
-Cette section liste les termes techniques qui ont un sens spécifique
-dans le projet Debian. Pour chacune de ces expressions vous trouverez la
-traduction française utilisée dans ce manuel, une définition et une
-référence à la section du manuel qui traite de ce sujet.
+Cette section liste les termes techniques qui ont un sens spécifique dans le
+projet Debian. Pour chacune de ces expressions, vous trouverez la traduction
+française utilisée dans ce manuel, une définition et une référence à la section
+du manuel qui traite de ce sujet.
- <list>
+<list>
<item><em>Upload</em> : mise à jour, téléchargement (parfois
- livraison). Opération qui consiste à télécharger un nouveau paquet
- ou une nouvelle version de paquet dans l'archive Debian (<ref
+ livraison). Opération qui consiste à télécharger un nouveau paquet ou
+ une nouvelle version de paquet dans l'archive Debian (<ref
id="upload">).
- <item><em>Non-maintainer upload (NMU)</em> : mise à jour indépendante.
- Téléchargement d'une nouvelle version de paquet dans l'archive
- Debian par une personne qui n'est pas officiellement responsable de ce
- paquet(<ref id="nmu">).
+ <item><em>Non-maintainer upload (NMU)</em> : mise à jour
+ indépendante. Téléchargement d'une nouvelle version de paquet dans
+ l'archive Debian par une personne qui n'est pas officiellement
+ responsable de ce paquet (<ref id="nmu">).
- <item><em>NMU source</em> : mise à jour indépendante source. Il
+ <item><em>Source NMU</em> : mise à jour indépendante source. Il
s'agit d'une mise à jour indépendante pour un paquet source (<ref
id="nmu-terms">).
- <item><em>NMU binaire</em> : mise à jour indépendante binaire.
- Mise à jour indépendante pour un paquet binaire(<ref id="nmu-terms">).
+ <item><em>Binary NMU</em> : mise à jour indépendante binaire. Mise
+ à jour indépendante pour un paquet binaire (<ref id="nmu-terms">).
<item><em>Bug Tracking System (BTS)</em> : système de suivi des
bogues. Il s'agit du système utilisé par le projet Debian pour suivre
les bogues et leur correction (<ref id="bug-handling">).
<item><em>Bug submitter</em> : rapporteur du bogue. Personne qui
- envoie un rapport de bogue au système de suivi des bogues(<ref
+ envoie un rapport de bogue au système de suivi des bogues (<ref
id="submit-bug">).
- <item><em>Release critical bug</em> : bogue remettant en cause la
- distribution. Bogues de sévérité <em>critique</em>, <em>grave</em>
- et <em>sérieuse</em>. Ces bogues ne doivent pas apparaître dans une
- distribution <em>stable</em>. Ils doivent être corrigés ou bien les
- paquets en cause doivent être supprimés (<ref id="rc-bug">).
+ <item><em>Release critical bug</em> : bogue empêchant l'intégration
+ du paquet dans la distribution. Bogues de gravité <em>critique</em>,
+ <em>grave</em> et <em>sérieuse</em>. Ces bogues ne doivent pas
+ apparaître dans une distribution <em>stable</em>. Ils doivent être
+ corrigés ou bien les paquets en cause doivent être supprimés (<ref
+ id="rc-bugs">).
- <item><em>Unstable</em> : Nom de la distribution en cours de
- développement. Cette distribution contient les paquets envoyés par
- les développeurs. Ceux-ci étant humains, elle est parfois cassée (<ref
- id="life-cycle">).
+ <item><em>Package Tracking System (PTS)</em> : système de suivi des
+ paquets. Il s'agit du système utilisé par le projet Debian pour suivre
+ les paquets sources des différentes distributions (<ref
+ id="pkg-tracking-system">).
- <item><em>Testing</em> : Nom de la distribution en test. Cette
+ <item><em>Unstable</em> : nom de la distribution en cours
+ de développement. Cette distribution contient les paquets
+ envoyés par les développeurs. Ceux-ci n'étant que des êtres
+ humains, elle est parfois cassée (<ref id="sec-dists">).
+
+ <item><em>Testing</em> : nom de la distribution en test. Cette
distribution reçoit les paquets des développeurs qui ont passé une
période de deux semaines dans <em>unstable</em> et pour lesquels aucun
- bogue sévère n'a été découvert. Cette distribution n'a pas été testée
- en profondeur. Elle est cependant sensée être plus stable que
- <em>unstable</em> (<ref id="life-cycle">).
-
- <item><em>Frozen</em> : Nom de la distribution gelée. Cette
- distribution apparaît pendant quelques mois avant la sortie d'une
- nouvelle distribution stable. Elle est destinée à être testée en
- profondeur et ne reçoit que des corrections de bogues (<ref
- id="life-cycle">).
+ bogue remettant en cause la distribution (cf. <em>Release critical
+ bug</em>) n'a été découvert. Cette distribution n'a pas été testée en
+ profondeur. Elle est cependant censée être plus stable
+ qu'<em>unstable</em> (<ref id="sec-dists">).
- <item><em>Stable</em> : Nom de la distribution dite stable. Cette
- distribution a été testée, validée et diffusée (<ref
- id="life-cycle">).
+ <item><em>Stable</em> : nom de la distribution stable. Cette
+ distribution a été testée, validée et diffusée (<ref id="sec-dists">).
<item><em>Debian maintainer</em> : responsable Debian, développeur
- Debian (parfois mainteneur). Personne qui fait officiellement
- partie du projet Debian. Elle a accès aux serveurs Debian et participe
- au développement -- au sens large -- de la distribution (<ref
- id="developer-duties">). La plupart des responsables font de la mise
- en paquet mais il existe d'autres activités telles que documentation,
- site web, création des cédéroms, administration des serveurs...
+ Debian (parfois mainteneur). Personne qui fait officiellement partie du
+ projet Debian. Elle a accès aux serveurs Debian et participe au
+ développement — au sens large — de la distribution (<ref
+ id="developer-duties">). La plupart des responsables font de la mise en
+ paquet, mais il existe d'autres activités telles que la documentation,
+ la gestion du site web, la création des cédéroms, l'administration des
+ serveurs, etc.
<item><em>Upstream version</em> : version amont. Il s'agit du
- logiciel tel qu'il est fournit par le responsable amont -- par
- opposition à la version fournie par la distribution Debian. (Voir
- <ref id="upstream-coordination">.)
+ logiciel tel qu'il est fourni par le responsable amont — par
+ opposition à la version fournie par la distribution Debian. (Voir <ref
+ id="upstream-coordination">.)
- <item><em>Upstream maintainer</em> : responsable amont ou développeur
- amont. Personne(s) responsable(s) du développement ou de la
- maintenance d'un logiciel. En général le responsable amont n'a rien à
+ <item><em>Upstream maintainer</em> : responsable amont ou
+ développeur amont. Personne responsable du développement ou de la
+ maintenance d'un logiciel. En général, le responsable amont n'a rien à
voir avec le projet Debian (<ref id="upstream-coordination">).
<item><em>Debian keyring</em> : porte-clés Debian. Le porte-clés
Debian contient les clés publiques de tous les responsables Debian (<ref
id="key-maint">).
- <item><em>Work-needing and prospective packages (WNPP)</em> : paquets en
- souffrance et paquets souhaités. La liste des paquets en
+ <item><em>Work-needing and prospective packages (WNPP)</em> :
+ paquets en souffrance et paquets souhaités. La liste des paquets en
souffrance indique les paquets qui n'ont plus de responsable. La liste
des paquets souhaités indique les logiciels que des utilisateurs
aimeraient bien voir dans la distribution (<ref id="upload">).
</list>
- <chapt id="new-maintainer">Devenir responsable Debian
-
-
- <sect>Pour commencer
-
+ <chapt id="new-maintainer">Devenir responsable Debian
+
+ <sect id="getting-started">Pour commencer
+<p>
+Vous avez lu toute la documentation, vous avez examiné le <url
+ id="&url-newmaint-guide;" name="guide du nouveau responsable">, vous comprenez
+ l'intérêt de tout ce qui se trouve dans le paquet d'exemple
+ <package>hello</package> et vous vous apprêtez à mettre en paquet votre
+ logiciel préféré. Comment devenir responsable Debian et intégrer votre travail
+ au projet ?
+<p>
+Si vous ne l'avez pas encore fait, commencez par vous inscrire à la
+ liste &email-debian-devel;. Pour cela, envoyez un courrier à l'adresse
+ &email-debian-devel-req; avec le mot <tt>subscribe</tt> dans la ligne
+ <em>Objet</em><footnote><p><em>Subject</em> en anglais</footnote> de votre
+ message. En cas de problème, contactez l'administrateur de la liste
+ &email-listmaster;. Vous trouverez plus d'informations dans la section <ref
+ id="mailing-lists">. &email-debian-devel-announce; est une autre liste
+ incontournable pour qui veut suivre les développements de Debian.
+<p>
+Vous suivrez les discussions de cette liste (sans poster) pendant quelque temps
+ avant de coder quoi que ce soit et vous informerez la liste de votre intention
+ de travailler sur quelque chose pour éviter de dupliquer le travail d'un autre.
<p>
-Vous avez lu toute la documentation, vous comprenez l'intérêt de tout ce qui
-se trouve dans le paquet exemple <package>hello</package> et vous vous
-apprêtez à mettre en paquet votre logiciel préféré. Comment devenir
-responsable Debian et intégrer votre travail au projet ?
-
+Une autre liste intéressante est &email-debian-mentors;. Voir la section <ref
+ id="mentors"> pour les détails. Le canal IRC <tt>#debian</tt> pourra aussi être
+ utile.
+
+<p>
+Quand vous avez choisi la manière dont vous contribuerez au projet
+ &debian-formal;, prenez contact avec les responsables Debian qui travaillent
+ sur des tâches similaires. Ainsi, vous pourrez apprendre auprès de personnes
+ expérimentées. Si, par exemple, vous voulez mettre en paquet des logiciels
+ existants, trouvez-vous un parrain. Un parrain est une personne qui travaillera
+ sur vos paquets avec vous et les téléchargera dans l'archive Debian une fois
+ qu'il sera satisfait de votre mise en paquet. Pour trouver un parrain, envoyez
+ une demande de parrainage à la liste &email-debian-mentors; en vous présentant
+ et en décrivant votre paquet (voir <ref id="sponsoring"> pour en savoir plus
+ sur le sujet). Si vous préférez porter Debian sur une architecture ou un noyau
+ alternatif, abonnez-vous aux listes dédiées au portage et demandez-y comment
+ démarrer. Finalement, si vous êtes intéressé par la documentation ou
+ l'assurance qualité (QA), vous pouvez contacter les responsables qui
+ travaillent déjà sur ces tâches et proposer des correctifs et des
+ améliorations.
+
+
+ <sect id="registering">S'enregistrer comme responsable Debian
+<p>
+Avant de décider de devenir responsable Debian, il vous faudra lire toute la
+ documentation disponible dans le <url id="&url-newmaint;" name="coin du nouveau
+ responsable">. Elle décrit toutes les étapes préparatoires qu'il vous faudra
+ franchir avant de déposer votre candidature.
+
+Par exemple, avant d'être candidat, il vous faudra lire le <url
+ id="&url-social-contract;" name="contrat social Debian">. Devenir responsable
+ Debian implique que vous adhériez à ce contrat social et que vous vous engagiez
+ à le soutenir ; il est très important que les responsables soient en
+ accord avec les principes fondamentaux qui animent le projet &debian-formal;.
+ Lire le <url id="&url-gnu-manifesto;" name="Manifeste GNU"> est aussi une bonne
+ idée.
+<p>
+Le processus d'enregistrement a pour but de vérifier votre identité, vos
+ intentions et vos compétences. Le nombre de personnes travaillant pour
+ &debian-formal; a atteint &number-of-maintainers; et notre système est utilisé
+ dans plusieurs endroits très importants : nous devons rester vigilants
+ pour éviter un acte malveillant. C'est pourquoi nous contrôlons les nouveaux
+ responsables avant de leur donner un compte sur nos serveurs et de les autoriser à
+ ajouter des paquets dans l'archive.
+<p>
+Pour devenir responsable, il faudra montrer que vous pouvez faire du bon travail
+ et que vous serez un bon contributeur. Pour cela, vous pourrez proposer des correctifs
+ par le système de suivi des bogues (BTS) ou maintenir un paquet parrainé
+ pendant un temps. Nous attendons aussi des contributeurs qu'ils soient
+ intéressés par le projet dans son ensemble et pas uniquement par leurs propres
+ paquets. Si vous pouvez aider d'autres responsables en fournissant des
+ informations sur un bogue ou même avec un correctif, faites-le !
+<p>
+Pour votre candidature, vous devrez être familiarisé avec la philosophie du
+ projet Debian et avec sa documentation technique. Il vous faudra aussi une clé
+ GnuPG signée par un responsable Debian. Si votre clé GnuPG n'est pas encore
+ signée, vous devriez essayer de rencontrer un responsable Debian pour le faire.
+ La <url id="&url-gpg-coord;" name="page de coordination des signatures de clé
+ GnuPG"> devrait vous aider à trouver un responsable Debian près de chez vous.
+ (Si vous ne trouvez pas de responsable près de chez vous, il existe un second
+ moyen pour valider votre identité. Vous pouvez envoyer une photo d'identité
+ signée avec votre clé GnuPG. Privilégiez tout de même la clé GnuPG signée pour
+ valider une identité. Reportez-vous à la <url id="&url-newmaint-id;" name="page
+ d'identification"> pour en savoir plus sur ces deux options).
+
+<p>
+Si vous n'avez pas de clé OpenPGP, créez-la. Tout responsable a besoin d'une clé
+ OpenPGP pour signer et vérifier les mises à jour de paquets. Vous lirez la
+ documentation du logiciel de cryptographie que vous utiliserez car elle
+ contient des informations indispensables pour la sécurité de votre clé. Les
+ défaillances de sécurité sont bien plus souvent dues à des erreurs humaines
+ qu'à des problèmes logiciels ou à des techniques d'espionnage avancées. Voir
+ <ref id="key-maint"> pour plus d'informations sur la gestion de votre clé
+ publique.
<p>
-Si vous ne l'avez pas encore fait vous pouvez commencer par vous inscrire à la
-liste &email-debian-devel;.
-
+Debian utilise <prgn>GNU Privacy Guard</prgn> (paquet <package>gnupg</package>
+ version 1 ou supérieure) comme standard de base. Vous pouvez aussi utiliser une
+ autre implémentation d'OpenPGP. OpenPGP est un standard ouvert basé sur la <url
+ id="&url-rfc2440;" name="RFC 2440">.
<p>
-Pour cela, envoyez un courrier à l'adresse
-&email-debian-devel-req; avec le mot <tt>subscribe</tt> dans la ligne
-<em>Objet</em><footnote><em>Subject</em> en anglais</footnote> de votre
-message. En cas de problème, contactez l'administrateur de la liste
-&email-listmaster;. Vous trouverez plus d'information dans la section <ref
-id="mailing-lists">.
-
+L'algorithme à clé publique recommandé pour les développements Debian est DSA
+ (parfois appelé « DSS » ou « DH\ElGamal »). Vous pouvez
+ aussi utiliser d'autres types de clés. La longueur de votre clé doit être au
+ minimum de 1024 bits ; il n'y a pas de raison d'utiliser une clé plus
+ courte et le faire serait beaucoup moins sûr. Votre clé doit être signée avec
+ votre propre identifiant ; cela évite les falsifications. <prgn>GNU
+ Privacy Guard</prgn> le fait automatiquement.
<p>
-Vous suivrez les discussions de cette liste (sans poster) pendant quelques
-temps avant de coder quoi que ce soit et vous informerez la liste de votre
-intention de travailler sur quelque chose pour éviter de dupliquer le travail
-d'un autre.
-
+Si votre clé publique n'est pas sur un serveur public tel que &pgp-keyserv;,
+ reportez-vous à la documentation disponible localement dans &file-keyservs;.
+ Cette documentation explique comment mettre votre clé publique sur un serveur.
+ L'équipe <em>New maintainer</em> mettra votre clé publique sur les serveurs de
+ clés si elle n'y est pas déjà.
+<p>
+Certains pays limitent l'usage des logiciels de cryptographie. Cela ne devrait
+ cependant pas avoir d'impact sur l'activité d'un responsable de paquet car il
+ peut être tout à fait légal d'utiliser des logiciels de cryptographie pour
+ l'authentification plutôt que pour le chiffrement. &debian-formal; ne nécessite
+ en aucune façon l'utilisation de chiffrement. Si vous vivez dans un pays où
+ l'utilisation de la cryptographie pour authentification est interdite,
+ contactez-nous pour que nous prenions des dispositions particulières.
+<p>
+Pour faire acte de candidature, il vous faut un responsable Debian qui vérifiera
+ votre candidature (un <em>avocat</em>). Après avoir contribué au projet Debian
+ pendant un temps, quand vous choisissez de devenir un responsable Debian
+ officiel, un responsable déjà enregistré avec qui vous aurez travaillé dans les
+ derniers mois devra exprimer que, d'après lui, vous pouvez contribuer avec
+ succès au projet Debian.
+<p>
+Quand vous avez trouvez un <em>avocat</em>, quand votre clé GnuPG est signée et
+ quand vous avez déjà contribué au projet, vous êtes prêt à faire
+ acte de candidature. Il vous suffit pour cela de vous enregistrer sur notre
+ <url id="&url-newmaint-apply;" name="page de candidature">. Ensuite, votre
+ avocat devra confirmer votre candidature. Quand il aura accompli cette tâche,
+ un responsable de candidature<footnote><p>Application manager</footnote> sera
+ désigné pour vous accompagner dans le processus d'enregistrement. Vous pouvez
+ toujours consulter le <url id="&url-newmaint-db;" name="tableau de bord des
+ candidatures"> pour connaître l'état de votre candidature.
<p>
-Une autre liste intéressante est &email-debian-mentors;. Voir la section <ref
-id="mentors"> pour les détails. Le canal IRC <tt>#debian</tt> sur le réseau
-<em>Linux People IRC</em> (c.-à-d. <tt>irc.debian.org</tt>) pourra aussi être
-utile.
-
-
-
+Pour en savoir plus, consultez le <url id="&url-newmaint;" name="coin des
+ nouveaux responsables"> sur le site Debian. Assurez-vous de bien connaître les
+ étapes nécessaires au processus d'enregistrement avant de vous porter candidat.
+ Vous gagnerez beaucoup de temps si vous êtes bien préparé.
- <sect id="registering">Devenir responsable Debian
+ <sect id="mentors">Mentors et parrains Debian
<p>
-Avant de décider de devenir responsable Debian, il vous faudra lire le <url
-id="&url-social-contract;" name="Contrat social Debian">. Vous faire
-enregistrer comme responsable implique que vous adhériez à ce contrat social
-et que vous vous engagiez à le soutenir ; il est très important que les
-responsables soient en accord avec les principes fondamentaux qui animent le
-projet Debian GNU-Linux. Lire le <url id="&url-gnu-manifesto;" name="Manifeste
-GNU"> est aussi une bonne idée.
-
+La liste de diffusion &email-debian-mentors; a été créée pour les responsables
+ débutants qui cherchent de l'aide pour leur première création de paquet ainsi
+ que pour des problèmes spécifiques aux développeurs. Tout responsable débutant
+ est invité à s'y inscrire (voir <ref id="mailing-lists"> pour plus de détails).
<p>
-Le processus d'enregistrement a pour but de vérifier votre identité et vos
-intentions. Le nombre de personnes travaillant pour Debian GNU-Linux a atteint
-&number-of-maintainers; et notre système est utilisé dans un certain nombre
-d'endroits très importants : nous devons rester attentifs pour éviter un acte
-malveillant. C'est pourquoi nous contrôlons les nouveaux responsables avant de
-leur donner un compte sur nos serveurs et les autoriser à ajouter des paquets
-dans l'archive.
-
+Ceux qui préfèrent une aide personnalisée (via une correspondance privée)
+ doivent aussi poster dans cette liste, un développeur expérimenté se portera
+ volontaire pour les aider.
<p>
-Pour votre enregistrement il sera nécessaire d'envoyer les informations
-suivantes<footnote>Voir la page <url id="&url-newmaint-checklist;"
-name="Checklist for applicants">.</footnote> après une
-première prise de contact à l'adresse &email-new-maintainer; :
-
- <list compact>
- <item>
- Votre nom.
-
- <item>
- Le <em>login</em> que vous voudriez avoir sur <tt>master</tt> (maximum
- huit caractères) ainsi que l'adresse qui sera utilisée pour votre
- inscription à la liste &email-debian-private; (il s'agira soit de
- votre adresse personnelle soit de votre adresse <tt>debian.org</tt>
- fraîchement acquise).
-
- <item>
- Un numéro de téléphone où nous pouvons vous joindre. Souvenez-vous que
- l'équipe <em>New maintainer</em> appelle généralement le soir pour
- limiter les coûts de communication longue distance. Ne donnez pas de
- numéro professionnel à moins d'y être souvent le soir.
-
- <item>
- Une déclaration de vos intentions. C'est à dire, sur quel paquet vous
- pensez travailler, à quel portage vous comptez participer ou comment
- vous comptez contribuer au projet.
+Si vos paquets sont prêts à être intégrés mais que vous attendiez le
+ résultat de votre candidature, vous pouvez chercher un parrain qui téléchargera
+ les paquets à votre place. Les parrains sont des responsables Debian officiels
+ volontaires pour examiner et télécharger vos paquets. Vous pouvez
+ demander un parrainage à l'adresse <url id="&url-sponsors;">.
+<p>
+Si vous désirez être mentor ou parrain, reportez-vous à <ref id="newmaint">.
- <item>
- Une déclaration indiquant que vous avez lu et acceptez de soutenir le
- <url id="&url-social-contract;" name="Contrat social Debian">.
- <item>
- Un moyen de vérifier votre identité réelle. Les moyens suivants feront
- l'affaire :
-
- <list compact>
- <item>
- une clé OpenPGP signée par une signature connue telle qu'un
- responsable Debian que vous aurez rencontré
- <em>physiquement</em> ou un service d'authentification qui
- vérifie votre identité (Verisign par exemple)<footnote>Un
- service d'authentification qui vérifie votre adresse
- électronique mais pas votre identité ne conviendra pas.
- </footnote>,
-
- <item>
- une copie (numérisée ou photocopiée) de n'importe quel
- document officiel prouvant votre identité (certificat de
- naissance, carte d'identité, permis de conduire, etc...). Pour
- un envoi électronique, signez avec votre clé OpenPGP.
-
- </list>
- </list>
+ <chapt id="developer-duties">Les charges du responsable Debian
+ <sect id="user-maint">Mise à jour de vos références Debian
<p>
-Si vous n'avez pas de clé OpenPGP, créez-la. Tout responsable a besoin d'une
-clé OpenPGP pour signer et vérifier les mises à jour de paquets. Vous lirez
-la documentation du logiciel de cryptographie que vous utiliserez car elle
-contient des informations indispensables pour la sécurité de votre clé. Les
-défaillances de sécurité sont bien plus souvent dues à des erreurs humaines
-qu'à des problèmes logiciels ou à des techniques d'espionnage avancées. Voir
-<ref id="key-maint"> pour plus d'information sur la gestion de votre clé
-publique.
-
+Il existe une base de données LDAP contenant des informations concernant les
+développeurs Debian à <url id="&url-debian-db;">. Vous devriez y entrer vos
+informations et les mettre à jour quand elles changent. Le plus important est de
+vous assurer que l'adresse vers laquelle est redirigée votre adresse debian.org
+est toujours à jour, de même que l'adresse à laquelle vous recevez votre
+abonnement à debian-private si vous choisissez d'être abonné à cette liste.
<p>
-Debian utilise <prgn>GNU Privacy Guard</prgn> (paquet <package>gnupg</package>
-version 1 ou supérieure comme standard de base). Vous pouvez aussi utiliser une
-autre implémentation d'OpenPGP. OpenPGP est un standard ouvert basé sur la
-<url id="&url-rfc2440;" name="RFC 2440">.
+Pour plus d'informations à propos de cette base de données, veuillez consulter
+<ref id="devel-db">.
+ <sect id="key-maint">Gérer votre clé publique
<p>
-L'algorithme à clé publique recommandé pour les développements Debian est DSA
-(parfois appelé « DSS » ou « DH\ElGamal »). Vous pouvez
-aussi utiliser d'autres types de clés. La longueur de votre clé doit être au
-minimum de 1024 bits ; il n'y a pas de raison d'utiliser une clé plus courte et le
-faire serait beaucoup moins sûr. Votre clé doit être signée avec votre propre
-identifiant ; cela évite les falsifications. <prgn>GNU Privacy Guard</prgn> le
-fait automatiquement.
-
+Soyez très vigilant en utilisant votre clé privée. Ne la placez pas sur un
+ serveur public ou sur des machines multi-utilisateurs telles que les serveurs
+ Debian (voir <ref id="server-machines">). Sauvegardez vos clés et gardez-en une
+ copie hors connexion. Lisez la documentation fournie avec votre logiciel et la
+ <url id="&url-pgp-faq;" name="FAQ PGP">.
<p>
-Souvenez-vous que l'un des noms de votre clé doit correspondre à l'adresse de
-mainteneur officiel que vous indiquez dans vos paquets. Par exemple, j'affecte
-le responsable du paquet <package>developers-reference</package> à « Adam
-Di Carlo <aph@debian.org> » ; alors l'un des identifiants de ma clé
-doit être cette même valeur « Adam Di Carlo
-<aph@debian.org> ».
-
+Si vous ajoutez des signatures ou des identifiants à votre clé publique, vous
+ pouvez mettre à jour le porte-clés Debian en envoyant votre clé publique à
+ <tt>&keyserver-host;</tt>. Si vous voulez ajouter ou supprimer une clé, envoyez
+ un courrier à &email-debian-keyring;. Les procédures d'extraction de clé
+ décrites dans <ref id="registering"> s'appliquent ici.
<p>
-Si votre clé publique n'est pas sur un serveur public tel que &pgp-keyserv;,
-reportez-vous à la documentation disponible localement dans &file-keyservs;.
-Cette documentation explique comment mettre votre clé publique sur un serveur.
-L'équipe <em>New maintainer</em> mettra votre clé publique sur les serveurs de
-clés si elle n'y est pas déjà.
+Vous pouvez trouver une présentation approfondie de la gestion de clé Debian
+ dans la documentation du paquet <package>debian-keyring</package>.
+ <sect id="voting">Voter
<p>
-Pour cause de restriction sur le droit à l'exportation aux États-Unis,
-certains paquets, dont <package>gnupg</package>, sont hébergés sur
-des serveurs FTP en dehors des États-Unis. Vous trouverez les adresses
-de ces serveurs dans le fichier <url id="&url-readme-non-us;">.
-
+Bien que Debian ne soit pas vraiment une démocratie, nous disposons d'un
+processus démocratique pour élire nos chefs et pour approuver les résolutions
+générales. Ces procédures sont définies par la <url id="&url-constitution;"
+name="charte Debian">.
<p>
-Certains pays limitent l'usage des logiciels de cryptographie. Cela ne
-devrait cependant pas avoir d'impact sur l'activité d'un responsable de paquet
-car il peut être tout à fait légal d'utiliser des logiciels de cryptographie
-pour l'authentification plutôt que pour le cryptage (comme c'est le cas en
-France). Le projet Debian ne nécessite en aucune manière de cryptographie en
-tant que cryptage. Si vous vivez dans un pays où l'usage de la cryptographie
-pour authentification est interdit, contactez-nous pour que nous prenions des
-dispositions particulières.
-
+En dehors de l'élection annuelle du chef, les votes ne se tiennent pas
+régulièrement et ils ne sont pas entrepris à la légère. Chaque proposition est
+tout d'abord discutée sur la liste de diffusion &email-debian-vote; et elle a
+besoin de plusieurs approbations avant que le secrétaire du projet n'entame la
+procédure de vote.
<p>
-Une fois que votre dossier est prêt et que votre clé publique est accessible sur
-les serveurs de clés publiques, envoyez votre candidature sur la liste
-&email-new-maintainer; pour être enregistré comme responsable Debian et
-pouvoir ajouter vos paquets dans l'archive. Ce message doit contenir votre nom
-et votre adresse électronique. Toutes les informations présentées plus tôt
-seront requises une fois que votre responsable de canditature aura été
-désigné. Le responsable de candidature<footnote>Application manager</footnote> est votre accompagnateur dans le
-processus d'enregistrement et vous pouvez toujours lui demander où en est
-votre candidature. Vous pouvez aussi consulter le <url id="&url-newmaint-db;"
-name="tableau de bord des candidatures"> sur le site Debian.
+Vous n'avez pas besoin de suivre les discussions précédant le vote car le
+secrétaire enverra plusieurs appels au vote sur la liste
+&email-debian-devel-announce; (et tous les développeurs devraient être inscrits
+à cette liste). La démocratie ne fonctionne pas si les personnes ne prennent pas
+part au vote, c'est pourquoi nous encourageons tous les développeurs à voter. Le
+vote est conduit par messages signés ou chiffrés par GPG.
<p>
-Pour en savoir plus, consultez le <url id="&url-newmaint;" name="coin des
-nouveaux responsables"> sur le site Debian.
+La liste de toutes les propositions (passées et présentes) est disponible à la
+ page <url id="&url-vote;" name="Informations sur les votes Debian">, ainsi que
+ des informations complémentaires sur la procédure à suivre pour effectuer une
+ proposition, la soutenir et voter pour elle.
+ <sect id="inform-vacation">Prendre des vacances courtoisement
<p>
-Une fois que votre dossier aura été reçu et traité, vous devriez
-recevoir les informations concernant votre compte Debian. Si vous
-ne recevez rien pendant un mois, envoyez un message de relance demandant si
-votre candidature initiale a bien été reçue. Ne renvoyez <em>pas</em> votre
-candidature initiale, cela embrouillerait l'équipe <em>New maintainer</em>.
-Soyez patient, en particulier à l'approche de la sortie d'une
-distribution ; des erreurs ont parfois lieu et les gens peuvent manquer
-de temps pour cette activité bénévole.
-
-
- <sect id="mentors">Mentors Debian
+Il est courant pour les développeurs de s'absenter, que ce
+soit pour des vacances prévues ou parce qu'ils sont submergés de travail. La
+chose importante à noter est que les autres développeurs ont besoin de savoir
+que vous êtes en vacances pour qu'ils puissent agir en conséquence si un
+problème se produit pendant vos vacances.
<p>
-La liste de diffusion &email-debian-mentors; a été créée pour les
-responsables débutants qui cherchent de l'aide pour leur première
-création de paquet ainsi que pour des problèmes spécifiques aux
-développeurs. Tout responsable débutant est invité à s'y inscrire
-(voir <ref id="mailing-lists"> pour plus de détails).
-
+Habituellement, cela veut dire que les autres développeurs peuvent faire des NMU
+(voir <ref id="nmu">) sur votre paquet si un gros problème (bogues empêchant
+l'intégration dans la distribution, mise à jour de sécurité, etc.) se produit pendant que vous êtes en
+vacances. Parfois, ce n'est pas très important, mais il est de
+toute façon approprié d'indiquer aux autres que vous n'êtes pas disponible.
<p>
-Ceux qui préfèrent une aide personnalisée (via une correspondance
-privée) doivent aussi poster dans cette liste, un développeur
-expérimenté se portera volontaire pour les aider.
-
-
-
-
-
-
- <chapt id="developer-duties">Les charges du responsable Debian
-
-
- <sect>Mise à jour de vos références Debian
-
+Il y a deux choses à faire pour informer les autres développeurs.
+Premièrement, envoyez un courrier électronique à &email-debian-private; en
+commençant le sujet de votre message par « [VAC] »<footnote>Ainsi, le
+message peut être facilement filtré par les personnes qui ne veulent pas lire
+ces annonces de vacances.</footnote> et donnez la période de vos
+vacances. Vous pouvez également donner quelques instructions pour
+indiquer comment agir si un problème survenait.
+<p>
+L'autre chose à faire est de vous signaler comme « en
+ vacances »<footnote><p><em>on vacation</em> en anglais</footnote> dans la
+ <qref id="devel-db">base de données Debian LDAP</qref> (l'accès à cette
+ information est réservé aux développeurs). N'oubliez pas de retirer votre
+ indicateur « en vacances » lorsque celles-ci sont terminées !
+
+ <sect id="upstream-coordination">Coordination avec les développeurs amont
+<p>
+Une grande part de votre travail de responsable Debian sera de rester en contact
+ avec les développeurs amont. Parfois, les utilisateurs établissent des
+ rapports de bogue qui ne sont pas spécifiques à Debian. Vous devez transmettre
+ ces rapports de bogue aux développeurs amont pour qu'ils soient corrigés dans
+ les prochaines versions.
+<p>
+Bien qu'il ne soit pas de votre responsabilité de corriger les
+ bogues non spécifiques à Debian, vous pouvez le faire si vous en êtes capable.
+ Quand vous faites de telles corrections, assurez-vous de les envoyer
+ également au développeur amont. Les utilisateurs et responsables
+ Debian proposent souvent des correctifs pour corriger des bogues amont, il
+ vous faudra alors évaluer ce correctif puis le transmettre aux développeurs
+ amont.
<p>
-Une base de données LDAP contient de nombreuses informations concernant
-les développeurs, vous pouvez y accéder à l'adresse <url
-id="&url-debian-db;">. Vous pouvez modifier votre mot de passe (ce mot de
-passe est diffusé sur la plupart des machines auxquelles vous avez accès),
-votre adresse, votre pays, la latitude et la longitude de l'endroit où vous
-résidez, vos numéros de téléphone et de fax, votre interpréteur de commande
-préféré, votre surnom IRC, votre page web, votre adresse de courrier
-électronique ainsi que l'alias que vous utilisez pour votre courrier
-électronique chez debian.org. La plupart de ces informations ne sont pas
-accessibles au public. Pour plus de détails au sujet de cette base de données
-reportez-vous à sa documentation en ligne disponible à l'adresse <url
-id="&url-debian-db-doc;">.
-
+Si vous avez besoin de modifier les sources d'un logiciel pour fabriquer un
+ paquet conforme à la charte Debian, alors vous devriez proposer un correctif
+ aux développeurs amont pour qu'il soit inclus dans leur version. Ainsi, vous
+ n'aurez plus besoin de modifier les sources lors des mises à jour amont
+ suivantes. Quels que soient les changements dont vous avez besoin, il faut
+ toujours essayer de rester dans la lignée des sources amont.
+
+ <sect id="rc-bugs">Comment gérer les bogues empêchant l'intégration du
+ paquet dans la distribution ?
+<p>
+Habituellement, vous devriez traiter les rapports de bogue sur vos paquets tel
+ que cela est décrit dans <ref id="bug-handling">. Cependant, il y a une
+ catégorie spéciale de bogues qui nécessite particulièrement votre
+ attention : les bogues empêchant l'intégration du paquet dans la
+ distribution<footnote>Traduction de l'anglais <em>Release-critical bug (RC
+ Bugs)</em></footnote>. Tous les rapports de bogue de gravité <em>critique</em>,
+ <em>grave</em> et <em>sérieuse</em><footnote>Respectivement <em>critical</em>,
+ <em>grave</em> et <em>serious</em> en anglais</footnote> sont considérés comme
+ ayant un impact sur la présence du paquet dans la prochaine version stable de
+ Debian. Ces bogues peuvent retarder la diffusion d'une distribution Debian
+ ou peuvent justifier la suppression d'un paquet d'une distribution gelée.
+ C'est pourquoi ces bogues doivent être corrigés au plus vite.
+<p>
+Les développeurs faisant partie de l'équipe d'<url id="&url-debian-qa;"
+ name="assurance qualité Debian"> surveillent ces bogues et essaient de vous
+ aider chaque fois qu'ils le peuvent. Si vous ne pouvez pas corriger un bogue de
+ ce type dans les deux semaines, vous devriez soit demander de l'aide en
+ envoyant un courrier à l'équipe d'assurance qualité (<em>QA group</em>) à
+ &email-debian-qa;, soit expliquer vos difficultés et présenter un plan pour
+ corriger le problème en répondant au rapport de bogue concerné. Si rien n'est
+ fait, des personnes de l'équipe d'assurance qualité pourraient chercher à
+ corriger votre paquet (voir <ref id="nmu">) après avoir tenté de vous contacter
+ (ils pourraient attendre moins longtemps que d'habitude pour faire leur mise à
+ jour s'il n'y a pas trace d'activité récente de votre part dans le système de
+ suivi des bogues).
+
+
+ <sect>Démissionner
+<p>
+Si vous choisissez de quitter le projet Debian, procédez comme suit :
+<enumlist compact="compact">
+ <item><p>abandonnez tous vos paquets comme décrit dans <ref
+ id="orphaning"> ;</item>
+ <item><p>envoyez un courrier électronique à &email-debian-private; indiquant
+ pourquoi vous quittez le projet ;</item>
+ <item><p>signalez aux responsables du porte-clés Debian que vous quittez le
+ projet en écrivant à &email-debian-keyring;.</item>
+</enumlist>
+
+
+
+ <chapt id="resources">Ressources pour le responsable Debian
+<p>
+Dans ce chapitre, vous trouverez une brève description des listes de diffusion,
+ des machines Debian qui seront à votre disposition en tant que responsable
+ Debian ainsi que toutes les autres ressources à votre disposition pour vous
+ aider dans votre travail de responsable.
+
+ <sect id="mailing-lists">Les listes de diffusion
+<p>
+Une grande partie des discussions entre les développeurs Debian (et les
+utilisateurs) est gérée par un vaste éventail de listes de diffusion que nous
+hébergeons à <tt><url id="http://&lists-host;/" name="&lists-host;"></tt>.
+Pour en savoir plus sur comment s'abonner ou se désabonner, comment envoyer un
+message et comment ne pas en envoyer, comment retrouver d'anciens messages et
+comment les rechercher, comment contacter les responsables des listes et pour
+sevoir d'autres informations sur les listes de diffusion, veuillez lire <url
+id="&url-debian-lists;">. Cette section ne couvrira que les aspects des listes
+de diffusion qui ont un intérêt particulier pour les développeurs.
+
+ <sect1 id="mailing-lists-rules">Rêgles de base d'utilisation
+<p>
+Lorsque vous répondez sur une liste de diffusion, veuillez ne pas envoyer de
+copie (<tt>CC</tt>) à l'auteur d'origine sauf s'il le demande explicitement.
+Toute personne envoyant un message à une liste de diffusion devrait la suivre
+pour voir les réponses.
+<p>
+Le multi-postage (cross-posting) (envoyer le même message à plusieurs listes)
+est découragé. Comme toujours sur le net, veuillez réduire la citation des
+articles auxquels vous répondez. En général, veuillez adhérez aux conventions
+usuelles d'envoi de messages.
+<p>
+Veuillez lire le <url name="code de conduite"
+id="&url-debian-lists;#codeofconduct"> pour plus d'informations.
+
+ <sect1 id="core-devel-mailing-lists">Principales listes pour les
+ responsables
+<p>
+Les principales listes de diffusion de Debian que les développeurs
+ devraient suivre sont :
+<list>
+<item>&email-debian-devel-announce;, utilisée pour les annonces importantes
+ faites aux responsables. Tous les responsables Debian sont censés être
+ inscrits à cette liste,</item>
+<item>&email-debian-devel;, utilisée pour discuter de diverses questions
+ techniques relatives au développement,</item>
+<item>&email-debian-policy; où l'on discute et vote les modifications de la
+ charte Debian,</item>
+<item>&email-debian-project;, utilisée pour discuter de questions non
+ techniques.</item>
+</list>
<p>
-Vous y tiendrez à jour les informations vous concernant.
-
-
-
-
- <sect id="key-maint">Gérer votre clé publique
+Il existe d'autres listes de diffusion spécialisées dans différents thèmes.
+ Reportez-vous à la page <url id="http://&lists-host;/"> pour en obtenir
+ la liste complète.
+ <sect1 id="mailing-lists-special">Listes spéciales
<p>
-Soyez très vigilant en utilisant votre clé privée. Ne la placez pas sur un
-serveur public ou sur des machines multi-utilisateurs telles que
-<tt>master.debian.org</tt>. Sauvegardez vos clés et gardez-en une copie hors
-connexion. Lisez la documentation fournie avec votre logiciel et la <url
-id="&url-pgp-faq;" name="FAQ PGP">.
-
+&email-debian-private; est une liste de diffusion destinée aux discussions
+ privées entre développeurs Debian. Elle doit être utilisée pour tout message
+ qui ne doit pas être publié, quelle qu'en soit la raison. C'est une liste à
+ faible trafic et les utilisateurs sont priés de ne l'utiliser qu'en cas de
+ réelle nécessité. De plus, il ne faut <em>jamais</em> faire suivre un courrier
+ de cette liste à qui que ce soit. Pour des raisons évidentes, les archives de
+ cette liste ne sont pas disponibles sur la toile. Vous pouvez les consulter en
+ visitant le répertoire <file>~debian/archive/debian-private</file> avec votre
+ compte sur <tt>lists.debian.org</tt>.
<p>
-Si vous ajoutez des signatures ou des identifiants à votre clé publique, vous
-pouvez mettre à jour le porte-clés Debian en envoyant votre clé publique à
-<tt>&keyserver-host;</tt>. Si vous voulez ajouter ou supprimer une clé, envoyez
-un courrier à &email-debian-keyring;. Les procédures d'extraction de clé
-décrites dans <ref id="registering"> s'appliquent ici.
-
+&email-debian-email; est une liste de diffusion fourre-tout. Elle est utilisée
+ pour les correspondances relatives à Debian qu'il serait utile d'archiver,
+ telles que des échanges avec les auteurs amont à propos de licences, de bogues
+ ou encore des discussions sur le projet avec d'autres personnes.
+
+ <sect1 id="mailing-lists-new">Demander une nouvelle liste relative au développement
+<p>
+Avant de demander un liste de diffusion liée au développement d'un paquet (ou
+d'un petit groupe de paquets liés), veuillez considérer si l'utilisation d'un
+alias (via un fichier .forward-aliasname sur master.debian.org, ce qui se
+traduit en une adresse raisonnablement agréable
+<var>you-aliasname@debian.org</var>) ou une liste de diffusion auto-gérée sur
+<qref id="alioth">Alioth</qref> serait plus appropriée.
+<p>
+Si vous décidez qu'une liste de diffusion standard sur lists.debian.org est
+vraiment ce que vous voulez, lancez-vous et faites une demande en suivant <url
+name="le guide" id="&url-debian-lists-new;">.
+
+
+ <sect id="irc-channels">Canaux IRC
+<p>
+Plusieurs canaux IRC sont dédiés au développement Debian. Ils sont
+ principalement hébergés sur le réseau <url id="&url-openprojects;"
+ name="freenode"> (anciennement connu sous le nom de Open Projects Network).
+ L'entrée DNS <tt>irc.debian.org</tt> est simplement un alias vers
+ <tt>irc.freenode.net</tt>.
+<p>
+Le principal canal pour Debian est <em>#debian</em>. Il s'agit d'un
+canal important, généraliste, où les utilisateurs peuvent trouver des nouvelles
+ récentes dans le sujet et qui est administré par des robots. <em>#debian</em>
+ est destiné aux anglophones ; il existe également <em>#debian.de</em>,
+ <em>#debian-fr</em>, <em>#debian-br</em> et d'autres canaux avec des noms
+ semblables pour les personnes parlant d'autres langues.
+<p>
+Le canal principal pour le développement Debian est <em>#debian-devel</em>.
+ C'est un canal très actif avec habituellement plus de 150 personnes connectées
+ en permanence. C'est un canal pour les personnes qui travaillent sur Debian, ce
+ n'est pas un canal d'aide (il existe <em>#debian</em> pour cela). Il est
+ cependant ouvert à tous ceux qui veulent écouter (et apprendre). Le sujet est
+ toujours rempli d'informations intéressantes.
+<p>
+Comme <em>#debian-devel</em> est un canal ouvert, vous ne devriez pas y parler
+ de problèmes discutés sur &email-debian-private;. Il existe un canal protégé
+ par clé <em>#debian-private</em> dans ce but. La clé est disponible dans les
+ archives de debian-private à
+ <file>master.debian.org:&file-debian-private-archive;</file>, effectuez
+ simplement un <prgn>zgrep</prgn> avec <em>#debian-private</em> dans tous les
+ fichiers.
+<p>
+Il existe d'autres canaux dédiés à des sujets spécifiques. <em>#debian-bugs</em>
+ est utilisé pour la coordination des <em>chasses aux bogues</em>.
+ <em>#debian-boot</em> est utilisé pour la coordination du travail sur les
+ disquettes de démarrage (i.e., l'installeur). <em>#debian-doc</em> est utilisé
+ occasionnellement pour travailler sur la documentation comme celle que vous
+ lisez actuellement. D'autres canaux sont dédiés à une architecture ou un
+ ensemble de paquets : <em>#debian-bsd</em>, <em>#debian-kde</em>,
+ <em>#debian-jr</em>, <em>#debian-edu</em>, <em>#debian-sf</em> (paquet
+ SourceForge), <em>#debian-oo</em> (paquet OpenOffice), etc.
+<p>
+Certains canaux pour développeurs non anglophones existent, par exemple,
+ <em>#debian-devel-fr</em> pour les francophones intéressés dans le
+ développement de Debian.
+<p>
+Il existe également des canaux dédiés pour Debian sur d'autres réseaux IRC,
+ notamment sur le réseau IRC <url name="Open and free technology community
+ (OFTC)" id="http://www.oftc.net/">.
+
+
+ <sect id="doc-rsrcs">Documentation
+<p>
+Ce document contient beaucoup d'informations très utiles aux développeurs
+ Debian, mais il ne peut pas tout contenir. La plupart des autres documents
+ intéressants sont référencés dans le <url id="&url-devel-docs;" name="coin
+ du développeur Debian">. Prenez le temps de parcourir tous les liens, vous
+ apprendrez encore beaucoup de choses.
+
+
+ <sect id="server-machines">Les serveurs Debian
+<p>
+Debian possède plusieurs ordinateurs employés comme serveurs, dont la plupart hébergent
+ les fonctions critiques du projet Debian. La plupart des machines sont
+ utilisées pour des activités de portage et elles ont toutes un accès permanent
+ à Internet.
+<p>
+La plupart des machines peuvent être utilisées par les développeurs
+ tant qu'ils respectent les règles définies dans la <url
+ id="&url-dmup;" name="charte d'utilisation des machines Debian">.
+<p>
+Dans l'ensemble, vous pouvez faire usage de ces machines pour des buts relatifs
+ à Debian comme vous l'entendez. Veuillez cependant être gentil avec les
+ administrateurs système et ne pas utiliser de grandes quantités d'espace
+ disque, de ressource réseau ou CPU sans obtenir auparavant l'accord des
+ administrateurs. Habituellement, ces machines sont administrées par des
+ volontaires.
+<p>
+Veuillez prendre soin de votre mot de passe Debian ainsi que des clés SSH
+ installées sur les machines Debian. Évitez les méthodes de connexion ou d'envoi
+ de données qui envoient les mots de passe en clair par l'Internet comme telnet,
+ FTP, POP, etc.
+<p>
+Veuillez ne pas déposer de données non relatives à Debian sur les serveurs
+Debian à moins que vous n'ayez préalablement obtenu la permission de le faire.
+<p>
+La liste actuelle des machines Debian est disponible à <url
+ id="&url-devel-machines;">. Cette page web contient les noms des machines, les
+ informations de contact, les informations sur qui peut s'y connecter, les clés
+ SSH, etc.
<p>
-Vous pouvez trouver une présentation approfondie de la gestion de clé Debian
-dans la documentation du paquet <package>debian-keyring</package>.
-
-
-
-
- <sect id="inform-vacation">Prendre des vacances courtoisement
-
+Si vous avez un problème en utilisant un serveur Debian et si vous estimez que
+ les administrateurs système devraient en être avertis, l'équipe des
+ administrateurs système peut être jointe à
+ <email>debian-admin@lists.debian.org</email>.
<p>
-La plupart des développeurs prennent des vacances ; généralement, cela signifie
-qu'ils ne peuvent ni travailler pour Debian ni être joints par
-courrier électronique si un problème se présentait. Les autres développeurs
-ont besoin de savoir que vous êtes en vacances ; ainsi ils sauront comment
-réagir en cas de problème. En général, cela signifie que les autres
-développeurs sont autorisés à modifier votre paquet (voir <ref id="nmu">) en
-cas de gros problème (bogues bloquants pour la distribution, mise à jour de
-sécurité...) durant vos vacances.
+Si votre problème est lié à un certain service ou n'est pas lié au système
+ (paquet à supprimer de l'archive ou suggestion pour le site web par exemple),
+ il vous faudra en général ouvrir un rapport de bogue sur un
+ « pseudo-paquet ». Reportez-vous à la section <ref id="submit-bug">
+ pour connaître la procédure à suivre.
+ <sect1 id="servers-bugs">Le serveur pour les rapports de bogues
<p>
-Il y a deux choses à faire pour informer les autres développeurs.
-Premièrement, envoyer un courrier électronique indiquant vos dates de vacances
-à &email-debian-private;, vous pouvez aussi donner quelques instructions pour
-indiquer comment agir si un problème survenait. Deuxièmement, il faut mettre
-à jour la base de données Debian LDAP et vous signaler « en
-vacances » (l'accès à cette information est réservé aux développeurs).
-N'oubliez pas de retirer votre indicateur « en vacances » lorsque
-celles-ci sont terminées.
-
-
-
-
- <sect id="upstream-coordination">Coordination avec les développeurs
- amonts
-
+<tt>&bugs-host;</tt> est le serveur maître du système de suivi des bogues
+ (BTS<footnote><p>Système de suivi des bogues se dit <em>Bug Tracking
+ System</em> en anglais</footnote>). Si vous envisagez de manipuler les rapports
+ de bogue ou d'en faire une analyse statistique, ce sera le bon endroit pour le
+ faire. Informez la liste &email-debian-devel; de votre intention avant
+ d'implémenter quoi que ce soit afin d'éviter un travail en double ou un
+ gaspillage de temps machine.
<p>
-Une grosse part de votre travail de responsable Debian sera de rester en
-contact avec les développeurs amonts. Parfois, les utilisateurs établissent
-des rapports de bogue qui ne sont pas spécifiques à Debian. Vous devez
-transmettre ces rapports de bogue aux développeurs amonts pour qu'ils soient
-corrigés dans les prochaines versions. Il n'est pas de votre responsabilité
-de corriger les bogues qui ne sont pas spécifiques à Debian. ### However ###,
-si vous êtes capable de le faire, nous vous encourageons à contribuer au
-développements amonts en proposant un <em>patch</em> qui corrige ce bogue.
-Les utilisateurs et responsables Debian proposent souvent des <em>patches</em>
-pour corriger des bogues amonts, il vous faudra alors évaluer ce
-<em>patch</em> puis le transmettre aux développeurs amonts.
+Tous les développeurs Debian ont un compte sur
+ <tt>&bugs-host;</tt>.
+ <sect1 id="servers-ftp-master">Le serveur ftp-master
<p>
-Si vous avez besoin de modifier les sources d'un logiciel pour fabriquer un
-paquet conforme à la charte Debian, alors vous devriez proposer un
-<em>patch</em> aux developpeurs amonts pour qu'il soit inclus dans leur
-version. Ainsi, vous n'aurez plus besoin de modifier les sources lors des
-mises à jour amonts suivantes. Quels que soient les changements dont vous
-avez besoin, il faut toujours essayer de rester dans la lignée des sources
-amonts.
-
-
-
-
-
- <sect id="rc-bug">Gestion des bogues bloquants pour la distribution
-
+Le serveur <tt>ftp-master.debian.org</tt> est le serveur maître de l'archive
+ Debian (exception faite des paquets non-US). En général, les mises à jour de
+ paquets se font sur ce serveur. Reportez-vous à la section <ref id="upload">
+ pour en savoir plus.
<p>
-Les bogues bloquants pour la distribution<footnote>Traduction de l'anglais
-<em>Release critical bug (RCB)</em></footnote> sont les bogues de sévérité
-<em>critique</em>, <em>grave</em> et <em>sérieuse</em><footnote>Respectivement
-<em>critical</em>, <em>grave</em> et <em>serious</em> en anglais</footnote>.
-Ces bogues peuvent retarder la diffusion d'une distribution Debian et/ou
-peuvent justifier la suppression d'un paquet d'une distribution gelée. C'est
-pourquoi ces bogues ont besoin d'être corrigés au plus vite. Vous devez être
-conscient que certains développeurs faisant partie de l'équipe d'<url
-id="&url-debian-qa;" name ="assurance qualité Debian"> surveillent ces bogues
-et essaient de vous aider chaque fois qu'ils le peuvent. Si vous ne pouvez pas
-corriger un bogue de ce type dans les deux semaines, vous devriez soit
-demander de l'aide en envoyant un courrier à l'équipe d'assurance qualité
-(<em>QA group</em> &email-debian-qa;), soit vous expliquer et présenter un
-plan pour corriger le problème en répondant au rapport de bogue
-concerné. Si rien n'est fait, des personnes de l'équipe d'assurance qualité
-pourraient chercher à corriger votre paquet (voir <ref id="nmu">) après avoir
-tenté de vous contacter. Ils pourraient attendre moins longtemps que
-d'habitude pour faire leur mise à jour s'il n'y a pas trace d'activité récente
-de votre part dans le système de suivi des bogues.
-
-
-
- <sect id="qa-effort">L'effort d'assurance qualité
+Les problèmes avec l'archive Debian FTP doivent généralement être rapportés
+ comme bogues sur le pseudo-paquet <package>ftp.debian.org</package> ou par
+ courrier électronique à &email-ftpmaster; ; reportez-vous à la section
+ <ref id="archive-manip"> pour connaître la procédure à suivre.
+ <sect1 id="servers-non-us">Le serveur non-US
<p>
-Même s'il y a un groupe de personnes dédié à l'assurance qualité, cette
-activité ne leur est pas réservée. Vous pouvez participer à cet effort en
-éliminant, autant que faire se peut, tout bogue de vos paquets et en observant
-les remarques émises par <prgn>lintian</prgn> (voir <ref id="lintian-reports">). Si cela
-vous semble tout à fait impossible, il faudrait songer à abandonner certains
-de vos paquets, vous pourrez ainsi faire du bon travail avec les paquets dont
-vous restez responsable (voir <ref id="orphaning">). Vous pouvez aussi
-demander l'aide d'autres personnes pour rattraper votre retard dans la liste
-des bogues (vous pouvez demander de l'aide sur les listes &email-debian-qa;
-et &email-debian-devel;).
-
-
- <sect>Démissionner courtoisement
+Le serveur non-US <tt>non-us.debian.org</tt> est le serveur maître de la partie
+ non-US de l'archive Debian. Si vous avez besoin d'envoyer un paquet dans l'une
+ des sections non-US, envoyez-le vers ce serveur. Reportez-vous à la section
+ <ref id="upload-non-us"> pour en savoir plus.
<p>
-Si vous choisissez de quitter le projet Debian, procédez comme suit :
-
- <enumlist>
- <item>
- Abandonnez tous vos paquets comme décrit dans <ref id="orphaning">.
-
- <item>
- Envoyez un courrier électronique à &email-debian-private; indiquant
- comment vous quittez le projet.
-
- <item>
- Signalez aux responsables du porte-clés Debian que vous quittez le
- projet en écrivant à &email-debian-keyring;.
-
- </enumlist>
-
-
-
-
-
- <chapt id="servers">Listes de diffusion, serveurs et autres machines
+Les problèmes avec l'archive de paquets non-US doivent généralement être
+ rapportés comme bogues sur le pseudo-paquet <package>nonus.debian.org</package>
+ (remarquez l'absence de trait d'union entre "non" et "us" dans le nom du
+ pseudo-paquet — c'est dû à la compatibilité descendante). Rappelez-vous
+ de vérifier si quelqu'un n'aurait pas déjà rempli un rapport de bogue
+ concernant le problème sur le <url id="http://&bugs-host;/nonus.debian.org"
+ name="système de suivi des bogues">.
+ <sect1 id="servers-www">Le serveur www-master
<p>
-Dans ce chapitre vous trouverez une très brève description des listes de
-diffusion Debian, des principaux serveurs Debian et des autres machines
-auxquelles vous aurez accès en tant que développeur.
-
-
-
- <sect id="mailing-lists">Les listes de diffusion
-
+Le serveur web principal est <tt>www-master.debian.org</tt>. Il héberge les
+ pages web officielles, la façade de Debian pour la plupart des débutants.
<p>
-Le serveur de liste de diffusion est <tt>&lists-host;</tt>. Envoyez un
-courrier électronique à <tt>debian-<var>foo</var>-REQUEST@&lists-host;</tt>,
-où <tt>debian-<var>foo</var></tt> est le nom de la liste, avec le mot
-<tt>subscribe</tt> dans le champ <em>Objet</em><footnote><em>Subject</em> en
-anglais</footnote> pour vous abonner à la liste ou <tt>unsubscribe</tt> pour
-vous désabonner. Vous trouverez des instructions plus détaillées pour vous
-abonner et vous désabonner aux adresses <url
-id="&url-debian-lists-subscribe;">, <url id="&url-debian-lists;"> ou
-localement dans le fichier &file-mail-lists; si vous avez installé le paquet
-<package>doc-debian</package>.
+Si vous rencontrez un problème avec un serveur web Debian, vous devez
+ généralement envoyer un rapport de bogue sur le pseudo-paquet
+ <package>www.debian.org</package>. Vérifiez d'abord sur le <url
+ id="http://&bugs-host;/www.debian.org" name="système de suivi des bogues">
+ que personne ne l'a déjà rapporté avant vous.
+ <sect1 id="servers-people">Le serveur web people
<p>
-Lorsque vous répondez aux messages d'une liste de diffusion,
-n'envoyez pas de copie (<tt>CC</tt>) à l'auteur du courrier à moins
-qu'il ne l'ait demandé explicitement. Quelqu'un qui envoie un message à une
-liste de diffusion se doit d'y lire les réponses.
-
+<tt>people.debian.org</tt> est le serveur utilisé par les développeurs pour
+leurs pages concernant Debian.
<p>
-Les principales listes de diffusion Debian sont :
- <list compact>
- <item> &email-debian-devel;,
- <item> &email-debian-policy;,
- <item> &email-debian-user;,
- <item> &email-debian-private;,
- <item> &email-debian-announce; et
- <item> &email-debian-devel-announce;.
- </list>
-
-Un développeur devrait, au minimum, être inscrit aux listes
-&email-debian-private; et &email-debian-devel-announce;.
-
+Si vous avez des informations spécifiques Debian que vous voulez rendre
+ disponibles sur le web, vous pouvez le faire en les plaçant dans le répertoire
+ <file>public_html</file> de votre répertoire personnel sur
+ <tt>people.debian.org</tt>. Elles seront accessibles à l'adresse
+ <tt>http://people.debian.org/~<var>votre-user-id</var>/</tt>.
<p>
-Il existe d'autres listes de diffusion spécialisées dans différents thèmes.
-Reportez-vous à la page <url id="&url-debian-lists-subscribe;"> pour en
-obtenir la liste complète. Nous déconseillons l'usage des correspondances
-croisées (envoyer le même message à plusieurs listes).
-
+Vous ne devriez utiliser que cet emplacement particulier car il sera sauvegardé
+ alors que sur les autres serveurs, ce ne sera pas le cas.
<p>
-&email-debian-private; est une liste de diffusion destinée aux discussions
-privées entre développeurs Debian. Elle doit être utilisée pour tout message
-qui ne doit pas être publié, quelqu'en soit la raison. C'est une liste à
-faible trafic et les utilisateurs sont priés de ne l'utiliser qu'en cas de
-réelle nécessité. De plus, il ne faut <em>jamais</em> faire suivre un courrier
-de cette liste à qui que ce soit.
-
+Habituellement, la seule raison pour utiliser un serveur différent est que vous
+ avez besoin de publier des informations soumises aux restrictions d'exportation
+ américaines, dans ce cas, vous pouvez utiliser l'un des autres serveurs situés
+ en dehors des États-Unis, comme le serveur mentionné ci-dessus
+ <tt>non-us.debian.org</tt>.
<p>
-&email-debian-email; est une liste de diffusion fourre-tout. Elle est utilisée
-pour les correspondances relatives à Debian qu'il serait utile d'archiver, telles
-que des échanges avec les auteurs amonts à propos de licences, de bogues ou encore
-des discussions sur le projet avec d'autres personnes.
+Veuillez envoyer un courrier à &email-debian-devel; si vous avez une question.
+ <sect1 id="servers-cvs">Le serveur CVS
<p>
-Comme toujours sur internet, éliminez les lignes inutiles quand vous citez
-le message auquel vous répondez. Plus généralement, respectez
-les conventions habituelles lorsque vous envoyez des messages.
-
+Notre serveur CVS est situé sur <tt>cvs.debian.org</tt>.
<p>
-Les archives des listes de diffusion sont disponibles en ligne à l'adresse
-<url id="&url-lists-archives;">.
-
-
-
-
- <sect id="server-machines">Les serveurs Debian
-
+Si vous avez besoin d'un serveur CVS accessible par tous pour, par exemple,
+ coordonner le travail de plusieurs développeurs sur un paquet, vous pouvez
+ demander un espace CVS sur ce serveur.
<p>
-Les serveurs Debian sont bien connus et hébergent les fonctions
-critiques du projet Debian. Tout développeur se doit de savoir ce qu'ils sont
-et à quoi ils servent.
-
+Le serveur <tt>cvs.debian.org</tt> autorise les accès CVS locaux, les accès en
+ lecture seule pour les connexions client-serveur anonymes et les accès
+ client-serveur complets pour les connexions <prgn>ssh</prgn>. L'espace CVS peut
+ aussi être consulté par la toile à l'adresse <url id="&url-cvsweb;">.
<p>
-Si vous avez un problème en utilisant un serveur Debian et si vous estimez que
-les administrateurs système devraient en être avertis, vous trouverez
-l'adresse d'un responsable pour cette machine à la page <url
-id="&url-devel-machines;">. Si votre problème n'est pas lié au système
-(paquet à supprimer ou suggestion pour le site web par exemple), il vous
-faudra en général ouvrir un rapport de bogue sur un
-« pseudo-paquet ». Reportez-vous à la section <ref id="submit-bug">
-pour connaître la procédure à suivre.
-
-
+Pour obtenir un espace CVS, envoyez une demande à l'adresse &email-debian-admin;
+ en précisant le nom de l'espace, le compte Debian propriétaire du répertoire
+ racine et pourquoi vous en avez besoin.
- <sect1 id="servers-master">Le serveur maître
-
+ <sect id="devel-db">La base de données des développeurs
<p>
-<tt>master.debian.org</tt> est le serveur maître du système de suivi des
-bogues (BTS<footnote>Système de suivi des bogues se dit <em>Bug Tracking
-System</em> en anglais</footnote>). Si vous envisagez de manipuler les
-rapports de bogue ou d'en faire une analyse statistique ce sera le bon endroit
-pour le faire. Informez la liste &email-debian-devel; de votre intention
-avant d'implémenter quoi que ce soit afin d'éviter un travail en double
-ou le gaspillage de temps machine.
-
+La base de données des développeurs à <url id="&url-debian-db;"> est un annuaire
+ LDAP de gestion des informations des développeurs Debian. Vous pouvez utiliser
+ cette ressource pour rechercher la liste des développeurs Debian. Une partie de
+ ces informations est également disponible à travers le service <prgn>finger</prgn> sur les
+ serveurs Debian, essayez <prgn>finger yourlogin@debian.org</prgn> pour voir ce
+ qu'il indique.
<p>
-Tous les développeurs Debian ont un compte sur <tt>master.debian.org</tt>.
-Prenez grand soin de votre mot de passe. Évitez les méthodes de connexion et
-de téléchargement qui envoient votre mot de passe en clair sur internet.
-
+Les développeurs peuvent <url name="se connecter à la base de données"
+id="&url-debian-db-login;"> pour modifier différentes informations les
+concernant, comme :
+<list>
+ <item>l'adresse de suivi pour leur adresse debian.org,
+ <item>l'abonnement à debian-private,
+ <item>l'état en vacances ou non,
+ <item>des informations personnelles comme les adresse, pays, latitude et
+ longitude de l'endroit où ils vivent pour utilisation dans la <url
+ name="carte mondiale des développeurs Debian" id="&url-worldmap">,
+ numéros de téléphone et de fax, surnom IRC et page web,
+ <item>le mot de passe et le shell préféré sur les machines du projet Debian.
+</list>
<p>
-Si vous rencontrez un problème avec <tt>master.debian.org</tt> tel qu'un
-disque plein, une activité suspecte ou autre, envoyez un courrier
-électronique à &email-debian-admin;.
-
-
+La plupart des informations ne sont naturellement pas accessibles publiquement.
+Pour plus d'informations, veuillez lire la documentation en ligne que vous
+pouvez trouver à <url id="&url-debian-db-doc;">.
+<p>
+Il est également possible d'envoyer ses clés SSH pour les utiliser pour
+ autorisation sur les machines Debian officielles et même d'ajouter de nouvelles
+ entrées DNS du type *.debian.net. Ces fonctionnalités sont documentées à <url
+ id="&url-debian-db-mail-gw;">.
- <sect1 id="servers-ftp-master">Le serveur ftp-master
+ <sect id="archive">L'archive Debian
<p>
-Le serveur ftp-master (<tt>ftp-master.debian.org</tt> ou <tt>
-auric.debian.org</tt>) est le serveur maître de l'archive Debian
-(exception faite des paquets non-US). En général, les mises à jour de
-paquets se font sur ce serveur. Reportez-vous à la section <ref id="upload">
-pour en savoir plus.
-
+La distribution &debian-formal; est composée d'un grand nombre de paquets
+ (fichiers <tt>.deb</tt> : actuellement, à peu près &number-of-pkgs;) et de
+ quelques autres fichiers (comme la documentation et des images des disquettes
+ d'installation).
<p>
-Les problèmes avec l'archive Debian FTP doivent généralement être rapportés
-comme bogue contre le pseudo-paquet <package>ftp.debian.org</package> ou par
-courrier électronique à &email-ftpmaster; ; reportez-vous à la section <ref
-id="archive-manip"> pour connaître la procédure à suivre.
-
-
-
-
- <sect1 id="servers-www">Le serveur WWW
-
+Voici un exemple d'arborescence pour une archive Debian complète :
<p>
-Le serveur web principal, <tt>www.debian.org</tt>, est aussi connu sous le nom
-<tt>klecker.debian.org</tt>. Tous les développeurs ont un compte sur cette
-machine.
-
+&sample-dist-dirtree;
<p>
-Si vous désirez publier quelques informations spécifiques à Debian sur la
-toile,
-vous pouvez le faire en les déposant dans le sous-répertoire
-<file>public_html</file> de votre répertoire personnel sur
-<tt>klecker.debian.org</tt>. Toute information déposée à cet endroit est
-accessible à l'adresse <tt>http://people.debian.org/~<var>user-id</var>/</tt>.
-Vous devriez préférer ce serveur aux autres car les répertoires
-<file>public_html</file> du serveur <tt>klecker.debian.org</tt> sont
-sauvegardés. Ce n'est pas le cas sur les autres serveurs. N'utilisez pas ces
-serveurs pour publier des informations sans rapport avec le projet Debian
-avant d'en avoir obtenu la permission. Pour toute question supplémentaire,
-adressez-vous à la liste &email-debian-devel;.
-
+Comme vous pouvez le voir, le répertoire racine contient deux répertoires,
+ <file>dists/</file> et <file>pool/</file>. Le second est un ensemble de
+ répertoires où sont stockés les paquets. Ceux-ci sont manipulés grâce à la base
+ de données de l'archive et aux logiciels qui l'accompagnent. Le premier
+ répertoire contient les distributions <em>stable</em>, <em>testing</em> et
+ <em>unstable</em>. Les fichiers <file>Packages</file> et <file>Sources</file>
+ qui se trouvent dans les répertoires de distribution peuvent faire référence à
+ des fichiers du répertoire <file>pool/</file>. Le découpage en sous-répertoires
+ est identique d'un répertoire de distribution à l'autre . Ce que nous
+ exposerons ci-dessous pour la distribution <em>stable</em> est également
+ applicable aux distributions <em>unstable</em> et <em>testing</em>.
+<p>
+Le répertoire <file>dists/stable</file> contient trois répertoires nommés
+ <file>main</file>, <file>contrib</file> et <file>non-free</file>.
+<p>
+Dans chacune de ces sections, se trouve un répertoire contenant les paquets
+ sources (<file>source/</file>) et un répertoire pour chaque architecture
+ acceptée (<file>binary-i386/</file>, <file>binary-m68k/</file>, etc.).
<p>
-Si vous rencontrez un problème avec un serveur web Debian, vous devez
-généralement envoyer un rapport de bogue contre le pseudo-paquet
-<package>www.debian.org</package>. Vérifiez d'abord sur le <url
-id="http://bugs.debian.org/www.debian.org" name="système de suivi des bogues">
-que personne ne l'a déjà rapporté avant vous.
-
-
-
+La section <em>main</em> contient d'autres répertoires destinés aux images de
+ disquettes et à plusieurs documents essentiels pour installer la distribution
+ Debian sur une architecture particulière (<file>disk-i386/</file>,
+ <file>disk-m68k/</file>, etc.).
- <sect1 id="servers-cvs">Le serveur CVS
-
+ <sect1>Les sections
<p>
-Le serveur <tt>cvs.debian.org</tt> est aussi connu sous le nom
-<tt>klecker.debian.org</tt> (déjà présenté plus haut). Si vous avez besoin
-d'un serveur CVS accessible par tous pour, par exemple, coordonner le travail
-de plusieurs développeurs sur un paquet, vous pouvez demander un espace sur ce
-serveur.
-
+La section <em>main</em> constitue la <strong>distribution &debian-formal;
+ officielle</strong>. Elle est officielle parce qu'elle est entièrement conforme
+ à toutes nos recommandations. Les deux autres sections divergent de ces
+ recommandations à différents degrés, elles <strong>ne</strong> font donc <strong>pas</strong>
+ officiellement partie de &debian-formal;.
<p>
-Le serveur <tt>cvs.debian.org</tt> autorise les accès CVS locaux, les accès en
-lecture seule pour les connexions client-serveur anonymes et les accès
-client-serveur complets pour les connexions <prgn>ssh</prgn>. L'espace CVS peut
-aussi être consulté par la toile à l'adresse <url id="&url-cvsweb;">.
-
+Chaque paquet de la section <em>main</em> doit être conforme aux <url
+ id="&url-dfsg;" name="directives Debian pour le logiciel
+ libre"><footnote>Debian Free Software Guidelines</footnote> et à toutes les
+ autres recommandations décrites dans <url id="&url-debian-policy;" name="la
+ charte Debian"><footnote>Debian Policy Manual</footnote>. Les
+ DFSG<footnote><em>Debian Free Software Guidelines</em></footnote> constituent
+ notre définition de « logiciel libre ». Reportez-vous à la <em>charte
+ Debian</em> pour en savoir plus.
+<p>
+Les paquets de la section <em>contrib</em> doivent être conformes aux DFSG, mais
+ ne respectent pas d'autres contraintes. Ils peuvent, par exemple, dépendre de
+ paquets de la section <em>non-free</em>.
<p>
-Pour obtenir un espace CVS, envoyez une demande à l'adresse
-&email-debian-admin; en précisant le nom de l'espace, le propriétaire du
-répertoire racine et pourquoi vous en avez besoin.
-
-
-
-
- <sect1 id="servers-mirrors">Les miroirs des serveurs Debian
-
+Les paquets qui ne sont pas conformes aux DFSG sont rangés dans la section
+ <em>non-free</em>. Bien que nous supportions l'usage de ces paquets et qu'ils
+ bénéficient de nos infrastructures (système de suivi des bogues, listes de
+ diffusion, etc.), ces paquets <em>non-free</em> ne font pas partie de la
+ distribution Debian.
+<p>
+La <em>charte Debian</em> donne des définitions plus précises pour ces trois
+ sections. Les paragraphes précédents ne constituent qu'une introduction.
+<p>
+La séparation de l'archive en trois sections est importante pour toute personne
+ qui désire distribuer Debian, que ce soit par serveur FTP ou sur cédérom. Il
+ suffit de distribuer les sections <em>main</em> et <em>contrib</em> pour éviter
+ tout problème légal. Certains paquets de la section <em>non-free</em>
+ interdisent leur distribution à titre commercial par exemple.
+<p>
+D'un autre côté, un distributeur de cédérom pourra facilement vérifier
+ la licence de chacun des paquets de la section <em>non-free</em> et
+ inclure tous les paquets qu'il lui sera autorisé (dans
+ la mesure où cela varie énormément d'un distributeur à l'autre, ce travail ne
+ peut être fait par les développeurs Debian).
+<p>
+Notez que le terme « section » est également utilisé pour faire
+ référence aux catégories qui simplifient l'organisation des paquets
+disponibles et leur recherche, e.g. <em>admin</em>, <em>net</em>, <em>utils</em> etc. Il
+ fut un temps où ces sections (sous-sections, plutôt) existaient sous la forme
+ de sous-répertoires dans l'archive Debian. Actuellement, elles n'existent plus
+ que dans le champ en-tête « Section » des paquets.
+
+ <sect1>Les architectures
<p>
-Les serveurs web et FTP Debian sont dupliqués sur d'autres serveurs. Évitez de
-charger les serveurs originaux. Idéalement, les serveurs originaux se
-contentent de copier leur contenu sur les miroirs de premier niveau et
-tous les utilisateurs consultent les miroirs. Ainsi le projet Debian étale
-ces besoins en bande passante sur plusieurs serveurs et plusieurs réseaux.
-Notez que la duplication des données sur les miroirs est déclenchée par le
-serveur maître. Ceci nous garantit que les miroirs sont aussi à jour que
-possible.
-
+À ses débuts, le noyau Linux existait uniquement pour les architectures Intel
+ x86 ; il en était de même pour Debian. Linux devenant de plus en plus
+ populaire, il a été porté vers d'autres architectures.
+<p>
+Le noyau 2.0 existe pour les architectures Intel x86, DEC Alpha, SPARC,
+ Motorola, 680x0 (Atari, Amiga, et Macintosh), MIPS et PowerPC. Le noyau 2.2
+ reconnaît de nouvelles architectures, comme ARM et UltraSPARC. Puisque Linux
+ reconnaît ces architectures, le projet Debian a décidé qu'il devait également les
+ accepter. C'est pourquoi plusieurs portages sont en cours ; en fait, il y
+ a aussi des portages vers d'autres noyaux. À côté d'<em>i386</em> (notre nom
+ pour Intel x86), nous avons, au moment où j'écris, <em>m68k</em>,
+ <em>alpha</em>, <em>powerpc</em>, <em>sparc</em>, <em>hurd-i386</em>,
+ <em>arm</em>, <em>ia64</em>, <em>hppa</em>, <em>s390</em>, <em>mips</em>,
+ <em>mipsel</em> et <em>sh</em>.
+<p>
+&debian-formal; 1.3 est disponible uniquement pour <em>i386</em>. Debian 2.0
+ reconnaît les architectures <em>i386</em> et <em>m68k</em>. Debian 2.1 reconnaît
+ les architectures <em>i386</em>, <em>m68k</em>, <em>alpha</em> et
+ <em>sparc</em>. Debian 2.2 accepte en plus les architectures
+ <em>powerpc</em> et <em>arm</em>. Debian 3.0 accepte cinq
+ nouvelles architectures : <em>ia64</em>, <em>hppa</em>, <em>s390</em>,
+ <em>mips</em> et <em>mipsel</em>.
+<p>
+Pour chaque portage, vous trouverez des informations destinées aux développeurs
+ et utilisateurs sur la page <url id="&url-debian-ports;" name="Portage
+ Debian">.
+
+ <sect1>Les paquets
+<p>
+Il existe deux types de paquets Debian : les paquets sources et les paquets
+ binaires.
+<p>
+Les paquets sources sont constitués de deux ou trois fichiers : un fichier
+ <file>.dsc</file> et soit un fichier <file>.tar.gz</file>, soit un fichier
+ <file>.orig.tar.gz</file> et un fichier <file>.diff.gz</file>.
<p>
-La liste des miroirs FTP (et en général HTTP) se trouve à l'adresse <url
-id="&url-debian-mirrors;">. Vous trouverez plus d'information sur les miroirs
-Debian à l'adresse <url id="&url-debian-mirroring;">. Cette page contient des
-informations et des outils qui pourront vous aider si vous avez l'intention de
-mettre en place votre propre miroir, que ce soit pour un usage interne ou
-pour un accès public.
-
+Si un paquet est développé spécifiquement pour le projet Debian et n'est pas
+ distribué en dehors de Debian, il n'y a qu'un fichier <file>.tar.gz</file> qui
+ contient les sources du programme. Si un paquet est distribué ailleurs, le
+ fichier <file>.orig.tar.gz</file> contient ce que l'on appelle <em>code source
+ amont</em>, c'est-à-dire, le code source distribué par le <em>mainteneur
+ amont</em> (il s'agit souvent de l'auteur du logiciel). Dans ce cas, le fichier
+ <file>.diff.gz</file> contient les modifications faites par le responsable
+ Debian.
+<p>
+Le fichier <file>.dsc</file> liste tous les fichiers sources avec leurs sommes
+ de contrôle (<prgn>md5sums</prgn>) et quelques informations supplémentaires
+ concernant le paquet (responsable, version, etc.).
+
+ <sect1>Les distributions
+<p>
+L'organisation des répertoires présentée précédemment est elle-même englobée par
+ les <em>répertoires des distributions</em>. Chaque distribution est incluse
+ dans le répertoire <file>pool</file> à la racine de l'archive Debian.
+<p>
+Pour résumer, une archive Debian a un répertoire racine sur un serveur FTP. Par
+ exemple, sur le site miroir <ftpsite>ftp.us.debian.org</ftpsite>, l'archive
+ Debian se trouve dans <ftppath>/debian</ftppath> ce qui est un emplacement
+ courant. Un autre emplacement courant est <file>/pub/debian</file>.
+<p>
+Une distribution est composée de paquets sources et binaires et des
+ fichiers <file>Sources</file> et <file>Packages</file> correspondants qui
+ contiennent toutes les méta-informations sur les paquets. Les premiers sont
+ conservés dans le répertoire <file>pool/</file> tandis que les seconds sont
+ conservés dans le répertoire <file>dists/</file> de l'archive (pour
+ compatibilité descendante).
+
+ <sect2 id="sec-dists"><em>Stable</em>, <em>testing</em> et
+ <em>unstable</em>
<p>
-Les miroirs sont en général mis en oeuvre par des tiers qui veulent aider
-Debian. C'est pourquoi les développeurs n'ont en général pas de compte sur ces
-machines.
-
-
-
-
- <sect id="other-machines">Les autres machines Debian
-
+Il y a toujours une distribution appelée <em>stable</em> (dans le répertoire
+ <file>dists/stable</file>), une distribution appelée <em>testing</em> (dans le
+ répertoire <file>dists/testing</file>) et une distribution appelée
+ <em>unstable</em> (dans le répertoire <file>dists/unstable</file>). Ceci
+ reflète le processus de développement du projet Debian.
+<p>
+Les développements se font sur la distribution
+ <em>unstable</em><footnote><p><em>unstable</em> signifie
+ « instable »</footnote> (c'est pourquoi elle est aussi appelée
+ <em>distribution de développement</em>). Chaque développeur Debian peut
+ modifier ses paquets à tout moment dans cette distribution. Ainsi son contenu
+ change tous les jours. Comme aucun effort particulier n'est fait pour s'assurer
+ que tout fonctionne correctement dans cette distribution, elle est parfois
+ littéralement « instable ».
+<p>
+<ref id="testing"> est générée automatiquement en prenant les paquets
+ d'<em>unstable</em> s'ils satisfont à certains critères. Ces critères
+ garantissent que les paquets de <em>testing</em> sont de bonne qualité. La
+ mise à jour de <em>testing</em> est lancée chaque jour après que les
+ nouveaux paquets ont été installés.
<p>
-Vous aurez peut-être accès à d'autres machines Debian. Vous pouvez utiliser
-ces machines pour des tâches en rapport avec le projet Debian. Soyez gentils
-avec les administrateurs et ne consommez pas des montagnes d'espace disque, de
-bande passante ou de temps machine sans en avoir d'abord reçu l'autorisation.
-En général, ces machines sont gérés par des volontaires et sont utilisées pour
-des activités de portage.
-
+Après une période de développement, quand le responsable de
+ distribution<footnote><p><em>Release manager</em></footnote> le juge opportun,
+ la distribution <em>testing</em> est gelée, ce qui signifie que les conditions
+ à remplir pour qu'un paquet passe d'<em>unstable</em> à <em>testing</em> sont
+ durcies. Les paquets trop bogués sont supprimés et les seules mises à jours
+ autorisées concernent les corrections de bogues. Après quelque temps, selon
+ l'avancement, la distribution entre dans une phase de « gel complet »
+ où les seules modifications acceptées concernent la procédure d'installation.
+ Cette phase s'appelle un « cycle de test » et cela peut durer jusqu'à
+ deux semaines. Il peut y avoir plusieurs cycles de tests avant que le
+ responsable de distribution ne la déclare prête pour la diffusion. À la fin du
+ dernier cycle de test, la distribution <em>frozen</em> devient <em>stable</em>,
+ remplaçant l'ancienne distribution <em>stable</em> qui est enlevée à cette
+ occasion (elle peut être retrouvée à l'adresse <tt>&archive-host;</tt>).
<p>
-Vous trouverez une liste des autres machines mises à la disposition des
-développeurs Debian à l'adresse <url id="&url-devel-machines;">.
-
-
-
-
-
- <chapt id="archive">L'archive Debian
+Ce cycle de développement est basé sur l'idée que la distribution
+ <em>unstable</em> devient <em>stable</em> après une période de test
+ (<em>testing</em>). Une distribution contient inévitablement des bogues, même
+ si elle est classée stable. C'est pourquoi les distributions stables sont mises
+ à jour de temps en temps. Les corrections introduites sont testées avec une
+ grande attention et sont ajoutées une à une à l'archive pour diminuer les
+ risques d'introduire de nouveaux bogues. Vous pouvez trouver des paquets
+ proposés pour les mises à jour de <em>stable</em> dans le répertoire
+ <file>proposed-updates</file>. De temps en temps, les paquets de ce répertoire
+ qui ne présentent pas de problème sont installés dans la distribution
+ <em>stable</em> et le numéro de révision de cette distribution est incrémenté
+ (« 3.0 » devient « 3.0r1 », « 2.0r4 » devient
+ « 2.0r5 » et ainsi de suite).
+<p>
+Notez que, pendant la période de gel, les développements continuent sur la
+ distribution <em>unstable</em> car cette distribution reste en place.
+
+ <sect2 id="testing">
+ <heading>Informations complémentaires sur la distribution
+ « testing »</heading>
+<p>
+Les scripts qui mettent à jour la distribution <em>testing</em> sont exécutés
+ chaque jour après l'installation des paquets mis à jour. Ils fabriquent les
+ fichiers <file>Packages</file> pour la distribution <em>testing</em>, mais ils
+ le font d'une manière intelligente pour éviter toute incohérence et essayer de
+ n'utiliser que des paquets sans bogue.
+<p>
+L'inclusion d'un paquet d'<em>unstable</em> est soumise aux
+ conditions suivantes :
+<list compact="compact">
+<item><p>Le paquet doit avoir été disponible dans <em>unstable</em> depuis
+ plusieurs jours ; le nombre précis dépend du champ d'urgence de
+ l'envoi. Il s'agit de 10 jours pour une urgence faible, 5 jours pour une
+ urgence moyenne et 2 jours pour une urgence élevée. Ces délais peuvent
+ être doublés lors d'un gel de distribution ;</item>
+<item><p>Il doit avoir moins de bogues empêchant l'intégration dans la distribution que la
+ version disponible dans <em>testing</em> ;</item>
+<item><p>Il doit être disponible pour toutes les architectures pour lesquelles
+ il a été auparavant construit. <ref id="madison"> peut être
+ intéressant pour vérifier cette information ;</item>
+<item><p>Il ne doit pas casser les dépendances d'un paquet qui est déjà
+ disponible dans <em>testing</em> ;</item>
+<item><p>Les paquets dont il dépend doivent soit être déjà disponibles dans
+ <em>testing</em> soit être acceptés dans <em>testing</em> au
+ même moment (et ils doivent eux-mêmes respecter tous ces
+ critères).</item>
+</list>
+<p>
+Pour savoir si un paquet a progressé ou non dans <em>testing</em>, veuillez voir la
+ sortie du script de <em>testing</em> sur la <url name="page web de la distribution testing"
+id="&url-testing-maint;"> ou utilisez le programme <prgn>grep-excuses</prgn>
+inclus dans le paquet <package>devscripts</package>. Si l'on veut rester
+informé de la progression de ses paquets dans <em>testing</em>, on peut
+facilement le mettre dans la <manref
+ section="5" name="crontab">.
+<p>
+Le fichier <file>update_excuses</file> ne donne pas toujours la raison précise
+ pour laquelle un paquet est refusé, on peut avoir à la chercher soi-même en
+ regardant ce qui serait cassé avec l'inclusion du paquet. La <url
+ id="&url-testing-maint;" name="page web de la distribution testing"> donne plus
+ d'informations à propos des problèmes courants qui peuvent occasionner cela.
+<p>
+Parfois, certains paquets n'entrent jamais dans <em>testing</em> parce que le
+ jeu des inter-relations est trop compliqué et ne peut être résolu par le
+ script. Dans ce cas, le responsable de version doit être contacté et il forcera
+ l'inclusion du paquet.
+ <p>
+En général, veuillez vous référer à la <url name="page web de la distribution testing"
+id="&url-testing-maint;"> pour plus d'informations. Cette page inclut également
+des réponses aux questions fréquemment posées.
- <sect>Aperçu
+ <sect2 id="experimental">Experimental
<p>
-La distribution Debian est composée d'un grand nombre de paquets Debian
-(fichiers <tt>.deb</tt> : à peu près &number-of-pkgs;) et de quelques
-autres fichiers (documentation, images des disquettes d'installation,
-etc.).
-
+La distribution <em>experimental</em> est une distribution particulière. Ce n'est
+ pas une distribution à part entière comme le sont <em>stable</em> et
+ <em>unstable</em>. Elle est prévue pour servir de plate-forme de
+ développement pour les projets expérimentaux qui risquent vraiment de
+ détruire le système ou bien pour des logiciels qui sont vraiment trop
+ instables pour être inclus dans la distribution <em>unstable</em> (mais pour
+ lesquels une mise en paquet est justifiée). Les utilisateurs qui téléchargent
+ et installent des paquets depuis <em>experimental</em> sont prévenus :
+ on ne peut pas faire confiance à la distribution <em>experimental</em>.
<p>
-Voici un exemple d'arborescence pour une archive Debian complète :
-
+Voici les lignes de <manref name="sources.list" section="5"> pour
+ <em>experimental</em> :
+<example>
+deb http://ftp.<var>xy</var>.debian.org/debian/ ../project/experimental main
+deb-src http://ftp.<var>xy</var>.debian.org/debian/ ../project/experimental main
+</example>
<p>
-&sample-dist-dirtree;
-
+Si un logiciel peut causer des dégats importants, il sera sûrement
+ préférable de le mettre dans la distribution <em>experimental</em>. Un
+ système de fichiers compacté expérimental, par exemple, devrait probablement
+ aller dans <em>experimental</em>.
+<p>
+Une nouvelle version amont qui ajoute de nouvelles fonctions tout en supprimant
+ de nombreuses autres ne devra pas être téléchargée dans l'archive Debian,
+ elle pourra cependant être téléchargée dans <em>experimental</em>. Une
+ nouvelle version non finalisée d'un logiciel qui utilise une méthode de
+ configuration complètement différente pourrait aller dans
+ <em>experimental</em> au gré du responsable. Si vous travaillez sur un cas de
+ mise à jour complexe ou incompatible, vous pouvez aussi utiliser
+ <em>experimental</em> comme plate-forme d'intégration et ainsi fournir un
+ accès aux testeurs.
+<p>
+Quelques logiciels expérimentaux peuvent cependant aller dans <em>unstable</em>,
+ avec un avertissement dans la description, mais ce n'est pas recommandé car
+ les paquets d'<em>unstable</em> se propagent dans <em>testing</em> et
+ aboutissent dans <em>stable</em>. Vous ne devriez pas avoir peur d'utiliser
+ <em>experimental</em> car ceci ne cause aucun souci aux ftpmasters, les
+ paquets expérimentaux sont automatiquement enlevés quand vous envoyez le
+ paquet dans <em>unstable</em> avec un numéro de version supérieur.
+<p>
+Un nouveau logiciel qui ne risque pas d'endommager le système ira directement
+ dans <em>unstable</em>.
+<p>
+Une solution de rechange à <em>experimental</em> consiste à utiliser vos pages
+ personnelles sur le serveur <tt>people.debian.org</tt>.
+
+ <sect1 id="codenames">Les noms de distribution
+<p>
+Chaque distribution Debian diffusée a un <em>nom de code</em> : Debian 1.1
+ s'appelle « buzz » ; Debian 1.2, « rex » ; Debian
+ 1.3, « bo » ; Debian 2.0, « hamm » ; Debian 2.1,
+ « slink »; Debian 2.2, « potato » et Debian 3.0,
+ « woody ». Il y a aussi une pseudo-distribution nommée
+ « sid », il s'agit de la distribution <em>unstable</em> ; comme
+ les paquets vont d'<em>unstable</em> à <em>testing</em> quand ils approchent
+ de la stabilité, la distribution « sid » n'est jamais diffusée. En
+ plus du contenu habituel d'une distribution Debian, « sid » contient
+ des paquets pour des architectures qui ne sont pas encore officiellement
+ reconnues ou pour lesquelles la distribution n'a pas encore été diffusée. Ces
+ architectures seront intégrées ultérieurement à la distribution principale.
<p>
-Comme vous pouvez le voir, le répertoire racine contient deux répertoires,
-<tt>dists/</tt> et <tt>pool/</tt>. Le second est un ensemble de répertoires où
-sont stockés les paquets. Ceux-ci sont manipulés grâce à la base de données de
-l'archive et aux logiciels qui l'accompagnent. Le premier répertoire contient
-les distributions <em>stable</em>, <em>testing</em> et <em>unstable</em>. Le
-découpage en sous-répertoires est identique d'un répertoire de distribution à
-l'autre ; nous nous contenterons donc d'exposer ce découpage pour la
-distribution <em>stable</em>. Les fichiers <tt>Packages</tt> et
-<tt>Sources</tt> qui se trouvent dans les répertoires de distribution peuvent
-faire référence à des fichiers du répertoire <tt>pool/</tt>.
+Comme Debian est un projet de développement ouvert (i.e. tout le monde peut
+ participer et suivre les développements), même les distributions
+ <em>unstable</em> et <em>testing</em> sont disponibles sur les serveurs HTTP et
+ FTP de Debian. Si nous avions nommé le répertoire qui contient la prochaine
+ distribution à diffuser « testing », il aurait fallu changer son nom en
+ « stable » au moment de la diffusion, ce qui aurait forcé les miroirs
+ FTP à télécharger à nouveau la distribution complète (qui est plutôt volumineuse).
+<p>
+D'un autre côté, si une distribution s'appelait <em>Debian-x.y</em> dès le
+ départ, des personnes pourraient s'imaginer que la distribution Debian
+ <em>x.y</em> est disponible. (Cela s'est produit par le passé, un distributeur
+ avait gravé des cédéroms Debian 1.0 en utilisant une version de développement
+ pré-1.0. C'est pour cette raison que la première version officielle était la
+ version 1.1 et non la 1.0).
+<p>
+En conséquence, les noms de répertoire des distributions dans l'archive sont
+ déterminés par leur nom de code et non par leur statut (exemple :
+ slink). Ces noms sont identiques pendant la période de développement et une
+ fois la distribution diffusée ; des liens symboliques, qui peuvent être
+ modifiés facilement, indiquent la distribution stable actuelle. Tout ceci
+ explique pourquoi les répertoires des distributions sont nommés à partir des
+ noms de code des distributions alors que <em>stable</em>, <em>testing</em> et
+ <em>unstable</em> sont des liens symboliques qui pointent vers les répertoires
+ appropriés.
+ <sect id="mirrors">Les miroirs Debian
+ <p>
+Les différentes archives de téléchargement et le site web disposent de plusieurs
+miroirs pour soulager les serveurs principaux d'une lourde charge. En fait,
+certains de ces serveurs ne sont pas publics et la charge est
+répartie sur une première série de serveurs. De cette façon, les
+utilisateurs ont toujours accès aux miroirs et s'y habituent, ce qui permet à
+Debian de mieux répartir les besoins en bande passante sur plusieurs serveurs et
+plusieurs réseaux différents et évitent aux utilisateurs de surcharger
+l'emplacement primaire. Notez que, dans cette première série, les serveurs sont aussi à jour
+que possible car la mise à jour est déclenchée par les sites maîtres internes.
+ <p>
+Toutes les informations sur les miroirs Debian peuvent être trouvées à <url
+id="&url-debian-mirrors;">, y compris une liste des miroirs publics disponibles
+FTP/HTTP. Cette page utile inclut également des informations et des outils pour
+créer son propre miroir, soit en interne soit pour un accès public.
+ <p>
+Les miroirs sont en général mis en œuvre par des tiers qui veulent aider
+ Debian. C'est pourquoi les développeurs n'ont en général pas de compte sur ces
+ machines.
+
+
+ <sect id="incoming-system">
+ <heading>Le système Incoming
+<p>
+Le système Incoming est responsable de la collecte des paquets mis à jour et de
+ leur installation dans l'archive Debian. Il est constitué d'un ensemble de
+ répertoires et de scripts qui sont installés à la fois sur
+ <tt>&ftp-master-host;</tt> et sur <tt>&non-us-host;</tt>.
+<p>
+Les paquets sont envoyés par tous les responsables Debian dans un répertoire
+ nommé <file>unchecked</file>. Ce répertoire est parcouru toutes les 15 minutes
+ par le script <prgn>katie</prgn> qui vérifie l'intégrité des paquets envoyés et
+ les signatures de chiffrage. Si le paquet est considéré comme prêt à être
+ installé, il est déplacé dans le répertoire <file>accepted</file>. S'il s'agit
+ du premier envoi du paquet, il est déplacé dans le répertoire <file>new</file>
+ où il attend l'approbation des ftpmasters. Si le paquet contient des fichiers
+ devant être installés <em>à la main</em>, il est déplacé dans le répertoire
+ <file>byhand</file> où il attend une installation manuelle par les ftpmasters.
+ Sinon, si une erreur a été détectée, le paquet est refusé et il est déplacé
+ dans le répertoire <file>reject</file>.
+<p>
+Une fois que le paquet est accepté, le système envoie une confirmation par
+ courrier au responsable et ferme les bogues corrigés par l'envoi, puis
+ les compilateurs automatiques peuvent commencer la recompilation. Le paquet est
+ maintenant accessible publiquement à <url id="&url-incoming;"> (une telle
+ adresse n'existe pas pour les paquets de l'archive non-US) jusqu'à ce qu'il
+ soit vraiment installé dans l'archive Debian. Ceci se produit seulement une
+ fois par jour, le paquet est alors supprimé de <file>Incoming</file> et
+ installé dans le pool avec les autres paquets. Une fois que toutes les autres
+ mises à jour (fabrication des nouveaux fichiers d'index <file>Packages</file> et
+ <file>Sources</file> par exemple) ont été effectuées, un script spécial est
+ appelé pour demander aux miroirs primaires de se mettre à jour.
+<p>
+Le logiciel de maintenance de l'archive enverra également le fichier
+<file>.changes</file> signé avec OpenPGP/GnuPG que vous avez envoyé, à la liste
+de diffusion appropriée. Si un paquet est diffusé avec le champ
+<tt>Distribution:</tt> positionné à « stable », l'annonce sera envoyée
+à &email-debian-changes;. Si un paquet est diffusé avec le champ
+<tt>Distribution:</tt> positionné à « unstable » ou
+« experimental », l'annonce sera à la place envoyée à
+&email-debian-devel-changes;.
<p>
-Le répertoire <tt>dists/stable</tt> contient trois répertoires nommés
-<tt>main</tt>, <tt>contrib</tt> et <tt>non-free</tt>.
+Tous les développeurs Debian ont un droit d'écriture dans le répertoire
+ <file>unchecked</file> pour pouvoir y envoyer leurs paquets, ils ont également
+ accès au répertoire <file>reject</file> pour supprimer les mauvais envois ou
+ déplacer certains fichiers dans le répertoire <file>unchecked</file>. Mais
+ seuls les ftpmasters ont droit d'écriture dans les autres répertoires.
+ C'est pourquoi vous ne pouvez pas supprimer un envoi une fois qu'il a été
+ accepté.
+
+ <sect1 id="delayed-incoming">Incoming différé
+<p>
+Le répertoire <file>unchecked</file> comprend un sous-répertoire spécial,
+ <file>DELAYED</file><footnote>Différé en anglais</footnote>. Celui-ci est
+ lui-même subdivisé en neuf répertoires nommés <file>1-day</file> à
+ <file>9-day</file>. Les paquets qui sont envoyés dans l'un de ces
+ répertoires seront déplacés dans le vrai répertoire <file>unchecked</file>
+ après le nombre correspondant de jours. Un script, exécuté chaque jour,
+déplace les paquets entre les répertoires. Ceux
+ qui sont dans « 1-day » sont installés dans
+ <file>unchecked</file> alors que les autres sont déplacés dans le
+ répertoire adjacent (par exemple, un paquet dans <file>5-day</file> sera
+ déplacé dans <file>4-day</file>). Cette fonctionnalité est particulièrement
+ utile pour les personnes qui effectuent des mises à jour indépendantes
+ (NMU, « non-maintainer uploads »). Au lieu d'attendre avant
+ d'envoyer la NMU, elle est envoyée dès qu'elle est prête dans l'un de ces
+ répertoires <file>DELAYED/<var>x</var>-day</file>. Ceci laisse le nombre
+ correspondant de jours au responsable pour réagir et envoyer lui-même une
+ autre correction s'il n'est pas complètement satisfait par la NMU. Il peut
+ également enlever complètement la NMU.
+<p>
+L'utilisation de ce délai peut être simplifiée en
+ l'intégrant à votre outil d'envoi. Par exemple, si vous utilisez
+ <prgn>dupload</prgn> (voir <ref id="dupload">), vous pouvez ajouter cette
+ partie à votre fichier de configuration :
+<example>
+$delay = ($ENV{DELAY} || 7);
+$cfg{'delayed'} = {
+ fqdn => "&ftp-master-host;",
+ login => "yourdebianlogin",
+ incoming => "/org/ftp.debian.org/incoming/DELAYED/$delay-day/",
+ dinstall_runs => 1,
+ method => "scpb"
+};</example>
+Une fois que vous avez fait ce changement, <prgn>dupload</prgn> peut être
+utilisé pour envoyer facilement dans l'un des répertoires de délai ainsi :
+<example>DELAY=5 dupload --to delayed <changes-file></example>
-<p>
-Dans chacune de ces sections se trouve un répertoire contenant les paquets
-sources (<tt>source/</tt>), un répertoire pour chaque architecture supportée
-(<tt>binary-i386/</tt>, <tt>binary-m68k/</tt>, etc) et un répertoire pour les
-paquets indépendants de l'architecture (<tt>binary-all/</tt>).
+ <sect id="pkg-info">Informations sur un paquet
<p>
-La section <em>main</em> contient d'autres répertoires destinés aux images de
-disquettes et à quelques documentations essentielles pour installer la
-distribution Debian sur une architecture particulière (<tt>disk-i386/</tt>,
-<tt>disk-m68k/</tt>, etc).
+ <sect1 id="pkg-info-web">Sur le web
+<p>
+Chaque paquet a plusieurs pages web dédiées.
+ <tt>http://&packages-host;/<var>nom-paquet</var></tt> affiche chaque version
+ du paquet disponible dans les différentes distributions. Les informations
+ détaillées par version incluent la description du paquet, les dépendances et
+ des liens pour récupérer le paquet.
<p>
-Les répertoires <tt>binary-*/</tt> et <tt>source/</tt> sont à nouveau
-divisés en <em>sous-sections</em>.
+Le système de suivi des bogues trie les bogues par paquet. Vous pouvez regarder
+ les bogues de chaque paquet à
+ <tt>http://&bugs-host;/<var>nom-paquet</var></tt>.
+ <sect1 id="madison">L'outil <prgn>madison</prgn>
+<p>
+<prgn>madison</prgn> est un outil en ligne de commande qui est disponible sur
+ <tt>&ftp-master-host;</tt> et sur <tt>&non-us-host;</tt>. Il utilise un seul
+ argument qui correspond au nom du paquet. Il affiche comme résultat quelle
+ version du paquet est disponible pour chaque combinaison d'architecture et de
+ distribution. Un exemple l'expliquera mieux.
+<p>
+<example>
+$ madison libdbd-mysql-perl
+libdbd-mysql-perl | 1.2202-4 | stable | source, alpha, arm, i386, m68k, powerpc, sparc
+libdbd-mysql-perl | 1.2216-2 | testing | source, arm, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc
+libdbd-mysql-perl | 1.2216-2.0.1| testing | alpha
+libdbd-mysql-perl | 1.2219-1 | unstable | source, alpha, arm, hppa, i386, ia64, m68k, mips, mipsel, powerpc, s390, sparc</example>
+<p>
+Dans cet exemple, vous pouvez voir que la version dans <em>unstable</em> diffère
+ de celle de <em>testing</em> et qu'il y a eu une NMU binaire seulement pour
+ l'architecture alpha. À chaque fois, le paquet a été recompilé sur la plupart
+ des architectures.
+
+
+ <sect id="pkg-tracking-system">Système de suivi des paquets
+<p>
+Le système de suivi des paquets (PTS)<footnote>« Package Tracking
+ System »</footnote> est un outil pour suivre par courrier l'activité
+ concernant un paquet source. Cela veut vraiment dire que vous pourrez recevoir
+ les mêmes courriers que le responsable, simplement en vous inscrivant au paquet
+ dans le PTS.
+<p>
+Chaque courrier envoyé par le PTS est classé et associé à l'un des mots-clés
+ listés ci-dessous. Ceci vous permettra de sélectionner les courriers que vous
+ voulez recevoir.
+<p>
+Par défaut, vous recevrez :
+<taglist>
+ <tag><tt>bts</tt>
+ <item>Tous les rapports de bogue et les discussions qui
+ suivent.
+
+ <tag><tt>bts-control</tt>
+ <item>Les courriers de notification de <email>control@bugs.debian.org</email>
+ sur les changement d'état de l'un des rapports de bogue.
+
+ <tag><tt>upload-source</tt>
+ <item>Le courrier de notification de <prgn>katie</prgn> quand un paquet
+ source envoyé a été accepté.
+
+ <tag><tt>katie-other</tt>
+ <item>Les autres courriers d'avertissement et d'erreur de
+ <prgn>katie</prgn> (comme une incohérence de passage en force pour les champs
+ section ou priorité).
+
+ <tag><tt>default</tt>
+ <item>Tout courrier non automatique envoyé au PTS par les personnes qui
+ veulent contacter les inscrits au paquet. Ceci peut être fait en
+ envoyant un courrier à <tt><var>paquet-source</var>@&pts-host;</tt>. Pour
+ prévenir l'envoi de spam, tous les courriers envoyés à ces adresses doivent
+ contenir l'en-tête <tt>X-PTS-Approved</tt> avec une valeur non vide.
+
+ <tag><tt>summary</tt>
+ <item>(Ceci est une extension prévue).
+ Les courriers de résumé réguliers sur l'état du paquet (statistiques sur
+ les bogues, vue générale du portage, progression dans <em>testing</em>,
+ etc.).
+</taglist>
+
+<p>
+Vous pouvez également décider de recevoir des informations supplémentaires :
+<taglist>
+ <tag><tt>upload-binary</tt>
+ <item>Le courrier d'information de <prgn>katie</prgn> quand un paquet
+ binaire envoyé est accepté. En d'autres termes, à chaque fois qu'un
+ démon de compilation ou un porteur envoie votre paquet pour une autre
+ architecture, vous recevez un courrier pour suivre comment votre paquet
+ est recompilé pour toutes les architectures.
+
+ <tag><tt>cvs</tt>
+ <item>Les notifications de modifications CVS<footnote><p><em>CVS
+ commits</em></footnote> si le responsable a mis en place un système pour
+ faire suivre les notifications de modifications vers le PTS.
+
+ <tag><tt>ddtp</tt>
+ <item>Les traductions des descriptions ou des questionnaires debconf soumis
+ au Projet de traduction des descriptions de paquets
+ Debian<footnote><p><em>Debian Description Translation Project,
+ DDTP</em></footnote>.
+
+</taglist>
+
+ <sect1 id="pts-commands">L'interface de courrier du PTS
+<p>
+Vous pouvez contrôler votre (vos) inscription(s) au PTS en envoyant différents
+ commandes à <email>pts@qa.debian.org</email>.
+
+<taglist>
+ <tag><tt>subscribe <paquet source> [<adresse>]</tt>
+ <item>Inscrit <var>adresse</var> aux communications liées au paquet source
+ <var>paquet source</var>. L'adresse de l'expéditeur est utilisée si le
+ second argument n'est pas présent. Si <var>paquet source</var> n'est pas
+ un paquet source valide, vous obtiendrez un avertissement. Cependant,
+ s'il s'agit d'un paquet binaire valide, le PTS vous inscrira pour le
+ paquet source correspondant.
+
+ <tag><tt>unsubscribe <paquet source> [<adresse>]</tt>
+ <item>Supprime une inscription précédente au paquet source
+ <var>paquet source</var> en utilisant l'adresse spécifiée ou l'adresse de
+ l'expéditeur si le second argument n'est pas rempli.
+
+ <tag><tt>which [<adresse>]</tt>
+ <item>Liste les inscriptions pour l'expéditeur ou pour l'adresse indiquée
+ si elle est spécifiée.
+
+ <tag><tt>keyword [<adresse>]</tt>
+ <item>Donne les mots-clés que vous acceptez. Pour une explication des ces
+ mots-clés, <qref id="pkg-tracking-system">voir ci-dessus</qref>. Voici
+ un rapide résumé :
+ <list>
+ <item><tt>bts</tt> : courriers venant du système de gestion de bogues (BTS) Debian
+ <item><tt>bts-control</tt> : réponses aux courriers envoyés à
+ &bugs-host;&email-bts-control;
+ <item><tt>summary</tt> : courriers de résumé automatique sur l'état
+ d'un paquet
+ <item><tt>cvs</tt> : notifications de modifications CVS
+ <item><tt>ddtp</tt> : traductions des descriptions et
+ questionnaires debconf
+ <item><tt>upload-source</tt> : annonce d'un nouvel envoi de paquet
+ source qui a été accepté
+ <item><tt>upload-binary</tt> : annonce d'un nouvel envoi de binaire
+ seulement (portage)
+ <item><tt>katie-other</tt> : autres courriers des ftpmasters
+ (incohérence de passage en force, etc.)
+ <item><tt>default</tt> : tous les autres courriers (ceux qui ne sont
+ pas automatiques)
+ </list>
+
+ <tag><tt>keyword <paquet source> [<adresse>]</tt>
+ <item>Identique à l'élément précédent, mais pour un paquet source donné
+ car vous pouvez sélectionner un ensemble de mots-clés différent pour
+ chaque paquet source.
+
+ <tag><tt>keyword [<adresse>] {+|-|=} <liste de mots-clés></tt>
+ <item>Accepte (+) ou refuse (-) les courriers associés au(x) mot(s)-clé(s).
+ Définit la liste (=) des mots-clés acceptés.
+
+ <tag><tt>keyword <paquet source> [<adresse>] {+|-|=} <liste de mots-clés></tt>
+ <item>Identique à l'élément précédent, mais remplace la liste des mots-clés
+ pour le paquet source indiqué.
+
+ <tag><tt>quit | thanks | --</tt>
+ <item>Arrête le traitement des commandes. Toutes les lignes suivantes sont
+ ignorées par le robot.
+</taglist>
+
+ <sect1 id="pts-mail-filtering">Filtrer les courriers du PTS
+<p>
+Une fois que vous vous êtes inscrit à un paquet, vous recevrez les courriers
+ envoyés à <tt><var>paquet source</var>@packages.qa.debian.org</tt>. Ces courriers
+ ont des en-têtes spéciaux ajoutés pour vous permettre de les filtrer dans des
+ boîtes aux lettres (par exemple, avec <prgn>procmail</prgn>). Les en-têtes ajoutés sont
+ <tt>X-Loop</tt>, <tt>X-PTS-Package</tt>, <tt>X-PTS-Keyword</tt> et
+ <tt>X-Unsubscribe</tt>.
+<p>
+Voici un exemple d'en-têtes ajoutés pour une notification d'envoi de
+source sur le paquet <package>dpkg</package> :
+<example>
+X-Loop: dpkg@&pts-host;
+X-PTS-Package: dpkg
+X-PTS-Keyword: upload-source
+X-Unsubscribe: echo 'unsubscribe dpkg' | mail pts@qa.debian.org
+</example>
+ <sect1 id="pts-cvs-commit">Faire suivre les modifications de CVS vers le PTS
+<p>
+Si vous utilisez un référentiel CVS accessible publiquement pour maintenir votre
+ paquet Debian, vous pouvez vouloir faire suivre les notifications de
+ modifications vers le PTS pour que les inscrits (ainsi que des possibles
+ co-responsables) puissent suivre de près l'évolution du paquet.
+<p>
+Une fois que votre référentiel génère des notifications de modifications, vous
+ devez simplement vous assurer qu'il envoie une copie de tous ces courriers à
+ <tt><var>paquet source</var>_cvs@&pts-host;</tt>. Seules les personnes qui ont
+ accepté le mot-clé <em>cvs</em> recevront les notifications.
+
+ <sect1 id="pts-web">L'interface web du PTS
+<p>
+Le PTS possède une interface web à <url id="http://&pts-host;/"> qui réunit
+beaucoup d'informations au
+même endroit à propos de chaque paquet source. Il propose plusieurs liens utiles
+(BTS, statistiques QA, informations de contact, état de traduction DDTP,
+journaux de compilation automatique) et il regroupe beaucoup d'autres informations
+provenant de différents endroits (les 30 dernières entrées de changelog, l'état
+dans <em>testing</em>, etc.). Il s'agit d'un outil très pratique si vous désirez
+connaître ce qu'il en est d'un paquet source spécifique. De plus, il y a un
+formulaire qui permet de facilement s'inscrire au PTS par courrier.
+ <p>
+Vous pouvez aller directement à la page web concernant un paquet source avec une
+URL comme <tt>http://&pts-host;/<var>paquet source</var></tt>.
+<p>
+Cette interface a été conçue comme un portail pour le développements des
+paquets : vous pouvez ajouter du contenu personnalisé aux pages de vos
+paquets. Vous pouvez ajouter des « informations
+statiques »<footnote><em>Static information</em></footnote> (des annonces
+qui sont destinées à rester disponibles indéfiniment) et des nouvelles dans la
+section « dernières nouvelles »<footnote><em>Latest
+news</em></footnote>.
+<p>
+Les annonces statiques peuvent être utilisées pour indiquer :
+<list>
+<item>la disponibilité d'un projet hébergé sur <qref id="alioth">Alioth</qref> pour la
+co-maintenance du paquet,
+<item>un lien vers le site web amont,
+<item>un lien vers le suivi de bogues amont,
+<item>l'existence d'un canal IRC dédié au logiciel,
+<item>toute autre ressource disponible qui peut être utile à la maintenance du paquet.
+</list>
+Les nouvelles usuelle peuvent être utilisées pour annoncer que :
+<list>
+<item>des paquets bêta sont disponibles pour test,
+<item>des paquets finaux sont attendus pour la semaine prochaine,
+<item>l'empaquetage est sur le point d'être intégralement refait,
+<item>des rétroportages sont disponibles,
+<item>le responsable est en vacance (s'il désire publier cette information),
+<item>une mise à jour indépendante (NMU) est en cours de réalisation,
+<item>quelque chose d'important va affecter le paquet.
+</list>
+<p>
+Les deux types d'informations sont fabriqués de façon similaire : il vous
+suffit d'envoyer un courrier soit à <email>pts-static-news@qa.debian.org</email>
+(pour les annonces statiques), soit à <email>pts-news@qa.debian.org</email>
+(pour les nouvelles usuelles). Le courrier devrait indiquer quel paquet est
+concerné par la nouvelle en donnant le nom du paquet source dans un en-tête de
+courrier <tt>X-PTS-Package</tt> ou dans un pseudo-en-tête <tt>Package</tt>
+(comme pour les rapports de bogue du BTS). Si une URL est disponible dans
+l'en-tête de courrier <tt>X-PTS-Url</tt> ou dans un pseudo-en-tête <tt>Url</tt>,
+le résultat est un lien vers cette URL au lieu d'une nouvelle complète.
+<p>
+Voici quelques exemples de courriers valides utilisés pour générer des nouvelles dans
+le PTS. Le premier ajoute un lien vers l'interface cvsweb de debian-cd dans la
+section « Informations statiques » :
+<example>
+From: Raphael Hertzog <hertzog@debian.org>
+To: pts-static-news@qa.debian.org
+Subject: Browse debian-cd CVS repository with cvsweb
+
+Package: debian-cd
+Url: http://cvs.debian.org/debian-cd/
+</example>
+<p>
+Le second est une annonce envoyée à une liste de diffusion et également
+envoyée au PTS pour qu'elle soit publiée sur la page web du PTS du paquet. Notez
+l'utilisation du champ BCC pour éviter que des réponses ne soient envoyées par
+erreur au PTS.
+<example>
+From: Raphael Hertzog <hertzog@debian.org>
+To: debian-gtk-gnome@lists.debian.org
+Bcc: pts-news@qa.debian.org
+Subject: Galeon 2.0 backported for woody
+X-PTS-Package: galeon
- <sect>Les sections
+Hello gnomers!
+I'm glad to announce that galeon has been backported for woody. You'll find
+everything here:
+...
+</example>
<p>
-La section <em>main</em> constitue la <strong>distribution Debian GNU-Linux
-officielle</strong>. Elle est officielle parce qu'elle est conforme à toutes
-nos recommandations. Les deux autres sections divergent de ces recommandations
-à différents degrés, elles ne font donc pas officiellement partie de Debian.
+Réfléchissez-y à deux fois avant d'ajouter une nouvelle au PTS car vous ne
+pourrez pas l'enlever par la suite et vous ne pourrez pas non plus l'éditer. La
+seule chose que vous puissiez faire est d'envoyer une deuxième nouvelle qui va
+déprécier l'information contenue dans la précédente.
+ <sect id="ddpo">Vue d'ensemble des paquets d'un développeur
<p>
-Chaque paquet de la section <em>main</em> doit être conforme aux <url
-id="&url-dfsg;" name="Debian Free Software Guidelines"> et à toutes les autres
-recommandations décrites dans <url id="&url-debian-policy;" name="le Debian
-Policy Manual">. Les DFSG<footnote><em>Debian Free Software
-Guidelines</em></footnote> constituent notre définition de <em>logiciel
-libre</em>. Reportez-vous au <em>Debian Policy Manual</em> pour en savoir
-plus.
-
+Un portail web pour l'Assurance Qualité (QA) est disponible à <url
+ id="&url-ddpo;"> qui affiche un tableau de tous les paquets d'un
+ développeur (y compris ceux pour lequel il est co-responsable). Le tableau donne
+ un bon résumé sur les paquets d'un développeur : nombre de bogues par
+ gravité, liste des versions disponibles, état des tests et des liens vers
+ d'autres informations utiles.
<p>
-Les paquets de la section <em>contrib</em> doivent être conformes aux DFSG
-mais ne respectent pas d'autres contraintes. Ils peuvent par exemple dépendre
-de paquets de la section <em>non-free</em>.
+C'est une bonne idée de vérifier régulièrement vos données pour ne pas oublier
+ de bogues ouverts et pour ne pas oublier quels paquets sont sous votre
+ responsabilité.
+ <sect id="alioth">Debian *Forge : Alioth
<p>
-Les paquets qui ne sont pas conformes aux DFSG sont rangés dans la section
-<em>non-free</em>. Bien que nous supportions l'usage de ces paquets et qu'ils
-bénéficient de nos infrastructures (système de suivi des bogues, listes de
-diffusion, etc), ces paquets <em>non-free</em> ne font pas partie de la
-distribution Debian.
-
+Alioth est un service de Debian plutôt récent, basé sur une version
+légèrement modifiée du logiciel GForge (qui a évolué à partir de
+SourceForge). Ce logiciel offre aux développeurs l'accès à des outils
+faciles d'utilisation comme un un gestionnaire de suivi de bogues, un
+gestionnaire de correctifs, un gestionnaire de tâches et de projets,
+un service d'hébergement de fichiers, des listes de diffusion, des
+dépôts CVS, etc. Tous ces outils sont gérés par une interface web.
<p>
-Le <em>Debian Policy Manual</em> donne des définitions plus précises pour ces trois sections.
-Les paragraphes précédants ne constituent qu'une introduction.
-
+Alioth est destiné à fournir des facilités pour des projets de logiciels
+soutenus ou dirigés par Debian, à faciliter les contributions de développeurs
+externes aux projets initiés par Debian et à aider des projets dont les buts
+sont de promouvoir Debian ou ses dérivés.
<p>
-La séparation de l'archive en trois sections est
-importante pour toute personne qui désire distribuer Debian, que ce soit par
-serveur FTP ou sur cédérom. Il suffit de distribuer les sections <em>main</em>
-et <em>contrib</em> pour éviter tout problème légal. Certains paquets de la
-section <em>non-free</em> interdisent leur distribution à titre commercial par
-exemple.
+Pour plus d'informations, veuillez visiter <url id="&url-alioth;">.
+ <chapt id="pkgs">Gestion des paquets
<p>
-D'un autre coté, un distributeur de cédérom pourra facilement vérifier
-individuellement les licences des paquets de la section <em>non-free</em> et
-ajouter autant de paquets qu'il est autorisé à le faire sur ses cédéroms (dans
-la mesure où cela varie énormément d'un distributeur à l'autre ce travail ne
-peut être fait par les développeurs Debian).
+Ce chapitre contient des informations relatives à la création, l'envoi, la
+ maintenance et le portage des paquets.
-
- <sect>Les architectures
-
+ <sect id="newpackage">Nouveaux paquets
<p>
-À ses débuts, le noyau Linux existait uniquement pour les architectures Intel
-x86 ; il en était de même pour Debian. Linux devenant de plus
-en plus populaire, il a été porté vers d'autres architectures. <p> Le noyau
-2.0 existe pour les architectures Intel x86, DEC Alpha, SPARC, Motorola, 680x0
-(Atari, Amiga, et Macintosh), MIPS et PowerPC. Le noyau 2.2 supporte encore
-plus d'architectures dont ARM et UltraSPARC. Puisque Linux supporte ces
-architectures, Debian a décidé qu'il devait les supporter aussi. C'est
-pourquoi plusieurs portages sont en cours ; en fait il y a aussi des portages
-vers d'autres noyaux. À coté d'<em>i386</em> (notre nom pour Intel x86), nous
-avons, au moment où j'écris <em>m68k</em>, <em>alpha</em>, <em>powerpc</em>,
-<em>sparc</em>, <em>hurd-i386</em>, et <em>arm</em>.
-
+Si vous voulez créer un nouveau paquet pour la distribution Debian, vous devriez
+ commencer par consulter la liste des <url id="&url-wnpp;" name="paquets en
+ souffrance et paquets souhaités">. Vous pourrez ainsi vérifier que personne ne
+ travaille déjà sur ce paquet et éviter un double travail. Consultez aussi cette
+ page si vous voulez en savoir plus.
<p>
-Debian GNU-Linux 1.3 est disponible uniquement pour <em>i386</em>. Debian 2.0
-supporte les architectures <em>i386</em> et <em>m68k</em>. Debian 2.1
-supporte les architectures <em>i386</em>, <em>m68k</em>, <em>alpha</em> et
-<em>sparc</em>. Debian 2.2 ajoute le support de l'architecture
-<em>powerpc</em>.
-
+Supposons que personne ne travaille sur le paquet que vous visez, vous devez
+ alors envoyer un rapport de bogue (voir <ref id="submit-bug">) concernant le
+ pseudo-paquet <package>wnpp</package>. Ce courrier devra décrire le paquet que
+ vous projetez de créer, la licence de ce paquet et l'URL à laquelle le source
+ peut être téléchargé. Cette liste n'est pas limitative.
+<p>
+Le sujet de votre rapport de bogue devra être <ITP<footnote><p><em>Intent To
+ Package</em> : intention de d'empaquetage</footnote> :
+ <var>NomDuPaquet</var> — <var>courte description</var>>, en remplaçant
+ <var>NomDuPaquet</var> par le nom du paquet. La gravité du bogue sera
+ <em>wishlist</em>. Si vous le jugez nécessaire, envoyez une copie à
+ &email-debian-devel; en mettant cette adresse dans le champ
+ <tt>X-Debbugs-CC:</tt> de l'en-tête du message. N'utilisez pas le champ
+ <tt>CC:</tt> car de cette manière le sujet du message ne contiendrait pas le
+ numéro du bogue.
+<p>
+Il faudra aussi ajouter une entrée <tt>Closes: bug#<var>nnnnn</var></tt> dans le
+ fichier <file>changelog</file> du nouveau paquet. Cette indication fermera
+ automatiquement le rapport de bogue à l'installation du nouveau paquet sur les
+ serveurs d'archivage (voir <ref id="upload-bugfix">).
+<p>
+Plusieurs raisons nous poussent à demander aux responsables
+ d'annoncer leur intention :
+<list compact>
+<item>Les responsables ont ainsi la possibilité de puiser dans l'expérience
+ des autres responsables et cela leur permet de savoir si une autre
+ personne travaille déjà dessus.
+<item>D'autres personnes qui envisagent de travailler sur le même paquet
+ apprendront ainsi qu'il existe déjà un volontaire, l'effort peut alors
+ être partagé.
+<item>Cela permet aux autres responsables de connaître le nouveau
+ paquet mieux que ne le permettent la description d'une ligne et l'habituelle
+ entrée de type changelog <em>Initial release</em> postée sur
+ <tt>debian-devel-changes</tt>.
+<item>C'est une information utile pour
+ les gens qui utilisent la distribution <em>unstable</em> et qui sont nos
+ premiers testeurs. Nous devons faciliter la tâche de ces gens.
+<item>Avec ces annonces, les développeurs Debian et toutes les autres personnes
+ intéressées peuvent se faire une meilleure idée des évolutions et des
+ nouveautés du projet.
+</list>
+
+
+ <sect id="changelog-entries">Enregistrer les modifications dans le paquet
+<p>
+Les modifications que vous apportez au paquet doivent être notifiées dans le
+ fichier <file>debian/changelog</file>. Ces notes doivent donner une
+ description concise des changements, expliquer les raisons de ceux-ci (si
+ ce n'est pas clair) et indiquer si des rapports de bogue ont été clos. Il
+ faut aussi indiquer quand le paquet a été terminé. Ce fichier sera
+ installé dans
+ <file>/usr/share/doc/<var>paquet</var>/changelog.Debian.gz</file> ou
+ <file>/usr/share/doc/<var>paquet</var>/changelog.gz</file> pour un paquet
+ natif.
+<p>
+Le fichier <file>debian/changelog</file> a une structure précise comportant
+ différents champs. Le champ <em>distribution</em> est décrit dans <ref
+ id="distribution">. Vous trouverez plus d'informations sur la structure de ce
+ fichier dans la section « <file>debian/changelog</file> » de la
+ <em>charte Debian</em>.
+<p>
+Les entrées du fichier <file>changelog</file> peuvent être
+ utilisées pour fermer des rapports de bogue au moment où le paquet est
+ installé dans l'archive. Voir la section <ref id="upload-bugfix">.
+<p>
+Par convention, l'entrée changelog d'un paquet contenant une nouvelle version
+ amont ressemble à :
+<example>
+ * new upstream version
+</example>
<p>
-Vous trouverez des informations destinées aux développeurs à propos d'un
-portage particulier sur la page <url id="&url-debian-ports;" name="Portage
-Debian">.
-
-
-
-
- <sect>Les sous-sections
-
+Quelques outils peuvent vous aider à créer des entrées et à finaliser le fichier
+ <file>changelog</file> pour une livraison — voir les sections <ref
+ id="devscripts"> et <ref id="dpkg-dev-el">.
+<p>
+Voir aussi <ref id="bpp-debian-changelog">.
+
+
+ <sect id="sanitycheck">Tester le paquet
+<p>
+Avant d'envoyer votre paquet, vous devriez faire quelques tests de base. Vous
+ devriez au moins faire les tests suivants (il vous faut une ancienne version
+ du paquet) :
+<list>
+<item>Installez le paquet et vérifiez que le logiciel fonctionne. Si le
+ paquet existait déjà dans une version plus ancienne, faites une mise à
+ jour.
+<item>Exécutez <prgn>lintian</prgn> sur votre paquet. Vous pouvez exécuter
+ <prgn>lintian</prgn> comme suit : <tt>lintian -v
+ <var>version-paquet</var>.changes</tt>. Ce programme fera une
+ vérification sur les paquets source et binaire. Si vous ne comprenez pas
+ les messages retournés par <prgn>lintian</prgn>, essayez l'option
+ <tt>-i</tt>. Cette option rendra <prgn>lintian</prgn> beaucoup plus
+ bavard dans sa description du problème.
+ <p>
+ En principe, un paquet pour lequel <prgn>lintian</prgn> renvoie des erreurs
+ (elles commencent par <tt>E</tt>) <em>ne doit pas</em> être installé dans
+ l'archive.
+ <p>
+ Pour en savoir plus sur <prgn>lintian</prgn>, reportez-vous à la section
+ <ref id="lintian">.
+<item>Vous pouvez facultativement exécuter <ref id="debdiff"> pour analyser les
+ modifications depuis une ancienne version si celle-ci existe.
+<item>Faites régresser le paquet vers sa version précédente si elle existe
+ — cela permet de tester les scripts <file>postrm</file> et
+ <file>prerm</file>.
+<item>Désinstallez le paquet et réinstallez-le.
+</list>
+
+
+ <sect id="sourcelayout">Disposition du paquet source
+<p>
+ Il existe deux types de paquets source Debian :
+ <list>
+ <item>les paquets appelés <em>natifs</em> pour lesquels il
+ n'y a pas de distinction entre les sources d'origine et les
+ correctifs appliqués pour Debian
+ <item>les paquets (plus courants) où il y a un fichier archive source
+ d'origine accompagné par un autre fichier contenant les
+ correctifs pour Debian.
+ </list>
+<p>
+Pour les paquets natifs, le paquet source inclut un fichier de contrôle source
+Debian (<tt>.dsc</tt>) et l'archive source (<tt>.tar.gz</tt>). Un paquet source
+d'un paquet non natif inclut un fichier de contrôle source Debian, l'archive
+source d'origine (<tt>.orig.tar.gz</tt>) et les correctifs Debian
+(<tt>.diff.gz</tt>).
+<p>
+Le caractère natif d'un paquet est déterminé lorsqu'il est construit par <manref
+name="dpkg-buildpackage" section="1">. Le reste de cette section ne se rapporte
+qu'aux paquets non natifs.
+
+<p>
+La première fois qu'un paquet est installé dans l'archive pour une version amont
+ donnée, le fichier <file>tar</file> de cette version amont doit être
+ téléchargé et mentionné dans le fichier <file>.changes</file>. Par la suite,
+ ce fichier <file>tar</file> sera utilisé pour générer les fichiers
+ <file>diff</file> et <file>.dsc</file> et il ne sera pas nécessaire de le
+ télécharger à nouveau.
<p>
-Les sections <em>main</em>, <em>contrib</em> et <em>non-free</em> sont
-divisées en sous-sections pour simplifier le processus d'installation et la
-maintenance de l'archive Debian. Ces sous-sections ne sont pas définies
-formellement, à l'exception peut-être de la sous-section <em>base</em>.
-Elles existent pour simplifier l'organisation des paquets et la navigation
-dans la liste des paquets disponibles. Reportez-vous à la distribution
-courante pour connaître la liste des sous-sections disponibles.
+Par défaut, <prgn>dpkg-genchanges</prgn> et <prgn>dpkg-buildpackage</prgn>
+ incluront le fichier <file>tar</file> amont si et seulement si le numéro de
+ révision du paquet source est 0 ou 1, ce qui indique une nouvelle version
+ amont. Ce comportement peut être modifié en utilisant <tt>-sa</tt> pour
+ l'inclure systématiquement ou <tt>-sd</tt> pour ne jamais l'inclure.
+<p>
+Si la mise à jour ne contient pas le fichier <file>tar</file> des sources
+ originaux, <prgn>dpkg-source</prgn> <em>doit</em>, pour construire les
+ fichiers <file>.dsc</file> et <file>diff</file> de la mise à jour, utiliser
+ un fichier <tt>tar</tt> identique à l'octet près à celui déjà présent dans
+ l'archive.
+
+ <sect id="distribution">Choisir une distribution
+<p>
+Chaque envoi doit spécifier à quelle distribution le paquet est destiné. Le
+processus de construction de paquet extrait cette information à partir de la
+première ligne du fichier <file>debian/changelog</file> et la place dans le champ
+<tt>Distribution</tt> du fichier <tt>.changes</tt>.
+<p>
+Il existe plusieurs valeurs possibles pour ce champ : « stable »,
+ « unstable », « testing-proposed-updates » et
+ « experimental ».
+<p>
+En fait, il y a deux autres possibilités :
+ « stable-security » et « testing-security », mais
+ veuillez lire <ref id="bug-security"> pour plus d'informations sur celles-ci.
+<p>
+Il est techniquement possible d'envoyer un paquet dans plusieurs distributions
+ en même temps, mais ceci n'a habituellement aucun sens d'utiliser cette
+ fonctionnalité car les dépendances d'un paquet peuvent varier selon les
+ distributions. En particulier, il est absurde de combiner la distribution
+ <em>experimental</em> avec tout autre chose.
+
+ <sect1 id="upload-stable">Cas spécial mise à jour d'un paquet de
+ la distribution <em>stable</em>
+<p>
+Livrer un paquet pour la distribution <em>stable</em> signifie que le paquet
+ sera dirigé vers le répertoire <file>stable-proposed-updates</file> des
+ archives Debian pour y être testé avant d'être effectivement inclus dans
+ <em>stable</em>.
+<p>
+Une livraison pour la distribution <em>stable</em> requiert des soins
+ supplémentaires. Un paquet de cette distribution ne devrait être mis à jour
+ que dans les cas suivants :
+<list>
+<item>un problème fonctionnel vraiment critique,
+<item>un paquet devenu ininstallable,
+<item>un paquet indisponible pour une architecture.
+</list>
+<p>
+Par le passé, des envois vers <em>stable</em> étaient également utilisés pour
+corriger les problèmes de sécurité. Cependant, cette pratique est dépréciée car
+les envois utilisés pour les avis de sécurité Debian<footnote>Debian security
+advisory</footnote> sont automatiquement copiés dans l'archive
+<file>proposed-updates</file> appropriée quand l'avis est publié. Reportez-vous
+à <ref id="bug-security"> pour des informations plus détaillées sur la gestion
+des problèmes de sécurité.
+<p>
+Il est fortement déconseillé de changer quoi que ce soit si ce
+ n'est pas important car même une modification triviale peut provoquer un
+ bogue.
+<p>
+Les paquets livrés pour <em>stable</em> doivent être compilés avec la
+ distribution <em>stable</em> pour que leurs dépendances se limitent aux
+ bibliothèques (et autres paquets) disponibles dans <em>stable</em> ;
+ un paquet livré pour la distribution <em>stable</em> qui dépend d'une
+ bibliothèque qui n'est disponible que dans <em>unstable</em> sera rejeté.
+ Modifier les dépendances d'autres paquets (en manipulant le champ
+ <tt>Provides</tt> ou les fichiers shlibs) et, peut-être, rendre ces paquets
+ ininstallables, est fortement déconseillé.
+<p>
+L'équipe responsable de la distribution<footnote><em>the Release
+ team</em></footnote> (joignable à l'adresse &email-debian-release;)
+ évaluera régulièrement le contenu de <em>stable-proposed-updates</em> et
+ décidera si votre paquet peut être inclus dans la distribution
+ <em>stable</em>. Soyez précis (et, si nécessaire, prolixe) quand vous
+ décrivez, dans le fichier changelog, vos changements pour une livraison
+ vers <em>stable</em>, sinon le paquet ne sera pas pris en considération.
+
+ <sect1 id="upload-t-p-u">Cas spécial : Mise à jour d'un paquet de la
+ distribution <em>testing-proposed-updates</em>
+<p>
+La distribution <em>testing</em> est peuplée avec des paquets en provenance
+ d'<em>unstable</em> selon des règles expliquées dans <ref id="testing">.
+ Cependant, le responsable de distribution peut stopper les scripts de
+ <em>testing</em> quand il veut geler la distribution. Dans ce cas, vous
+ pouvez envoyer vos paquets vers <em>testing-proposed-updates</em> pour
+ fournir des paquets corrigés durant le gel.
+<p>
+Souvenez-vous que les paquets envoyés là ne sont pas traités automatiquement,
+ ils doivent passer entre les mains du responsable de distribution. Vous devez
+ donc avoir une bonne raison pour les y envoyer. Pour savoir ce que
+ représente une bonne raison aux yeux du responsable de distribution, vous
+ devriez lire les instructions données qu'il envoie régulièrement sur
+ &email-debian-devel-announce;.
+<p>
+Vous ne devriez pas envoyer un paquet à <em>testing-proposed-updates</em> quand
+ vous pouvez le mettre à jour par <em>unstable</em>. Si vous ne pouvez faire
+ autrement (par exemple, parce que vous avez une nouvelle version dans
+ <em>unstable</em>), vous pouvez l'utiliser, mais il est recommandé de
+ demander l'autorisation du responsable de distribution auparavant.
+
+
+ <sect id="upload">Mettre à jour un paquet
+ <sect1 id="upload-ftp-master">Installer un paquet sur
+ <tt>ftp-master</tt>
+<p>
+Pour installer un paquet, vous avez besoin d'un compte sur
+ <ftpsite>&ftp-master-host;</ftpsite>, ce que vous devriez déjà avoir en tant
+ que développeur Debian. Si vous utilisez <prgn>scp</prgn> ou
+ <prgn>rsync</prgn> pour télécharger vos paquets, placez-les dans
+ &us-upload-dir;. Si vous utilisez un FTP anonyme, placez-les dans
+ &upload-queue;.
+<p>
+Si vous désirez utiliser la fonctionnalité de délai décrite dans <ref
+id="delayed-incoming">, vous devez effectuer votre envoi vers
+<tt>ftp-master</tt>. Il s'agit de la seule destination d'envoi supportant
+l'incoming différé.
+<p>
+Attention, il est préférable de transférer le fichier
+ <tt>changes</tt> en dernier. Dans le cas contraire, votre livraison pourrait
+ être rejetée car l'outil de maintenance de l'archive pourrait lire le fichier
+ <tt>changes</tt> et constater que les fichiers ne sont pas tous présents. Si
+ vous ne voulez pas vous embêter avec l'ordre de transfert des fichiers, vous
+ pouvez tout simplement copier vos fichiers dans un répertoire temporaire de
+ <tt>ftp-master</tt> et les déplacer ensuite vers &us-upload-dir;.
+<p>
+<em>Note :</em> ne téléchargez pas sur <tt>ftp-master</tt> de paquets
+ concernant la cryptographie qui appartiendraient à <em>contrib</em> ou <em>non-free</em>.
+ Ces logiciels doivent aller sur <tt>non-us</tt> (voir <ref
+ id="upload-non-us">). De plus, les paquets contenant un logiciel protégé par
+ des brevets américains ne peuvent pas être envoyés sur
+ <tt>ftp-master</tt> ; selon le cas, ils peuvent peut-être pourtant être
+ envoyés vers <file>non-US/non-free</file> (le paquet est dans
+ <em>non-free</em> à cause de problèmes de distribution et non pas à cause de
+ la licence du logiciel). Quand vous ne pouvez télécharger sur
+ <tt>ftp-master</tt>, vous ne pouvez pas non plus télécharger sur
+ <tt>chiark</tt> ou <tt>erlangen</tt>. Si vous ne savez pas si votre paquet
+ est protégé par un brevet ou s'il est soumis aux lois de contrôle des
+ exportations américaines, posez la question sur la liste
+ &email-debian-devel;.
+<p>
+Les paquets <ref id="dupload"> ou <ref id="dput"> pourront vous faciliter le
+ travail lors du téléchargement. Ces programmes, bien pratiques, aident à
+ automatiser le processus d'envoi de paquets vers Debian
+<p>
+Après avoir téléchargé votre paquet, vous pouvez vérifier ce qu'en
+ fera le logiciel de maintenance de l'archive en exécutant
+ <prgn>dinstall</prgn> sur votre fichier <file>.changes</file> :
+<example>dinstall -n foo.changes</example>
<p>
-Notez qu'avec l'introduction de la nouvelle organisation de l'archive (voir le
-répertoire racine <em>pool/</em>), les sous-sections matérialisées par des
-répertoires pourraient disparaître à l'avenir. Elles seront cependant
-conservées dans le champ <tt>Section</tt> de l'en-tête des paquets.
-
-
-
-
- <sect>Les paquets
-
-<p>
-Il existe deux types de paquets Debian : les paquets sources et les
-paquets binaires.
-
-<p>
-Les paquets sources sont constitués de deux ou trois fichiers :
-
- <list compact>
- <item>
- un fichier <tt>.dsc</tt> et un fichier <tt>.tar.gz</tt> ou,
-
- <item>
- un fichier <tt>.dsc</tt>, un fichier <tt>.orig.tar.gz</tt> et un
- fichier <tt>.diff.gz</tt>.
-
- </list>
-
-<p>
-Si un paquet est développé spécifiquement pour le projet Debian et n'est pas
-distribué en dehors de Debian, il n'y a qu'un fichier <tt>.tar.gz</tt> qui
-contient les sources du programme. Si un paquet est distribué ailleurs, le
-fichier <tt>.orig.tar.gz</tt> contient ce que l'on appelle <em>code source
-amont</em>, c'est-à-dire le code source distribué par le <em>mainteneur
-amont</em> (il s'agit souvent de l'auteur du logiciel). Dans ce cas, le
-fichier <tt>.diff.gz</tt> contient les modifications faites par le responsable
-Debian.
-
-<p>
-Le fichier <tt>.dsc</tt> liste tous les fichiers sources avec leurs sommes de
-contrôle (<prgn>md5sums</prgn>) et quelques informations supplémentaires
-concernant le paquet (responsable, version, etc).
-
-
-
-
- <sect>Les répertoires des distributions
-
-<p>
-L'organisation des répertoires présentée précédemment est elle-même englobée
-par les <em>répertoires des distributions</em>. Chaque distribution est
-incluse dans le répertoire <tt>pool</tt> à la racine de l'archive Debian.
-
-<p>
-En résumant, une archive Debian a un répertoire racine sur un serveur FTP. Par
-exemple, sur le site miroir <ftpsite>ftp.us.debian.org</ftpsite>, l'archive
-Debian se trouve dans <ftppath>/debian</ftppath> ce qui est un emplacement
-courant. Un autre emplacement courant est <tt>/pub/debian</tt>.
-
-<p>
-Une distribution est composée de paquets Debian sources et binaires et des
-fichiers <tt>Sources</tt> et <tt>Packages</tt> correspondants. Ces derniers
-contiennent la description de tous les paquets. Les premiers sont
-conservés dans le répertoire <tt>pool/</tt> tandis que les seconds sont
-conservés dans le répertoire <tt>dists/</tt> de l'archive (pour des questions
-de compatibilité descendante)
-
-
-
-
- <sect1 id="life-cycle"><em>Stable</em>, <em>testing</em>,
- <em>unstable</em> et parfois <em>frozen</em>
-
-<p>
-Il y a toujours une distribution appelée <em>stable</em> (dans le répertoire
-<tt>dists/stable</tt>), une distribution appelée <em>testing</em> (dans le
-répertoire <tt>dists/testing</tt>) et une distribution appelée
-<em>unstable</em> (dans le répertoire <tt>dists/unstable</tt>). Ceci reflète
-le processus de développement du projet Debian.
-
-<p>
-Les développements se font sur la distribution <em>unstable</em><footnote>
-<em>unstable</em> signifie « instable »</footnote> (c'est pourquoi
-elle est aussi appelée <em>distribution de développement</em>). Chaque
-développeur Debian peut modifier ses paquets à tout moment dans cette
-distribution. Ainsi son contenu change tous les jours. Comme aucun effort
-particulier n'est fait pour s'assurer que tout fonctionne correctement dans
-cette distribution, elle est parfois <em>instable</em>.
-
-<p>
-Les paquets sont copiés de <em>unstable</em> vers <em>testing</em> s'ils
-satisfont certains critères. Pour entrer dans la distribution <em>testing</em>
-un paquet doit faire partie de l'archive depuis deux semaines et ne doit pas
-avoir de bogue bloquant pour la distribution<footnote><em>Release critical
-bug</em></footnote>. Passée cette période, le paquet sera installé dans
-<em>testing</em> dès que les paquets dont il dépend y seront. Ce processus est
-automatique.
-
-<p>
-Après une période de développement, quand le responsable de
-distribution<footnote><em>Release manager</em></footnote> le juge opportun, la
-distribution <em>testing</em> est renommée <em>frozen</em>. Une fois que cela
-est fait, aucun changement n'est autorisé sur cette distribution en dehors des
-corrections de bogues ; c'est pourquoi nous l'appelons <em>frozen<footnote>
-<em>frozen</em> signifie « gelée »</footnote></em>. Après un mois
-ou un peu plus selon l'avancement, la distribution entre dans une phase de
-« gel complet » où les seules modifications acceptées concernent la
-procédure d'installation. Cette phase s'appelle un « cycle de test »
-et cela peut durer jusqu'à deux semaines. Il peut y avoir plusieurs cycles de
-tests avant que le responsable de distribution ne la déclare prête pour la
-diffusion. À la fin du dernier cycle de test, la distribution <em>frozen</em>
-est renommée <em>stable</em>, remplaçant l'ancienne distribution <em>stable</em> qui
-est enlevée à cette occasion.
-
-<p>
-Ce cycle de développement est basé sur l'idée que la distribution
-<em>instable</em> devient <em>stable</em> après une période de test en tant
-que distribution <em>gelée</em>. Une distribution contient inévitablement des
-bogues, même si elle est classée stable. C'est pourquoi les distributions
-stables sont mises à jour de temps en temps. Les corrections introduites sont
-testées avec une grande attention et ajoutées individuellement à l'archive
-pour diminuer les risques d'introduire de nouveaux bogues. Vous pouvez trouver
-des paquets proposés pour les mises à jour de <em>stable</em> dans le
-répertoire <tt>proposed-updates</tt>. De temps en temps, les paquets de ce
-répertoire qui ne présentent pas de problème sont installés dans la
-distribution <em>stable</em> et le numéro de révision de cette distribution
-est incrémenté (« 1.3 » devient « 1.3r1 »,
-« 2.0r2 » devient « 2.0r3 » et ainsi de suite).
-
-<p>
-Notez que pendant la période de gel les développements continuent sur la
-distribution instable car cette distribution reste en place quand
-<em>testing</em> devient <em>frozen</em>. Quand la distribution
-<em>frozen</em> devient officiellement <em>stable</em>, l'ancienne distribution
-stable est entièrement supprimée de l'archive Debian (elle reste cependant
-disponible à l'adresse <tt>&archive-host;</tt>).
-
-<p>
-En résumé, les distributions <em>stable</em>, <em>testing</em> et
-<em>unstable</em> sont disponibles en permanence et de temps en temps, une
-distribution <em>frozen</em> apparaît pour quelques mois.
-
-
-
-
-
- <sect1>Experimental
-
-<p>
-<em>NOTE : <em>experimental</em> ne fonctionne plus depuis la mise en place du
-<em>package pool</em>. Si la distribution <em>experimental</em> est remise en service
-un jour, la présente section aura sûrement besoin d'une mise à jour.</em>
-
-<p>
-La distribution <em>experimental</em> est une distribution particulière. Ce
-n'est pas une distribution à part entière comme le sont <em>stable</em> et
-<em>unstable</em>. Elle est prévue pour servir de plate-forme de développement
-pour les projets expérimentaux qui ont de grandes chances de détruire le
-système. Les utilisateurs qui téléchargent et installent des paquets depuis
-<em>experimental</em> sont prévenus : on ne peut pas faire confiance à la
-distribution <em>experimental</em>.
-
-<p>
-Les responsables doivent être très sélectifs quant à l'utilisation de la
-distribution <em>experimental</em>. Même très instable, un paquet peut aller
-dans <em>unstable</em> ; ajoutez juste quelques avertissements dans la
-description. Par contre, s'il y a une chance que le logiciel endommage
-sérieusement le système, il est préférable de le mettre dans
-<em>experimental</em>.
-
-<p>
-Un système de fichier crypté, par exemple, devrait probablement aller dans
-<em>experimental</em>. Une nouvelle version non finalisée d'un logiciel qui
-utilise une méthode de configuration complètement différente pourrait aller
-dans <em>experimental</em> à la discrétion du responsable. Un nouveau logiciel
-qui a peu de chance d'endommager le système ira dans <em>unstable</em>. Si
-vous travaillez sur un cas de mise à jour complexe ou incompatible vous pouvez
-aussi utiliser <em>experimental</em> comme plate-forme d'intégration et ainsi
-fournir un accès aux testeurs.
-
-<p>
-Par contre, utiliser <em>experimental</em> comme plate-forme n'est pas
-toujours la meilleure idée. Vous ne pouvez pas remplacer ou mettre à jour des
-paquets dans cet espace vous-même (c'est le logiciel de maintenance de
-l'archive qui s'en charge). De plus, il vous faudra penser à demander la
-suppression de vos paquets à l'équipe d'administration de l'archive une fois
-qu'ils seront installés dans <em>unstable</em>. Utiliser vos pages web
-personnelles sur le serveur <tt>klecker.debian.org</tt> est en général une
-meilleure idée, cela permet de décharger l'équipe de maintenance de l'archive.
-
-
-
- <sect id="codenames">Les noms de distribution
-
-<p>
-Chaque distribution Debian diffusée a un nom : Debian 1.1 s'appelle
-« buz » ; Debian 1.2, « rex » ; Debian 1.3 « bo » ;
-Debian 2.0, « hamm » ; Debian 2.1, « slink » et Debian 2.2
-« potato ». Il y a aussi une pseudo-distribution nommée
-« sid », il s'agit de la distribution <em>unstable</em> ; comme les
-paquets vont de <em>unstable</em> à <em>testing</em> quand ils approchent de
-la stabilité, la distribution « sid » n'est jamais diffusée. En plus
-du contenu habituel d'une distribution Debian, « sid » contient des
-paquets pour des architectures qui ne sont pas encore officiellement
-supportées ou pour lesquelles la distribution n'a pas encore été diffusée. Ces
-architectures doivent rejoindre les architectures supportées à une date
-future.
-
-<p>
-Comme Debian est un projet de développement ouvert (i.e. tout le monde peut
-participer et suivre les développements) même les distributions
-<em>unstable</em> et <em>testing</em> sont disponibles sur les serveurs HTTP
-et FTP de Debian.
-
-<p>
-Si nous avions nommé le répertoire qui contient la prochaine version àc
-diffuser « testing », il aurait fallu le renommer
-« stable » au moment de la diffusion, ce qui aurait forcé les
-miroirs FTP à re-télécharger la distribution complète (qui est plutôt
-volumineuse).
-
-<p>
-D'un autre coté, si une distribution s'appelle <em>Debian-x.y</em> dès le
-départ, des personnes pourraient s'imaginer que la distribution Debian
-<em>x.y</em> est disponible. (Cela s'est produit par le passé, un distributeur
-avait gravé des cédéroms Debian 1.0 en utilisant une version de développement
-pré-1.0. C'est pour cette raison que la première version officielle était la
-version 1.1 et non la 1.0.)
-
-<p>
-En conséquence, les noms de répertoire des distributions dans l'archive sont
-déterminés par leurs noms de code et non par leur statut (exemple : slink). Ces
-noms sont identiques pendant la période de développement et une fois la
-distribution diffusée ; des liens symboliques, qui peuvent être modifiés
-facilement, indiquent la distribution stable actuelle.
-
-<p>
-Tout ceci explique pourquoi les répertoires des distributions sont nommés à
-partir des noms de code des distributions alors que <em>stable</em>,
-<em>testing</em>, <em>unstable</em> et <em>frozen</em> sont des liens
-symboliques qui pointent vers les répertoires appropriés.
-
-
-
-
-
- <chapt id="upload">La mise à jour d'un paquet
-
-
- <sect>Annoncer un nouveau paquet
-
-<p>
-Si vous voulez créer un nouveau paquet pour la distribution Debian vous
-devriez commencer par consulter la liste des <url id="&url-wnpp;"
-name="paquets en souffrance et paquets souhaités">. Vous pourrez ainsi
-vérifier que personne ne travaille déjà sur ce paquet et éviter un double
-travail. Consultez aussi cette page si vous voulez en savoir plus.
-
-<p>
-Supposons que personne ne travaille sur le paquet que vous visez, vous devez
-alors envoyer un rapport de bogue (voir <ref id="submit-bug">) concernant le
-pseudo-paquet <tt>wnpp</tt>. Ce
-courrier devra décrire le paquet que vous projetez de créer, la licence de ce
-paquet et l'URL à laquelle le source peut être téléchargé. Cette liste n'est
-pas limitative.
-
-<p>
-Le sujet de votre rapport de bogue devra être <ITP<footnote><em>Intent To
-Package</em> : intention de mise en paquet</footnote> :
-<var>NomDuPaquet</var> -- <var> courte description </var>>, en remplaçant
-<var>NomDuPaquet</var> par le nom du paquet. La sévérité du bogue sera
-<em>whishlist</em>. Si vous le jugez nécessaire, envoyez une copie à
-&email-debian-devel; en mettant cette adresse dans le champs X-Debbugs-CC: de
-l'entête du message. N'utilisez pas le champs CC: car de cette manière le
-sujet du message ne contiendrait pas le numéro du bogue.
-
-<p>
-Il faudra aussi ajouter une entrée
-<tt>Closes: bug#<var>nnnnn</var></tt> dans le fichier <file>changelog</file>
-du nouveau paquet. Cette indication fermera automatiquement le rapport de
-bogue à l'installation du nouveau paquet sur les serveurs d'archivage (voir
-<ref id="upload-bugfix">).
-
-<p>
-Il y a plusieurs raisons qui nous poussent à demander aux responsables d'annoncer
-leurs intentions :
-
- <list compact>
- <item>
- Les responsables ont ainsi la possibilité de puiser dans l'expérience
- des autres responsables et cela leur permet de savoir si une autre personne
- travaille déjà dessus.
-
- <item>
- D'autres personnes qui envisagent de travailler sur le même paquet
- apprendront ainsi qu'il existe déjà un volontaire, l'effort peut alors
- être partagé.
-
- <item>
- Cela permet aux autres responsables d'en savoir plus sur le nouveau
- paquet que ne le permettent la description d'une ligne et l'habituelle
- entrée « <em>Initial release</em> » que l'on trouve dans les
- fichiers <em>changelog</em> qui sont postés sur
- <tt>debian-devel-changes</tt>.
-
- <p>
- C'est une information utile pour les gens qui utilisent la
- distribution <em>unstable</em> et qui sont nos premiers testeurs. Nous
- devons faciliter la tâche de ces gens.
-
- <p>
- Avec ces annonces, les développeurs Debian et toutes les autres personnes
- intéressées peuvent se faire une meilleure idée des évolutions et nouveautés du
- projet.
-
- </list>
-
-
-
-
-
- <sect id="uploading">Mettre à jour un paquet
-
-
- <sect1>Générer le fichier « changes »
-
-<p>
-Chaque nouvelle version d'un paquet installé sur les archives FTP Debian doit
-être accompagnée d'un fichier <tt>.changes</tt>. Ce fichier explique à
-l'administrateur de l'archive Debian ce qu'il doit faire du paquet. Il est en
-général créé par <prgn>dpkg-genchanges</prgn> au cours du processus de
-fabrication du paquet.
-
-<p>
-Le fichier <tt>changes</tt> est un fichier de contrôle qui contient les champs
-suivants :
-
-<p>
-&control-file-fields;
-
-<p>
-Tous ces champs sont obligatoires pour une installation sur les serveurs
-Debian. Vous pouvez consulter la liste des champs de contrôle dans le
-<url id="&url-debian-policy;" name="Debian Policy Manual"> pour connaître
-les valeurs que prennent ces champs. Vous pouvez fermer un rapport de bogue
-automatiquement avec le champ <tt>Description</tt> (voir <ref
-id="upload-bugfix">). Nous ne verrons ici que le champ <tt>Distribution</tt>
-car il est directement lié aux règles d'administration de l'archive.
-
-
-
-
- <sect1 id="upload-dist">Choisir une distribution
-
-<p>
-Le champ <tt>Distribution</tt>, qui provient du fichier
-<file>debian/changelog</file>, indique à quelle distribution le paquet est
-destiné. Il y a quatre valeurs possibles pour ce champ : <em>stable</em>,
-<em>unstable</em>, <em>frozen</em> et <em>experimental</em> ; ces valeurs
-peuvent aussi être combinées. Si, par exemple, Debian a été gelée et vous
-voulez mettre à jour une correction de bogue sur <em>frozen</em>, il faudra
-indiquer <em>frozen unstable</em> dans le champ distribution (se reporter à
-<ref id="upload-frozen"> pour savoir quand vous pouvez faire une mise à jour
-sur <em>frozen</em>). Notez bien qu'il n'y a pas de raison de combiner
-<em>experimental</em> avec quelque distribution que ce soit.
-
-<p>
-Vous devriez éviter de combiner <em>stable</em> avec d'autres cibles à cause
-des problèmes potentiels de dépendance de bibliothèque (pour votre paquet et
-pour les paquets fabriqués par le démon de compilation pour les autres
-architectures). Notez encore que choisir la valeur <em>stable</em> pour ce
-champ signifie que le paquet sera dirigé vers le répertoire
-<tt>proposed-update</tt> des archives Debian pour y être testé avant d'être
-effectivement inclus dans <em>stable</em>. L'équipe responsable de la
-distribution<footnote><em>the release team</em></footnote> (joignable à
-l'adresse &email-debian-release;) prendra la décision d'inclure ou de ne pas
-inclure votre paquet dans la distribution <em>stable</em>. C'est pourquoi vous
-pourrez choisir de leur envoyer un courrier expliquant les motifs qui vous ont
-incité à faire une mise à jour pour <em>stable</em>, si votre fichier
-<file>changelog</file> n'est pas suffisamment clair sur ce point.
-
-<p>
-La première fois qu'un paquet est installé dans l'archive pour une version
-amont donnée, le fichier <tt>tar</tt> de cette version amont doit être
-téléchargé et mentionné dans le fichier <tt>.changes</tt>. Par la suite, ce
-fichier <tt>tar</tt> sera utilisé pour générer les fichiers <tt>diff</tt> et
-<tt>.dsc</tt> et il ne sera pas nécessaire de le re-télécharger.
-
-<p>
-Par défaut, <prgn>dpkg-genchanges</prgn> et <prgn>dpkg-buildpackage</prgn>
-incluront le fichier <tt>tar</tt> amont si et seulement si le numéro de
-révision du paquet source est 0 ou 1, ce qui indique une nouvelle version
-amont. Ce comportement peut être modifié en utilisant <tt>-sa</tt> pour
-l'inclure systématiquement ou <tt>-sd</tt> pour ne jamais l'inclure.
-
-<p>
-Si la mise à jour ne contient pas le fichier <tt>tar</tt> des sources
-originaux, <prgn>dpkg-source</prgn> <em>doit</em>, pour construire les
-fichiers <tt>.dsc</tt> et <tt>diff</tt> de la mise à jour, utiliser un fichier
-<tt>tar</tt> identique à l'octet près à celui sur le serveur. Si pour une
-raison ou pour une autre il y a une différence, la nouvelle version de ce
-fichier doit à nouveau être incluse dans la mise à jour (en utilisant l'option
-<tt>-sa</tt> par exemple).
-
-
-
-
-
-
- <sect2 id="upload-frozen">Mettre à jour la distribution <em>frozen</em>
-
-<p>
-Le gel de la distribution est un moment crucial pour Debian. C'est l'occasion
-de synchroniser et de stabiliser notre distribution en un tout
-cohérent. Il faut donc être très vigilant quand on fait une mise à jour
-pour <em>frozen</em>.
-
-<p>
-Il est tentant de toujours mettre en paquet la dernière version d'un logiciel
-pour Debian ; mais il est bien plus important que le système soit stable et
-qu'il fonctionne de la manière attendue.
-
-<p>
-Le mot d'ordre pour télécharger vers <em>frozen</em> est : <strong>pas de code
-nouveau</strong>. C'est une chose difficile à quantifier, voici quelques
-conseils :
-
-<p>
- <list compact>
- <item>
- Les corrections de bogues de sévérité <em>critique</em>,
- <em>grave</em> ou <em>sérieuse</em><footnote>respectivement
- <em>critical</em>, <em>grave</em> ou <em>serious</em></footnote> sont
- toujours autorisées pour les paquets qui doivent exister dans la
- distribution.
-
- <item>
- Les corrections pour les bogues de sévérité <em>critique</em>,
- <em>grave</em> ou <em>sérieuse</em><footnote>respectivement
- <em>critical</em>, <em>grave</em> ou <em>serious</em></footnote> sont
- autorisées pour les paquets non indispensables uniquement si elles
- n'ajoutent pas de nouvelle fonctionnalité.
-
- <item>
- Les corrections pour les bogues de sévérité <em>importante</em>,
- <em>normale</em> et <em>mineure</em><footnote>respectivement
- <em>important</em>, <em>normal</em> et <em>minor</em></footnote> sont
- autorisées, bien que découragées, sur tous les paquets si et seulement
- s'elles n'ajoutent pas de nouvelle fonctionnalité.
-
- <item>
- Les corrections de sévérité <em>wishlist</em> ne sont pas autorisées (ce
- ne sont pas vraiment des bogues après tout).
-
- <item>
- Les corrections liées à la documentation sont autorisés car il est
- important d'avoir une bonne documentation.
-
- </list>
-
-<p>
-L'expérience montre qu'il y a 15% de chance d'introduire un nouveau bogue en
-corrigeant un autre bogue. L'introduction et la découverte d'un nouveau bogue
-retarde la mise à disposition de la distribution ou affaiblit le produit
-final. Il y a très peu de corrélation entre la sévérité du bogue corrigé et
-la sévérité du bogue introduit par la correction.
-
-
-
-
- <sect1 id="upload-checking">Vérifier le paquet avant la mise à jour
-
-<p>
-Avant de mettre à jour votre paquet vous ferez quelques tests de base. Vous
-devrez au moins faire les tests suivants (il vous faut une ancienne version
-du paquet pour cela) :
-
- <list compact>
- <item>
- Installez le paquet et vérifiez que le logiciel fonctionne. Si le
- paquet existait déjà dans une version plus ancienne, faites une mise à
- jour.
-
- <item>
- Exécutez <prgn>lintian</prgn> sur votre paquet. Vous pouvez exécuter
- <prgn>lintian</prgn> comme suit : <tt>lintian -v
- <var>package-version</var>.changes</tt>. Ce programme fera une
- vérification sur les paquets source et binaire. Si vous ne comprenez
- par les messages générés par <prgn>lintian</prgn> essayez l'option
- <tt>-i</tt>. Cette option rendra <prgn>lintian</prgn> beaucoup plus
- bavard dans sa description du problème. <p> Un paquet pour lequel
- <prgn>lintian</prgn> génère des erreurs (elles commencent par
- <tt>E</tt>) <em>ne doit pas</em> être installé dans l'archive.
-
- <p>
- Pour en savoir plus sur <prgn>lintian</prgn> reportez-vous à la
- section lintian <ref id="lintian">. <item> Faites régresser le paquet
- vers sa version précédente si elle existe -- cela permet de tester les
- scripts <tt>postrm</tt> et <tt>prerm</tt>.
-
- <item>
- Désinstallez le paquet et réinstallez-le.
-
- </list>
-
-
-
-
-
- <sect1 id="upload-ftp-master">Installer un paquet sur
- <tt>ftp-master</tt>
-
-<p>
-Pour installer un paquet vous avez besoin d'un compte sur
-<ftpsite>ftp-master</ftpsite>, ce que vous devez avoir en tant que
-développeur Debian. Si vous utilisez <prgn>scp</prgn> ou <prgn>rsync</prgn>
-pour télécharger vos paquets, placez-les dans
-<tt>&us-upload-dir;</tt>. Si vous utilisez un FTP anonyme,
-placez-les dans <ftppath>/pub/UploadQueue/</ftppath>.
-
-<p>
-<em>Note :</em> ne téléchargez pas de paquet soumis aux lois de contrôle des
-exportations américaines sur le serveur <tt>ftp-master</tt>, ni sur les serveurs
-<tt>chiark</tt> et <tt>erlangen</tt>. Cet interdit couvre à peu près tous les
-logiciels de cryptographie ainsi que quelques logiciels liés aux logiciels de
-cryptographie comme les clients de courrier électronique qui utilisent le
-cryptage et l'authentification PGP. Ces logiciels doivent être téléchargés sur
-le serveur <tt>non-us</tt>. Reportez-vous à la section <ref
-id="upload-non-us"> pour en savoir plus. Si vous ne savez pas si votre paquet
-est soumis aux lois de contrôle des exportations américaines posez la question sur la
-liste &email-debian-devel;.
-
-<p>
-Le paquet <package>dupload</package> pourra vous faciliter le travail lors du
-téléchargement. Ce programme, bien pratique, est configuré par défaut pour
-se connecter par FTP sur les serveurs <tt>ftp-master</tt>,
-<tt>chiark</tt> et <tt>erlangen</tt>. Il peut aussi être configuré pour
-utiliser <prgn>ssh</prgn> ou <prgn>rsync</prgn>. Se reporter à <manref
-name="dupload" section="1"> et <manref name="dupload" section="5"> pour en
-savoir plus.
-
-<p>
-Après avoir téléchargé votre paquet, vous pouvez vérifier ce qu'en fera le
-logiciel de maintenance de l'archive en exécutant <prgn>dinstall</prgn>
-sur votre fichier <file>.changes</file> :
-
-<example>dinstall -n foo.changes</example>
-
-
-
-
+Notez que <prgn>dput</prgn> peut le faire automatiquement pour vous.
<sect1 id="upload-non-us">Installer un paquet sur <tt>non-US</tt>
- (pandora)
-
<p>
Comme nous l'avons dit un peu plus haut, les programmes soumis au contrôle des
-exportations américain ne doivent pas être installés sur <tt>ftp-master</tt>.
-Utilisez <prgn>scp</prgn> ou <prgn>rsync</prgn> pour copier votre paquet sur
-<ftpsite>non-us.debian.org</ftpsite>. Placer les fichiers dans le répertoire
-<tt>&non-us-upload-dir;</tt>. Par défaut, vous pouvez utiliser le même
-<em>login/mot de passe</em> que pour <tt>ftp-master</tt>. Si vous utilisez
-une connexion FTP anonyme pour le téléchargement, placez vous fichiers dans le
-répertoire <ftppath>/pub/UploadQueue/</ftppath>.
-
-<p>
-Le programme <prgn>dupload</prgn> est, lui aussi, capable de télécharger sur
-<tt>non-us</tt> ; consultez la documentation de ce programme pour en savoir
-plus.
-
+ exportations américaines ne doivent pas être installés sur
+ <tt>ftp-master</tt>. Installez le paquet sur
+ <ftpsite>non-us.debian.org</ftpsite> dans le répertoire &non-us-upload-dir;
+ (<ref id="dupload"> et <ref id="dput"> avec les options adéquates peuvent
+ tous deux être utilisés pour cela). Par défaut, vous pouvez utiliser le même
+ <em>login/mot de passe</em> que pour <tt>ftp-master</tt>. Si vous utilisez
+ une connexion FTP anonyme pour le téléchargement, placez vos fichiers dans le
+ répertoire &upload-queue;.
<p>
Tout comme sur <tt>ftp-master</tt>, vous pouvez vérifier votre téléchargement
-avec :
-
-<example>dinstall -n foo.changes</example>
-
-
-<p>
-Attention, les personnes résidant aux États-unis et les citoyens américains
-sont soumis à des restrictions sur l'exportation des logiciels de
-cryptographie. Au moment où j'écris, les citoyens américains peuvent exporter
-quelques logiciels de cryptographie soumis à une obligation de déclaration
-auprès du département du commerce américain.
-
-<p>
-Le <em>Debian Policy Manual</em> n'empêche pas les résidents et citoyens
-américains de livrer des paquets sur <tt>non-US</tt> mais ils devront être
-vigilants en le faisant. Nous recommandons aux responsables concernés de
-prendre toutes les précautions nécessaires, <em>y compris consulter un
-juriste</em>, pour s'assurer qu'ils n'enfreignent pas une loi américaine en
-livrant un paquet sur <tt>non-US</tt>.
-
-<p>
-Pour les paquets des sections <em>non-US/main</em> et <em>non-US/contrib</em>
-les responsables devraient au moins suivre la <url id="&url-u.s.-export;"
-name="procédure décrite par le gouvernement américain">. Les responsables de
-paquets <em>non-US/non-free</em> devront en plus consulter les <url
-id="&url-notification-of-export;" name="règles de déclaration d'exportation
-pour les logiciels commerciaux">.
-
+ avec : <example>dinstall -n foo.changes</example>
+<p>
+Attention, les personnes résidant aux États-Unis et les citoyens américains sont
+ soumis à des restrictions sur l'exportation des logiciels de cryptographie.
+ Au moment où j'écris, les citoyens américains peuvent exporter quelques
+ logiciels de cryptographie soumis à une obligation de déclaration auprès du
+ département du commerce américain. Toutefois, cette restriction a été
+ abandonnée pour des logiciels qui sont déjà disponibles en dehors des
+ États-Unis. En conséquence, tout logiciel de cryptographie de la section
+ <em>main</em> de l'archive Debian qui ne dépend d'aucun paquet d'une autre
+ section — il ne doit pas dépendre de <em>non-US/main</em> — peut
+ être téléchargé sur <tt>ftp-master</tt> ou l'une de ses files d'attente
+ décrites plus haut.
+<p>
+La <em>charte Debian</em> n'empêche pas les résidents et citoyens américains de
+ livrer des paquets sur <tt>non-US</tt> mais ils devront être vigilants en le
+ faisant. Nous recommandons aux responsables concernés de prendre toutes les
+ précautions nécessaires, <em>y compris la consultation d'un juriste</em>,
+ pour s'assurer qu'ils n'enfreignent pas une loi américaine en livrant un
+ paquet sur <tt>non-US</tt>.
+<p>
+Pour les paquets des sections <em>non-US/main</em> et <em>non-US/contrib</em>,
+ les responsables devraient au moins suivre la <url id="&url-u.s.-export;"
+ name="procédure décrite par le gouvernement américain">. Les responsables de
+ paquets <em>non-US/non-free</em> devront en plus consulter les <url
+ id="&url-notification-of-export;" name="règles de déclaration d'exportation
+ pour les logiciels commerciaux">.
<p>
Cette section a pour seul but d'informer, elle n'a pas valeur de conseil
-juridique. Une fois encore, nous recommandons aux résidents et citoyens
-américains de consulter un juriste avant de livrer un paquet sur
-<tt>non-US</tt>.
-
+ juridique. Une fois encore, nous recommandons aux résidents et citoyens
+ américains de consulter un juriste avant de livrer un paquet sur
+ <tt>non-US</tt>.
<sect1>Installer un paquet via <tt>chiark</tt>
-
<p>
Si votre connexion vers <tt>ftp-master</tt> est lente, vous avez plusieurs
-possibilités. L'une d'elles consiste à télécharger vos fichiers dans
-<tt>Incoming</tt> en passant par le serveur <tt>chiark</tt> en Europe. Comme
-cette file d'attente des mises à jour est redirigée vers <tt>ftp-master</tt>,
-les indications de la section <ref id="upload-ftp-master"> sont applicables ici
-aussi.
-
+ possibilités. L'une d'elles consiste à télécharger vos fichiers dans
+ <file>Incoming</file> en passant par le serveur <tt>chiark</tt> en Europe.
+ Pour les détails, consultez <url id="&url-chiark-readme;">.
+<p>
+Attention, ne téléchargez pas de paquet contenant un logiciel soumis aux lois de
+ contrôle des exportations américaines sur <tt>chiark</tt>. Les paquets
+ téléchargés sur ce serveur sont redirigés vers <tt>ftp-master</tt>, les
+ indications de la section <ref id="upload-ftp-master"> sont applicables ici
+ aussi.
<p>
Le programme <prgn>dupload</prgn> est capable de télécharger sur
-<tt>chiark</tt> ; consultez la documentation de ce programme pour en savoir
-plus.
-
-
+ <tt>chiark</tt> ; consultez la documentation de ce programme pour en
+ savoir plus.
<sect1>Installer un paquet via <tt>erlangen</tt>
-
<p>
Vous pouvez aussi accéder à un serveur situé en Allemagne : il vous suffit
-d'ouvrir une connexion anonyme sur :
-
-<p>
- <url id="&url-upload-erlangen;">.
-
-<p>
-Le téléchargement fait sur ce serveur doit être aussi complet que s'il
-était fait dans le répertoire <tt>Incoming</tt> sur <tt>ftp-master</tt> :
-il doit comporter le fichier <file>.changes</file> et tous les fichiers
-mentionnés dans ce dernier. Le serveur vérifie que le fichier
-<tt>.changes</tt> est bien signé avec la clé PGP d'un développeur Debian pour
-éviter que des faux paquets n'atteignent <tt>ftp-master</tt>. Vérifiez bien
-que le champ <tt>Maintainer</tt> du fichier <tt>.changes</tt> contient
-<em>votre</em> adresse électronique. De même que sur <tt>ftp-master</tt>,
-cette adresse est ensuite utilisée pour toutes les réponses.
-
-<p>
-Il n'est pas nécessaire de déplacer votre fichier dans un autre répertoire
-après le téléchargement, contrairement au serveur <tt>chiark</tt>. Vous
-devriez ensuite recevoir un courrier du serveur expliquant ce qu'il a fait de
-votre paquet. Normalement, il devrait avoir été déplacé vers
-<tt>ftp-master</tt> ;
-vous serez informé par le même biais si une erreur s'est produite au cours du
-processus.
-
-<p>
-<em>Note :</em> ne téléchargez pas de paquets contenant des logiciels tombant
-sous le coup de la loi de contrôle des exportations américaine sur
-<tt>erlangen</tt>. Comme les paquets téléchargés ici vont vers
-<tt>ftp-master</tt>, les règles décrites dans la section <ref
-id="upload-ftp-master"> sont applicables ici aussi.
-
-<p>
-Le programme <prgn>dupload</prgn> est capable de télécharger sur
-<tt>erlangen</tt> ; consultez la documentation de ce programme pour en savoir
-plus.
-
-
-
-
-
- <sect1>Les autres serveurs
-
-<p>
-Un autre serveur est disponible aux États-Unis ; c'est un bon point
-de repli quand il est difficile de joindre <tt>ftp-master</tt>. Livrez vos
-paquets à l'adresse <url id="&url-upload-samosa;"> comme vous le feriez sur
-<tt>erlangen</tt>.
-<p>
-Il existe aussi un serveur au Japon : téléchargez vos paquet par FTP
-anonyme sur <url id="&url-upload-jp;">.
-
-
-
-
- <sect id="upload-announce">Annoncer une mise à jour
-
-<p>
-Quand un paquet est mis à jour, une annonce doit être envoyée sur l'une des
-listes « debian-changes ». Ceci est maintenant géré automatiquement
-par le logiciel de gestion de l'archive quand il est exécuté (en principe une
-fois par jour). Vous devez juste utiliser une version récente de
-<package>dpkg-dev</package> (>= 1.4.1.2). Le courrier généré par le
-logiciel de maintenance de l'archive contiendra le fichier <tt>.changes</tt>
-signé que vous avez livré avec votre paquet. Précédemment, cette charge
-revenait à <prgn>dupload</prgn> ; vérifiez que vous avez bien configuré
-<prgn>dupload</prgn> pour qu'il n'envoie pas ces annonces (cherchez
-<tt>dinstall_runs</tt> dans la documentation de <prgn>dupload</prgn>).
-
-<p>
-Si un paquet est mis à jour pour la distribution <em>stable</em>, l'annonce
-est envoyée sur la liste :
-
-<p>
-<tt> &email-debian-changes;.</tt>
-
+ d'ouvrir une connexion anonyme sur <url id="&url-upload-erlangen;">.
+<p>
+Le téléchargement fait sur ce serveur doit être aussi complet que s'il était
+ fait dans le répertoire <file>Incoming</file> sur <tt>ftp-master</tt> : il
+ doit comporter le fichier <file>.changes</file> et tous les fichiers
+ mentionnés dans ce dernier. Le serveur vérifie que le fichier
+ <file>.changes</file> est bien signé avec la clé PGP d'un développeur Debian
+ pour éviter que des faux paquets n'atteignent <tt>ftp-master</tt>. Vérifiez
+ bien que le champ <tt>Maintainer</tt> du fichier <file>.changes</file>
+ contient <em>votre</em> adresse électronique. De même que sur
+ <tt>ftp-master</tt>, cette adresse est ensuite utilisée pour toutes les
+ réponses.
+<p>
+Il n'est pas nécessaire de déplacer votre fichier dans un autre répertoire après
+ le téléchargement, contrairement au serveur <tt>chiark</tt>. Vous devriez
+ ensuite recevoir un courrier du serveur expliquant ce qu'il a fait de votre
+ paquet. Normalement, il devrait avoir été déplacé vers
+ <tt>ftp-master</tt> ; vous serez informé par le même biais si une erreur
+ s'est produite au cours du processus.
+<p>
+Attention, ne téléchargez pas de paquet contenant un logiciel soumis aux lois de
+ contrôle des exportations américaines sur <tt>erlangen</tt>. Les paquets
+ téléchargés sur ce serveur sont redirigés vers <tt>ftp-master</tt>, les
+ indications de la section <ref id="upload-ftp-master"> sont applicables ici
+ aussi.
<p>
-S'il est mis à jour pour les distributions <em>unstable</em>,
-<em>experimental</em> ou <em>frozen</em>, l'annonce est envoyée sur la liste
-&email-debian-devel-changes;.
-
-<p>
-De temps en temps, il est nécessaire de mettre à jour simultanément les
-distributions <em>stable</em> et <em>unstable</em> ; cela est possible en
-indiquant les deux distributions sur la ligne <tt>Distribution:</tt>. Dans ce
-dernier cas, l'annonce sera faite sur les deux listes de diffusion citées
-précédemment.
-
-<p>
-Le programme <prgn>dupload</prgn> est suffisamment intelligent pour déterminer
-où devra aller l'annonce et pour envoyer le courrier sur la bonne liste. Voir <ref
-id="dupload">.
-
-
-
-
- <sect id="upload-notification">
- <heading>Notification de l'installation d'un nouveau paquet</heading>
-
-<p>
-Les administrateurs de l'archive Debian sont responsables de l'installation
-des mises à jour. La plupart des mises à jour sont gérées
-quotidiennement par le logiciel de gestion de l'archive <prgn>dak</prgn>
-(aussi appelé <prgn>katie</prgn> ou <prgn>dinstall</prgn>). Les mises à jour
-de paquets sur la distribution <em>unstable</em>, en particulier, sont
-installés ainsi. Dans les autres cas et notamment dans le cas d'un nouveau
-paquet, celui-ci sera installé manuellement. Il peut s'écouler jusqu'à un mois
-entre le téléchargement d'un paquet vers un serveur et son installation
-effective. Soyez patients.
-
-<p>
-Dans tous les cas vous recevrez un accusé de réception par courrier
-électronique indiquant que votre paquet a été installé. Lisez attentivement ce
-courrier. Vous pourriez remarquer que votre paquet n'a pas été installé dans
-la section que vous aviez désignée. La raison de ce changement sera dans le
-courrier.
-
-
-
-
- <sect1 id="override-file">Le fichier <em>override</em>
-
-<p>
-Les champs <tt>Section</tt> et <tt>Priority</tt> du fichier
-<file>debian/control</file> n'indiquent ni où le paquet sera installé dans
-l'archive Debian ni sa priorité. Afin de conserver la
-cohérence de l'archive, ce sont les administrateurs qui contrôlent ces
-champs. Les valeurs du fichier <file>debian/control</file> sont juste des
-indications.
-
-<p>
-Les administrateurs de l'archive indiquent les sections et priorités des paquets
-dans le fichier <em>override</em>. De temps en temps, ce fichier doit être
-corrigé. Modifier le fichier <file>control</file> du paquet n'aura aucun
-effet. Il vous faudra écrire à &email-override; ou faire un rapport de bogue
-sur le pseudo-paquet <package>ftp.debian.org</package>.
-
-<p>
-Pour en savoir plus sur le fichier <em>override</em>, reportez-vous à <manref
-name="dpkg-scanpackages" section="8">, &file-bts-mailing; et &file-bts-info;.
-
-
-
-
- <chapt id="nmu">Mise à jour indépendante
-
-<p>
-Dans certaines circonstances il est nécessaire qu'une personne autre que le
-responsable d'un paquet fasse une mise à jour de ce paquet. Ce type de mise à
-jour est désigné en anglais par l'expression <em>non-maintainer upload
-(NMU)</em>. Dans le présent document, nous traduisons librement cette
-expression par « mise à jour indépendante ».
-
-<p>
-Ces mises à jour indépendantes font partie du travail normal des porteurs qui
-compilent les paquets pour d'autres architectures (voir <ref id="porting">).
-Nous faisons aussi des mises à jour indépendantes quand un développeur Debian
-corrige le paquet d'un autre développeur pour éliminer un trou de sécurité
-ou un bogue paralysant. Cela se produit plus particulièrement en période de
-gel de la distribution de développement ou quand le responsable officiel du
-paquet ne peut pas fournir une correction dans un délai raisonnable.
-
-<p>
-Ce chapitre contient des informations qui vous expliqueront quand et comment
-faire des mises à jour indépendantes. Une distinction fondamentale doit être
-faite entre les mises à jour indépendantes sources et les mises à jour
-indépendantes binaires. Elle est explicitée dans la section suivante.
-
-
- <sect id="nmu-terms">Terminologie
-
-<p>
-Deux nouvelles expressions sont introduites dans cette section :
-« mise à jour indépendante source » et « mise à
-jour indépendante binaire ». Ces expressions ont une définition
-précie dans le monde Debian. Elles correspondent toutes deux au même type
-d'activité ; elles impliquent toutes deux qu'une personne fait une mise à
-jour d'un paquet alors qu'elle n'est pas officiellement responsable de ce
-paquet. C'est pourquoi nous qualifions ces mises à jours
-d'<em>indépendantes</em><footnote>Contrairement à ce que pourrait laisser
-entendre cette traduction de <em>non-maintainer upload</em>, il n'est pas
-question d'agir sans prévenir le responsable au préalable (voir <ref
-id="nmu-guidelines">).</footnote>.
-
-<p>
-Une mise à jour indépendante source est une livraison de paquet faite par
-une personne qui n'est pas le responsable officiel de ce paquet avec pour
-objectif de corriger un bogue dans le paquet. Une mise à jour indépendante
-source implique toujours une modification des sources du paquet, même s'il
-ne s'agit que d'un changement dans le fichier <file>debian/changelog</file>.
-Ce changement peut tout aussi bien concerner la version amont du source que la
-partie du source spécifique à Debian.
-
-<p>
-Une mise à jour indépendante binaire est une recompilation et un archivage
-d'un paquet pour une nouvelle architecture. Il s'agit souvent du résultat d'un
-effort de portage. Une mise à jour indépendante binaire est la livraison d'un
-paquet compilé (souvent pour une autre architecture) à condition que cette
-compilation n'ait pas nécessité de modifications des sources. Dans de
-nombreux cas, les porteurs
-sont obligés de modifier les sources pour les rendre compilables sur leur
-architecture cible ; il s'agira alors d'une mise à jour indépendante source et
-non d'une mise à jour indépendante binaire. Comme vous pouvez le remarquer,
-nous ne faisons pas de distinction entre les mises à jour indépendantes
-faites par des porteurs et les autres mises à jour indépendantes.
-
-<p>
-Les mises à jour indépendantes sources et binaires sont toutes deux couvertes
-par l'expression « mise à jour indépendante »
-(NMU<footnote>Non-maintainer upload</footnote>). Pourtant cela conduit souvent
-à des confusions car beaucoup associent « mise à jour indépendante »
-et « mise à jour indépendante source ». Il faut donc rester
-vigilant. Dans ce chapitre, si j'utilise « mise à jour
-indépendante » seul, il s'agit des deux types de livraisons.
-
-
-
-
-
- <sect id="nmu-who">Qui peut faire une mise à jour indépendante ?
-
-<p>
-Seuls les responsables Debian officiels peuvent faire des mises à jour
-indépendantes. Un responsable officiel est une personne dont la clé est dans
-le porte-clés Debian. Toute personne est invitée à télécharger les paquets
-sources pour corriger des bogues ; au lieu de faire des mises à jour
-indépendantes, ils pourront soumettre les <em>patch</em> qui le méritent au
-système de suivi des bogues. Les responsables apprécient presque toujours les
-<em>patch</em> et les rapports de bogue soignés.
-
-
- <sect id="nmu-when">Quand faire une mise à jour indépendante source ?
-
-<p>
-Les recommandations pour déterminer quand faire une mise à jour indépendante
-source dépendent de la distribution visée (i.e. stable, instable ou
-gelée). Les porteurs, ayant une activité particulière, obéissent à des règles
-légèrement différentes (voir <ref id="source-nmu-when-porter">).
-
-<p>
-La distribution stable ne peut recevoir que des corrections critiques ou des
-mises à jour de sécurité. Quand une faille de sécurité est détectée, un
-paquet corrigé doit être livré le plus tôt possible. Dans ce cas, le responsable de
-sécurité Debian<footnote>Debian Security Manager</footnote> entrera en contact
-avec le responsable du paquet pour s'assurer qu'un paquet corrigé sera livré dans
-un délai raisonnable (moins de 48 heures). Si le mainteneur ne peut
-fournir une mise à jour suffisamment vite ou s'il ne peut être joint à temps, le
-responsable de sécurité pourra corriger le paquet (i.e. faire une mise à jour
-indépendante source).
-
-<p>
-Pendant la phase de gel (voir <ref id="upload-frozen">), les livraisons qui
-corrigent les bogues de sévérité <em>sérieuse</em> (i.e. <em>serious</em>) et
-supérieures sont encouragées et acceptées. Même pendant cette période, vous
-devrez tenter d'entrer en contact avec le responsable du paquet ; il pourrait
-bien être sur le point de livrer un paquet corrigé lui aussi. Comme pour
-n'importe quelle mise à jour indépendante source, les recommandations de la
-section <ref id="nmu-guidelines"> doivent être respectées.
-
-<p>
-Les mises à jour indépendantes sont aussi acceptable pour la distribution
-instable mais seulement en dernier ressort
-ou avec une autorisation. Essayez d'abord ce qui suit et si cela ne fonctionne
-pas il est probablement correct de faire une mise à jour indépendante
-<em>(NMU)</em> :
-
-<p>
- <list compact>
- <item>
- Vérifiez que le bogue est bien référencé dans le système de suivi des
- bogues. S'il n'y est pas, faites un rapport de bogue.
-
- <item>
- Envoyez un courrier au responsable du paquet et proposez votre aide
- pour corriger le bogue. Donnez-lui quelques jours.
-
- <item>
- Lancez-vous. Corrigez le bogue et envoyez votre <em>patch</em> au système de
- suivi des bogues. Construisez le paquet et testez-le comme décrit dans
- la section <ref id="upload-checking">. Utilisez le paquet chez vous.
-
- <item>
- Attendez une réponse pendant quelques semaines.
-
- <item>
- Envoyez un courrier au responsable lui demandant son accord pour faire
- une mise à jour indépendante <em>(NMU)</em>.
-
- <item>
- Vérifiez une nouvelle fois que votre modification n'a pas d'effet de
- bord inattendu et qu'elle est aussi minimaliste et peu intrusive que
- possible.
-
- <item>
- Attendez une réponse une semaine encore.
-
- <item>
- Faites votre mise à jour indépendante comme décrit dans la section
- <ref id="nmu-guidelines">.
-
- </list>
-
-
-
-
-
-
- <sect id="nmu-guidelines">Comment faire une mise à jour indépendante
- source ?
-
-<p>
-Les règles qui suivent s'appliquent aux porteurs tant qu'ils jouent le double
-rôle de correcteur de bogue et de porteur. Si un porteur doit modifier le
-paquet source, cette mise à jour est automatiquement une mise à jour
-indépendante source et est soumise aux règles qui suivent. Si un porteur
-construit un paquet binaire recompilé, les règles sont différentes (voir <ref
-id="porter-guidelines">.
-
-<p>
-Tout d'abord il est capital que ces mises à jour indépendantes soient aussi peu
-intrusives que possible. Ne faites pas de ménage, ne modifiez pas le nom des
-modules ou des fichiers, ne déplacez pas les répertoires ; plus généralement ne
-corrigez pas ce qui n'est pas cassé. Faites un <em>patch</em> aussi petit que
-possible. Si certaines choses froissent votre sens de l'esthétique, parlez-en
-au responsable du paquet, au responsable amont ou soumettez un rapport de
-bogue. Quoiqu'il en soit, les changements esthétiques <em>ne doivent pas</em>
-être faits lors d'une mise à jour indépendante.
-
-
-
-
-
- <sect1 id="nmu-version">Numéro de version pour les mises à jour
- indépendantes sources
-
-<p>
-Chaque fois que vous modifiez un paquet, le numéro de version de ce paquet doit
-changer, même pour la plus triviale des modifications. Notre système de
-gestion de paquets s'appuie sur ces numéros de version.
-
-<p>
-Si vous faites une mise à jour indépendante <em>(NMU)</em>, vous devez ajouter
-un numéro de version mineur à la partie <var>debian-revision</var> du numéro
-de version (la partie qui suit le dernier trait d'union). Ce numéro
-supplémentaire débutera à « 1 ». Prenons pour exemple le paquet
-« foo » qui porte le numéro de version 1.1-3. Dans l'archive, le
-fichier de contrôle du paquet source serait <file>foo_1.1-3.dsc</file>. La
-version amont est « 1.1 » et la révision Debian est « 3 ».
-La mise à jour indépendante suivante ajouterait le numéro de version mineur
-« .1 » au numéro de révision Debian; le nouveau fichier de contrôle
-du paquet source serait alors <file>foo_1.1-3.1.dsc</file>.
-
-<p>
-Le numéro de révision mineur est nécessaire pour éviter de prendre un numéro
-de version au responsable officiel du paquet, ce qui pourrait perturber son
-travail. Cela a aussi l'avantage de montrer clairement que le paquet n'a pas
-été livré par le responsable officiel.
-
-<p>
-S'il n'y a pas de partie <var>debian-revision</var> dans le numéro de version
-du paquet, il faut en créer une en démarrant à « 0.1 ». S'il est
-absolument nécessaire qu'une personne qui n'est pas responsable d'un paquet
-fasse une livraison basée sur une nouvelle version amont, cette personne
-doit choisir « 0.1 » comme numéro de révision Debian. Le mainteneur
-du paquet doit, lui, démarrer sa numérotation à « 1 ». Notez que pour
-faire cela vous devrez utiliser <prgn>dpkg-buildpackage</prgn> avec l'option
-<tt>-sa</tt> pour le forcer à utiliser le nouveau paquet source (par défaut il
-reconnaît les numéros de révisions « 0 » ou « 1 » -- il
-n'est pas suffisamment intelligent pour reconnaître « 0.1 »).
-
-<p>
-Attention, les porteurs qui ne font que recompiler les paquets pour d'autres
-architectures n'ont pas besoin de renuméroter les paquets. Les porteurs ne
-doivent utiliser de nouveaux numéros de version que s'ils modifient les
-paquets sources qu'ils recompilent, c'est-à-dire s'ils font une mise à jour
-indépendante source et non une mise à jour indépendante binaire.
-
-
-
-
-
- <sect1 id="nmu-changelog">
- <heading>Les mises à jour indépendantes sources doivent être
- mentionnées dans le fichier changelog</heading>
-
-<p>
-Une personne qui fait une mise à jour indépendante source doit ajouter une
-entrée dans le fichier <file>changelog</file> qui indique les bogues corrigés
-et qui précise pourquoi cette mise à jour était nécessaire. Cette entrée
-comportera l'adresse de la personne ayant fait la mise à jour ainsi que la
-version livrée.
-
-<p>
-Par convention, dans le cas d'une mise à jour indépendante source
-<em>(NMU)</em>, l'entrée du fichier changelog débute par la ligne
-
-<example>
- * Non-maintainer upload
-</example>
-
-
-
-
-
- <sect1 id="nmu-patch">Mise à jour indépendante source et système
- de suivi des bogues
-
-<p>
-Un développeur qui n'est pas responsable d'un paquet doit faire aussi peu de
-modifications que possible et doit toujours envoyer ses modifications au
-système de suivi des bogues au format diff unifié (<tt>diff -u</tt>).
-
-<p>
-En cas de simple recompilation du paquet, le processus diffère
-suivant que vous agissez en tant que porteur ou pas. Si vous faites une mise
-à jour indépendante qui ne nécessite rien de plus qu'une recompilation et
-n'agissez pas en temps que porteur (i.e. une nouvelle bibliothèque partagée
-est disponible, un bogue a été corrigé dans <package>debhelper</package>),
-vous devez tout de même ajouter une entrée dans le fichier <em>changelog</em>;
-il y aura donc une modification. Si vous êtes porteur, vous êtes probablement
-en train de faire une mise à jour indépendante binaire. (Note : ce système ne
-tient pas compte des porteurs qui font des recompilations -- tenez cela pour
-une faiblesse de notre système de gestion des paquets.)
-
-<p>
-Si la mise à jour indépendante source corrige des bogues, vous devez le
-<em>notifier</em> au système de suivi des bogues mais vous ne devez pas
-<em>clore</em> les rapports de bogue. Seul le responsable officiel d'un paquet
-et le rapporteur du bogue sont autorisés à fermer un rapport de bogue.
-Cependant, la personne qui fait une mise à jour indépendante doit envoyer une
-note à chaque bogue concerné expliquant qu'il est corrigé par cette mise à
-jour indépendante. Cette personne doit ensuite utiliser l'adresse
-<email>control@bugs.debian.org</email> pour modifier la sévérité des bogues
-corrigés et leur donner la valeur <em>corrigé</em> (i.e. <em>fixed</em>).
-Cela permet de s'assurer que chacun sait que le bogue est corrigé par une mise
-à jour indépendante tout en laissant le rapport de bogue ouvert jusqu'à ce que
-le responsable du paquet incorpore les modifications de cette mise à jour dans
-la version officielle du paquet. Si nécessaire, ouvrez des rapports de bogue
-avec les <em>patch</em> correspondants ou assurez-vous que l'un des rapports de
-bogue déjà ouverts comporte ces <em>patch</em>.
-
-<p>
-Le responsable officiel pourra choisir d'appliquer le <em>patch</em>, il pourra aussi
-employer une autre méthode pour régler le problème. Certains bogues sont
-corrigés dans la version amont, ce qui est une bonne raison pour annuler les
-modifications d'une mise à jour indépendante. Si le responsable choisit de
-mettre à jour le paquet sans utiliser les <em>patch</em> de la mise à jour
-indépendante, il devra s'assurer que cette nouvelle version corrige
-effectivement chacun des bogues corrigés dans la mise à jour indépendante.
-
-<p>
-De plus, le responsable officiel devrait <em>toujours</em> conserver les
-entrées documentant une mise à jour indépendante dans le fichier
-<file>changelog</file>.
-
-
-
-
-
-
- <sect1 id="nmu-build">Fabriquer une mise à jour indépendante source
-
-<p>
-Les paquets faisant l'objet d'une mise à jour indépendante source sont
-construits comme les
-autres. Sélectionnez une distribution en utilisant les règles décrites dans
-la section <ref id="upload-dist"> et construisez un fichier <tt>.changes</tt>
-classique avec tout ce qui l'accompagne conformément à la description <ref
-id="upload">.
-
-<p>
-En fait, toutes les prescriptions de la section <ref id="upload"> sont
-applicables ici, y compris l'obligation d'annoncer la mise à jour sur la liste
-idoine.
-
-<p>
-Vérifiez que vous n'avez pas modifié la valeur du champ <tt>maintainer</tt>
-dans le fichier <file>debian/control</file>. Votre nom, mentionné dans
-l'entrée du fichier <file>debian/changelog</file> concernant la mise à jour,
-sera utilisé pour signer le fichier <tt>.changes</tt>.
-
-
-
-
- <chapt id="porting">Le portage
-
-<p>
-Debian supporte un nombre croissant d'architectures. Même si vous n'êtes pas
-un porteur et même si vous n'utilisez qu'une architecture, il est de votre
-responsabilité de développeur d'être attentif aux questions de portabilité.
-C'est pourquoi il est important que vous lisiez ce chapitre même si vous
-n'êtes pas un porteur.
-
-<p>
-Porter un paquet consiste à faire un paquet binaire pour une architecture
-différente de celle du paquet binaire fait par le responsable du paquet.
-C'est une
-activité remarquable et essentielle. En fait, les porteurs sont à l'origine
-de la plupart des compilations de paquet Debian. Pour un paquet binaire
-<em>i386</em>, par exemple, il faut compter une recompilation pour chaque
-autre architecture, soit un total de cinq recompilations.
-
-
-
-
- <sect id="kind-to-porters">Être gentil avec les porteurs
-
-<p>
-Les porteurs ont une tâche remarquable et difficile car ils doivent gérer un
-grand nombre de paquets. Idéalement, tout paquet source devrait compiler sans
-modification. Malheureusement, c'est rarement le cas. Cette section contient
-une liste d'erreurs commises régulièrement par les responsables Debian --
-problèmes courants qui bloquent souvent les porteurs et compliquent
-inutilement leur travail.
-
-<p>
-Ici, le mot d'ordre est de répondre rapidement aux rapports de bogues et
-remarques soulevées par les porteurs. Traitez-les courtoisement, comme s'ils
-étaient co-responsables de vos paquets (ce qu'ils sont d'une certaine
-manière).
-
-<p>
-Les problèmes les plus couramment rencontrés par les porteurs sont causés par
-des erreurs de mise en paquet dans le paquet source. Voici une
-<em>checklist</em> de choses auxquelles vous devez être attentif :
-
- <enumlist>
- <item>
- Ne choisissez pas d'autre valeur que <em>all</em> ou <em>any</em> pour
- le champ architecture sans avoir de bonnes raisons pour le faire. Trop
- souvent, les développeurs ne respectent pas les instructions du
- <url id="&url-debian-policy;" name="Debian Policy Manual">. Choisir
- la valeur « i386 » est la plupart du temps incorrect.
-
- <item>
- Vérifiez que votre paquet source est bon. Faites <tt>dpkg-source -x
- <var>package</var>.dsc</tt> pour vous assurer que le paquet se
- désarchive correctement. En utilisant le résultat de ce test,
- construisez votre paquet binaire à l'aide de la commande
- <tt>dpkg-buildpackage</tt>.
-
- <item>
- Vérifiez que les fichiers <file>debian/files</file> et
- <file>debian/substvars</file> ne sont pas dans votre paquet source.
- Ils doivent être effacés par la cible <em>clean</em> de
- <file>debian/rules</file>.
-
- <item>
- Assurez-vous que vous ne vous appuyez pas sur des éléments de
- configuration ou des logiciels installés ou modifiés localement. Par
- exemple, vous ne devriez jamais appeler des programmes du répertoire
- <file>/usr/local/bin</file> ou de répertoires équivalents. Essayez de ne pas vous
- appuyer sur des logiciels configurés de manière spéciale. Essayez de
- construire votre paquet sur une autre machine, même s'il s'agit de la
- même architecture.
-
- <item>
- Ne vous appuyez pas sur une installation préexistante de votre paquet
- (un sous-cas de la remarque précédente).
-
- <item>
- Ne supposez pas qu'<prgn>egcc</prgn> est disponible, ni que vous
- utilisez une version précise de <prgn>gcc</prgn>.
-
- <item>
- Vérifiez que votre <file>debian/rules</file> distingue les cibles
- <em>binary-arch</em> et <em>binary-indep</em> comme l'exige le
- <em>Debian packaging manual</em>. Vérifiez que ces cibles sont
- indépendantes l'une de l'autre, c'est à dire qu'il n'est pas
- nécessaire d'invoquer l'une de ces cibles avant d'invoquer l'autre.
- Pour vérifier cela, essayez d'exécuter <tt>dpkg-buildpackage -b</tt>.
-
- </enumlist>
-
-
-
-
- <sect id="porter-guidelines">Instructions pour les mises à jour des
- porteurs
-
-<p>
-Si le paquet se construit tel quel sur l'architecture que vous visez, vous avez
-de la chance et votre travail est facile. Cette section s'applique dans ce
-cas ; elle décrit comment construire et installer correctement votre mise à
-jour indépendante binaire dans l'archive Debian. Si vous devez modifier le
-paquet pour le rendre compilable sur votre architecture cible vous devez faire
-une mise à jour des sources, consultez la section <ref id="nmu-guidelines">.
-
-<p>
-Pour une mise à jour indépendante binaire, ne faites pas de changement
-dans les sources. Vous n'avez pas besoin de modifier les fichiers du paquet
-source (cela inclut <file>debian/changelog</file>).
-
-<p>
-Parfois il est nécessaire de recompiler des paquets quand d'autres paquets,
-tels que les bibliothèques, ont été mis à jour. Dans ce cas, vous devez
-changer le numéro de version pour que le système de gestion des paquets
-fonctionne correctement. Ce type de mise à jour reste une mise à jour
-indépendante binaire -- il n'est pas nécessaire de faire une recompilation sur
-toutes les architectures. Vous devez utiliser la même règle de numérotation
-que pour une mise à jour indépendante mais en ajoutant « .0. »
-devant le numéro de révision Debian. Par exemple une recompilation du paquet
-source « foo_1.3-1 » portera le numéro de version
-<tt>foo_1.3-1.0.1</tt>.
-
-<p>
-La manière d'invoquer <prgn>dpkg-buildpackage</prgn> est la suivante :
-<tt>dpkg-buildpackage -B -e<var>adresse-porteur</var></tt>. Bien sûr,
-remplacez <var>adresse-porteur</var> par votre adresse électronique. Cette
-commande construira les portions du paquet qui dépendent de l'architecture, en
-utilisant la cible <em>binary-arch</em> de <file>debian/rules</file>.
-
-
-
-
-
-
- <sect1 id="source-nmu-when-porter"> <heading>Quand faire une mise à
- jour indépendante source pour un portage ?</heading>
-
-<p>
-Les porteurs qui font des mises à jour indépendantes sources suivent
-généralement les instructions de la section <ref id="nmu"> tout comme les
-non-porteurs. Les délais d'attente sont cependant plus courts car les porteurs
-doivent manipuler un grand nombre de paquets.
-
-<p>
-À nouveau, la situation diffère selon la distribution visée. Une correction
-cruciale (i.e. rendre un paquet compilable sur une architecture supportée par
-la prochaine distribution) peut être installée <em>sans</em> délai pour la
-distribution gelée.
-
-<p>
-Si vous êtes porteur et faites une mise à jour pour <em>unstable</em>, les
-instructions précédentes sont applicables à deux différences près. Tout
-d'abord, le temps d'attente raisonnable -- délai entre le moment où vous
-envoyez un rapport au système de suivi des bogues et le moment où vous pouvez
-faire une mise à jour indépendante <em>(NMU)</em> -- est de sept jours. Ce
-délai peut être raccourci si le problème est crucial et met l'effort de
-portage en difficulté : c'est à la discrétion de l'équipe de portage.
-(Souvenez-vous, il ne s'agit pas d'un règlement mais de recommandations
-communément acceptées).
-
-<p>
-Deuxième différence, les porteurs qui font des mises à jour indépendantes
-sources doivent choisir une sévérité <em>sérieuse</em> (i.e.
-<em>serious</em>) ou supérieure quand ils envoient leur rapport au système de
-suivi des bogues. Ceci assure qu'un paquet source unique permet de produire un
-paquet binaire pour chaque architecture supportée au moment de la sortie de la
-distribution. Il est très important d'avoir un paquet source et un paquet
-binaire pour toutes les architectures pour être conforme à plusieurs licences.
-
-<p>
-Les porteurs doivent éviter d'implémenter des contournements pour
-des bogues de l'environnement de compilation, du noyau ou de la libc. Quelques
-fois ces contournements sont inévitables. Si vous devez faire quelque chose de
-ce genre, marquez proprement vos
-modifications avec des <tt>#ifdef</tt> et documentez votre contournement pour
-que l'on sache le retirer une fois que le problème aura disparu.
-
-<p>
-Les porteurs peuvent aussi avoir une adresse où ils publient le résultat de
-leur travail pendant le délai d'attente. Ainsi d'autres personnes peuvent
-bénéficier du travail du porteur même pendant ce délai. Bien sûr ces adresses
-n'ont rien d'officiel alors soyez sur vos gardes si vous les utilisez.
-
-
-
-
- <sect>Outils pour les porteurs
-
-<p>
-Il y a plusieurs outils pour le travail de portage. Cette section contient
-une courte description de ces outils ; reportez-vous à la documentation de
-leurs paquets ou aux références citées ci-après pour une description complète.
-
-
-
-
- <sect1 id="quinn-diff">
- <heading><package>quinn-diff</package>
-
-<p>
-<package>quinn-diff</package> est utilisé pour localiser les différences d'une
-architecture à l'autre. Il pourrait vous dire, par exemple, quels paquets de
-l'architecture <var>X</var> doivent être portés sur l'architecture <var>Y</var>.
-
-
-
-
-
- <sect1 id="buildd">
- <heading><package>buildd</package>
-
-<p>
-Le système <package>buildd</package> est un système distribué pour la
-compilation d'une distribution. Il est habituellement utilisé en conjonction
-avec des automates de compilation ; ce sont des machines « esclaves »
-qui récupèrent des paquets sources et tentent de les compiler. Il est aussi
-possible d'interagir par courrier électronique avec ce système. Cette
-interface est utilisée par les porteurs pour récupérer un paquet source (en
-général un paquet qui ne peut être compilé automatiquement) et travailler
-dessus.
-
-<p>
-<package>buildd</package> n'est pas disponible sous forme de paquet ;
-pourtant, la plupart des équipes de porteurs l'utilisent aujourd'hui ou ont prévu
-de l'utiliser bientôt. Il regroupe un ensemble de composants très utiles,
-continuellement utilisés mais non encore mis en paquet, tels que
-<prgn>andrea</prgn>, <prgn>sbuild</prgn> et <prgn>wanna-build</prgn>.
-
-<p>
-Une partie des informations produites par <package>buildd</package> -- utiles
-pour les porteurs -- est disponible sur la toile à l'adresse <url
-id="&url-buildd;">. Ces informations incluent les résultats produits toutes
-les nuits par <prgn>andrea</prgn> (dépendances des sources) et
-<prgn>quinn-diff</prgn> (paquets à recompiler). <p> Nous sommes très
-enthousiasmés par ce système car il a de nombreux usages potentiels. Des
-groupes de développeurs indépendants peuvent utiliser ce système pour créer
-différentes saveurs de la Debian -- qui peuvent être ou ne pas être
-intéressantes pour tous (une version de Debian compilée avec des vérifications
-relatives à <prgn>gcc</prgn>). Ce système nous permettra aussi de recompiler
-rapidement toute une distribution.
-
-
-
-
- <sect1 id="dpkg-cross">
- <heading><package>dpkg-cross</package>
-
-<p>
-<package>dpkg-cross</package> est un outil qui installe les bibliothèques et
-les entêtes nécessaires à une compilation croisée<footnote><em>cross-compilation</em>
-</footnote> d'une manière similaire à <package>dpkg</package>. De plus
-<prgn>dpkg-buildpackage</prgn> et <prgn>dpkg-shlibdeps</prgn> ont été
-améliorés pour supporter les compilations croisées.
-
-
-
-
-
- <chapt id="archive-manip">
- <heading>Déplacer, effacer, renommer, adopter et abandonner des
- paquets</heading>
-
-<p>
-Certaines manipulations de l'archive ne sont pas accessibles avec le processus
-de mise à jour automatisé. Elles sont appliquées manuellement par les
-développeurs. Ce chapitre décrit ce qu'il faut faire dans ces situations.
-
-
-
-
- <sect>Déplacer des paquets
-
-<p>
-Parfois un paquet pourra changer de section. Une nouvelle version d'un paquet
-de la section <tt>non-free</tt> pourrait par exemple être distribuée sous
-licence LGP GNU ; dans ce cas le paquet doit être déplacé dans la section
-<tt>main</tt> ou <tt>contrib</tt><footnote> Reportez-vous au <url
-id="&url-debian-policy;" name="Debian Policy Manual"> pour savoir dans quelle
-section un paquet doit être classé.</footnote>.
-
-<p>
-Si vous avez besoin de modifier la section de l'un de vos paquets, modifiez
-les informations de contrôle du paquet pour le placer dans la section désirée
-et téléchargez à nouveau votre paquet dans l'archive. Reportez-vous au
-<url id="&url-debian-policy;" name="Debian Policy Manual"> pour en savoir
-plus. Lisez attentivement le rapport d'installation qui vous sera envoyé lors
-de l'archivage de votre paquet. Si pour une raison ou une autre le paquet
-est toujours à son ancien emplacement, envoyez un rapport de bogue sur le
-pseudo-paquet <tt>ftp.debian.org</tt> demandant la suppression dudit paquet.
-Décrivez précisément vos manipulations car il pourrait s'agir d'un bogue dans
-le logiciel de gestion de l'archive.
-
-<p>
-Si vous avez besoin de modifier la sous-section de l'un de vos paquets
-(<tt>devel</tt> ou <tt>admin</tt> par exemple) la procédure est légèrement
-différente. Modifiez la sous-section dans le fichier de contrôle de votre
-paquet et téléchargez-le. Il vous faudra ensuite demander la modification du
-fichier <em>override</em> comme décrit dans la section <ref
-id="override-file">.
-
-
-
-
- <sect id="removing-pkgs">Supprimer des paquets
+Le programme <prgn>dupload</prgn> est capable de télécharger sur
+ <tt>erlangen</tt> ; consultez la documentation de ce programme pour en
+ savoir plus.
+ <sect1>Les autres serveurs
<p>
-Si pour une raison ou une autre vous avez besoin de supprimer un paquet
-de l'archive (disons qu'il s'agit d'une vieille bibliothèque devenue inutile,
-que l'on conservait pour des raisons de compatibilité), il vous faudra
-envoyer un rapport de bogue concernant le pseudo-paquet
-<tt>ftp.debian.org</tt> et demandant sa suppression. N'oubliez pas de
-préciser de quelle distribution le paquet doit être supprimé.
-
+Un autre serveur est disponible aux États-Unis ; c'est un bon point de
+ repli quand il est difficile de joindre <tt>ftp-master</tt>. Livrez vos
+ paquets à l'adresse <url id="&url-upload-samosa;"> comme vous le feriez sur
+ <tt>erlangen</tt>.
<p>
-Si vous ne savez pas bien si un paquet peut être supprimé, demandez l'avis des
-autres développeurs sur la liste &email-debian-devel;. Le programme
-<prgn>apt-cache</prgn> du paquet <package>apt</package> pourra aussi vous être
-utile. La commande <tt>apt-cache showpkg <var>package</var> </tt> vous
-indiquera, entre autres, les paquets qui dépendent de <var>package </var>.
+Il existe aussi un serveur au Japon : téléchargez vos paquet par FTP
+ anonyme sur <url id="&url-upload-jp;">.
- <sect1>Supprimer des paquets dans <tt>Incoming</tt>
+ <sect1 id="upload-notification">
+ <heading>Notification de l'installation d'un nouveau paquet</heading>
<p>
-Si vous décidez de supprimer un paquet de la section <tt>Incoming</tt>, il
-serait gentil de l'annoncer sur la liste de diffusion appropriée
-(&email-debian-changes; ou &email-debian-devel-changes;). Ce n'est pas
-obligatoire.
-
-
-
- <sect>Remplacer ou renommer un paquet
-
+Les administrateurs de l'archive Debian sont responsables de l'installation des
+ mises à jour. La plupart des mises à jour sont gérées quotidiennement par le
+ logiciel de gestion de l'archive <prgn>katie</prgn>. Les mises à jour de
+ paquets sur la distribution <em>unstable</em> sont installées
+ ainsi. Dans les autres cas et notamment dans le cas d'un nouveau paquet,
+ celui-ci sera installé manuellement. Il peut s'écouler jusqu'à un mois entre le
+ téléchargement d'un paquet vers un serveur et son installation effective. Soyez
+ patient.
<p>
-Il peut vous arriver de vous tromper en nommant un paquet et avoir besoin de le
-renommer. Dans ce cas, vous devrez intervenir en deux étapes. D'abord,
-modifiez votre fichier <file>debian/control</file> pour que votre paquet
-renommé remplace et entre en conflit avec le nom de paquet que vous voulez
-remplacer. Reportez-vous au <url id="&url-debian-policy;" name="Debian Policy
-Manual"> pour les détails. Une fois que votre paquet est installé dans
-l'archive, faites un rapport de bogue concernant le pseudo-paquet
-<tt>ftp.debian.org</tt> et demandant la suppression du paquet mal nommé.
-l'archive, faites un rapport de bogue concernant le pseudo-paquet
-<tt>ftp.debian.org</tt> et demandant la suppression du paquet mal nommé.
-
-
-
-
+Dans tous les cas, vous recevrez un accusé de réception par courrier
+ électronique indiquant que votre paquet a été installé et quels rapports de
+ bogues ont été clos. Lisez attentivement ce courrier et vérifiez que tous les
+ rapports de bogue que vous vouliez clore sont bien dans cette liste.
+<p>
+L'accusé de réception indique aussi la section dans laquelle le paquet a été
+ installé. S'il ne s'agit pas de votre choix, vous recevrez un second courrier
+ qui vous informera de cette différence (voir ci-dessous).
- <sect id="orphaning">Abandonner un paquet
+ <sect id="override-file">Déterminer la section et la priorité d'un paquet
<p>
-Si vous ne pouvez plus maintenir un paquet, vous devez en informer les autres
-et faire le nécessaire pour qu'il soit marqué <em>abandonné</em>(i.e.
-<em>orphaned</em>). Vous devriez aussi remplacer votre nom par <tt>Debian QA
-Group &orphan-address;</tt> dans le champ
-<tt>maintainer</tt> du paquet et faire un rapport de bogue sur le
-pseudo-paquet <tt>wnpp</tt>. Le titre de votre rapport de bogue devra être
-« <tt>O<footnote><em>Orphaned</em> : abandonné.</footnote>:
-<var>paquet</var> -- <var>courte description</var></tt> » pour indiquer
-que le paquet est orphelin. La sévérité du bogue sera <em>normale</em>.
-Si vous le jugez nécessaire, envoyez une copie à
-&email-debian-devel; en mettant cette adresse dans le champs X-Debbugs-CC: de
-l'entête du message. N'utilisez pas le champs CC: car de cette manière le
-sujet du message ne contiendrait pas le numéro du bogue.
-
+Les champs <tt>Section</tt> et <tt>Priority</tt> du fichier
+ <file>debian/control</file> n'indiquent ni où le paquet sera installé dans
+ l'archive Debian, ni sa priorité. Afin de conserver la cohérence de
+ l'archive, ce sont les administrateurs qui contrôlent ces champs. Les valeurs
+ du fichier <file>debian/control</file> sont juste des indications.
<p>
-Si le paquet est particulièrement important pour la distribution il vous
-faudra faire un rapport de bogue sur le pseudo-paquet <tt>wnpp</tt>, titrer
-« <tt>RFA<footnote><em>Request For Adoption</em> : offre
-d'adoption.</footnote>: <var>paquet</var> -- <var>courte
-description</var></tt> » et lui affecter la sévérité <em>importante</em>.
-Envoyez une copie de votre rapport de bogue à la liste debian-devel comme
-décrit précédemment.
-
+Les administrateurs de l'archive indiquent les sections et priorités des paquets
+ dans le fichier <em>override</em>. Si ce fichier <em>override</em> et le
+ fichier <file>debian/control</file> de votre paquet diffèrent, vous en serez
+ informé par courrier électronique quand votre paquet sera installé dans
+ l'archive. Vous pourrez corriger votre fichier <em>debian/control</em> avant
+ votre prochain téléchargement ou alors vous pourrez vouloir modifier le
+ fichier <em>override</em>.
+<p>
+Pour modifier la section dans laquelle un paquet est archivé, vous devez d'abord
+ vérifier que fichier <file>debian/control</file> est correct. Ensuite,
+ envoyez un courrier à &email-override; ou un rapport de bogue sur le
+ pseudo-paquet <package>ftp.debian.org</package> demandant la modification de
+ la section ou de la priorité de votre paquet. Exposez bien les raisons qui
+ vous amènent à demander ces changements.
+<p>
+Pour en savoir plus sur les <em>fichiers override</em>, reportez-vous à <manref
+name="dpkg-scanpackages" section="8"> et <url
+id="&url-bts-devel;#maintincorrect">.
+ <p>
+Notez également que le terme « section » est utilisé pour la
+ séparation des paquets selon leur licence, e.g <em>main</em>, <em>contrib</em>
+ et <em>non-free</em>. Ceci est décrit dans une autre section, <ref
+ id="archive">.
+
+
+ <sect id="bug-handling">Gérer les bogues
+<p>
+Chaque développeur doit être capable de travailler avec le <url name="système de
+suivi des bogues" id="&url-bts;"> Debian. Il faut savoir comment remplir
+des rapports de bogue correctement (voir <ref id="submit-bug">), comment les
+mettre à jour et les réordonner et comment les traiter et les fermer.
+<p>
+Les fonctionnalités du système de suivi des bogues qui intéressent les
+développeurs sont décrites dans la <url id="&url-bts-devel;" name="documentation
+du BTS pour les développeurs">. Ceci inclut la fermeture des bogues, l'envoi des
+messages de suivi, l'assignation des niveaux de gravité et des marques,
+l'indication que les bogues ont été envoyés au développeur amont et autres
+problèmes.
+<p>
+Des opérations comme réassigner des bogues à d'autres paquets, réunir des
+rapports de bogues séparés traitant du même problème ou réouvrir des bogues
+quand ils ont été prématurément fermés, sont gérées en utilisant le serveur de
+courrier de contrôle. Toutes les commandes disponibles pour ce serveur sont
+décrites dans la <url id="&url-bts-control;" name="documentation du serveur de
+contrôle du BTS">.
+
+ <sect1 id="bug-monitoring">Superviser les rapports de bogue
+<p>
+Si vous voulez être un bon responsable, consultez régulièrement la page du <url
+ id="&url-bts;" name="système de suivi des bogues">. Cette page contient tous
+ les rapports de bogue qui concernent vos paquets. Vous pouvez les vérifier avec
+ cette page : <tt>http://&bugs-host;/<var>votre_compte</var>@debian.org</tt>.
+<p>
+Les responsables interagissent avec le système de suivi des bogues en utilisant
+ l'adresse électronique <tt>&bugs-host;</tt>. Vous trouverez une documentation
+ sur les commandes disponibles à l'adresse <url id="&url-bts;"> ou, si vous avez
+ installé le paquet <package>doc-debian</package>, dans les fichiers locaux
+ &file-bts-docs;.
<p>
-Reportez-vous à la page WNPP<footnote><em>Work-needing and prospective
-packages</em> : paquets en souffrance et paquets souhaités.</footnote> <url
-id="&url-wnpp;"> pour en savoir plus.
-
+Certains trouvent utile de recevoir régulièrement une synthèse des rapports de
+ bogues ouverts. Si vous voulez recevoir une synthèse hebdomadaire relevant tous
+ les rapports de bogue ouverts pour vos paquets, vous pouvez configurer
+ <prgn>cron</prgn> comme suit :
+<example>
+# Synthèse hebdomadaire des rapports de bogue qui me concernent
+&cron-bug-report;
+</example>
+Remplacez <var>address</var> par votre adresse officielle de responsable Debian.
+
+ <sect1 id="bug-answering">Répondre à des rapports de bogue
+<p>
+Lorsque vous répondez à des rapports de bogue, assurez-vous que toutes vos
+ discussions concernant les bogues sont envoyées au
+ rapporteur du bogue et au bogue lui-même (<email>123@&bugs-host;</email>
+ par exemple). Si vous rédigez un nouveau courrier et que vous ne vous souvenez
+ plus de l'adresse du rapporteur de bogue, vous pouvez utiliser l'adresse
+ <email>123-submitter@&bugs-host;</email> pour contacter le rapporteur
+ <em>et</em> enregistrer votre courrier dans le journal du bogue (ce qui veut
+ dire que vous n'avez pas besoin d'envoyer une copie du courrier à
+ <email>123@&bugs-host;</email>).
+<p>
+Si vous recevez un bogue mentionnant « FTBFS », cela veut dire
+« Fails To Build From Source » (Erreur de construction à partir du
+source). Les porteurs emploient fréquemment cet acronyme.
+<p>
+Une fois que vous avez traité un rapport de bogue (i.e. que vous l'avez
+ corrigé), marquez-le comme <em>done</em> (fermez-le) en envoyant un message
+ d'explication à <email>123-done@&bugs-host;</email>. Si vous corrigez un
+ bogue en changeant et en envoyant une nouvelle version du paquet, vous pouvez
+ fermer le bogue automatiquement comme décrit dans <ref id="upload-bugfix">.
+<p>
+Vous ne devez <em>jamais</em> fermer un rapport de bogue en envoyant la commande
+ <tt>close</tt> à l'adresse &email-bts-control;.Si vous le faites, le rapporteur
+ n'aura aucune information sur la clôture de son rapport.
+
+ <sect1 id="bug-housekeeping">Gestion générale des bogues
+<p>
+En tant que responsable de paquet, vous trouverez fréquemment des bogues dans
+ d'autres paquets ou vous aurez des bogues sur vos paquets qui sont en fait des
+ bogues sur d'autres paquets. Les fonctions intéressantes du système de suivi
+ des bogues pour les développeurs sont décrites dans la <url
+ id="&url-bts-devel;" name="documentation du BTS pour les développeurs Debian">.
+ Les <url id="&url-bts-control;" name="instructions du serveur de contrôle du
+ BTS"> documentent les opérations techniques du BTS, telles que comment remplir,
+ réassigner, regrouper et marquer des bogues. Cette section contient des lignes
+ directrices pour gérer vos propres bogues, définies à partir de l'expérience
+ collective des développeurs Debian.
+<p>
+Remplir des rapports de bogue pour des problèmes que vous trouvez dans d'autres
+ paquet est l'une des « obligations civiques » du responsable,
+ reportez-vous à <ref id="submit-bug"> pour les détails. Cependant, gérer les
+ bogues de vos propres paquets est encore plus important.
+<p>
+Voici une liste des étapes que vous pouvez suivre pour gérer un rapport de
+ bogue :
+<enumlist>
+ <item>
+ Décider si le rapport correspond à un bogue réel ou non. Parfois, les
+ utilisateurs exécutent simplement un programme de la mauvaise façon car
+ ils n'ont pas lu la documentation. Si c'est votre diagnostic, fermez
+ simplement le bogue avec assez d'informations pour laisser l'utilisateur
+ corriger son problème (donnez des indications vers la bonne
+ documentation et ainsi de suite). Si le rapport de bogue revient
+ régulièrement, vous devriez vous demander si la documentation est assez
+ bonne ou si le programme ne devrait pas détecter une mauvaise
+ utilisation pour donner un message d'erreur informatif. Il s'agit d'un
+ problème qui peut être présenté à l'auteur amont.
+ <p>
+ Si le rapporteur de bogue n'est pas d'accord avec votre décision de
+ fermeture du bogue, il peut le ré-ouvrir jusqu'à ce que vous trouviez un
+ accord sur la façon de le gérer. Si vous n'en trouvez pas, vous pouvez
+ marquer le bogue avec <tt>wontfix</tt> pour indiquer aux personnes que
+ le bogue existe, mais ne sera pas corrigé. Si cette situation n'est pas
+ acceptable, vous (ou le rapporteur) pouvez vouloir demander une décision
+ par le comité technique en réattribuant le bogue à
+ <package>tech-ctte</package> (vous pouvez utiliser la commande
+ <tt>clone</tt> du BTS si vous désirez garder le bogue comme rapporté sur
+ votre paquet). Avant de faire cela, veuillez lire la <url
+ id="&url-tech-ctte;" name="procédure recommandée">.
+ </item>
+ <item>
+ Si le bogue est réel, mais est causé par un autre paquet,
+ réattribuez simplement le bogue à l'autre paquet. Si vous ne savez pas à
+ quel paquet il doit être réattribué, vous pouvez demander de l'aide sur
+ &email-debian-devel; ou vous pouvez le réattribuer à
+ <package>debian-policy</package> pour les laisser décider dans quel
+ paquet est située l'erreur.
+ <p>
+ Parfois, vous devez également ajuster la gravité du bogue pour qu'elle
+ corresponde à notre définition de gravité des bogues. C'est dû au
+ fait que les gens tendent à augmenter la gravité des bogues pour
+ s'assurer que leurs bogues seront corrigés rapidement. La gravité de
+ certains bogues peut même être rétrogradée en <em>wishlist</em> (souhait)
+ quand le changement demandé est seulement d'ordre cosmétique.
+ </item>
+ <item>
+ Le rapporteur de bogue peut avoir oublié de fournir certaines
+ informations. Dans ce cas, vous devez lui demander les informations
+ nécessaires. Vous pouvez utiliser la marque <tt>moreinfo</tt> (plus
+ d'information) sur le bogue. De plus, si vous ne pouvez pas reproduire le
+ bogue, vous pouvez le marquer comme <tt>unreproducible</tt> (non
+ reproductible). Une personne qui arriverait à reproduire le bogue est
+ alors invitée à fournir plus d'informations sur la façon de le
+ reproduire. Après quelques mois, si cette information n'a été envoyée
+ par personne, le bogue peut être fermé.
+ </item>
+ <item>
+ Si le bogue est lié à l'empaquetage, vous devez simplement le
+ corriger. Si vous ne pouvez pas le corriger vous-même, marquez alors le
+ bogue avec <tt>help</tt> (aide). Vous pouvez également demander de
+ l'aide sur &email-debian-devel; ou &email-debian-qa;. S'il s'agit d'un
+ problème amont, vous devez faire suivre le rapport à l'auteur amont.
+ Faire suivre un bogue n'est pas suffisant, vous devez vérifier à chaque
+ version si le bogue a été corrigé ou non. S'il a été corrigé, vous le
+ fermez simplement, sinon vous devez le rappeler à l'auteur. Si vous avez
+ les compétences nécessaires, vous pouvez préparer un correctif pour
+ corriger le bogue et l'envoyer en même temps à l'auteur. Assurez-vous
+ d'envoyer le correctif au BTS et marquez le bogue avec <tt>patch</tt>
+ (correctif).
+ </item>
+ <item>
+ Si vous avez corrigé un bogue sur votre copie locale ou si un correctif
+ a été inclus dans le référentiel CVS, vous pouvez marquer le bogue avec
+ <tt>pending</tt> (en attente) pour informer que le bogue est corrigé et
+ qu'il sera fermé lors du prochain envoi (ajoutez le <tt>closes:</tt>
+ dans le <file>changelog</file>). C'est particulièrement utile si
+ plusieurs développeurs travaillent sur le même paquet.
+ </item>
+ <item>
+ Une fois que le paquet corrigé est disponible dans la distribution
+ <em>unstable</em>, vous pouvez fermer le bogue. Ceci peut être fait
+ automatiquement, pour cela, reportez-vous à <ref id="upload-bugfix">.
+ </item>
+</enumlist>
+
+ <sect1 id="upload-bugfix">Quand les rapports de bogue sont-ils fermés par
+ une mise à jour ?
+<p>
+Au fur et à mesure que les bogues et problèmes sont corrigés dans vos paquets,
+ il est de votre responsabilité de fermer le rapport de bogue associé.
+ Cependant, vous ne devez pas le fermer avant que le paquet n'ait été accepté
+ dans l'archive Debian. C'est pourquoi, vous pouvez et vous devez clore le
+ rapport dans le système de suivi des bogues une fois que vous avez reçu l'avis
+ indiquant que votre nouveau paquet a été installé dans l'archive.
+<p>
+Cependant, il est possible d'éviter d'avoir à fermer manuellement les bogues
+ après l'envoi — indiquez simplement les bogues corrigés dans le fichier
+ <file>changelog</file> en suivant une syntaxe précise. Par exemple :
+<example>
+acme-cannon (3.1415) unstable; urgency=low
+ * Frobbed with options (closes: Bug#98339)
+ * Added safety to prevent operator dismemberment, closes: bug#98765,
+ bug#98713, #98714.
+ * Added man page. Closes: #98725.
+</example>
+Techniquement parlant, l'expression rationnelle Perl suivante décrit comment les
+lignes de <em>changelogs</em> de fermeture de bogues sont identifiées :
- <sect id="adopting">Adopter un paquet
+<example>
+ /closes:\s*(?:bug)?\#\s*\d+(?:,\s*(?:bug)?\#\s*\d+)*/ig
+</example>
+Nous préfèrons la syntaxe <tt>closes: #<var>XXX</var></tt>, car c'est l'entrée
+la plus concise et la plus facile à intégrer dans le texte du fichier
+<file>changelog</file>.
<p>
-Une liste des paquets en attente de nouveau responsable est disponible à la
-page <url id="&url-wnpp;" name="Work-Needing and Prospective Packages">. Si
-vous voulez prendre en charge un paquet de cette liste reportez-vous à la page
-susmentionnée pour connaître la procédure à suivre.
-
+Si vous entrez un numéro de bogue incorrect ou si vous oubliez un bogue dans les
+ entrées du fichier <file>changelog</file>, n'hésitez pas à annuler tout dommage
+ que l'erreur a entraîné. Pour réouvrir un bogue fermé par erreur, envoyez une
+ commande <tt>reopen <var>XXX</var></tt> à l'adresse de contrôle du système de
+ suivi des bogues, &email-bts-control;. Pour fermer tous les bogues restants qui
+ ont été corrigés par votre envoi, envoyez le fichier <file>.changes</file> à
+ <email>XXX-done@&bugs-host;</email> où <var>XXX</var> est le numéro du
+ bogue.
+<p>
+Rappelez-vous qu'il n'est pas obligatoire de fermer les bogues en utilisant le
+ <file>changelog</file> tel que décrit ci-dessus. Si vous désirez simplement
+ fermer les bogues qui n'ont rien à voir avec l'un de vos envois, faites-le
+ simplement en envoyant une explication à
+ <email>XXX-done@&bugs-host;</email>. Vous <strong>ne devez pas</strong> pas
+ fermer des bogues dans une entrée de changelog d'une version si les
+ changements dans cette version n'ont rien à voir avec le bogue.
+<p>
+Pour une information plus générale sur ce qu'il faut mettre dans les entrées de
+changelog, veuillez vous reporter aux <ref id="bpp-debian-changelog">.
+
+ <sect1 id="bug-security">Gérer les bogues de sécurité
+<p>
+À cause de leur nature sensible, les bogues liés à la sécurité doivent être
+ soigneusement traités. L'équipe de sécurité de Debian est là pour coordonner
+ cette activité, pour faire le suivi des problèmes de sécurité en cours, pour
+ aider les responsables ayant des problèmes de sécurité ou pour les corriger
+ elle-même, pour envoyer les annonces de sécurité et pour maintenir le site
+ security.debian.org.
+<p>
+Si vous prenez connaissance d'un bogue lié à un problème de sécurité sur un
+ paquet Debian, que vous soyez ou non le responsable, regroupez les
+ informations pertinentes sur le problème et contactez rapidement l'équipe de
+ sécurité à &email-security-team; dès que possible. Les informations utiles incluent, par
+ exemple :
+
+ <list compact>
+ <item>
+ les versions du paquet connues pour être affectées par le bogue. Vérifiez
+ chaque version présente dans les distributions maintenues par Debian ainsi
+ que dans <em>testing</em> et dans <em>unstable</em>,
+ </item>
+ <item>
+ la nature d'une solution si elle est disponible (les correctifs sont
+ particulièrement utiles),
+ </item>
+ <item>
+ tout paquet corrigé que vous avez vous-même préparé (envoyez seulement les
+ fichiers <file>.diff.gz</file> et <file>.dsc</file> et lisez d'abord <ref
+ id="bug-security-building">),
+ </item>
+ <item>
+ toute assistance que vous pouvez fournir pour aider les tests (exploits,
+ tests de régression, etc.),
+ </item>
+ <item>
+ toute information nécessaire pour l'annonce de sécurité (voir <ref
+ id="bug-security-advisories">).
+ </item>
+ </list>
+
+ <sect2 id="bug-security-confidentiality">Confidentialité
+<p>
+À la différence de la plupart des autres activités au sein de Debian, les
+ informations sur les problèmes de sécurité doivent parfois être gardées en
+ privé pour un certain temps. Ceci permet les distributeurs de logiciels de
+ coordonner leur dévoilement afin de minimiser l'exposition de leurs
+ utilisateurs. Cette décision dépend de la nature du problème
+ et de l'existence d'une solution correspondante et également s'il s'agit d'un
+ fait connu publiquement.
+<p>
+Il existe plusieurs façons pour un développeur de prendre connaissance d'un
+problème de sécurité :
+
+<list compact>
+ <item>
+ il le remarque sur un forum public (liste de diffusion, site web, etc.),
+ </item>
+ <item>
+ quelqu'un remplit un rapport de bogue,
+ </item>
+ <item>
+ quelqu'un l'informe par courrier privé.
+ </item>
+</list>
+
+Dans les deux premiers cas, l'information est publique et il est important
+d'avoir une solution le plus vite possible. Dans le dernier cas, cependant, ce
+n'est peut-être pas une information publique. Dans ce cas, il existe quelques
+options possibles pour traiter le problème :
+
+<list>
+<item>
+ si l'exposition de sécurité est mineure, il n'y a parfois pas besoin de
+ garder le secret sur le problème et une correction devrait être effectuée
+ et diffusée,
+</item>
+<item>
+ si le problème est grave, il est préférable de partager cette
+ information avec d'autres vendeurs et de coordonner une diffusion.
+ L'équipe de sécurité garde des contacts avec les différentes organisations
+ et individus et peut prendre soin des actions à mener.
+</item>
+</list>
+
+<p>
+Dans tous les cas, si la personne qui indique le problème demande à ce que
+l'information ne soit pas diffusée, cela devrait être respecté avec l'évidente exception
+d'informer l'équipe de sécurité pour qu'une correction puisse être effectuée
+pour la version stable de Debian. Quand vous envoyez des informations
+confidentielles à l'équipe de sécurité, assurez-vous de bien mentionner ce fait.
+
+<p>Veuillez noter que si le secret est nécessaire, vous ne pourrez pas envoyer
+un correctif vers <em>unstable</em> (ou ailleurs) puisque les informations de
+changelog et de diff sont publiques pour <em>unstable</em>.
+
+<p>Il existe deux raisons pour diffuser l'information même si le secret est
+demandé : le problème est connu depuis un certain temps ou le problème ou
+son exploitation est devenu public.
+
+ <sect2 id="bug-security-advisories">Annonces de sécurité
+<p>
+Les annonces de sécurité ne sont émises que pour la distribution actuelle
+ diffusée <em>stable</em>, <em>PAS</em> pour <em>testing</em> ou <em>unstable</em>.
+ Quand elle est diffusée, l'annonce est envoyée à la liste de diffusion
+ &email-debian-security-announce; et elle est postée sur <url
+ id="&url-debian-security-advisories;" name="la page de sécurité">. Les
+ annonces de sécurité sont écrites et postées par les membres de l'équipe de sécurité.
+ Cependant, ils ne verront aucun inconvénient à ce qu'un responsable leur
+ apporte des informations ou écrive une partie du texte. Les informations qui
+ devraient être présentes dans une annonce incluent :
+<list compact>
+<item>
+ une description du problème et de sa portée, y compris :
+ <list>
+ <item>
+ le type du problème (usurpation de privilège, déni de service,
+ etc.),
+ </item>
+ <item>
+ quels sont les privilèges obtenus et par quels utilisateurs (si c'est le
+ cas)
+ </item>
+ <item>
+ comment il peut être exploité,
+ </item>
+ <item>
+ si le problème peut être exploité à distance ou localement,
+ </item>
+ <item>
+ comment le problème a été corrigé,
+ </item>
+ </list>
+ Ces informations permettent aux utilisateurs d'estimer la menace pesant
+ sur leurs systèmes.
+
+</item>
+<item>
+ les numéros de version des paquets affectés,
+</item>
+<item>
+ les numéros de version des paquets corrigés,
+</item>
+<item>
+ une information sur la façon de récupérer les paquets mis à jour
+ (habituellement l'archive de sécurité Debian),
+</item>
+<item>
+ des références à des annonces amont, des identifiants <url
+ id="http://cve.mitre.org" name="CVE"> et toute autre information utile
+ pour recouper les références de la vulnérabilité.
+</item>
+</list>
+
+ <sect2 id="bug-security-building">
+ <heading>Préparer les paquets pour corriger des problèmes de sécurité
+<p>
+Une façon d'aider l'équipe de sécurité dans ses travaux est de leur fournir des
+ paquets corrigés convenables pour une annonce de sécurité pour la version
+ <em>stable</em> de Debian
+<p>
+Quand une mise à jour de la version <em>stable</em> est effectuée, un soin
+ particulier doit être apporté pour éviter de modifier le comportement du
+ système ou d'introduire de nouveaux bogues. Pour cela, faites le moins de
+ changements possibles pour corriger le bogue. Les utilisateurs et les
+ administrateurs s'attendent à un comportement identique dans une version
+ lorsque celle-ci est diffusée, donc tout changement qui est fait est
+ susceptible de casser le système de quelqu'un. Ceci est spécialement vrai pour
+ les bibliothèques : assurez-vous ne de jamais changer l'API ou l'ABI,
+ quelque minimal que soit le changement.
+<p>
+Cela veut dire que passer à une version amont supérieure n'est pas une bonne
+solution. À la place, les changements pertinents devraient être rétroportés
+vers la version présente dans la distribution <em>stable</em> de Debian.
+Habituellement, les développeurs amont veulent bien aider. Sinon, l'équipe de
+sécurité Debian peut le faire.
+<p>
+Dans certains cas, il n'est pas possible de rétroporter un correctif de
+sécurité, par exemple, quand de grandes quantités de code source doivent être
+modifiées ou réécrites. Si cela se produit, il peut être nécessaire de passer à
+une nouvelle version amont. Cependant, ceci n'est fait que dans des situations
+extrêmes et vous devez toujours coordonner cela avec l'équipe de sécurité au
+préalable.
+<p>
+Il existe une autre règle de conduite liée à cela : testez toujours vos
+changements. Si une exploitation du problème existe, essayez-la et
+vérifiez qu'elle réussit sur le paquet non corrigé et échoue sur le paquet
+corrigé. Testez aussi les autres actions normales car parfois un correctif de
+sécurité peut casser de manière subtile des fonctionnalités qui ne semblent pas
+liées.
+<p>
+Examinez et testez autant que possible vos changements. Vérifiez les différences
+avec la version précédente de manière répétée (<prgn>interdiff</prgn> du
+paquet <package>patchutils</package> et <prgn>debdiff</prgn> du paquet
+<package>devscripts</package> sont des outils utiles pour cela, voir <ref
+id="debdiff">).
+<p>
+Lors de la construction de la correction, gardez les points suivants à
+l'esprit :
+
+<list>
+<item>
+ Assurez-vous que vous avez pour cible la bonne distribution dans votre
+ fichier <file>debian/changelog</file>. Pour <em>stable</em>, il s'agit de
+ <tt>stable-security</tt> et pour <em>testing</em>, c'est
+ <tt>testing-security</tt> et pour l'ancienne distribution stable, c'est
+ <tt>oldstable-security</tt>. Ne ciblez pas
+ <var>distribution</var>-proposed-updates !
+</item>
+<item>
+ Fournissez des entrées de changelog descriptives et complètes. D'autres
+ personnes se baseront dessus pour déterminer si un bogue particulier a été
+ corrigé. Quand cela est possible, incluez une référence externe, de
+ préférence, un identifiant CVE, pour qu'elle puisse être recoupée.
+</item>
+<item>
+ Assurez-vous que le numéro de version est correct. Il doit être plus élevé
+ que celui du paquet actuel, mais moins que ceux des paquets des versions
+ des distributions suivantes. En cas de doute, testez-le avec <tt>dpkg
+ --compare-versions</tt>. Pour <em>testing</em>, il doit y avoir un numéro
+ de version supérieur dans <em>unstable</em>. S'il n'y en a pas encore (par
+ exemple, si <em>testing</em> et <em>unstable</em> ont la même version),
+ vous devez envoyer une nouvelle version vers <em>unstable</em> en premier.
+</item>
+<item>
+ Ne faites pas d'envoi de source seul si votre paquet possède un ou
+ plusieurs paquets binary-all (n'utilisez pas l'option <tt>-S</tt> de
+ <prgn>dpkg-buildpackage</prgn>). L'infrastructure <prgn>buildd</prgn> ne
+ construira pas ceux-ci. Ce point s'applique aux envois de paquets normaux
+ également.
+</item>
+<item>
+ Si la source amont a été envoyée auparavant à security.debian.org (par une
+ précédente mise à jour de sécurité), construisez le paquet sans la source
+ amont (<tt>dpkg-buildpackage -sd</tt>). Sinon, construisez-le avec le
+ source complet (<tt>dpkg-buildpackage -sa</tt>).
+</item>
+<item>
+ Assurez-vous d'utiliser exactement le même nom <file>*.orig.tar.gz</file>
+ que celui utilisé dans l'archive normale, sinon il ne sera pas possible de
+ déplacer plus tard le correctif de sécurité dans l'archive principale.
+</item>
+<item>
+ Assurez-vous de compiler sur un système
+ propre, dont tous les paquets appartiennent à la distribution pour laquelle vous
+ construisez le paquet. Si vous n'avez pas un tel système, vous pouvez
+ utiliser l'une des machines de debian.org (voir <ref
+ id="server-machines">) ou mettez en place un chroot (voir <ref id=
+ "pbuilder"> et <ref id="debootstrap">).
+</item>
+</list>
+
+ <sect2 id="bug-security-upload">Mettre à jour le paquet corrigé
+<p>
+Vous <em>NE</em> devez <em>PAS</em> envoyer un paquet dans la file d'attente des envois de sécurité
+(oldstable-security, stable-security, etc.)
+sans l'accord préalable de l'équipe de sécurité. Si le paquet ne remplit pas
+exactement les exigences de l'équipe, il causera beaucoup de problèmes, ainsi
+que des délais dans la gestion de l'envoi indésirable.
+<p>
+Vous <em>NE</em> devez <em>PAS</em> envoyer votre correction dans
+<em>proposed-updates</em> sans vous coordonner avec l'équipe de sécurité. Les
+paquets seront copiés de security.debian.org dans le répertoire
+<file>proposed-updates</file> automatiquement. Si un paquet avec le même numéro
+de version ou un numéro plus grand est déjà installé dans l'archive, la mise à
+jour de sécurité sera rejetée par le système d'archive. Ainsi, la distribution
+<em>stable</em> se retrouvera à la place sans la mise à jour de sécurité de ce
+paquet.
+<p>
+Une fois que vous avez créé et testé le nouveau paquet et qu'il a été approuvé
+par l'équipe de sécurité, il doit être envoyé pour être installé dans les
+archives. Pour les envois de sécurité, l'adresse d'envoi est
+<tt>ftp://security.debian.org/pub/SecurityUploadQueue/</tt>.
+
+<p>
+Une fois que l'envoi vers la file d'attente de sécurité a été accepté, le paquet sera
+automatiquement recompilé pour toutes les architectures et stocké pour
+vérification par l'équipe de sécurité.
+
+<p>
+Les envois en attente d'acceptation ou de vérification ne sont accessibles que
+par l'équipe de sécurité. C'est nécessaire car il pourrait y avoir des
+correctifs pour des problèmes de sécurité qui ne peuvent pas encore être
+diffusés.
+
+<p>
+Si une personne de l'équipe de sécurité accepte un paquet, il sera installé sur
+security.debian.org ainsi que dans le répertoire
+<var>distribution</var>-proposed-updates qui convient sur ftp-master ou dans
+l'archive non-US.
+
+ <sect id="archive-manip">
+ <heading>Déplacer, effacer, changer le nom, adopter et abandonner des paquets
+<p>
+Certaines manipulations de l'archive ne sont pas possibles avec le processus
+ de mise à jour automatisé. Elles sont appliquées manuellement par les
+ développeurs. Ce chapitre décrit ce qu'il faut faire dans ces situations.
+
+ <sect1 id="moving-pkgs">Déplacer des paquets
+<p>
+Il se peut qu'un paquet puisse changer de section. Une nouvelle version d'un paquet
+ de la section <tt>non-free</tt> pourrait, par exemple, être distribuée sous
+ licence GNU GPL ; dans ce cas, le paquet doit être déplacé dans la section
+ <tt>main</tt> ou <tt>contrib</tt><footnote><p>Reportez-vous à la <url
+ id="&url-debian-policy;" name="charte Debian"> pour savoir dans quelle section
+ un paquet doit être classé.</footnote>.
+<p>
+Si vous avez besoin de modifier la section de l'un de vos paquets, modifiez les
+ informations de contrôle du paquet pour le placer dans la section désirée et
+ téléchargez à nouveau votre paquet dans l'archive. Reportez-vous à la <url
+ id="&url-debian-policy;" name="charte Debian"> pour en savoir plus. Si votre
+ nouvelle section est valide, il sera déplacé automatiquement. Si ce n'est pas
+ le cas, contactez les responsables ftp pour comprendre ce qui s'est passé.
+<p>
+Si vous avez besoin de modifier la sous-section de l'un de vos paquets
+ (<tt>devel</tt> ou <tt>admin</tt> par exemple), la procédure est légèrement
+ différente. Modifiez la sous-section dans le fichier de contrôle de votre
+ paquet et téléchargez-le. Il vous faudra ensuite demander la modification du
+ fichier <em>override</em> comme décrit dans la section <ref
+ id="override-file">.
+
+
+ <sect1 id="removing-pkgs">Supprimer des paquets
+<p>
+Si, pour une raison ou une autre, vous avez besoin de supprimer un paquet de
+ l'archive (disons qu'il s'agit d'une vieille bibliothèque devenue inutile, que
+ l'on conservait pour des raisons de compatibilité), il vous faudra envoyer un
+ rapport de bogue concernant le pseudo-paquet <tt>ftp.debian.org</tt> et
+ demander sa suppression. N'oubliez pas de préciser de quelle distribution le
+ paquet doit être supprimé. Normalement, vous ne devriez avoir à supprimer que
+ des paquets d'<em>unstable</em> ou de <em>experimental</em>. Les paquets de
+ <em>testing</em> ne sont pas supprimés directement. Ils sont plutôt enlevés
+ automatiquement après que le paquet a été supprimé d'<em>unstable</em> et
+ si aucun paquet de <em>testing</em> n'en dépend.
+<p>
+Vous devez également détailler les raisons justifiant cette demande. Ceci a pour
+ but d'éviter les suppressions non désirées et de garder une trace de la raison
+ pour laquelle un paquet a été supprimé. Par exemple, vous pouvez fournir le nom
+ du paquet qui remplace celui à supprimer.
+<p>
+Vous ne pouvez demander la suppression d'un paquet que si vous en
+ êtes le responsable. Si vous voulez supprimer un autre paquet, vous devez
+ obtenir l'accord de son dernier responsable.
+<p>
+Si vous ne savez pas bien si un paquet peut être supprimé, demandez l'avis des
+ autres développeurs sur la liste &email-debian-devel;. Le programme
+ <prgn>apt-cache</prgn> du paquet <package>apt</package> pourra aussi vous être
+ utile. La commande <tt>apt-cache showpkg <var>paquet</var> </tt> vous
+ indiquera, entre autres, les paquets qui dépendent de <var>paquet</var>.
+<p>
+Une fois que le paquet a été supprimé, les bogues du paquet doivent être gérés.
+ Soit ils sont réattribués à un autre paquet dans le cas où le code actuel a
+ évolué en un autre paquet (par exemple, <tt>libfoo12</tt> a été supprimé parce
+ que <tt>libfoo13</tt> le remplace) ou ils sont fermés si le logiciel ne fait
+ simplement plus partie de Debian.
+
+ <sect2>Supprimer des paquets dans <tt>Incoming</tt>
+<p>
+Par le passé, il était possible de supprimer un paquet de <file>Incoming</file>.
+ Cependant, ce n'est plus possible depuis la mise en place du nouveau système
+ de file d'attente. Il vous faudra télécharger une nouvelle version de votre
+ paquet avec un numéro de version postérieur à celui que vous voulez
+ remplacer. Les deux versions seront installées dans l'archive mais seule la
+ plus récente sera accessible dans <em>unstable</em> car la précédente sera
+ immédiatement remplacée par la nouvelle. Toutefois, si vous testez
+ correctement vos paquets, le besoin d'en remplacer un ne devrait pas être
+ trop fréquent.
+
+ <sect1>Remplacer un paquet ou changer son nom
+<p>
+Il peut vous arriver de vous tromper en nommant un paquet et de vouloir
+changer son nom. Dans ce cas, vous devrez intervenir en deux étapes. D'abord, modifiez
+ votre fichier <file>debian/control</file> pour que votre nouveau paquet
+ remplace et entre en conflit avec l'ancien paquet que vous voulez remplacer
+ (reportez-vous à la <url id="&url-debian-policy;" name="charte Debian"> pour
+ les détails). Une fois que votre paquet est installé dans l'archive, faites un
+ rapport de bogue concernant le pseudo-paquet <tt>ftp.debian.org</tt> et
+ demandez la suppression du paquet mal nommé. N'oubliez pas de réattribuer
+ correctement les bogues du paquet en même temps.
+<p>
+D'autres fois, vous pouvez commettre une erreur en construisant le paquet et
+vous désirez le remplacer. La seule façon de faire est d'incrémenter le numéro de
+ version et d'envoyer une nouvelle version. L'ancienne version expirera de la
+ façon habituelle. Notez que ceci s'applique à chaque partie de votre paquet, y
+ compris les sources : si vous désirez remplacer l'archive source amont de
+ votre paquet, vous devez l'envoyer avec un numéro de version différent. Une
+ possibilité simple est de remplacer <file>foo_1.00.orig.tar.gz</file> par
+ <file>foo_1.00+0.orig.tar.gz</file>. Cette restriction donne à chaque fichier
+ du site ftp un nom unique, ce qui aide à garantir la consistance dans le réseau
+ des miroirs.
+
+ <sect1 id="orphaning">Abandonner un paquet
+<p>
+Si vous ne pouvez plus maintenir un paquet, vous devez en informer les autres et
+ faire le nécessaire pour qu'il soit marqué <em>abandonné</em> (i.e.
+ <em>orphaned</em>). Vous devriez aussi remplacer votre nom par <tt>Debian QA
+ Group &orphan-address;</tt> dans le champ <tt>maintainer</tt> du paquet et
+ faire un rapport de bogue sur le pseudo-paquet <package>wnpp</package>. Le
+ titre de votre rapport de bogue devrait être
+ « <tt>O<footnote><p><em>Orphaned</em> : abandonné.</footnote>:
+ <var>paquet</var> — <var>courte description</var></tt> » pour
+ indiquer que le paquet est abandonné. La gravité du bogue sera
+ <em>normale</em>. Si vous le jugez nécessaire, envoyez une copie à
+ &email-debian-devel; en mettant cette adresse dans le champ X-Debbugs-CC: de
+ l'en-tête du message. N'utilisez pas le champ CC: car de cette manière le sujet
+ du message ne contiendra pas le numéro du bogue.
+<p>
+Si le paquet est particulièrement important pour la distribution, il vous faudra
+ faire un rapport de bogue sur le pseudo-paquet <package>wnpp</package>,
+ l'intituler « <tt>RFA<footnote><p><em>Request For Adoption</em> :
+ offre d'adoption.</footnote>: <var>paquet</var> — <var>courte
+ description</var></tt> » et lui affecter la gravité <em>importante</em>.
+ Envoyez une copie de votre rapport de bogue à la liste debian-devel comme
+ décrit ci-dessus.
+<p>
+Reportez-vous à la page WNPP<footnote><p><em>Work-needing and prospective
+ packages</em> : paquets en souffrance et paquets souhaités.</footnote>
+ <url id="&url-wnpp;"> pour en savoir plus.
+
+ <sect1 id="adopting">Adopter un paquet
+<p>
+Une liste des paquets en attente de nouveau responsable est disponible à la page
+ <url id="&url-wnpp;" name="paquets en souffrance et paquets souhaités">. Si
+ vous voulez prendre en charge un paquet de cette liste, reportez-vous à la page
+ mentionnée ci-dessus pour connaître la procédure à suivre.
<p>
Prendre un paquet parce qu'il vous semble que celui-ci est négligé n'est pas
-correct -- ce serait une prise d'otage. Vous pouvez prendre contact avec le
-responsable actuel et lui demander si vous pouvez prendre en charge ce paquet.
-Vous ne pouvez le faire sans son accord. Qu'il vous ignore n'est pas une
-raison suffisante pour le faire. Si vous avez le sentiment qu'un responsable
-est parti sans prévenir depuis un moment, demandez-le sur la liste
-&email-debian-private;.
-
+ correct — ce serait un détournement de paquet. Vous pouvez prendre
+ contact avec le responsable actuel et lui demander si vous pouvez prendre en
+ charge ce paquet. Si vous avez le sentiment qu'un responsable est parti sans
+ prévenir depuis un moment, veuillez vous reporter à <ref id="mia-qa">).
+<p>
+Généralement, vous ne pouvez pas adopter un paquet sans l'accord du responsable
+actuel. Même s'il vous ignore, ce n'est pas une raison pour le faire. Les
+plaintes à propos des responsables devraient être portées sur la liste de
+diffusion des développeurs. Si la discussion ne se termine pas par une
+conclusion positive et que le problème est de nature technique, considérez de
+porter le cas à l'attention du comité technique (voir la <url name="page web du
+comité technique" id="&url-tech-ctte;"> pour plus d'information).
+<p>
+Si vous reprenez un vieux paquet, vous voudrez sûrement que le système de suivi
+ des bogues indique que vous êtes le responsable du paquet. Cela se produira
+ automatiquement une fois que vous aurez installé une nouvelle version du paquet
+ dans l'archive avec le champ <tt>Maintainer</tt> à jour. Cela peut prendre
+ quelques heures après le téléchargement. Si vous pensez ne pas avoir de mise à
+ jour à faire pour un moment, vous pouvez utiliser le <ref
+ id="pkg-tracking-system"> pour recevoir les rapports de bogue. Cependant,
+ assurez-vous que cela ne pose aucun problème à l'ancien responsable de
+ continuer à recevoir les bogues durant ce temps.
+
+ <sect id="porting">Le portage
+<p>
+Debian accepte un nombre croissant d'architectures. Même si vous n'êtes pas un
+ porteur et même si vous n'utilisez qu'une architecture, il est de votre
+ responsabilité de développeur d'être attentif aux questions de
+ portabilité. C'est pourquoi il est important que vous lisiez ce chapitre
+ même si vous n'êtes pas un porteur.
<p>
-Si vous reprenez un vieux paquet, vous voudrez sûrement que le système de
-suivi des bogues indique que vous êtes le responsable du paquet. Cela se
-produira automatiquement une fois que vous aurez installé une nouvelle version
-du paquet dans l'archive avec le champ <tt>Maintainer</tt> à jour. Cela peut
-prendre quelques heures après le téléchargement. Si vous pensez ne pas avoir
-de mise à jour à faire pour un moment, envoyez un courrier électronique à
-&email-override; pour pouvoir recevoir les rapports de bogue.
-
-
-
+Porter un paquet consiste à faire un paquet binaire pour une architecture
+ différente de celle du paquet binaire fait par le responsable du paquet.
+ C'est une activité remarquable et essentielle. En fait, les porteurs sont
+ à l'origine de la plupart des compilations de paquets Debian. Pour un
+ paquet binaire <em>i386</em>, par exemple, il faut compter une
+ recompilation pour chaque autre architecture, soit un total de
+ &number-of-arches; recompilations.
- <chapt id="bug-handling">Gérer les bogues
+ <sect1 id="kind-to-porters">Être gentil avec les porteurs
+<p>
+Les porteurs ont une tâche remarquable et difficile car ils doivent gérer un
+ grand nombre de paquets. Idéalement, tout paquet source devrait compiler sans
+ modification. Malheureusement, c'est rarement le cas. Cette section contient
+ une liste d'erreurs commises régulièrement par les responsables Debian —
+ problèmes courants qui bloquent souvent les porteurs et compliquent inutilement
+ leur travail.
+<p>
+Ici, le mot d'ordre est de répondre rapidement aux rapports de bogues et
+ remarques soulevées par les porteurs. Traitez-les courtoisement, comme s'ils
+ étaient co-responsables de vos paquets (ce qu'ils sont d'une certaine manière).
+ Merci pour votre indulgence envers des rapports de bogue succincts ou peu
+ clairs ; faites de votre mieux pour éliminer le problème.
+<p>
+Les problèmes les plus couramment rencontrés par les porteurs sont causés par
+ des erreurs de mise en paquet dans le paquet source. Voici un
+ pense-bête pour les choses auxquelles vous devez être attentif :
+<enumlist>
+ <item>
+ Vérifiez que les champs <tt>Build-Depends</tt> et
+ <tt>Build-Depends-Indep</tt> du fichier <file>debian/control</file> sont
+ corrects. Le meilleur moyen de le vérifier est d'utiliser le paquet
+ <package>debootstrap</package> pour créer un environnement
+ <em>unstable</em> <em>chrooté</em> (voir <ref id="debootstrap">). Dans
+ cet environnement <em>chrooté</em>, il faudra installer le paquet
+ <package>build-essential</package> et tous les paquets mentionnés dans
+ les champs <tt>Build-Depends</tt> et <tt>Build-Depends-Indep</tt>.
+ Ensuite, vous essayerez de fabriquer votre paquet dans cet
+ environnement. Ces étapes peuvent être automatisées en utilisant le
+ programme <prgn>pbuilder</prgn> qui est fourni par le paquet de même
+ nom (voir <ref id="pbuilder">).
+ <p>
+ Si vous n'arrivez pas à installer un environnement <em>chrooté</em>,
+ <prgn>dpkg-depcheck</prgn> pourra peut-être vous aider (voir <ref
+ id="dpkg-depcheck">).
+ <p>
+ Consultez la <url id="&url-debian-policy;" name="charte Debian"> pour en
+ savoir plus sur les dépendances de fabrication.
+ </item>
+ <item>
+ Ne choisissez pas d'autres valeurs que <em>all</em> ou <em>any</em> pour
+ le champ architecture sans avoir de bonnes raisons pour le faire. Trop
+ souvent, les développeurs ne respectent pas les instructions de la <url
+ id="&url-debian-policy;" name="charte Debian">. Choisir la valeur
+ « i386 » est la plupart du temps incorrect.
+ </item>
+ <item>
+ Vérifiez que votre paquet source est bon. Faites <tt>dpkg-source -x
+ <var>paquet</var>.dsc</tt> pour vous assurer que le paquet se
+ décompresse correctement. En utilisant le résultat de ce test,
+ construisez votre paquet binaire à l'aide de la commande
+ <prgn>dpkg-buildpackage</prgn>.
+ </item>
+ <item>
+ Vérifiez que les fichiers <file>debian/files</file> et
+ <file>debian/substvars</file> ne sont pas dans votre paquet source. Ils
+ doivent être effacés par la cible <em>clean</em> de
+ <file>debian/rules</file>.
+ </item>
+ <item>
+ Assurez-vous que vous ne vous appuyez pas sur des éléments de
+ configuration ou des logiciels installés ou modifiés localement. Par
+ exemple, vous ne devriez jamais appeler des programmes du répertoire
+ <file>/usr/local/bin</file> ou de répertoires équivalents. Essayez de ne
+ pas vous appuyer sur des logiciels configurés de manière spéciale.
+ Essayez de construire votre paquet sur une autre machine, même s'il
+ s'agit de la même architecture.
+ </item>
+ <item>
+ Ne vous appuyez pas sur une installation préexistante de votre paquet
+ (un sous-cas de la remarque précédente).
+ </item>
+ <item>
+ Si possible, ne vous appuyez pas sur une particularité présente dans un
+ compilateur précis ou dans une certaine version d'un compilateur. Si
+ vous ne pouvez pas faire autrement, assurez-vous que les dépendances de
+ fabrication reflètent bien cette restriction. Dans ce cas, vous cherchez
+ sûrement les problèmes car quelques architectures pourraient choisir un
+ compilateur différent.
+ </item>
+ <item>
+ Vérifiez que votre fichier <file>debian/rules</file> distingue les
+ cibles <em>binary-arch</em> et <em>binary-indep</em> comme l'exige la
+ charte Debian. Vérifiez que ces cibles sont indépendantes l'une de
+ l'autre, c'est-à-dire, qu'il n'est pas nécessaire d'invoquer l'une de
+ ces cibles avant d'invoquer l'autre. Pour vérifier cela, essayez
+ d'exécuter <tt>dpkg-buildpackage -B</tt>.
+ </item>
+</enumlist>
+
+
+ <sect1 id="porter-guidelines">Instructions pour les mises à jour des
+ porteurs
+<p>
+Si le paquet se construit tel quel sur l'architecture que vous visez, vous avez
+ de la chance et votre travail est facile. Cette section s'applique dans ce
+ cas ; elle décrit comment construire et installer correctement votre
+ paquet binaire dans l'archive Debian. Si vous devez modifier le paquet pour le
+ rendre compilable sur votre architecture cible vous devez faire une mise à jour
+ des sources, consultez la section <ref id="nmu-guidelines">.
+<p>
+Pour un envoi de portage, ne faites pas de changement dans les sources. Vous
+ n'avez pas besoin de modifier les fichiers du paquet source (cela inclut le
+ fichier <file>debian/changelog</file>).
+<p>
+La manière d'invoquer <prgn>dpkg-buildpackage</prgn> est la suivante :
+ <tt>dpkg-buildpackage -B -m<var>adresse-porteur</var></tt>. Bien sûr, remplacez
+ <var>adresse-porteur</var> par votre adresse électronique. Cette commande
+ construira les parties du paquet qui dépendent de l'architecture, en utilisant
+ la cible <em>binary-arch</em> de <file>debian/rules</file>.
+
+ <sect2 id="binary-only-nmu">
+ Mises à jour indépendantes binaires ou recompilations
+<p>
+Parfois, l'envoi du portage initial pose problème car l'environnement dans lequel
+ le paquet a été construit n'était pas bon (bibliothèques plus à jour ou
+ obsolètes, mauvais compilateur, etc.). Il se peut que vous ayez à le recompiler
+ dans un environnement mis à jour. Cependant, dans ce cas, vous devez changer
+ le numéro de version pour que les mauvais anciens paquets soient remplacés dans
+ l'archive Debian (<prgn>katie</prgn> refuse d'installer de nouveaux paquets
+ s'ils n'ont pas un numéro de version supérieur à celui actuellement
+ disponible). Malgré les modifications nécessaires du changelog, ce type de mise
+ à jour reste une mise à jour indépendante binaire — il n'est pas
+ nécessaire de reconsidérer le statut des paquets binaires des autres
+ architectures pour les marquer périmés ou à recompiler.
+<p>
+Ces recompilations nécessitent des numéros de version « magiques »
+ pour que le système de maintenance de l'archive comprennent que, bien qu'il y
+ ait une nouvelle version, il n'y a pas eu de modification des sources. Si vous
+ ne faites pas cela correctement, les administrateurs de l'archive rejetteront
+ votre mise à jour (car il n'y aura pas de code source associé).
+<p>
+Cette « magie » associée à une mise à jour par recompilation est déclenchée en
+ utilisant un troisième nombre dans la partie debian du numéro de version. Si,
+ par exemple, la dernière version du paquet que vous recompilez était
+ « 2.9-3 », votre mise à jour portera le numéro
+ « 2.9-3.0.1 ». Si cette version était « 3.4-2.1 » votre
+ mise à jour portera le numéro « 3.4-2.1.1 ».
+
+
+ <sect2 id="source-nmu-when-porter">
+ Quand faire une mise à jour indépendante source pour un portage ?
+<p>
+Les porteurs qui font des mises à jour indépendantes sources suivent
+ généralement les instructions de la section <ref id="nmu"> tout comme les
+ non-porteurs. Les délais d'attente sont cependant plus courts car les
+ porteurs doivent manipuler un grand nombre de paquets. À nouveau, la
+ situation diffère selon la distribution visée.
+<p>
+Si vous êtes porteur et faites une mise à jour pour <em>unstable</em>, les
+ instructions précédentes sont applicables à deux différences près. Tout
+ d'abord, le temps d'attente raisonnable — délai entre le moment où vous
+ envoyez un rapport au système de suivi des bogues et le moment où vous pouvez
+ faire une mise à jour indépendante <em>(NMU)</em> — est de sept jours.
+ Ce délai peut être raccourci si le problème est crucial et met l'effort de
+ portage en difficulté : c'est à la discrétion de l'équipe de portage.
+ (Souvenez-vous, il ne s'agit pas d'un règlement, mais de recommandations
+ communément acceptées).
+<p>
+Deuxième différence, les porteurs qui font des mises à jour indépendantes
+ sources doivent choisir une gravité <em>sérieuse</em> (i.e. <em>serious</em>)
+ ou supérieure quand ils envoient leur rapport au système de suivi des bogues.
+ Ceci assure qu'un paquet source unique permet de produire un paquet binaire
+ pour chaque architecture supportée au moment de la sortie de la distribution.
+ Il est très important d'avoir un paquet source et un paquet binaire pour
+ toutes les architectures pour être conforme à plusieurs licences.
+<p>
+Les porteurs doivent éviter d'implémenter des contournements pour des bogues de
+ l'environnement de compilation, du noyau ou de la libc. Quelques fois, ces
+ contournements sont inévitables. Si vous devez faire quelque chose de ce
+ genre, marquez proprement vos modifications avec des <tt>#ifdef</tt> et
+ documentez votre contournement pour que l'on sache le retirer une fois que le
+ problème aura disparu.
+<p>
+Les porteurs peuvent aussi avoir une adresse où ils publient le résultat de leur
+ travail pendant le délai d'attente. Ainsi, d'autres personnes peuvent
+ bénéficier du travail du porteur même pendant ce délai. Bien sûr, ces
+ adresses n'ont rien d'officiel, alors soyez sur vos gardes si vous les
+ utilisez.
+
+
+ <sect1 id="porter-automation">
+ <heading>Infrastructure de portage et automatisation</heading>
+ <p>
+Il existe une infrastructure et plusieurs outils pour faciliter l'automatisation
+du portage des paquets. Cette section contient un bref aperçu de cette
+automatisation et du portage de ces outils ; veuillez vous reporter à la
+documentation des paquets ou les références pour une information complète.</p>
+
+ <sect2>
+ <heading>Listes de diffusion et pages web</heading>
+ <p>
+Les pages web contenant l'état de chaque portage peuvent être trouvées à <url
+id="&url-debian-ports;">.
+ <p>
+Chaque portage de Debian possède sa propre liste de diffusion. La liste des
+listes de diffusion de portage peut être trouvée à <url
+id="&url-debian-port-lists;">. Ces listes sont utilisées pour coordonner les
+porteurs et pour mettre en relation les utilisateurs d'un portage donné avec les
+porteurs.</p>
+ </sect2>
+
+ <sect2>
+ <heading>Outils pour les porteurs</heading>
+<p>
+Les descriptions de plusieurs outils de portage peuvent être trouvées dans les
+<ref id="tools-porting">.</p>
+
+
+ <sect2 id="buildd">
+ <heading><package>buildd</package></heading>
+<p>
+Le système <package>buildd</package> est un système distribué pour la
+ compilation d'une distribution. Il est habituellement utilisé en conjonction
+ avec des automates de compilation ; ce sont des machines
+ « esclaves » qui récupèrent des paquets sources et tentent de les
+ compiler. Il est aussi possible d'interagir par courrier électronique avec ce
+ système. Cette interface est utilisée par les porteurs pour récupérer un
+ paquet source (en général, un paquet qui ne peut être compilé
+ automatiquement) et travailler dessus.
+<p>
+<package>buildd</package> n'est pas disponible sous forme de paquet ;
+ pourtant, la plupart des équipes de porteurs l'utilisent aujourd'hui ou ont
+ prévu de l'utiliser bientôt. L'outil de construction automatisé réel est dans
+ le paquet <package>sbuild</package>, voir la description dans <ref
+ id="sbuild">. Le système <package>buildd</package> regroupe également un
+ ensemble de composants très utiles, continuellement utilisés, mais non encore
+ mis en paquet, tels que <prgn>andrea</prgn> et <prgn>wanna-build</prgn>.
+<p>
+Une partie des informations produites par <package>buildd</package>
+ — utiles pour les porteurs — est disponible sur la
+ toile à l'adresse <url id="&url-buildd;">. Ces informations
+ incluent les résultats produits toutes les nuits par
+ <prgn>andrea</prgn> (dépendances des sources) et
+ <prgn>quinn-diff</prgn> (paquets à recompiler).
+<p>
+Nous sommes très fiers de ce système car il a de nombreux usages potentiels. Des
+ groupes de développeurs indépendants peuvent utiliser ce système pour créer
+ différentes saveurs de Debian — qui peuvent être ou ne pas être
+ intéressantes pour tous (par exemple, une version de Debian compilée avec des
+ vérifications relatives à <prgn>gcc</prgn>). Ce système nous permettra aussi
+ de recompiler rapidement toute une distribution.
+</sect2>
+
+ <sect id="nmu">Mise à jour indépendante
+<p>
+Dans certaines circonstances, il est nécessaire qu'une personne autre que le
+ responsable d'un paquet fasse une mise à jour de ce paquet. Ce type de
+ mise à jour est désigné en anglais par l'expression <em>non-maintainer
+ upload (NMU)</em>. Dans le présent document, nous traduisons librement
+ cette expression par « mise à jour indépendante ».
+<p>
+Ces mises à jour indépendantes de binaires font de temps en temps partie du
+ travail normal des porteurs qui compilent les paquets pour d'autres
+ architectures (voir <ref id="porting">). Un développeur peut aussi faire
+ des mises à jour indépendantes quand il corrige le paquet d'un autre
+ développeur pour éliminer un problème de sécurité ou un bogue bloquant. Cela
+ se produit plus particulièrement en période de gel de la distribution de
+ développement ou quand le responsable officiel du paquet ne peut pas
+ fournir une correction dans un délai raisonnable.
+<p>
+Ce chapitre contient des informations qui vous expliqueront quand et comment
+ faire des mises à jour indépendantes. Une distinction fondamentale doit
+ être faite entre les mises à jour indépendantes sources et les mises à
+ jour indépendantes binaires. Elle est explicitée dans la section suivante.
+
+ <sect1 id="nmu-terms">Terminologie
+<p>
+Deux nouvelles expressions sont introduites dans cette section :
+ « mise à jour indépendante source » et « mise à jour
+ indépendante binaire ». Ces expressions ont une définition précise dans le
+ monde Debian. Elles correspondent toutes deux au même type d'activité ;
+ elles impliquent toutes deux qu'une personne fait une mise à jour d'un paquet
+ alors qu'elle n'est pas officiellement responsable de ce paquet. C'est pourquoi
+ nous qualifions ces mises à jours
+ d'<em>indépendantes</em><footnote>Contrairement à ce que pourrait laisser
+ entendre cette traduction de <em>non-maintainer upload</em>, il n'est pas
+ question d'agir sans prévenir le responsable au préalable (voir <ref
+ id="nmu-guidelines">).</footnote>.
+<p>
+Une mise à jour indépendante source est une livraison de paquet faite par une
+ personne qui n'est pas le responsable officiel de ce paquet avec pour objectif
+ de corriger un bogue dans le paquet. Une mise à jour indépendante source
+ implique toujours une modification des sources du paquet, même s'il ne s'agit
+ que d'un changement dans le fichier <file>debian/changelog</file>. Ce
+ changement peut tout aussi bien concerner la partie amont du source que la
+ partie spécifique à Debian. Une mise à jour indépendante source peut aussi
+ inclure des paquets spécifiques à une architecture tout comme un fichier
+ <em>diff</em> modifié.
+<p>
+Une mise à jour indépendante binaire est constitué par la recompilation et
+ l'archivage d'un paquet pour une architecture donnée. Il s'agit souvent du
+ résultat d'un effort de portage. Une mise à jour indépendante binaire est la
+ livraison d'un paquet compilé (souvent pour une autre architecture) à condition
+ que cette compilation n'ait pas nécessité de modifications des sources. Dans de
+ nombreux cas, les porteurs sont obligés de modifier les sources pour les rendre
+ compilables sur leur architecture cible ; il s'agira alors d'une mise à
+ jour indépendante source et non d'une mise à jour indépendante binaire. Comme
+ vous pouvez le remarquer, nous ne faisons pas de distinction entre les mises à
+ jour indépendantes faites par des porteurs et les autres mises à jour
+ indépendantes.
+<p>
+Les mises à jour indépendantes sources et binaires sont toutes deux couvertes
+ par l'expression « mise à jour indépendante »
+ (NMU<footnote><p>Non-maintainer upload</footnote>). Pourtant, cela conduit
+ souvent à des confusions car beaucoup associent « mise à jour
+ indépendante » et « mise à jour indépendante source ». Il faut
+ donc rester vigilant. Dans ce chapitre, si nous utilisons l'expression
+ « mise à jour indépendante » seule, il s'agit des deux types de
+ livraisons.
+ <sect1 id="nmu-who">Qui peut faire une mise à jour indépendante ?
+<p>
+Seuls les responsables Debian officiels peuvent faire des mises à jour
+ indépendantes. Un responsable officiel est une personne dont la clé est dans le
+ porte-clés Debian. Toute personne est invitée à télécharger les paquets sources
+ pour corriger des bogues ; au lieu de faire des mises à jour
+ indépendantes, ils pourront soumettre les correctifs qui le méritent au système
+ de suivi des bogues. Les responsables apprécient presque toujours les
+ correctifs et les rapports de bogue soignés.
- <sect>Superviser les rapports de bogues
+ <sect1 id="nmu-when">Quand faire une mise à jour indépendante
+ source ?
<p>
-Si vous voulez être un bon responsable, vous devrez consulter régulièrement la
-page du <url id="&url-bts;" name="système de suivi des bogues">. Cette page
-contient tous les rapports de bogue qui concernent vos paquets.
-
+Les recommandations pour déterminer quand faire une mise à jour indépendante
+ source dépendent de la distribution visée (i.e. <em>stable</em>,
+ <em>unstable</em> ou <em>experimental</em>). Les porteurs, ayant une activité
+ particulière, obéissent à des règles légèrement différentes (voir <ref
+ id="source-nmu-when-porter">).
+<p>
+Quand une bogue de sécurité est détecté, l'équipe de sécurité peut faire une
+ mise à jour indépendante. Veuillez vous reporter à <ref id="bug-security"> pour
+ plus d'informations.
+<p>
+Pendant le cycle de mise au point (<em>release cycle</em>, voir <ref
+ id="sec-dists">), les livraisons qui corrigent les bogues de gravité
+ <em>sérieuse</em> (i.e. <em>serious</em>) et supérieures sont encouragées et
+ acceptées. Même pendant cette période, vous devriez tenter d'entrer en contact
+ avec le responsable du paquet ; il pourrait bien être sur le point de
+ livrer un paquet corrigé lui aussi. Comme pour n'importe quelle mise à jour
+ indépendante source, les recommandations de la section <ref
+ id="nmu-guidelines"> doivent être respectées. Des exceptions spéciales sont
+ effectuées pour <ref id="qa-bsp">.
+<p>
+Envoyer des corrections de bogues vers <em>unstable</em> par une autre personne
+ que le responsable ne devrait être fait qu'en suivant ce protocole :
+<p>
+<list>
+<item>Vérifiez que les bogues du paquet qui devraient être corrigés par la
+ mise à jour indépendante sont bien référencés dans le système de suivi des
+ bogues. S'ils n'y sont pas, faites des rapports de bogue
+ immédiatement.
+<item>Attendez la réponse du responsable quelques jours. Si vous n'obtenez
+ aucune réponse, vous pouvez l'aider en lui envoyant le correctif qui
+ corrige le bogue. N'oubliez pas de marquer le bogue avec le mot-clé
+ « patch ».
+<item>Patientez quelques jours. Si vous n'avez toujours aucune réponse du
+ responsable, envoyez-lui un courrier annonçant votre intention
+ d'effectuer une mise à jour indépendante du paquet. Préparez la NMU comme
+ décrit dans <ref id="nmu-guidelines">, testez-la soigneusement sur votre
+ machine (cf. <ref id="sanitycheck">). Re-vérifiez que votre correctif
+ n'a aucun effet de bord inattendu. Assurez-vous que votre correctif est
+ aussi minimaliste et non intrusif que possible.
+<item>Envoyez votre paquet à incoming dans <file>DELAYED/7-day</file> (cf.
+ <ref id="delayed-incoming">), envoyez le correctif final au responsable
+ par le BTS et expliquez-lui qu'il a 7 jours pour réagir s'il veut annuler
+ la NMU.
+<item>Suivez ce qui se passe, vous êtes responsable pour tout bogue que vous
+ auriez introduit avec votre NMU. Vous devriez probablement utiliser le
+ <ref id="pkg-tracking-system"> (PTS) pour vous tenir informé de l'état du
+ paquet après votre NMU.
+</list>
+<p>
+Parfois, le responsable de version ou un groupe organisé de
+ développeurs peut annoncer une certaine période de temps au cours de laquelle
+ les règles de mise à jour indépendante seront plus souples. Ceci implique
+ habituellement une période plus courte d'attente avant d'envoyer des
+ correctifs et une période de délai plus courte. Il est important de noter que,
+ même au cours de ces « chasses aux bogues », la personne
+ désirant faire la mise à jour indépendante doit remplir des bogues et
+ contacter en premier le développeur, et ensuite seulement passer à
+ l'action.
+
+ <sect1 id="nmu-guidelines">Comment faire une mise à jour indépendante
+ source ?
<p>
-Les responsables interagissent avec le système de suivi des bogues en
-utilisant l'adresse électronique <tt>bugs.debian.org</tt>. Vous trouverez une
-documentation sur les commandes disponibles à l'adresse <url id="&url-bts;">
-ou, si vous avez installé le paquet <package>doc-debian</package>, dans les
-fichiers locaux <file>/usr/share/doc/debian/bug-*</file>.
-
+Les règles qui suivent s'appliquent aux porteurs tant qu'ils jouent le double
+ rôle de correcteur de bogue et de porteur. Si un porteur doit modifier le
+ paquet source, cette mise à jour est automatiquement une mise à jour
+ indépendante source et est soumise aux règles qui suivent. Si un porteur
+ construit un paquet binaire recompilé, les règles sont différentes (voir <ref
+ id="porter-guidelines">.
+<p>
+Tout d'abord, il est capital que ces mises à jour indépendantes soient aussi peu
+ intrusives que possible. Ne faites pas de ménage, ne modifiez pas le nom des
+ modules ou des fichiers, ne déplacez pas les répertoires ; plus
+ généralement, ne corrigez pas ce qui n'est pas cassé. Faites un correctif aussi
+ petit que possible. Si certaines choses froissent votre sens de l'esthétique,
+ parlez-en au responsable du paquet, au responsable amont ou soumettez un
+ rapport de bogue. Quoiqu'il en soit, les changements esthétiques <em>ne doivent
+ pas</em> être effectués lors d'une mise à jour indépendante.
+
+
+ <sect2 id="nmu-version">Numéro de version pour les mises à jour
+ indépendantes sources
<p>
-Certains trouvent utile de recevoir régulièrement une synthèse des rapports de
-bogues ouverts. Si vous voulez recevoir une synthèse hebdomadaire relevant
-tous les rapports de bogue ouverts pour vos paquets, vous pouvez configurer
-<prgn>cron</prgn> comme suit :
-
+Chaque fois que vous modifiez un paquet, le numéro de version de ce paquet doit
+ changer, même pour la plus triviale des modifications. Notre système de
+ gestion de paquets s'appuie sur ces numéros de version.
+<p>
+Si vous faites une mise à jour indépendante <em>(NMU)</em>, vous devez ajouter
+ un numéro de version mineur à la partie <var>révision-debian</var> du numéro
+ de version (la partie qui suit le dernier trait d'union). Ce numéro
+ supplémentaire débutera à « 1 ». Prenons pour exemple le paquet
+ « foo » qui porte le numéro de version 1.1-3. Dans l'archive, le
+ fichier de contrôle du paquet source serait <file>foo_1.1-3.dsc</file>. La
+ version amont est « 1.1 » et la révision Debian est
+ « 3 ». La mise à jour indépendante suivante ajouterait le numéro de
+ version mineur « .1 » au numéro de révision Debian ; le nouveau
+ fichier de contrôle du paquet source serait alors
+ <file>foo_1.1-3.1.dsc</file>.
+<p>
+Le numéro de révision mineur est nécessaire pour éviter de prendre un numéro de
+ version au responsable officiel du paquet, ce qui pourrait perturber son
+ travail. Cela a aussi l'avantage de montrer clairement que le paquet n'a pas
+ été livré par le responsable officiel.
+<p>
+S'il n'y a pas de partie <var>révision-debian</var> dans le numéro de version du
+ paquet, il faut en créer une en démarrant à « 0.1 ». S'il est
+ absolument nécessaire qu'une personne qui n'est pas responsable d'un paquet
+ fasse une livraison basée sur une nouvelle version amont, cette personne doit
+ choisir « 0.1 » comme numéro de révision Debian. Le mainteneur du
+ paquet doit, lui, démarrer sa numérotation à « 1 ».
+
+
+ <sect2 id="nmu-changelog">
+ <heading>Les mises à jour indépendantes sources doivent être
+ mentionnées dans le fichier changelog</heading>
<p>
+Une personne qui fait une mise à jour indépendante source doit ajouter une
+ entrée dans le fichier <file>changelog</file> qui indique les bogues corrigés
+ et qui précise pourquoi cette mise à jour était nécessaire. Cette entrée
+ comportera l'adresse de la personne ayant fait la mise à jour ainsi que la
+ version livrée.
+<p>
+Par convention, dans le cas d'une mise à jour indépendante source
+ <em>(NMU)</em>, l'entrée du fichier changelog débute par la ligne :
+
<example>
-# Synthèse hebdomadaire des rapports de bogue qui me concernent
-0 17 * * fri echo "index maint <var>adresse</var>" | mail request@bugs.debian.org
+ * Non-maintainer upload
</example>
-<p>
-Remplacez <var>adresse</var> par votre adresse officielle de responsable
-Debian.
+ <sect2 id="nmu-patch">Mise à jour indépendante source et système de
+ suivi des bogues
+<p>
+Un développeur qui n'est pas responsable d'un paquet doit faire aussi peu de
+ modifications que possible et doit toujours envoyer ses modifications au
+ système de suivi des bogues au format diff unifié (<tt>diff -u</tt>).
+<p>
+Et si vous recompilez simplement le paquet ? Si vous avez simplement besoin
+ de recompiler le paquet pour une seule architecture, vous pouvez faire une
+ NMU binaire seulement comme décrit dans <ref id="binary-only-nmu"> qui ne
+ nécessite pas qu'un correctif soit envoyé. Si vous désirez que le paquet soit
+ recompilé pour toutes les architectures, vous devez alors faire une NMU
+ source et vous devrez envoyer un correctif.
+<p>
+Si la mise à jour indépendante source (<em>source NMU</em>) corrige des bogues,
+ ceux-ci doivent être marqués <em>fixed</em> (corrigé) dans le système de
+ suivi des bogues plutôt que clos. Par convention, seul le responsable du
+ paquet et la personne qui a ouvert le rapport de bogue peuvent clore ce
+ rapport. Heureusement, le système d'archivage Debian reconnaît les mises à
+ jours indépendantes et positionne correctement le statut des bogues à
+ <em>fixed</em> si la personne qui fait la mise à jour a listé tous les bogues
+ dans le fichier changelog en utilisant la syntaxe <tt>Closes:
+ bug#<var>nnnnn</var></tt> (voir <ref id="upload-bugfix"> pour en savoir plus
+ sur la fermeture de bogue par le fichier <file>changelog</file>). Ce passage
+ au statut <em>fixed</em> assure que chacun sait que le bogue est corrigé par
+ une mise à jour indépendante tout en laissant le rapport de bogue ouvert
+ jusqu'à ce que le responsable du paquet incorpore les modifications de cette
+ mise à jour dans la version officielle du paquet.
+<p>
+Après avoir fait une mise à jour indépendante, il vous faudra aussi ouvrir un
+ nouveau rapport de bogue qui inclura un correctif contenant toutes les
+ modifications que vous avez faites. Sinon, vous pouvez envoyer cette
+ information aux bogues qui sont fixés par votre NMU. Le responsable officiel
+ pourra choisir d'appliquer le correctif, il pourra aussi employer une autre
+ méthode pour régler le problème. Certains bogues sont corrigés dans la
+ version amont, ce qui est une bonne raison pour annuler les modifications
+ d'une mise à jour indépendante. Si le responsable choisit de mettre à jour le
+ paquet plutôt que d'utiliser les correctifs de la mise à jour indépendante,
+ il devra s'assurer que cette nouvelle version corrige effectivement chacun
+ des bogues corrigés dans la mise à jour indépendante.
+<p>
+De plus, le responsable officiel devrait <em>toujours</em> conserver les entrées
+ documentant une mise à jour indépendante dans le fichier
+ <file>changelog</file>.
+
+
+ <sect2 id="nmu-build">Fabriquer une mise à jour indépendante source
+<p>
+Les paquets faisant l'objet d'une mise à jour indépendante source sont
+ construits comme les autres. Sélectionnez une distribution en utilisant les
+ règles décrites dans la section <ref id="distribution"> en suivant toutes les
+ prescriptions de la section <ref id="upload">.
+<p>
+Vérifiez que vous n'avez pas modifié la valeur du champ <tt>maintainer</tt> dans
+ le fichier <file>debian/control</file>. Votre nom, mentionné dans l'entrée du
+ fichier <file>debian/changelog</file> concernant la mise à jour, sera utilisé
+ pour signer le fichier <file>.changes</file>.
+
+ <sect1 id="ack-nmu">Valider une mise à jour indépendante
+<p>
+Si l'un de vos paquets a subi une mise à jour indépendante, vous devez récupérer
+ les changements dans votre copie des sources. Ceci est aisé, vous avez
+ simplement à appliquer le correctif qui vous a été envoyé. Une fois ceci fait,
+ vous devez fermer les bogues qui ont été marqués comme fixés par la mise à
+ jour. Vous pouvez soit les fermer manuellement en envoyant les courriers
+ nécessaires au BTS soit ajouter les <tt>closes: #nnnn</tt> nécessaires dans
+ l'entrée du changelog de votre prochain envoi.
+<p>
+Dans tous les cas, vous ne devriez pas être perturbé par la NMU. Une NMU n'est
+ pas une attaque personnelle contre le responsable. C'est une preuve que le
+ paquet est important pour quelqu'un et qu'il est désireux de vous aider dans
+ votre travail, vous devriez donc lui être reconnaissant. Vous pouvez également
+ lui demander s'il serait intéressé pour vous aider sur une base plus régulière
+ comme co-responsable ou responsable de secours (cf. <ref
+ id="collaborative-maint">).
+
+
+
+ <sect id="collaborative-maint">
+ <heading>Maintenance collective</heading>
+<p>
+« Maintenance collective » est un terme décrivant le partage des
+ devoirs de la maintenance d'un paquet Debian par plusieurs personnes. Cette
+ collaboration est presque toujours une bonne idée car il en résulte
+ généralement une meilleure qualité et un temps de correction de bogues plus
+ petit. Il est fortement recommandé que les paquets de priorité
+ <tt>Standard</tt> ou qui font partie de la base aient des co-responsables.
+<p>
+Habituellement, il y a un responsable principal et un ou plusieurs
+ co-responsables. Le responsable principal est celui dont le nom est indiqué
+ dans le champ <tt>Maintainer</tt> du fichier <file>debian/control</file>. Les
+ co-responsables sont tous les autres responsables.
+<p>
+Dans sa forme la plus simple, ajouter un nouveau co-responsable est assez
+ simple :
+<list>
+<item><p> Donner au co-responsable un accès aux sources à partir desquelles vous
+ construisez le paquet. Habituellement, cela implique que vous utilisiez un
+ système de contrôle de version comme <prgn>CVS</prgn> ou
+ <prgn>Subversion</prgn>.
+</item>
+<item><p> Ajouter les nom et adresse correctes du co-responsable au champ
+ <tt>Uploaders</tt> dans la partie globale du fichier
+ <file>debian/control</file>.
+<example>
+Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>
+</example>
+</item>
+<item><p>
+ En utilisant le PTS (<ref id="pkg-tracking-system">), les
+ co-responsables devraient s'inscrire eux-mêmes aux paquets sources
+ appropriés.
+</item>
+</list>
+<p>
+La maintenance collaborative peut souvent être facilitée par l'utilisation
+d'outils sur Alioth (voir <ref id="alioth">).
+
+
+ <chapt id="best-pkging-practices">
+ <heading>Les meilleurs pratiques pour la construction des paquets
+<p>
+La qualité de Debian est principalement due à la <url id="&url-debian-policy;"
+name="charte Debian"> qui définit explicitement les obligations que tous les
+paquets doivent suivre. Mais c'est également grâce à une histoire partagée
+d'expériences qui va au-delà de la charte Debian, une accumulation d'années
+d'expérience pour la construction des paquets ; des développeurs de grand
+talent ont créé de bons outils qui vous aideront, vous, responsable Debian, à
+créer et maintenir d'excellents paquets.
+
+<p>
+Ce chapitre fournit les meilleurs pratiques pour les développeurs Debian. Ce ne
+sont que des recommandations, non pas des obligations ou des règles. Ce sont
+seulement des astuces et conseils subjectifs et des liens collectés pour les
+développeurs Debian. Prenez et choisissez ce qui vous convient le mieux.
+
+ <sect id="bpp-debian-rules">
+ <heading>Les meilleures pratiques pour le fichier <file>debian/rules</file></heading>
+ <p>
+Les recommandations suivantes s'appliquent au fichier <file>debian/rules</file>.
+Comme ce fichier contrôle le processus de compilation et qu'il sélectionne les
+fichiers inclus dans le paquet (directement ou indirectement), il s'agit
+habituellement du fichier sur lequel les responsables passent le plus de temps.
+
+
+ <sect1 id="helper-scripts">Scripts d'aide
+<p>
+La raison sous-jacente à l'utilisation des scripts d'aide dans le fichier
+<file>debian/rules</file> est que cela permet aux responsables d'utiliser et de
+partager une logique commune pour un grand nombre de paquets. Prenez, par
+exemple, l'installation des entrées de menu : vous avez besoin de
+placer un fichier dans <file>/usr/lib/menu</file> et d'ajouter des commandes aux
+scripts de maintenance pour enregistrer et désenregistrer ces entrées de menu.
+Comme il s'agit d'une chose très commune, pourquoi chaque
+responsable devrait-il écrire sa propre version, parfois avec des bogues ?
+Supposons également que le répertoire de menu soit modifié, chaque paquet
+devrait être modifié.
+<p>
+Les scripts d'aide peuvent résoudre ces problèmes. En supposant que vous vous
+conformiez aux conventions attendues par le script d'aide, celui-ci prend soin
+de tous les détails. Les changements dans la charte peuvent alors être faits
+dans le script d'aide, les paquets ont alors simplement besoin d'être
+reconstruits avec la nouvelle version du script et sans aucun changement
+supplémentaire.
+<p>
+L'<ref id="tools"> contient plusieurs systèmes d'aide. Le plus
+courant et le meilleur (à notre avis) système est <package>debhelper</package>.
+Les précédents systèmes d'aide comme <package>debmake</package> étaient
+« monolithiques » : vous ne pouviez pas choisir quelles parties
+intéressantes vous pouviez utiliser, mais vous étiez obligé de choisir le
+système pour tout faire. <package>debhelper</package>, à l'inverse, consiste en
+un certain nombre de petits programmes <prgn>dh_*</prgn>. Par exemple,
+<prgn>dh_installman</prgn> installe et compacte les pages de manuel,
+<prgn>dh_installmenu</prgn> installe les fichiers de menu et ainsi de suite.
+Ainsi, il offre une flexibilité suffisante pour pouvoir utiliser les scripts
+d'aide quand ils sont utiles, en complément de commandes définies manuellement
+dans le fichier <file>debian/rules</file>.
+<p>
+Vous pouvez débuter avec <package>debhelper</package> en lisant <manref
+name="debhelper" section="1"> et en regardant les exemples fournis avec le
+paquet. <prgn>dh_make</prgn> du paquet <package>dh-make</package> (voir <ref
+id="dh-make">) peut être utilisé pour convertir un paquet source
+« vierge » en une version utilisant <package>debhelper</package>. Ce
+raccourci ne devrait cependant pas vous faire croire que vous n'avez pas besoin
+de comprendre les scripts individuels <prgn>dh_*</prgn>. Si vous comptez
+utiliser un système d'aide, vous devez prendre le temps d'apprendre à utiliser
+ce système pour savoir ce que vous pouvez en attendre ainsi que son
+comportement.
+<p>
+Plusieurs personnes pensent que des fichiers <file>debian/rules</file> vierges
+sont préférables car vous n'avez pas à apprendre les détails internes d'un
+quelconque système d'aide. La décision vous appartient complètement. Utilisez ce
+qui vous convient. Plusieurs exemples de fichiers <file>debian/rules</file> sont
+disponibles à <url id="&url-rules-files;">.
+
+ <sect1 id="multiple-patches">
+ <heading>Séparer vos correctifs en plusieurs fichiers</heading>
+<p>
+Les gros paquets peuvent avoir plusieurs bogues que vous devez gérer. Si
+ vous corrigez sans faire attention les bogues dans les sources, vous ne
+ pourrez pas différencier facilement les nombreux correctifs que vous aurez
+ appliqués. Cela peut devenir trés compliqué de mettre à jour le paquet avec
+ une nouvelle version amont qui intègre certains correctifs (mais pas tous).
+ Vous ne pouvez pas prendre l'ensemble des correctifs (par exemple, dans les
+ fichiers <file>.diff.gz</file>) et décider quels correctifs il vous faut
+ enlever parce que les bogues ont été corrigés en amont.
+<p>
+Malheureusement, le système de création des paquets tel qu'il est actuellement
+ne fournit pas de moyen de séparer les correctifs en plusieurs fichiers.
+Cependant, il existe des moyens de séparer les correctifs : les fichiers
+correctifs sont livrés dans le fichier correctif Debian
+(<file>.diff.gz</file>), habituellement dans le répertoire <file>debian/</file>.
+La seule différence est qu'ils ne sont pas appliqués immédiatement par
+dpkg-source, mais par la règle <tt>build</tt> du fichier
+<file>debian/rules</file>. Inversement, ils sont annulés par la règle
+<tt>clean</tt>.
+<p>
+<prgn>dbs</prgn> est l'une des approches les plus populaires pour cela. Il fait
+ce qui est décrit ci-dessus et fournit la possibilité de créer de nouveaux
+correctifs et de mettre à jour d'anciens correctifs. Veuillez vous reporter au
+paquet <package>dbs</package> pour plus d'informations et au paquet
+<package>hello-dbs</package> pour un exemple.
+<p>
+<prgn>dpatch</prgn> fournit également ces fonctions, mais il est prévu pour être
+encore plus facile d'utilisation. Veuillez voir le paquet
+<package>dpatch</package> pour la documentation et des exemples (dans
+<file>/usr/share/doc/dpatch</file>).
+<p>
+
+ <sect1 id="multiple-binary">Paquets binaires multiples
+<p>
+Un simple paquet source va souvent permettre de construire plusieurs paquets
+ binaires différents, que ce soit pour fournir plusieurs saveurs du même
+ paquet (par exemple, le paquet source <package>vim</package>) ou pour créer
+ plusieurs petits paquets au lieu d'un seul gros (par exemple, si
+ l'utilisateur peut n'installer que la partie dont il a besoin et ainsi
+ économiser de l'espace disque).
+<p>
+Le second cas peut facilement être géré dans le fichier
+ <file>debian/rules</file>. Vous avez simplement besoin de déplacer les fichiers
+ appropriés du répertoire de construction dans les arborescence temporaires du
+ paquet. Vous pouvez le faire en utilisant <prgn>install</prgn>
+ ou <prgn>dh_install</prgn> du paquet <package>debhelper</package>.
+ Assurez-vous de vérifier les différentes permutations de paquets, en
+ garantissant que vous avez bien défini les dépendances entre les paquets dans
+ le fichier <file>debian/control</file>.
+<p>
+Le premier cas est un peu plus diffile car il implique de multiples
+ recompilations du même logiciel, mais avec différentes options de
+ configuration. Le paquet source <package>vim</package> est un exemple de la
+ façon de gérer cela avec un fichier <file>rules</file> écrit à la main.
+
+<!-- &FIXME; Find a good debhelper example with multiple configure/make cycles
+ -->
+</sect1>
+
+
+ <sect id="bpp-debian-control">
+ <heading>Les meilleures pratiques pour le fichier
+ <file>debian/control</file></heading>
+ <p>
+Les pratiques suivantes sont relatives au fichier <file>debian/control</file>.
+Elles viennent en complément des <url
+id="&url-debian-policy;ch-miscellaneous.html#s-descriptions" name="règles pour
+les descriptions des paquets">.
+<p>
+La description du paquet, telle qu'elle est définie par le champ correspondant
+dans le fichier <file>control</file>, contient à la fois le résumé du paquet et
+la description longue pour le paquet. <ref id="bpp-desc-basics"> décrit des
+lignes générales pour les deux parties de la description. Ensuite, <ref
+id="bpp-pkg-synopsis"> fournit des principes spécifiques pour le résumé et <ref
+id="bpp-pkg-desc"> contient des principes spécifiques pour la description
+longue.
+
+ <sect1 id="bpp-desc-basics">
+ <heading>Les règles générales pour les descriptions des paquets</heading>
+<p>
+La description du paquet devrait être écrite pour l'utilisateur moyen,
+l'utilisateur qui va utiliser et bénéficier du paquet. Par exemple, les paquets
+de développement sont pour les développeurs et leur description peut utiliser un
+langage technique. Pour les applications à but plus général comme un éditeur, la
+description devrait être écrite pour un non-spécialiste.
+<p>
+Notre critique des descriptions des paquets nous amène à conclure que la plupart
+des descriptions des paquets sont techniques, c'est-à-dire, qu'elles ne sont pas
+écrites pour être comprises par les non-spécialistes. À moins que
+votre paquet ne soit que pour les techniciens, c'est un problème.
+<p>
+Comment écrire pour les non-spécialistes ? Évitez le jargon.
+Évitez de vous référer à d'autres applications et cadres de travail avec
+lesquels l'utilisateur n'est pas forcément familier — « GNOME »
+ou « KDE » sont corrects car les utilisateurs sont probablement
+familiers avec ces termes, mais « GTK+ » ne l'est probablement pas.
+Ne supposez aucune connaissance. Si vous devez utiliser des termes techniques,
+introduisez-les.
+<p>
+Soyez objectif. Les descriptions de paquet ne sont pas un endroit pour
+promouvoir votre paquet, quel que soit l'amour que vous lui portez.
+Rappelez-vous que le lecteur n'a pas forcément les mêmes priorités que vous.
+<p>
+Des références aux noms de tout autre paquet de logiciels, noms de protocoles,
+standards ou spécifications devraient utiliser leurs formes canoniques si elles
+existent. Par exemple, utilisez « X Window System », « X11 »
+ou « X » et non « X Windows », « X-Windows » ou
+« X Window ». Utilisez « GTK+ » et non « GTK » ou
+« gtk ». Utilisez « GNOME » et non « Gnome ».
+Utilisez « PostScript » et non « Postscript » ou
+« postscript ».
+<p>
+Si vous avez des problèmes pour écrire votre description, vous pouvez l'envoyer à
+&email-debian-l10n-english; et demander un retour d'informations.
+
+ </sect1>
+
+<sect1 id="bpp-pkg-synopsis">
+ <heading>Le résumé du paquet ou description courte</heading>
+<p>
+La ligne de résumé (la description courte) devrait être concise. Elle ne doit
+pas répéter le nom du paquet (c'est une règle).
+<p>
+C'est une bonne idée de penser au résumé comme à une clause apposée et non une
+phrase complète. Une clause apposée est définie dans WordNet comme une relation
+grammaticale entre un mot et une phrase pronominale qui la suit, par exemple
+« Rudolph, le renne au nez rouge ». La clause apposée ici est
+« le renne au nez rouge ». Comme le résumé est une clause et non une
+phrase complète, nous recommandons de ne pas la commencer par une majuscule et
+de ne pas la finir par un point. Il ne doit pas non plus commencer avec un
+article, défini (« le ») ou indéfini (« un »).
+<p>
+Cela peut vous aider d'imaginer le résumé combiné avec le nom du paquet de
+la façon suivante :
+
+<example><var>nom-paquet</var> est un <var>résumé</var>.</example>
+
+Sinon, il peut être plus compréhensible de le voir comme
+
+<example><var>nom-paquet</var> est <var>résumé</var>.</example>
+
+ou, si le nom du paquet est lui-même un pluriel (comme
+« developer-tools »)
+
+<example><var>nom-paquet</var> sont <var>résumé</var>.</example>
+
+Cette façon de former une phrase à partir du nom du paquet et du résumé devrait
+être considérée comme une heuristique et non comme une règle stricte. Il y a
+certains cas où cela n'a aucun sens de former une phrase.
+
+ </sect1>
+
+ <sect1 id="bpp-pkg-desc">
+ <heading>La description longue</heading>
+<p>
+La description longue du paquet est la première information dont dispose
+l'utilisateur avant d'installer un paquet. Aussi, elle devrait fournir toutes
+les informations nécessaires pour le laisser décider de l'installation du
+paquet. Vous pouvez supposer que l'utilisateur a déjà lu le résumé du paquet.
+<p>
+La description longue devrait toujours être constituée de phrases complètes.
+<p>
+Le premier paragraphe de la description longue devrait répondre aux questions
+suivantes : qu'est-ce que fait le paquet ? Quelle tâche aide-t-il
+l'utilisateur à accomplir ? Il est important de décrire ceci d'une manière
+non technique, à moins que le paquet ne s'adresse qu'à un auditoire de techniciens.
+<p>
+Les paragraphes suivants devraient répondre aux questions suivantes :
+Pourquoi, en tant qu'utilisateur, ai-je besoin de ce paquet ? Quelles
+sont les autres fonctionnalités dont dispose le paquet ? Quelles
+sont les fonctionnalités marquantes et les déficiences de ce paquet comparé à
+d'autres paquets (par exemple, « si vous avez besoin de X, utilisez Y à la
+place ») ? Est-ce que le paquet est lié à d'autres paquets d'une
+certaine façon qui n'est pas gérée par le gestionnaire de paquet (par exemple,
+« il s'agit d'un client pour le serveur foo ») ?
+<p>
+Soyez attentif à éviter les fautes d'orthographe et de grammaire. N'oubliez
+pas votre vérificateur orthographique. <prgn>ispell</prgn> possède une option
+spéciale (<tt>-g</tt>) pour cela :
+
+<example>ispell -d american -g debian/control</example>
+
+ </sect1>
+
+ <sect1 id="bpp-upstream-info">
+ <heading>Page d'accueil amont</heading>
+ <p>
+Nous vous recommandons d'ajouter l'adresse de la page d'accueil du paquet à la
+description du paquet dans le fichier <file>debian/control</file>. Cette
+information devrait être ajoutée à la fin de la description en utilisant le
+format suivant :
+
+<example> .
+ Homepage: http://some-project.some-place.org/</example>
+
+Veuillez noter les espaces au début de la ligne, ils servent à séparer les
+lignes correctement. Pour voir un exemple de ce que cela affiche, veuillez vous
+reporter à <url id="&url-eg-desc-upstream-info;">.
+ <p>
+Ne mettez rien s'il n'existe pas de page pour le logiciel.
+ <p>
+Veuillez noter que nous espérons que ce champ sera remplacé par un
+vrai champ de <file>debian/control</file> que comprendraient <prgn>dpkg</prgn>
+et <tt>&packages-host;</tt>. Si vous ne voulez pas vous embêter à déplacer la
+page d'accueil depuis la description vers ce nouveau champ, vous devriez
+probablement attendre qu'il soit disponible.</p>
+ </sect1>
+ </sect>
- <sect id="submit-bug">Ouvrir un rapport de bogue
+ <sect id="bpp-debian-changelog">
+ <heading>Les meilleures pratiques pour le fichier <file>debian/changelog</file></heading>
+ <p>
+Les pratiques suivantes viennent en complément de la <url name="directive sur
+les fichiers changelog" id="&url-debian-policy;ch-docs.html#s-changelogs">.</p>
-<p>
-En tant que responsable Debian, vous trouvez des bogues dans d'autres paquets
-En tant que responsable Debian, vous trouvez des bogues dans d'autres paquets,
-ou bien vous voulez réassigner à d'autres paquets des rapports de bogue
-concernant vos paquets. La page d'aide du <url id="&url-bts-control;"
-name="système de suivi des bogues"> vous explique comment procéder.
+ <sect1 id="bpp-changelog-do">
+ <heading>Écrire des entrées de changelog utiles</heading>
+ <p>
+L'entrée de changelog pour une révision de paquet documente les changements dans
+cette révision et seulement ceux-ci. Concentrez-vous sur la description des
+changements significatifs et visibles de l'utilisateur qui ont été effectués
+depuis la dernière version.
+ <p>
+Ciblez <em>ce</em> qui a été changé — qui, comment et quand cela a été fait
+est généralement de moindre importance. Ceci dit, rappelez-vous de nommer
+poliment les personnes qui ont fourni une aide notable pour réaliser le
+paquet (par exemple, ceux qui ont envoyé des correctifs).
+ <p>
+Vous n'avez pas besoin de détailler les changements triviaux et évidents. Vous
+pouvez également regrouper plusieurs de ces changements dans une seule entrée.
+D'un autre côté, ne soyez pas trop concis si vous avez entrepris un changement
+majeur. Soyez tout spécialement clair s'il y a des changements qui modifient le
+comportement du programme. Pour plus d'explications, utilisez le fichier
+<file>README.Debian</file>.
+ <p>
+Utilisez un langage anglais commun pour que la majorité des lecteur puissent le
+comprendre. Évitez les abbréviations, le parler technique et le jargon quand
+vous expliquez des changements fermant un bogue, spécialement pour les rapports
+de bogue créés par des utilisateurs qui ne vous paraissent pas particulièrement
+à l'aise techniquement. Vous devez être poli et ne pas jurer.
+ <p>
+Il est parfois désirable de préfixer les entrées de changelog avec le nom des
+fichiers qui ont été modifiés. Cependant, il n'est pas besoin de lister
+explicitement tous les fichiers modifiés, particulièrement si la modification
+est petite ou répétitive. Vous pouvez utiliser les caractères génériques.
+ <p>
+Quand vous faites référence aux bogues, ne supposez rien a priori. Dites ce
+qu'était le problème, comment il a été résolu et ajoutez la chaîne de caractères
+« closes: #nnnnn ». Veuillez voir <ref id="upload-bugfix"> pour plus
+d'informations.
-<p>
-Nous vous encourageons à ouvrir des rapports de bogue s'il y a des problèmes.
-Essayez de soumettre ces rapports depuis un compte utilisateur où vous pouvez
-recevoir du courrier. Ne les envoyez pas en tant que <em>root</em>.
+ <sect1 id="bpp-changelog-misconceptions">
+ <heading>idées fausses communes sur les entrées de changelog</heading>
+ <p>
+Les entrées de changelog <strong>ne devraient pas</strong> documenter des
+problèmes génériques d'empaquetage (« Hé, si vous cherchez foo.conf, il
+est dans /etc/blah/. ») car les administrateurs et utilisateurs sont
+supposés être au moins vaguement rompus à la façon dont les choses sont
+arrangées sur un système Debian. Mentionnez cependant tout changement
+d'emplacement d'un fichier de configuration.
+ <p>
+Les seuls bogues fermés par une entrée de changelog devraient être ceux qui sont
+vraiment corrigés dans la même révision du paquet. Fermer des bogues non liés
+par le fichier changelog est considéré comme une très mauvaise pratique.
+Veuillez voir <ref id="upload-bugfix">.
+ <p>
+Les entrées de changelog <strong>ne devraient pas</strong> être le lieu de
+discussions avec les émetteurs de bogues (« Je ne vois pas de segfaults
+lors du lancement de foo avec l'option bar ; envoyez-moi plus
+d'informations. »), ni celui de phrases génériques sur la vie, l'univers et
+tout le reste (« Désolé, cet envoi m'a pris du temps, mais j'avais attrapé
+la grippe ») ou celui de demandes d'aide (« La liste des bogues sur
+ce paquet est énorme, donnez-moi un coup de main »). Ceci ne sera
+généralement pas remarqué par les personnes ciblées, mais peut ennuyer les
+personnes qui désirent lire des informations sur les changements réels du
+paquet. Veuillez vous reporter à <ref id="bug-answering"> pour plus
+d'informations sur la façon d'utiliser le système de suivi des bogues.
+ <p>
+C'est une vieille tradition de valider les bogues fixés par une mise à jour
+indépendante dans la première entrée du changelog de l'envoi du vrai
+responsable, par exemple, dans une entrée de changelog comme ceci :
+<example>
+ * Maintainer upload, closes: #42345, #44484, #42444.
+</example>
+Ceci fermera les bogues NMU marqués comme corrigé (« fixed ») quand le
+paquet arrivera dans l'archive. Le bogue pour le fait qu'une NMU a été faite
+peut être fermé de la même façon. Bien sûr, il est également parfaitement
+acceptable de fermer les bogues corrigés par NMU par d'autres moyens ; voir
+<ref id="bug-answering">.
+</sect1>
+ <sect1 id="bpp-changelog-errors">
+ <heading>Erreurs communes dans les entrées de changelogs</heading>
<p>
-Vérifiez que le bogue n'a pas encore été déclaré. Essayez de faire un travail
-propre en déclarant le bogue et en l'envoyant à la bonne adresse.
+Les exemples suivants montrent des erreurs communes ou des exemples de mauvais
+style dans les entrées de changelog<footnote>NdT : Les entrées de
+changelog sont ici affichées en français pour faciliter la compréhension, mais
+vos entrées devront naturellement être rédigées en anglais.</footnote>.
<p>
-Pour faire encore mieux, vous pouvez consulter d'autres paquets, grouper les
-bogues qui ont été rapportés plusieurs fois ou affecter la sévérité
-<em>corrigé</em> (i.e. <em>fixed</em>) à un rapport dont le bogue a été
-corrigé. Attention, quand vous n'êtes ni le rapporteur d'un bogue ni le
-responsable du paquet vous ne devez pas clore le rapport (à moins que vous
-n'ayez l'autorisation du responsable).
-
-
-
-
- <sect>Répondre à des rapports de bogues
-
+<example>
+ * Corrige tous les bogues restants.
+</example>
<p>
-Assurez-vous que toutes vos discussions concernant les bogues sont envoyées au
-rapporteur du bogue et au bogue lui-même (<email>123@bugs.debian.org</email>
-par exemple).
-
+Ceci n'indique visiblement rien d'utile au lecteur.
<p>
-Vous ne devez <em>jamais</em> fermer un rapport de bogue en envoyant la
-commande <em>close</em> à l'adresse :
+<example>
+ * Correctif de Jane Random appliqué.
+</example>
+Sur quoi portait le correctif ?
<p>
-<tt> &email-bts-control;</tt>
+<example>
+ * Révision de cible d'installation la nuit dernière.
+</example>
+Qu'a accompli la révision ? Est-ce que la mention de la nuit dernière
+est supposée nous rappeler que nous ne devons pas faire confiance à ce
+code ?
<p>
-Si vous le faites, le rapporteur n'aura aucun retour sur la clôture de son
-rapport.
-
-
-
-
- <sect id="upload-bugfix">Quand les rapports sont fermés par une
- mise à jour
+<example>
+ * Corrige MRD vsync av. anciens CRTs.
+</example>
+Trop d'acronymes et il n'est pas très clair de ce qu'était vraiment cette...
+ euh... merde (oups, un mot interdit !) ou comment cela a été corrigé.
<p>
-Si vous corrigez un bogue dans vos paquets, il est de votre responsabilité de
-fermer le rapport de bogue associé. Pourtant vous ne devez pas le fermer avant
-que le paquet n'ait été accepté dans l'archive Debian. C'est pourquoi, vous
-pouvez et vous devez clore le rapport dans le système de suivi des bogues une
-fois que vous avez reçu l'avis indiquant que votre nouveau paquet a été
-installé dans l'archive.
+<example>
+ * Ceci n'est pas un bogue. Closes: #nnnnnn.
+</example>
+Premièrement, il n'y a absolument pas besoin d'envoyer un paquet pour
+communiquer cette information ; à la place, utilisez le système de suivi des
+bogues. Deuxièmement, il n'y a aucune explication concernant la raison
+pour laquelle le rapport n'était pas un bogue.
<p>
-Si vous utilisez une version récente de <package>dpkg-dev</package> et que
-vous remplissez convenablement le fichier <file>changelog</file>, le logiciel de
-maintenance de l'archive fermera les rapports de bogue automatiquement. Tout ce
-que vous avez à faire est de respecter la syntaxe suivante dans votre fichier
-<file>debian/changelog</file> :
<example>
-acme-cannon (3.1415) unstable; urgency=low
-
- * Frobbed with options (closes: Bug#98339)
- * Added safety to prevent operator dismemberment, closes: bug#98765,
- bug#98713, #98714.
- * Added manpage. Closes: #98725.
+ * A été fixé il y a longtemps, mais j'ai oublié de le fermer. Closes: #54321.
</example>
+Si, pour toute raison, vous n'aviez pas indiqué le numéro du bogue dans une
+précédente entrée de changelog, ceci n'est pas un problème, fermez simplement le
+bogue normalement dans le BTS. Il n'y a pas besoin de modifier le fichier
+changelog, en supposant que la description de la correction est déjà intégrée
+(ceci s'applique aux correctifs par les auteurs/responsables amont également,
+vous n'avez pas à suivre les bogues qui ont été corrigés il y a longtemps dans
+votre changelog).
-Techniquement parlant, l'expression régulière suivante est utilisée :
+<p>
<example>
- /closes:\s*(?:bug)?\#\s*\d+(?:,\s*(?:bug)?\#\s*\d+)*/ig
+ * Closes: #12345, #12346, #15432.
</example>
-
-L'auteur préfère la syntaxe <tt>(closes: Bug#<var>XXX</var>)</tt>, car elle
-est facilement repérable dans le fichier <file>changelog</file>.
-
+Où est la description ?! Si vous n'arrivez pas à trouver un message
+descriptif, commencez par insérer le titre de chacun des différents bogues.
<p>
-Si vous voulez fermer un rapport de bogue manuellement -- à l'ancienne -- il
-suffit d'envoyer le fichier <tt>.changes</tt> à l'adresse
-<email>XXX-done@bugs.debian.org</email> où <var>XXX</var> est le numéro du
-bogue.
-
-
+</sect1>
+</sect>
+<!-- <sect1 id="pkg-mgmt-cvs">Managing a package with CVS
+ <p>
+ &FIXME; presentation of cvs-buildpackage, updating sources
+ via CVS (debian/rules refresh).
+ <url id="http://www.debian.org/devel/cvs_packages">
+-->
- <sect id="lintian-reports">Les rapports Lintian
-
+ <sect id="bpp-debian-maint-scripts">
+ <heading>Les meilleures pratiques pour les scripts de
+ maintenance</heading>
+ <p>
+Les scripts de maintenance incluent les fichiers <file>debian/postinst</file>,
+<file>debian/preinst</file>, <file>debian/prerm</file> et
+<file>debian/postrm</file>. Ces scripts prennent soin de la configuration
+d'installation ou de désinstallation des paquets, ce qui n'est pas simplement créer ou
+supprimer des fichiers et des répertoires. Les instructions suivantes
+complètent la <url id="&url-debian-policy;" name="charte Debian">.
+ <p>
+Les scripts de maintenance doivent être idempotents. Cela veut dire que vous
+devez vous assurer que rien de grave ne se produit si un script est appelé deux
+fois là où il ne devrait habituellement être appelé qu'une fois.
+ <p>
+Les entrée et sortie standard peuvent être redirigées (par exemple, dans des
+tubes<footnote><p>pipes</p></footnote>) pour des besoins d'enregistrement
+d'activité, donc vous ne devez pas supposer que ce sont des tty.
+ <p>
+Tous les affichages et les configurations interactives devraient être
+minimisées. Quand cela est nécessaire, vous devriez utiliser le paquet
+<package>debconf</package> pour l'interface. Rappelez-vous que, dans tous les
+cas, l'affichage ne doit se faire que dans l'étape de configuration,
+<tt>configure</tt> du script de post-installation, <file>postinst</file>.
+ <p>
+Gardez les scripts de maintenance aussi simples que possible. Nous vous
+suggérons d'utiliser des scripts shell POSIX purs. Rappelez-vous, que si vous
+avez besoin d'une fonctionnalité de Bash, le script de maintenance doit
+l'indiquer dans sa première ligne. Un shell POSIX ou Bash sont préférés à
+Perl car ils permettent à <package>debhelper</package> d'ajouter facilement des
+parties aux scripts.
+ <p>
+Si vous modifiez les scripts de maintenance, assurez-vous de tester la
+suppression du paquet, la double installation et la purge complète. Assurez-vous
+qu'il ne reste rien d'un paquet purgé, c'est-à-dire, que la purge doit enlever
+tout fichier créé, directement ou indirectement, par les scripts de
+maintenance.
+ <p>
+Si vous avez besoin de vérifier l'existence d'une commande, vous devriez
+utiliser quelque chose comme :
+<example>if [ -x /usr/sbin/install-docs ]; then ...</example>
+
+Si vous ne désirez pas mettre en dur le chemin de la commande dans le script de
+maintenance, la fonction de shell suivante conforme à POSIX peut vous
+aider :
+
+&example-pathfind;
+
+Vous pouvez utiliser cette fonction pour rechercher le <tt>$PATH</tt> pour un
+nom de commande passé en argument. Il renvoie vrai (zéro) si la commande a été
+trouvée et faux sinon. Il s'agit réellement de la façon la plus portable de faire
+car <tt>command -v</tt>, <prgn>type</prgn> et <prgn>which</prgn> ne sont pas
+POSIX.
+<p>
+Bien que <prgn>which</prgn> soit une alternative acceptable car il est
+présent dans le paquet classé <em>required</em> <package>debianutils</package>, il n'est pas
+présent dans la partition racine. Autrement dit, il est placé dans
+<file>/usr/bin</file> au lieu de <file>/bin</file>, il n'est donc pas possible
+de l'utiliser dans les scripts qui sont exécutés avant que la partition
+<file>/usr</file> soit montée. Cependant, la plupart des scripts n'auront pas ce
+problème.
+ </sect>
+
+ <sect id="bpp-config-mgmt">
+ <heading>Gestion de la configuration avec <package>debconf</package></heading>
+
+ <p>
<p>
-Vous devriez récupérer la dernière version de <package>lintian</package>
-depuis <em>unstable</em> régulièrement et vérifier tous vos paquets. Vous
-pouvez aussi chercher votre adresse électronique dans la page de <url
-id="&url-lintian;" name="rapport lintian">. Cette page, mise à jour
-automatiquement, contient les rapports lintian concernant la
-dernière version de la distribution (en général <em>unstable</em>) générés
-avec la dernière version de <package>lintian</package>.
+<package>Debconf</package> est un système de gestion de configuration qui
+ peut être utilisé par les divers scripts de maintenance (principalement
+ en post-installation dans le fichier <file>postinst</file>) pour demander à
+l'utilisateur des informations concernant la configuration du paquet. Il
+faut maintenant éviter les interactions directes avec l'utilisateur et
+préférer les interactions utilisant <package>debconf</package>. Ceci permettra
+ à l'avenir des installations non interactives.
+ <p>
+Debconf est un bon outil, mais il est souvent mal utilisé. Plusieurs erreurs
+ communes sont référencées dans la page de manuel <manref section="7"
+ name="debconf-devel">. Vous devriez vraiment lire cette page si vous décidez
+ d'utiliser debconf.
+ </sect>
+
+
+ <sect id="bpp-i18n">
+ <heading>Internationalisation</heading>
+
+
+
+ <sect1 id="bpp-i18n-debconf">Gestion des traductions de
+ debconf
+<p>
+Comme les porteurs, les traducteurs ont une tâche difficile. Ils travaillent sur
+ un grand nombre de paquets et doivent donc collaborer avec plusieurs
+ responsables différents. De plus, la plupart du temps, l'anglais n'est pas leur
+ langue maternelle, il se peut que vous deviez être particulièrement patient
+ avec eux.
+<p>
+Le but de <package>debconf</package> était de faciliter la configuration des
+paquets aux responsables et aux utilisateurs. À l'origine, les
+traductions des questionnaires debconf étaient gérées avec
+<prgn>debconf-mergetemplate</prgn>. Cependant, cette technique est maintenant
+déconseillée ; la meilleure façon pour l'internationalisation de
+<package>debconf</package> est d'utiliser le paquet
+<package>po-debconf</package>. Cette méthode est plus facile et pour le
+responsable et pour les traducteurs ; des scripts de transition sont
+fournis.
+<p>
+Lors de l'utilisation de <package>po-debconf</package>, la traduction est
+stockée dans des fichiers <file>po</file> (à l'instar des techniques de
+traduction de <prgn>gettext</prgn>). Des fichiers modèles contiennent les
+messages d'origine et indiquent quels sont les champs traduisibles. Quand vous
+modifiez l'état d'un champ traduisible en appelant
+<prgn>debconf-updatepo</prgn>, la traduction est marquée comme ayant besoin de
+l'attention des traducteurs. Puis, lors de la construction du paquet, le
+programme <prgn>dh_installdebconf</prgn> prendra soin de toute la magie
+nécessaire à l'ajout du modèle avec les traductions à jour dans les paquets
+binaires. Veuillez vous reporter à la page de manuel <manref name="po-debconf"
+section="7"> pour les détails.
+ </sect1>
+
+ <sect1 id="bpp-i18n-docs">
+ <heading>Documentation traduite</heading>
+ <p>
+La traduction de la documentation est cruciale pour les utilisateurs, mais elle
+représente un important travail. Il n'existe aucun moyen d'éliminer ce travail,
+mais vous pouvez faciliter les choses pour les traducteurs.
+ <p>
+Si vous êtes responsable d'une documentation quelle que soit sa taille, il est
+plus facile pour les traducteurs d'avoir accès à un système de contrôle de
+source. Ceci permet aux traducteurs de voir les différences entre deux versions
+de la documentation, pour, par exemple, qu'ils puissent voir ce qui a besoin
+d'être retraduit. Il est recommandé que le document traduit inclue une note à
+propos de la révision de contrôle du source sur laquelle la traduction est
+basée. Un système intéressant est fourni par <url id="&url-i18n-doc-check;"
+name="doc-check"> dans le paquet <package>boot-floppies</package> qui donne un
+aperçu de l'état de la traduction pour une langue donnée, en utilisant les
+commentaires structurés pour une révision donnée du fichier à traduire et, pour
+un fichier traduit, la révision du fichier d'origine sur laquelle la traduction
+est basée. Vous pouvez vouloir adapter et fournir ceci dans votre référentiel CVS.
+ <p>
+Si vous maintenez de la documentation au format XML ou SGML, nous vous suggérons
+d'isoler les informations indépendantes de la langue et de les définir
+comme des entités dans un fichier séparé qui sera inclus par les différentes
+traductions. Ceci aide, par exemple, à garder à jour les adresses pour
+plusieurs fichiers.
+ </sect1>
+ </sect>
+
+
+ <sect id="bpp-common-situations">
+ <heading>Pratiques communes d'empaquetage</heading>
+<!--
+ <sect1 id="bpp-kernel">Kernel modules/patches
+<p>
+ &FIXME; Heavy use of kernel-package. provide files in
+ /etc/modutils/ for module configuration.
+-->
+ <sect1 id="bpp-autotools">
+ <heading>Paquets utilisant <prgn>autoconf</prgn>/<prgn>automake</prgn>
+<p>
+Conserver à jour les fichiers d'<prgn>autoconf</prgn>, <file>config.sub</file>
+et <file>config.guess</file>, est critique pour les porteurs, spécialement pour
+les architectures plus changeantes. De très bonnes pratiques d'empaquetage
+utilisant <prgn>autoconf</prgn> et/ou <prgn>automake</prgn> ont été regroupées
+dans &file-bpp-autotools; du paquet <package>autotools-dev</package>. Vous êtes
+vivement encouragé à lire ce fichier et à suivre les recommandations indiquées.
+
+
+ <sect1 id="bpp-libraries">Bibliothèques
+<p>
+Pour diverses raisons, il a toujours été difficile d'empaqueter les
+bibliothèques. La charte impose plusieurs contraintes pour faciliter la maintenance
+ et pour garantir que les mises à jour sont aussi simples que possible quand une
+ nouvelle version amont est disponible. Une erreur dans une bibliothèque peut
+ rendre défectueux une douzaine de paquets qui en dépendent.
+<p>
+Les bonnes pratiques d'empaquetage des bibliothèques ont été regroupées dans
+ <url id="&url-libpkg-guide;" name="le guide d'empaquetage des
+ bibliothèques">.
+
+ <sect1 id="bpp-docs">Documentation
+ <p>
+Assurez-vous de suivre les <url id="&url-debian-policy;ch-docs.html"
+name="règles sur la documentation">.</p>
+ <p>
+Si votre paquet contient de la documentation construite à partir de XML ou SGML,
+nous vous recommandons de ne pas fournir le source XML ou SGML dans le(s)
+paquet(s) binaire(s). Si les utilisateurs désirent avoir le source de la
+documentation, ils peuvent récupérer le paquet source.</p>
+ <p>
+La charte spécifie que la documentation doit être fournie au format HTML.
+Nous vous recommandons également de la fournir au format PDF et texte simple si
+c'est adapté et qu'une sortie de qualité est possible. Cependant, il n'est
+généralement pas approprié de fournir des versions en texte simple pour la
+documentation dont le format source est du HTML.</p>
+ <p>
+Les principaux manuels fournis devraient être enregistrés par le paquet
+<package>doc-base</package> à l'installation. Reportez-vous à la documentation
+du paquet <package>doc-base</package> pour plus d'information.</p>
- <sect>Ouvrir un grand nombre de rapports d'un seul coup
+
+ <sect1 id="bpp-other">Types spécifiques de paquets
+<p>
+Plusieurs types spécifiques de paquets ont des sous-chartes spéciales et des
+ règles et pratiques d'empaquetage correspondantes :
+<list>
+<item>
+ Les paquets liés à Perl ont leur <url id="&url-perl-policy;" name="charte
+ Perl">, quelques exemples de paquets qui suivent cette charte sont
+ <package>libdbd-pg-perl</package> (module perl binaire) ou
+ <package>libmldbm-perl</package> (module perl indépendant de
+ l'architecture).
+</item>
+<item>
+ Les paquets liés à Python ont leur charte Python ; voir
+ &file-python-policy; dans le paquet <package>python</package>.
+</item>
+<item>
+ Les paquets liés à Emacs ont leur <url id="&url-emacs-policy;"
+ name="charte Emacs">.
+</item>
+<item>
+ Les paquets liés à Java ont leur <url id="&url-java-policy;" name="charte
+ Java">.
+</item>
+<item>
+ Les paquets liés à Ocaml ont leur propre charte que l'on trouve dans
+ &file-ocaml-policy; du paquet <package>ocaml</package>. Un bon exemple est
+ le paquet source <package>camlzip</package>.
+</item>
+<item>
+ Les paquets fournissant des DTDs XML ou SGML devraient se conformer aux
+ recommandations que l'on peut trouver dans le paquet
+ <package>sgml-base-doc</package>
+<item>
+ Les paquets Lisp devraient s'enregistrer avec le paquet
+ <package>common-lisp-controller</package> pour lequel vous pouvez vous
+ reporter au fichier &file-lisp-controller;.
+</list>
+
+ </sect1>
+
+ <sect1 id="bpp-archindepdata">Données indépendantes de l'architecture
+ <p>
+ Il n'est pas rare d'avoir une grande quantité de données indépendantes de
+ l'architecture fournie avec un programme. Par exemple, des fichiers
+ audio, une collection d'icônes, des motifs de papiers peints ou autres
+ fichiers graphiques. Si la taille des données est négligeable par
+ rapport à la taille du reste du paquet, il est probablement mieux de
+ tout garder dans le même paquet.
+ <p>
+ Cependant, si la taille des données est considérable, vous devez
+ envisager de les partager dans un paquet séparé et indépendant de
+ l'architecture (« _all.deb »). Ainsi, en faisant cela, vous
+ évitez une duplication inutile des mêmes données dans onze fichiers
+ .debs pour chaque architecture. Bien que ceci ajoute une surcharge
+ supplémentaire aux fichiers <file>Packages</file>, ceci sauve beaucoup
+ d'espace disque sur les miroirs Debian. Séparer les données
+ indépendantes de l'architecture réduit également le temps de traitement
+ de <prgn>lintian</prgn> ou de <prgn>linda</prgn> (voir <ref
+ id="tools-lint">) quand ils sont exécutés sur l'ensemble de l'archive
+ Debian.
+ </sect1>
+
+</sect>
+
+</chapt>
+
+ <chapt id="beyond-pkging">
+ <heading>Au-delà de l'empaquetage
+<p>
+Debian, c'est beaucoup plus que de l'empaquetage de logiciels et de
+ la maintenance de paquets. Ce chapitre contient des informations sur les
+ façons, souvent vraiment importantes, de contribuer à Debian au-delà de la
+ simple création et maintenance de paquets.
+<p>
+En tant qu'organisation de volontaires, Debian repose sur la liberté de
+ choisir ce sur quoi l'on désire travailler et de choisir la
+ partie la plus importante à laquelle on veut consacrer son temps.
+
+ <sect id="submit-bug">
+ <heading>Rapporter des bogues
+<p>
+Nous vous encourageons à remplir des rapports de bogue quand vous trouvez des
+ bogues dans les paquets Debian. En fait, les développeurs Debian sont souvent
+ les testeurs de première ligne. Trouver et rapporter les bogues dans les
+ paquets d'autres développeurs améliore la qualité de Debian.
+<p>
+Lisez les <url name="instructions pour créer un rapport de bogue"
+id="&url-bts-report;"> dans le <url name="système de suivi des bogues"
+id="&url-bts;"> Debian.
+<p>
+Essayez de soumettre le bogue à partir d'un compte utilisateur normal sur lequel
+ vous pouvez recevoir des courriers, pour que les personnes puissent vous
+ joindre s'ils ont besoin de plus d'informations à propos du bogue. Ne soumettez
+ pas de bogues en tant que root.
+<p>
+Vous pouvez utiliser un outil comme <manref name="reportbug" section="1"> pour
+soumettre des bogues. Il peut automatiser et dans l'ensemble faciliter le
+processus.
+<p>
+Assurez-vous que le bogue n'a pas déjà été rapporté. Chaque paquet dispose d'une
+liste de bogues facilement accessible à
+<tt>http://&bugs-host;/<var>nom_paquet</var></tt>. Des outils comme <manref
+name="querybts" section="1"> peuvent également vous fournir ces informations (et
+<prgn>reportbug</prgn> invoquera également habituellement <prgn>querybts</prgn>
+avant l'envoi).
+<p>
+Essayer d'envoyer vos bogues au bon emplacement. Quand, par exemple, votre bogue
+concerne un paquet qui réécrit des fichiers d'un autre paquet, vérifiez les
+listes des bogues pour les <em>deux</em> paquets pour éviter de créer des
+rapports de bogues dupliqués.
+<p>
+Vous pouvez également parcourir les bogues d'autres paquets, en les regroupant
+ s'ils sont indiqués plus d'une fois, ou en les marquant avec
+ « fixed » quand ils ont déjà été corrigés. Notez cependant que si
+ vous n'êtes ni le rapporteur du bogue, ni le responsable du paquet, vous ne
+ devriez pas fermer réellement le bogue (à moins que vous n'ayez obtenu la
+ permission du responsable).
+<p>
+De temps en temps, vous pourrez vouloir vérifier ce qui s'est passé à propos des
+ bogues que vous avez rapportés. Saisissez cette occasion pour fermer les bogues
+ que vous ne pouvez plus reproduire. Pour trouver tous les bogues que vous avez
+ rapportés, vous avez simplement besoin d'aller à
+ <tt>http://&bugs-host;/from:<var><votre-adresse-de-courrier></var></tt>.
+
+ <sect1 id="submit-many-bugs">Ouvrir un grand nombre de rapports d'un seul
+ coup
<p>
Ouvrir un grand nombre de rapports pour le même problème sur un grand nombre de
-paquet -- plus de dix -- est une pratique que nous déconseillons. Prenez
-toutes les mesures possibles pour éviter cette situation. Si le problème peut
-être détecté automatiquement par exemple, ajoutez un nouveau test dans le
-paquet <package>lintian</package> pour générer une erreur ou un avertissement.
-
+ paquets — plus de dix — est une pratique que nous déconseillons.
+ Prenez toutes les mesures possibles pour éviter cette situation. Si le problème
+ peut être détecté automatiquement par exemple, ajoutez un nouveau test dans le
+ paquet <package>lintian</package> pour générer une erreur ou un avertissement.
<p>
Si vous ouvrez plus de dix rapports sur le même sujet, il est préférable
-d'indiquer votre intention sur la liste &email-debian-devel;. Cela donnera à
-d'autres développeurs la possibilité de vérifier que le problème existe
-vraiment. De plus, cela permet d'éviter que plusieurs responsables ne rédigent
-les mêmes rapports de bogue simultanément.
-
+ d'indiquer votre intention sur la liste &email-debian-devel;. Cela donnera à
+ d'autres développeurs la possibilité de vérifier que le problème existe
+ vraiment. De plus, cela permet d'éviter que plusieurs responsables ne rédigent
+ les mêmes rapports de bogue simultanément.
<p>
Quand vous envoyez un grand nombre de rapports sur le même sujet, vous devriez
-les envoyer à <email>maintonly@bugs.debian.org</email> pour qu'ils ne soient
-pas redirigés vers les listes de diffusions.
-
-
-
-
+ les envoyer à <email>maintonly@&bugs-host;</email> pour qu'ils ne soient
+ pas redirigés vers les listes de diffusion.
- <chapt id="newmaint">
- <heading>Interaction avec les nouveaux responsables</heading>
-
-<p>
-Ce chapitre décrit les procédures que doivent suivre les responsables
-Debian quand ils ont affaire à un futur responsable Debian.
-
- <sect>Parrainer un paquet
-<p>
-Parrainer un paquet signifie télécharger un paquet dans l'archive Debian pour
-un responsable qui n'est pas capable de le faire lui même : un futur
-responsable. Parrainer un paquet signifie aussi assumer la résponsabilité de
-ce parrainage.
+ <sect id="qa-effort">Effort d'assurance qualité
+
+ <sect1 id="qa-daily-work">Travail journalier
+<p>
+Bien qu'il y ait un groupe de personnes dédiées à l'assurance qualité, les
+ devoirs de QA ne leur sont pas exclusivement réservés. Vous pouvez participer à
+ cet effort en conservant vos paquets aussi exempts de bogues que possible et
+ aussi corrects que possible selon <prgn>lintian</prgn> (reportez-vous à <ref
+ id="lintian">). Si cela vous paraît impossible, vous devriez alors envisager
+ d'abandonner certains de vos paquets (reportez-vous à <ref id="orphaning">).
+ Sinon, vous pouvez demander de l'aide à d'autres personnes pour qu'elles
+ puissent rattraper votre retard dans la correction des bogues (vous pouvez
+ demander de l'aide sur &email-debian-qa; ou &email-debian-devel;). En même
+ temps, vous pouvez rechercher des co-responsables (reportez-vous à <ref
+ id="collaborative-maint">).
+
+ <sect1 id="qa-bsp">Les chasses aux bogues
+<p>
+De temps en temps, le groupe d'assurance qualité organise des chasses aux
+ bogues<footnote><em>Bug Squashing Party</em></footnote> pour essayer de
+ supprimer le plus de problèmes possible. Elles sont annoncées sur
+ &email-debian-devel-announce; et l'annonce explique quel domaine sera visé
+ pendant la chasse : habituellement, il s'agit des bogues empêchant
+ l'intégration du paquet dans la distribution (« Release Critical »),
+ mais il peut arriver qu'ils décident d'aider à finir une transition majeure
+ (comme une nouvelle version de Perl qui demande la recompilation de tous les
+ modules binaires).
+<p>
+Les règles pour les mises à jour indépendantes sont différentes au cours de la
+ chasse parce que l'annonce de la chasse est considérée comme une annonce
+ préalable pour les mises à jour indépendantes. Si vous avez des paquets qui
+ peuvent être affectées par la chasse (parce qu'ils ont des bogues critiques par
+ exemple), vous devriez envoyer une mise à jour pour chaque bogue correspondant
+ pour expliquer leur état actuel et ce que vous attendez de la chasse. Si vous
+ ne voulez pas d'une mise à jour indépendante ou si vous n'êtes intéressé que
+ par un correctif ou si vous voulez gérer vous-même le bogue, veuillez l'expliquer
+ dans le BTS.
+<p>
+Les personnes qui participent à la chasse ont des règles spécifiques pour les
+ mises à jour indépendantes, ils peuvent en faire une sans avertissement
+ préalable s'ils envoient leur paquet avec un délai d'au moins 3 jours dans
+ DELAYED/3-day. Toutes les autres règles de mise à jour indépendante
+ s'appliquent comme d'habitude, ils devraient envoyer le correctif de la
+ mise à jour dans le BTS (pour l'un des bogues ouverts corrigé par la mise à
+ jour ou pour un nouveau bogue marqué comme fixé). Ils devraient également
+ respecter les souhaits du responsable s'il en a exprimés.
+<p>
+Si une personne ne se sent pas à l'aise avec une mise à jour indépendante, elle
+ devrait simplement envoyer un correctif au BTS. C'est de loin meilleur qu'une
+ mise à jour défectueuse.
+
+ <sect id="contacting-maintainers">Contacter d'autres responsables
+<p>
+Pendant vos activités dans Debian, vous aurez à contacter d'autres responsables
+ pour différentes raisons. Vous pourrez vouloir discuter d'une nouvelle
+ façon de coopérer au sein d'un ensemble de paquets liés, ou vous pouvez
+ simplement rappeler à quelqu'un qu'une nouvelle version est disponible et
+ que vous en avez besoin.
+<p>
+Chercher l'adresse d'un responsable d'un paquet peut être fastidieux.
+ Heureusement, il existe un alias de courrier simple,
+ <tt><paquet>@&packages-host;</tt>, qui fournit un moyen d'envoyer
+ un courrier à un responsable, quelle que soit son adresse (ou ses
+ adresses). Remplacez <tt><paquet></tt> par le nom du paquet source
+ ou binaire.
+<p>
+Vous pouvez également vouloir contacter les personnes qui sont inscrites à un
+ paquet de source donné par le <ref id="pkg-tracking-system">. Vous pouvez le
+ faire en utilisant l'adresse <tt><nom-paquet>@&pts-host;</tt>.
+
+
+ <sect id="mia-qa">Gérer les responsables non joignables
+<p>
+Si vous remarquez qu'un paquet manque de maintenance, vous devriez vous assurer
+ que le responsable est toujours actif et qu'il continue à travailler sur
+ ses paquets. Il est possible qu'il ne soit plus actif, mais qu'il ne se
+ soit pas désenregistré du système. D'un autre côté, il est possible qu'il
+ ait simplement besoin d'un rappel.
+<p>
+La première étape est de contacter poliment le responsable et d'attendre une
+réponse pendant un temps raisonnable. Il est assez difficile de définir le
+« temps raisonnable », mais il est important de prendre en compte que
+la vraie vie est parfois assez mouvementée. Une façon de gérer cela pourrait
+être d'envoyer un rappel après deux semaines.
+<p>
+Si le responsable ne répond pas après quatre semaines (un mois), on peut
+supposer qu'il n'y aura probablement pas de réponse. Si ceci se produit, vous
+devriez poursuivre vos investigations et essayer de réunir toutes les
+informations utiles sur ce responsable. Ceci inclut :
+ <p>
+ <list>
+ <item>Les informations « echelon » disponibles dans la <url
+ id="&url-debian-db;" name="base de données LDAP des
+ développeurs">, qui indiquent quand le développeur a envoyé un
+ message pour la dernière fois sur une liste de diffusion Debian.
+ (Ceci inclut les envois via les listes debian-*-changes.)
+ Rappelez-vous également de vérifier si le responsable est indiqué
+ comme en vacances dans la base de données.
+
+ <item>Le nombre de paquets de ce responsable et les conditions de ces
+ paquets. En particulier, restent-ils des bogues empêchant
+ l'intégration du paquet dans la distribution qui sont ouverts
+ depuis des lustres ? De plus, combien de bogues y a-t-il en
+ général ? Un autre point d'information important est si les
+ paquets ont subi des mises à jour indépendantes et si oui, par
+ qui ?
+
+ <item>Est-ce que le responsable est actif en dehors de Debian ? Par
+ exemple, il peut avoir envoyé des messages récemment à des
+ listes de diffusion non-Debian ou des groupes de discussion.
+ </list>
+ <p>
+Un gros problème est représenté par les paquets parrainés — le responsable
+n'est pas un développeur Debian officiel. Les informations « echelon »
+ne sont pas disponibles pour les personnes parrainés, par exemple, vous devez
+donc trouver et contacter le responsable Debian qui a réellement envoyé le
+paquet. Étant donné qu'il a signé le paquet, il est responsable de l'envoi de
+toute façon et il devrait savoir ce qui s'est passé avec la personne qu'il
+parraine.
+<p>
+Il est également permis d'envoyer une demande à &email-debian-devel; demandant
+si quelqu'un est au courant d'information sur le responsable manquant.
+<p>
+Une fois que vous avez réuni toutes ces informations, vous pouvez contacter
+&email-debian-qa;. Les personnes de cet alias utiliseront les informations que
+vous aurez fournies pour décider comment procéder. Par exemple, ils peuvent
+abandonner un ou tous les paquets du responsable. Si un paquet a subi une mise à
+jour indépendante, ils peuvent préférer contacter le responsable ayant fait cette
+mise à jour — il est peut-être intéressé par le paquet.
+<p>
+Un dernier mot : veuillez vous souvenir d'être poli. Nous sommes tous des
+volontaires et nous ne pouvons dédier l'intégralité de notre temps à Debian.
+Vous n'êtes pas non plus au courant des circonstances de la personne impliquée.
+Elle est peut-être sérieusement malade ou pourrait même nous avoir quitté
+— vous ne savez pas qui recevra vos courriers — imaginez comme un
+proche se sentira s'il lit un courrier pour la personne décédée et trouve un
+message très impoli, en colère et accusateur !)
+<p>
+D'un autre côté, bien que nous soyons tous volontaires, nous avons une
+responsabilité. Vous pouvez donc insister sur l'importance du plus grand intérêt
+— si un responsable n'a plus le temps ou l'envie, il devrait
+« laisser filer » et donner le paquet à quelqu'un ayant plus de temps.
+
+ <sect id="newmaint">
+ <heading>Interagir avec de futurs développeurs Debian
+<p>
+Le succès de Debian dépend de sa capacité à attirer et retenir de nouveaux et
+ talentueux volontaires. Si vous êtes un développeur expérimenté, nous vous
+ recommandons de vous impliquer dans le processus d'apport des nouveaux
+ responsables. Cette section décrit comment aider les futurs développeurs.
+
+
+ <sect1 id="sponsoring">Parrainer des paquets
+<p>
+Parrainer un paquet veut dire envoyer un paquet pour un responsable qui n'est
+ pas encore autorisé à le faire lui-même, un candidat nouveau responsable.
+ Parrainer un paquet veut aussi dire que vous en acceptez la responsabilité.
+<p>
+Si vous désirez être volontaire pour être parrain, vous pouvez vous inscrire à
+ <url id="&url-sponsors;">.
+<p>
+Les nouveaux responsables ont habituellement certaines difficultés à créer des
+ paquets Debian — ceci est bien compréhensible. C'est pourquoi le parrain
+ est là pour vérifier que le paquet parrainé est assez bon pour être inclus
+ dans Debian. (Notez que si le paquet parrainé est nouveau, les ftpmasters
+ devront également l'inspecter avant de l'intégrer)
+<p>
+Effectuer un parrainage en signant simplement l'envoi ou en recompilant le
+ paquet <strong>n'est définitivement pas recommandé</strong>. Vous devez
+ construire le paquet source comme si vous vouliez construire l'un de vos
+ paquets. Rappelez-vous que cela ne change rien si vous avez laissé le nom du
+ candidat développeur dans le changelog et dans le fichier de
+ contrôle, il est toujours possible de savoir que c'est vous qui avez fait l'envoi.
+<p>
+Si vous êtes un gestionnaire de candidature pour un futur développeur, vous
+ pouvez également être son parrain. Ainsi, vous pourrez vérifier comment le
+ candidat gère la partie « Tâches et Capacités »<footnote>Tasks and
+ Skills</footnote> de sa candidature.
+
+ <sect1>Gérer les paquets parrainés
+<p>
+En envoyant un paquet sponsorisé vers Debian, vous certifiez que le paquet
+ atteint les standards minimum de Debian. Ceci implique que vous devez
+ construire et tester le paquet sur votre propre système avant l'envoi.
+<p>
+Vous ne pouvez pas simplement envoyer un fichier <file>.deb</file> binaire d'un
+ filleul. En théorie, vous devriez seulement demander le fichier diff et
+ l'emplacement de l'archive source d'origine et ensuite vous devriez récupérer
+ le source et appliquer le diff vous-même. En pratique, vous pouvez vouloir
+ utiliser le paquet source construit par votre filleul. Dans ce cas, vous devez
+ vérifier qu'il n'a pas modifié les fichiers sources du fichier
+ <file>.orig.tar.gz</file> qu'il fournit.
+<p>
+N'ayez pas peur de répondre au filleul et de lui indiquer les changements qu'il
+ doit faire. Cela prend souvent plusieurs échanges de courriers avant que le
+ paquet ne soit dans un état acceptable. Être un parrain veut dire être un
+ mentor.
+<p>
+Une fois que le paquet a atteint les standards Debian, construisez et signez le
+paquet avec
+<example>
+dpkg-buildpackage -k<var>KEY-ID</var>
+</example>
+ avant de l'envoyer dans le répertoire Incoming.
<p>
-Les nouveaux responsables éprouvent souvent quelques difficultés pour créer
-des paquets Debian -- ce qui est bien compréhensible. C'est là que le parrain
-intervient. Il doit verifier que le paquet est suffisamment bon pour intégrer
-la distribution. Notez que si le paquet est nouveau les administrateurs FTP
-devront eux aussi inspecter ce paquet avant de le laisser entrer.
-
+Le champ Maintainer du fichier <file>control</file> et le fichier
+ <file>changelog</file> devraient afficher la personne qui a fait l'empaquetage,
+ c'est-à-dire, le filleul. Celui-ci recevra donc tous les courriers du système
+ de suivi des bogues (BTS) à propos de son paquet.
<p>
-Parrainer un paquet en se contentant de recompiler le paquet ou de signer le
-téléchargement <strong>n'est franchement pas recommandé</strong>. Vous devez
-reconstruire le paquet source comme vous le feriez avec vos propres paquets.
-N'oubliez pas qu'il sera possible de voir que vous avez téléchargé un paquet
-même si vous avez laissé le nom du futur responsable dans les fichiers de
-contrôle et changelog.
-
+Si vous préférez laisser une trace plus visible de votre travail de parrainage,
+ vous pouvez ajouter une ligne l'indiquant dans la plus récente entrée du
+ changelog.
<p>
-Si vous êtes responsable de candidature<footnote>Application
-manager</footnote> pour un developpeur, vous pouvez aussi être son parrain. De
-cette manière, vous aurez la possibilité de vérifier vous même comment ce
-candidat accomplit la partie `Tâches et compétences'<footnote>`Tasks and
-Skills'</footnote> de sa candidature.
-
-
-
- <sect>Soutenir un nouveau responsable
+Vous êtes encouragé à garder un œil sur le suivi des paquets que vous parrainez
+ en utilisant le <ref id="pkg-tracking-system">.
+ <sect1>Recommander un nouveau développeur
<p>
-Consultez la page <url id="&url-newmaint-advocate;" name="Soutenir un futur
-responsable"> sur le site du projet Debian.
-
-
-
- <sect>Suivre la candidature d'un nouveau responsable
+Reportez-vous à la page sur les <url id="&url-newmaint-advocate;"
+ name="recommandations pour un développeur prospectif"> sur le site web Debian.
+ <sect1>Gérer les candidatures des nouveaux candidats
<p>
-Consultez la page <url id="&url-newmaint-amchecklist;" name="Aide mémoire du
-responsable de candidature"> sur le site du projet Debian.
+Veuillez vous reporter à la <url id="&url-newmaint-amchecklist;" name="liste à
+ vérifier pour les responsables de candidatures"> sur le site web Debian.
-
-
-
- <chapt id="tools">Aperçu des outils du responsable Debian
-
+ <appendix id="tools">Aperçu des outils du responsable Debian
<p>
Cette section contient un aperçu rapide des outils dont dispose le responsable.
-Ces outils sont faits pour améliorer le confort des responsables et pour
-libérer leur temps pour des tâches cruciales.
-
+ Cette liste n'est ni complète, ni définitive, il s'agit juste d'un guide
+ des outils les plus utilisés.
+<p>
+Les outils du responsable Debian sont destinés à améliorer le confort des
+ responsables et libérer leur temps des tâches plus cruciales. Comme le dit
+ Larry Wall, il y a plus d'une manière de le faire.
<p>
Certaines personnes préfèrent utiliser des outils de haut niveau, d'autres pas.
-Debian n'a pas de position officielle sur la
-question ; tout outil conviendra du moment qu'il fait le boulot. C'est pourquoi
-cette section n'a pas été conçue pour indiquer à chacun
-quel outil il devrait utiliser ou comment il devrait faire pour gérer sa
-charge de responsable Debian. Elle n'est pas non plus destinée à
-favoriser l'usage d'un outil aux dépens d'un autre.
-
+ Debian n'a pas de position officielle sur la question ; tout outil
+ conviendra du moment qu'il fait le boulot. C'est pourquoi cette section
+ n'a pas été conçue pour indiquer à chacun quel outil il doit utiliser ou
+ comment il devrait faire pour gérer sa charge de responsable Debian. Elle
+ n'est pas non plus destinée à favoriser l'utilisation d'un outil aux
+ dépens d'un autre.
<p>
-La plupart des descriptions de ces outils proviennent des descriptions de
-leurs paquets. Vous trouverez plus d'information dans les
-documentations de ces paquets.
+La plupart des descriptions de ces outils proviennent des descriptions de leurs
+ paquets. Vous trouverez plus d'informations dans les documentations de ces
+ paquets. Vous pouvez aussi obtenir plus d'informations avec la commande
+ <tt>apt-cache show <nom_paquet></tt>.</p>
+ <sect id="tools-core">
+ <heading>Outils de base</heading>
+ <p>
+Les outils suivants sont pratiquement nécessaires à tout responsable.</p>
- <sect id="dpkg-dev">
- <heading><package>dpkg-dev</package>
+ <sect1 id="dpkg-dev">
+ <heading><package>dpkg-dev</package></heading>
<p>
Le paquet <package>dpkg-dev</package> contient les outils (y compris
-<prgn>dpkg-source</prgn>) nécessaires pour déballer, fabriquer et livrer des
-paquets Debian source. Ces utilitaires fournissent les fonctionnalités de bas
-niveau indispensables pour créer et manipuler les paquets ; en tant que tels,
-ils sont indispensables à tout responsable Debian.
-
-
-
-
- <sect id="lintian">
- <heading><package>lintian</package>
+ <prgn>dpkg-source</prgn>) nécessaires pour déballer, fabriquer et livrer des
+ paquets Debian source. Ces utilitaires fournissent les fonctionnalités de bas
+ niveau indispensables pour créer et manipuler les paquets ; en tant que
+ tels, ils sont indispensables à tout responsable Debian.
+ <sect1 id="debconf">
+ <heading><package>debconf</package></heading>
<p>
-<package>lintian</package> dissèque les paquets pour y repérer des bogues et
-des manquements aux règles de développement. Il contient des tests automatisés pour
-vérifier de nombreuses règles et quelques erreurs courantes. L'utilisation de
-<package>lintian</package> a déjà été discutée dans <ref id="upload-checking">
-et <ref id="lintian-reports">.
-
- <sect id="debconf">
- <heading><package>debconf</package></heading>
-
+Le paquet <package>debconf</package> fournit une interface unifiée pour
+ configurer les paquets interactivement. Il est indépendant de l'interface et
+ permet une configuration en mode texte, par une interface HTML ou par boîtes de
+ dialogue. D'autres types d'interface peuvent être ajoutés sous forme de
+ modules.
<p>
-Le paquet <package>debconf</package> fournit une interface consistante pour
-configurer les paquets interactivement. Il est indépendant de l'interface et
-permet une configuration en mode texte, par une interface HTML ou par boîtes
-de dialogues. D'autres types d'interface peuvent être ajoutés sous forme
-de modules.
-
+Vous trouverez la documentation de ce paquet dans le paquet
+ <package>debconf-doc</package>.
<p>
Beaucoup pensent que ce système devrait être utilisé pour tout paquet
-nécessitant une configuration interactive. <package>debconf</package> n'est
-pas requis par le <em>Debian Policy Manual</em> pour le moment ; cela
-pourra changer dans le futur.
-
-
- <sect id="debhelper">
- <heading><package>debhelper</package>
-
-<p>
-Le paquet <package>debhelper</package> regroupe un ensemble de programmes qui
-peuvent être utilisés dans <file>debian/rules</file> pour automatiser les
-tâches courantes relatives à la fabrication des paquets Debian binaires. Ce
-paquet contient des utilitaires pour installer différents fichiers, les
-compresser, ajuster leurs droits et intégrer votre paquet dans le
-système de menu Debian.
-
-<p>
-Au contraire de <package>debmake</package>, <package>debhelper</package> est
-divisé en plusieurs petits utilitaires qui agissent de manière cohérente.
-Ce découpage permet un contrôle des opérations plus fin que
-<package>debmake</package>.
-
-
-
-
- <sect id="debmake">
- <heading><package>debmake</package>
-
-<p>
-<package>debmake</package> -- un précurseur de <package>debhelper</package> --
-est un assistant moins modulaire pour manipuler le fichier
-<file>debian/rules</file>. Il inclut deux programmes principaux :
-<prgn>deb-make</prgn>, utile au développeur Debian pour convertir un paquet
-source normal (non-Debian) en paquet source Debian, et <prgn>debstd</prgn> qui
-regroupe le type de fonction que l'on trouve dans
-<package>debhelper</package>.
-
-<p>
-Le consensus actuel est que l'usage de <package>debmake</package> est
-déconseillé au profit de <package>debhelper</package> mais ce n'est pas une
-erreur d'utiliser <package>debmake</package>.
+ nécessitant une configuration interactive ; reportez-vous à la <ref
+ id="bpp-config-mgmt">. <package>debconf</package> n'est pas requis par la
+ <em>charte Debian</em> pour le moment ; cependant, cela pourra changer.
+</sect1>
+
+ <sect1 id="fakeroot">
+ <package>fakeroot</package>
+<p>
+<package>fakeroot</package> simule les privilèges <em>root</em>. Cela permet de
+ fabriquer un paquet sans être root (en général, les paquets installent des
+ fichiers appartenant à <em>root</em>). Si vous avez installé
+ <package>fakeroot</package>, vous pouvez construire un paquet en tant que
+ simple utilisateur avec : <tt>dpkg-buildpackage -rfakeroot</tt>.
+
+
+ <sect id="tools-lint">
+ <heading>Outils du paquet lint</heading>
+ <p>
+Selon le « Free On-line Dictionary of Computing » (FOLDOC),
+« lint » est « un outil de traitement de langage C qui contient
+beaucoup plus de tests complets sur le code que n'en font habituellement les
+compilateurs C. ». Les outils du paquet lint aide les responsables de
+paquet à trouver automatiquement des problèmes habituels et des violations de
+charte dans leurs paquets</p>
+
+ <sect1 id="lintian">
+ <heading><package>lintian</package></heading>
+<p>
+<package>lintian</package> dissèque les paquets pour y repérer des bogues et des
+ manquements aux règles de développement. Il contient des tests automatisés pour
+ vérifier de nombreuses règles et quelques erreurs courantes.
+<p>
+Vous devriez récupérer la dernière version de <package>lintian</package> depuis
+ <em>unstable</em> régulièrement et vérifier tous vos paquets. Notez que
+ l'option <tt>-i</tt> donne des explications détaillées sur la signication de
+ chaque erreur, la partie concernée dans la charte et le moyen habituel de
+ régler le problème.
+<p>
+Veuillez vous reporter à <ref id="sanitycheck"> pour plus d'informations sur
+comment et quand utiliser Lintian.
+<p>
+ Vous pouvez aussi obtenir un résumé de tous les problèmes reportés par Lintian
+ sur vos paquets à <url id="&url-lintian;">. Ces rapports contiennent la sortie
+ de la dernière version de <prgn>lintian</prgn> sur l'ensemble de la
+ distribution de développement (<em>unstable</em>).
+</sect1>
+
+ <sect1 id="linda">
+ <heading><package>linda</package></heading>
+ <p>
+<package>linda</package> est un autre vérificateur de paquet. Il est sembable à
+<package>lintian</package>, mais il a un ensemble de tests différents. Il est écrit
+en Python plutôt qu'en Perl.</p>
+ </sect1>
+
+
+ <sect1 id="debdiff">
+ <heading><package>debdiff</package></heading>
+ <p>
+<prgn>debdiff</prgn> (du paquet <package>devscripts</package>, <ref
+id="devscripts">) compare des listes de fichiers et des fichiers de contrôle de
+deux paquets. C'est un simple test de régression qui peut vous aider à remarquer
+si le nombre de paquets binaires à changer depuis le dernier envoi ou si autre
+chose a changé dans le fichier de contrôle. Bien sûr, certains des changements
+qu'il indique sont normaux, mais il peut aider à empêcher différents accidents.
+ <p>
+Vous pouvez l'exécuter sur un couple de paquets binaires :
+<example>
+debdiff package_1-1_arch.deb package_2-1_arch.deb
+</example>
+ <p>
+Ou même sur un couple de fichiers de changements :
+<example>
+debdiff package_1-1_arch.changes package_2-1_arch.changes
+</example>
+ <p>
+Pour plus d'informations, veuillez voir <manref name="debdiff" section="1">.
+ </sect1>
+ </sect>
- <sect id="yada">
- <heading><package>yada</package>
+ <sect id="tools-helpers">
+ <heading>Aides pour le fichier <file>debian/rules</file></heading>
+ <p>
+Des outils de construction de paquets rendent le processus d'écriture du fichier
+<file>debian/rules</file> plus facile. Veuillez voir les <ref
+id="helper-scripts"> pour plus d'informations sur les raisons pour lesquelles
+ils peuvent être désirables ou non.
+ <sect1 id="debhelper">
+ <heading><package>debhelper</package></heading>
<p>
-Le paquet <package>yada</package> est un nouvel assistant pour la création de
-paquets qui a une approche légèrement différente. Il utilise un fichier
-<file>debian/packages</file> pour générer d'autres fichiers nécessaires dans
-le sous-répertoire <file>debian/</file>.
-
+Le paquet <package>debhelper</package> regroupe un ensemble de programmes qui
+ peuvent être utilisés dans <file>debian/rules</file> pour automatiser les
+ tâches courantes relatives à la fabrication des paquets Debian binaires. Ce
+ paquet contient des utilitaires pour installer différents fichiers, les
+ compresser, ajuster leurs droits et intégrer votre paquet dans le système de
+ menu Debian.
<p>
-Remarque : <package>yada</package> est encore jeune et probablement moins
-robuste que ses aînés.
-
-
-
- <sect id="equivs">
- <heading><package>equivs</package>
-
+À la différence des autres approches, <package>debhelper</package> est divisé en
+ plusieurs petits utilitaires qui agissent de manière cohérente. Ce découpage
+ permet un contrôle des opérations plus fin que d'autres « <em>outils
+ debian/rules</em> ».
<p>
-<package>equivs</package> est un autre paquet pour faire des paquets. Il est
-souvent conseillé pour un usage local, si vous avez besoin de faire un paquet
-pour satisfaire des dépendances. Il est aussi parfois utilisé pour faire des
-« méta-paquets » qui sont des paquets dont l'unique objet est de
-dépendre d'autres paquets.
-
-
+Il existe aussi un certain nombre de petites extensions
+ <package>debhelper</package> trop éphémères pour être documentées. Vous en
+ listerez la plupart en faisant <tt>apt-cache search ^dh-</tt>.
+</sect1>
- <sect id="cvs-buildpackage">
- <heading><package>cvs-buildpackage</package>
+ <sect1 id="debmake">
+ <heading><package>debmake</package></heading>
<p>
-Le paquet <package>cvs-buildpackage</package> permet de mettre à jour ou
-récupérer des paquets sources dans un référentiel CVS, il permet de fabriquer
-un paquet Debian depuis le référentiel CVS et il assiste le développeur lors
-de l'intégration de modifications amont dans le référentiel.
-
+<package>debmake</package> — un précurseur de <package>debhelper</package>
+ — est un assistant moins modulaire pour manipuler le fichier
+ <file>debian/rules</file>. Il inclut deux programmes principaux :
+ <prgn>deb-make</prgn>, utile au développeur Debian pour convertir un paquet
+ source normal (non-Debian) en paquet source Debian, et <prgn>debstd</prgn> qui
+ regroupe le type de fonction que l'on trouve dans <package>debhelper</package>.
<p>
-Ce paquet fournit l'infrastructure facilitant l'utilisation de CVS
-pour le responsable. Il permet de conserver des branches CVS distinctes
-pour les distributions <em>stable</em>, <em>unstable</em> et probablement
-<em>experimental</em>.
-
-
- <sect id="dupload">
- <heading><package>dupload</package>
+Le consensus actuel est que l'usage de <package>debmake</package> est
+ déconseillé au profit de <package>debhelper</package>, mais ce n'est pas une
+ erreur d'utiliser <package>debmake</package>.
+</sect1>
-<p>
-Le paquet <package>dupload</package> contient un script du même nom pour
-mettre à jour des paquets dans l'archive Debian, tracer ces mises à jour et
-les annoncer par courrier électronique automatiquement. Vous pouvez le
-configurer pour faire des mises à jour à d'autres endroits et avec d'autres
-méthodes.
+ <sect1 id="dh-make">
+ <heading><package>dh-make</package>
+ <p>
+Le paquet <package/dh-make/ contient <prgn/dh_make/, un programme qui crée un
+squelette de fichiers nécessaires à la construction d'un paquet Debian à partir
+d'une arborescence source. Comme le nom le suggère, <prgn/dh_make/ est une
+réécriture de <package/debmake/ et ses fichiers modèles utilisent les
+programmes dh_* de <package/debhelper/.
+ <p>
+Quoique les fichiers de règles fabriqués par <prgn/dh_make/ constituent en général
+une base suffisante pour un paquet fonctionnel, ce ne sont que les
+fondations : la charge incombe toujours au responsable d'affiner
+les fichiers générés et de rendre le paquet complètement fonctionnel et
+en conformité avec la charte.
+ </sect1>
+ <sect1 id="yada">
+ <heading><package>yada</package></heading>
<p>
-Note : l'annonce d'une mise à jour est maintenant prise en charge par le logiciel
-de gestion de l'archive. <package>dupload</package> doit être configuré
-pour ne plus envoyer de courrier (voir <ref id="upload-announce">).
-
- <sect id="fakeroot">
- <heading><package>fakeroot</package>
-
+Le paquet <package>yada</package> est un autre assistant pour la création de
+ paquets. Il utilise un fichier <file>debian/packages</file> pour générer
+ <file>debian/rules</file> et d'autres fichiers nécessaires dans le
+ sous-répertoire <file>debian/</file>.
<p>
-<package>fakeroot</package> simule les privilèges <em>root</em>. Cela permet
-de fabriquer un paquet sans être root (en général les paquets installent des
-fichiers appartenant à <em>root</em>). Si vous avez installé
-<package>fakeroot</package> vous pouvez par exemple écrire
-<tt>dpkg-buildpackage -rfakeroot</tt> en tant qu'utilisateur.
-
+Remarque : <package>yada</package> est qualifié de « quasiment non
+ maintenu » par son responsable, Charles Briscoe-Smith. Son usage est donc
+ déconseillé.
+</sect1>
- <sect id="devscripts">
- <heading><package>devscripts</package>
-
+ <sect1 id="equivs">
+ <heading><package>equivs</package></heading>
<p>
-Le paquet <package>devscripts</package> contient quelques scripts et outils
-que vous trouverez peut-être utiles pour maintenir vos paquets Debian. Parmi
-ces scripts, vous trouverez <prgn>debchange</prgn> qui manipule votre fichier
-<file>debian/changelog</file> depuis la ligne de commande et
-<prgn>debuild</prgn> qui est construit au-dessus de
-<prgn>dpkg-buildpackage</prgn>.
-
-
+<package>equivs</package> est un autre paquet pour faire des paquets. Il est
+ souvent conseillé pour un usage local, si vous avez besoin de faire un paquet
+ pour satisfaire des dépendances. Il est aussi parfois utilisé pour faire des
+ « méta-paquets » qui sont des paquets dont l'unique objet est de
+ dépendre d'autres paquets.</p>
+ </sect1>
+</sect>
+
+
+ <sect id="tools-builders">
+ <heading>Constructeurs de paquets</heading>
+ <p>
+Les paquets suivants aident le processus de construction des paquets, en général
+en contrôlant <prgn>dpkg-buildpackage</prgn> ainsi que la gestion du support de
+tâches.
+
+ <sect1 id="cvs-buildpackage">
+ <heading><package>cvs-buildpackage</package></heading>
+<p>
+Le paquet <package>cvs-buildpackage</package> permet de mettre à jour ou de
+ récupérer des paquets sources dans un référentiel CVS, il permet de fabriquer
+ un paquet Debian depuis le référentiel CVS et il assiste le développeur lors de
+ l'intégration de modifications amont dans le référentiel.
+<p>
+Ce paquet fournit l'infrastructure facilitant l'utilisation de CVS pour le
+ responsable Debian. Il permet de conserver des branches CVS distinctes pour les
+ distributions <em>stable</em>, <em>unstable</em> et probablement
+ <em>experimental</em> et de bénéficier des avantages d'un système de contrôle
+ de version.
+ </sect1>
+
+ <sect1 id="debootstrap">
+ <heading><package>debootstrap</package></heading>
+<p>
+Le paquet <package>debootstrap</package> vous permet d'amorcer un système Debian
+ de base à n'importe quel endroit dans votre système de fichier. Par
+ « système de base », nous entendons le strict minimum nécessaire pour
+ fonctionner et installer le reste du système.
+<p>
+Avoir un système comme celui-ci peut vous servir de différentes manières. Vous
+ pouvez, par exemple, déplacer votre racine dans ce système avec
+ <prgn>chroot</prgn> pour tester vos dépendances de fabrication. Vous pouvez
+ aussi l'utiliser pour voir comment se comporte votre paquet quand il est
+ installé dans un environnement minimum.
+ </sect1>
+
+ <sect1 id="pbuilder">
+ <heading><package>pbuilder</package></heading>
+<p>
+<package>pbuilder</package> construit un système « chrooté » et
+ compile des paquets dans ce système. Ceci est très utile pour vérifier que les
+ dépendances de compilation de votre paquet sont correctes et pour vous assurer
+ qu'aucune dépendance de construction inutile ou incorrecte n'existe dans le
+ paquet résultant. </sect1>
+
+ <sect1 id="sbuild">
+ <heading><package>sbuild</package></heading>
+<p>
+<package>sbuild</package> est un autre compilateur automatique. Il peut aussi
+ être utilisé dans un environnement « chrooté ». Il peut être utilisé
+ seul ou comme partie d'un environnement de compilation distribué en réseau.
+ Comme le précédent, c'est une partie du système utilisé par les porteurs pour
+ construire des paquets binaires pour toutes les architectures disponibles.
+ Veuillez vous reporter à <ref id="buildd"> pour plus d'informations et à <url
+ id="&url-buildd;"> pour voir le système en fonctionnement.</p>
+ </sect1>
+ </sect>
+
+ <sect id="uploaders">
+ <heading>Téléchargeurs de paquets</heading>
+ <p>
+Les paquets suivants aident à automatiser ou à simplifier le processus d'envoi
+de paquets dans l'archive officielle.</p>
+
+ <sect1 id="dupload">
+ <heading><package>dupload</package></heading>
+<p>
+Le paquet <package>dupload</package> contient un script du même nom pour mettre
+ à jour des paquets dans l'archive Debian, tracer les mises à jour et les
+ annoncer par courrier électronique automatiquement. Vous pouvez le configurer
+ pour faire des mises à jour à d'autres endroits et avec d'autres méthodes.
+ </sect1>
+
+ <sect1 id="dput">
+ <heading><package>dput</package></heading>
+<p>
+Le script <package>dput</package> fait à peu près la même chose que
+ <package>dupload</package>, mais il le fait différemment. Il a aussi quelques
+ fonctions supplémentaires telles que la possibilité de vérifier la signature
+ GnuPG et les sommes de contrôles avant le téléchargement et la possibilité de
+ démarrer <prgn>dinstall</prgn> en mode simulation (<em>dry-run</em>) après le
+ téléchargement.
+ </sect1>
+ </sect>
+
+
+ <sect id="tools-maint-automate">
+ <heading>Automatisation de la maintenance</heading>
+ <p>
+Les outils suivants aident à automatiser les différentes tâches de maintenance
+par l'ajout des entrées de changelog ou de lignes de signatures, par la
+recherche de bogues à partir d'Emacs ou par l'utilisation du plus récent fichier
+officiel <file>config.sub</file>.</p>
+
+
+ <sect1 id="devscripts">
+ <heading><package>devscripts</package></heading>
+<p>
+Le paquet <package>devscripts</package> contient des scripts et outils qui sont
+ très utiles pour maintenir vos paquets Debian. Parmi ces scripts, vous
+ trouverez <prgn>debchange</prgn> et <prgn>dch</prgn> qui manipulent votre
+ fichier <file>debian/changelog</file> depuis la ligne de commande et
+ <prgn>debuild</prgn> qui est construit au-dessus de
+ <prgn>dpkg-buildpackage</prgn>. L'outil <prgn>bts</prgn> est également très
+ utile pour mettre à jour l'état des rapports de bogue depuis la ligne de
+ commande. Le programme <prgn>uscan</prgn> peut être utilisé pour suivre les
+ nouvelles versions amont de vos paquets. Le programme <prgn>debrsign</prgn>
+ peut être utilisé pour signer à distance un paquet avant de l'envoyer, ce qui
+ est agréable quand la machine sur laquelle vous construisez le paquet est
+ différente de celle où résident vos clés GPG.</p>
+<p>
+Vérifiez la page de manuel <manref section="1" name="devscripts"> pour une liste
+ complète des scripts disponibles.
+
+ <sect1 id="autotools-dev">
+ <heading><package>autotools-dev</package></heading>
+ <p>
+Contient les meilleurs pratiques pour des personnes assurant la maintenance de
+paquets qui utilisent <prgn>autoconf</prgn> et/ou <prgn>automake</prgn>.
+Contient également des fichiers canoniques <file>config.sub</file> et
+<file>config.guess</file> qui sont connus pour fonctionner avec tous les
+portages Debian.</p>
+ </sect1>
+
+ <sect1 id="dpkg-repack">
+ <heading><package>dpkg-repack</package></heading>
+ <p>
+<prgn>dpkg-repack</prgn> crée un paquet Debian à partir d'un paquet qui
+a déjà été installé. Si des changements ont été effectués sur le paquet quand il
+a été décompacté (par exemple, des fichiers dans <file>/etc</file> ont été
+modifés), le nouveau paquet héritera de ces changements.</p>
+ <p>
+Cet utilitaire peut faciliter la copie de paquet d'un ordinateur vers un autre
+ou la re-création de paquets installés sur un système, mais qui ne sont plus
+disponibles ailleurs ou pour stocker l'état actuel d'un paquet avant de le
+mettre à jour.</p>
+ </sect1>
+
+ <sect1 id="alien">
+ <heading><package>alien</package></heading>
+ <p>
+<prgn>alien</prgn> convertit des paquets binaires entre différents formats de
+paquets, y compris des paquets Debian, RPM (RedHat), LSB (Linux Standard Base),
+Solaris et Slackware.</p>
+ </sect1>
+
+ <sect1 id="debsums">
+ <heading><package>debsums</package></heading>
+ <p>
+<prgn>debsums</prgn> vérifie des paquets installés par rapport à leur somme de
+hachage MD5. Veuillez noter que tous les paquets n'ont pas de sommes MD5 car
+elles ne sont pas requises par la charte.</p>
+ </sect1>
+
+ <sect1 id="dpkg-dev-el">
+ <heading><package>dpkg-dev-el</package></heading>
+<p>
+<package>dpkg-dev-el</package> fournit des macros Emacs Lisp qui apportent une
+ aide lors de l'édition des fichiers du répertoire <file>debian</file> de votre
+ paquet. À l'édition de <file>debian/changelog</file>, par exemple, vous
+ disposez de fonctions pour finaliser une version et consulter la liste des
+ rapports de bogue ouverts.</p>
+</sect1>
+
+
+ <sect1 id="dpkg-depcheck">
+ <heading><package>dpkg-depcheck</package></heading>
+ <p>
+<prgn>dpkg-depcheck</prgn> (du paquet <package>devscripts</package>, <ref
+id="devscripts">) exécute une commande sous <prgn>strace</prgn> pour déterminer
+tous les paquets utilisés par la commande.
+ <p>
+Pour les paquets Debian, c'est utile quand vous devez créer une ligne
+<tt>Build-Depends</tt> pour votre nouveau paquet : exécuter le processus de
+compilation avec <prgn>dpkg-depcheck</prgn> vous fournira une bonne première
+approximation des dépendances de compilation. Par exemple :
+<example>
+dpkg-depcheck -b debian/rules build
+</example>
+ <p>
+<prgn>dpkg-depcheck</prgn> peut aussi être utilisé pour vérifier les dépendances
+d'exécution, particulièrement si votre paquet utilise exec(2) pour exécuter
+d'autres programmes.
+ <p>
+Pour plus d'informations, veuillez voir <manref name="dpkg-depcheck" section="1">.
+ </sect1>
- <sect id="debget">
- <heading><package>debget</package>
+ <sect id="tools-porting">
+ <heading>Outils de portage</heading>
+ <p>
+Les outils suivants facilitent le travail des porteurs et la compilation
+croisée.</p>
+ <sect1 id="quinn-diff">
+ <heading><package>quinn-diff</package></heading>
<p>
-Le paquet <package>debget</package> contient un script qui peut être utile
-pour télécharger des paquets depuis l'archive Debian. Vous pouvez par exemple
-l'utiliser pour télécharger des paquets sources.
-
-
-
-
-
-
-
+<package>quinn-diff</package> est utilisé pour localiser les différences d'une
+ architecture à l'autre. Il pourrait vous dire, par exemple, quels paquets de
+ l'architecture <var>X</var> doivent être portés sur l'architecture
+ <var>Y</var>.
+ <sect1 id="dpkg-cross">
+ <heading><package>dpkg-cross</package></heading>
+<p>
+<package>dpkg-cross</package> est un outil qui installe les bibliothèques et les
+ en-têtes nécessaires à une compilation
+ croisée<footnote><p><em>cross-compilation</em></footnote> d'une manière
+ similaire à <package>dpkg</package>. De plus, les paquets
+ <prgn>dpkg-buildpackage</prgn> et <prgn>dpkg-shlibdeps</prgn> ont été
+ améliorés pour accepter les compilations croisées.
+
+ <sect id="tools-doc">
+ <heading>Documentation et information</heading>
+ <p>
+Les paquets suivants fournissent des informations pour les responsables ou de
+l'aide pour construire de la documentation
+
+ <sect1 id="debiandoc-sgml">
+ <heading><package>debiandoc-sgml</package></heading>
+ <p>
+<package>debiandoc-sgml</package> fournit la DTD DebianDoc SGML qui est
+habituellement utilisée pour la documentation Debian. Ce manuel, par exemple,
+est écrit en DebianDoc. Il fournit également des scripts pour construire et
+décliner le source en de multiples formats de sortie.</p>
+ <p>
+La documentation sur la DTD peut être trouvée dans le paquet
+<package>debiandoc-sgml-doc</package>.</p>
+ </sect1>
+
+ <sect1 id="debian-keyring">
+ <heading><package>debian-keyring</package></heading>
+ <p>
+Contient les clés publiques GPG et PGP des développeurs Debian. Voir <ref
+id="key-maint"> et la documentation du paquet pour plus d'informations.</p>
+ </sect1>
+
+ <sect1 id="debview">
+ <heading><package>debview</package></heading>
+ <p>
+<package>debview</package> fournit un mode Emacs pour voir les paquets binaires
+Debian. Il vous permet d'examiner un paquet sans le décompresser.</p>
+ </sect1>
+ </sect>
+
+
+<!-- FIXME: add the following
+
+questionable:
+ dbs (referred to above)
+ dpatch (referred to above)
+ debarchiver
+ ucf
+ dpkg-awk
+ grep-dctrl
+ d-shlibs
+ wajig
+ magpie
+ apt-dpkg-ref
+ apt-show-source
+ apt-show-versions
+ pdbv
+ epm
+ apt-src
+ apt-build
+
+rejected:
+ debaux: too new, unmaintained?
+ dh-make-perl: too new, unmaintained?
+-->
-</book>
+ </appendix>
+ </book>
</debiandoc>
<!-- Keep this comment at the end of the file
sgml-local-ecat-files:nil
End:
-->
-<!-- vim:set tw=78:ts=8: -->
+
~ianmdlvl / developers-reference.git / blobdiff