[Relu] Fichier du répertoire Bugs
Un dernier fichier relu par Joël
Bugs/Developer.wml
A+,
Christian.
#use wml::debian::template title="Gestion des bogues Debian - informations pour les développeurs" NOHEADER=yes NOCOPYRIGHT=true
#use wml::debian::translation-check translation="1.32" maintainer="Christian Couder"
<H1>Informations pour les développeurs
concernant le système de traitement des bogues</H1>
<P>Initialement, un rapport de bogue est soumis par un utilisateur
comme un message ordinaire à
<CODE><a href="mailto:submit@bugs.debian.org";>submit@bugs.debian.org</a>
</CODE>.
Ce rapport recevra un numéro, un accusé de réception sera envoyé
à l'utilisateur, et il sera transmis à
<CODE>debian-bugs-dist</CODE>. Si celui qui a soumis le rapport a
inclus une ligne
<CODE>Package</CODE> indiquant un paquet ayant un responsable connu,
le responsable recevra aussi une copie.</P>
<P>La ligne <CODE>Subject</CODE> se verra rajouter
<CODE>Bug#</CODE><var>nnn</var><CODE>:</CODE>, et le
<CODE>Reply-To</CODE> sera modifié pour inclure à la fois celui qui
a soumis le rapport et <var>nnn</var><CODE>@bugs.debian.org</CODE>.</P>
<hrline>
<ul>
<li><a href="#closing">Fermer un rapport de bogue</a></li>
<li><a href="#followup">Destinataires des messages</a></li>
<li><a href="#severities">Niveaux de gravité</a></li>
<li><a href="#tags">Étiquettes pour les rapports de bogues</a></li>
<li><a href="#forward">Enregistrer que vous avez traité un rapport de bogue</a></li>
<li><a href="#maintincorrect">Responsables de paquet mal énoncés</a></li>
<li><a href="#requestserv">Rouvrir, réassigner ou utiliser un rapport de bogue</a></li>
<li><a href="#subjectscan">Possibilités plus ou moins obsolètes d'utiliser l'objet des messages</a></li>
<li><a href="#x-debian-pr">Fonctionnalité obsolète <code>X-Debian-PR: quiet</code></a></li>
</ul>
<hrline>
<h2><a name="closing">Fermer un rapport de bogue</a></h2>
<p>Un rapport de bogue devrait être fermé quand le problème est corrigé.
On peut considérer qu'un problème dans un paquet est corrigé seulement quand
le paquet qui comporte la correction est entré dans l'archive Debian.
</p>
<p>Normalement, seuls celui qui a envoyé le rapport et le responsable ou les
responsables du paquet concerné ont le droit de fermer un rapport de bogue.
Il y a des exceptions à cette règle ; par exemple, les rapport concernant
des paquets inconnus ou concernant des pseudo paquets génériques. En cas de
doute, demandez de l'aide sur la liste debian-devel.</p>
<p>Les rapports de bogues seront fermés en envoyant un courriel à
<var>nnn</var><code><a href="mailto:-done@bugs.debian.org";>-done@bugs.debian.org</a></code>. Le corps du message doit contenir l'explication de la correction
du bogue.</p>
<p>Avec les courriels reçus du système de gestion de bogues, il suffit, pour
fermer un rapport de bogue, de répondre à l'aide de son logiciel de courrier
préféré, et de modifier le champ <CODE>To</CODE> pour y inscrire
<var>nnn</var><CODE><a href="mailto:-done@bugs.debian.org";>-done@bugs.debian.org</a></CODE> à la place de
<var>nnn</var><CODE>@bugs</CODE>
(<var>nnn</var><CODE>-close</CODE> est fourni comme alias pour
<var>nnn</var><CODE>-done</CODE>).</p>
<p>La personne qui a soumis le rapport de bogue, celle qui l'a fermé et la
liste <code>debian-bugs-closed</code> seront informées du changement d'état
du rapport. La personne qui a soumis le rapport de bogue et la liste recevront
en outre le contenu du message envoyé à <var>nnn</var><code>-done</code>.</p>
<h2><a name="followup">Destinataires des messages</a></h2>
<p>Le système de gestion des bogues indique l'adresse de la personne qui a
soumis le rapport de bogue et l'adresse du rapport
(<var>nnn</var><code>@bugs</code>) dans le champ <code>Reply-To</code>
après avoir fait suivre le rapport de bogue. Veuillez
remarquer que ce sont deux adresses différentes.</p>
<p>Si un développeur souhaite répondre à un rapport de bogue, il peut
simplement répondre au message, en respectant l'en-tête <code>Reply-To</code>.
Cela <strong>ne fermera pas</strong> le rapport.
</p>
<p> Le système de gestion des bogues recevra le message
avec <VAR>nnn</VAR><CODE>@bugs</CODE>, l'enverra au responsable de paquet,
enregistrera la réponse avec les autres enregistrements pour ce rapport de
bogue et fera suivre à <CODE>debian-bugs-dist</CODE>.</p>
<P>Un développeur pourra explicitement envoyer un message à celui qui a soumis
le bogue en envoyant un message à
<var>nnn</var><CODE>-submitter@bugs</CODE>.</P>
<P>Si vous souhaitez envoyer un message de réponse qui n'est pas
approprié pour <CODE>debian-bugs-dist</CODE> vous pouvez le faire en
l'envoyant à <var>nnn</var><CODE>-quiet@bugs</CODE> ou
<VAR>nnn</VAR><CODE>-maintonly@bugs</CODE>. Un message envoyé à
<VAR>nnn</VAR><CODE>-quiet@bugs</CODE> est enregistré dans le système
de gestion des bogues mais n'est transmis à personne ni à aucune liste
de diffusion. Un message envoyé à
<VAR>nnn</VAR><CODE>-maintonly@bugs</CODE> est enregistré dans le
système de gestion des bogues ; il n'est transmis qu'au responsable du paquet
en question.</P>
<P>N'utilisez <em>pas</em> les fonctions « répondre à tous les
destinataires » ou « transférer » de votre logiciel de courrier sauf
si vous avez l'intention de modifier la liste des destinataires de
manière substantielle. En particulier, vérifiez que vous n'envoyez
pas de réponse à <CODE><a href="mailto:submit@bugs.debian.org";>submit@bugs.debian.org</a></CODE>.</P>
<h2><A name="severities">Niveaux de gravité</A></h2>
<P>Le système de bogues enregistre un niveau de gravité pour chaque
rapport de bogue. Celui-ci est mis à <CODE>normal</CODE> par défaut,
mais peut être modifié soit en fournissant une ligne
<CODE>Severity</CODE> dans le pseudo-en-tête quand le bogue est soumis
(voir <A href="Reporting#pseudoheader">les instructions pour signaler
les bogues</A>), soit en utilisant la commande <CODE>severity</CODE>
avec le <A href="#requestserv">serveur de requêtes de
contrôle</A>.</P>
<P>Les niveaux de gravité sont :
<DL>
<DT><CODE>critical</CODE> (critique)
<DD>rend inexploitable des programmes qui ne lui sont pourtant pas
associés, ou casse globalement le système, ou cause de sévères pertes
de données, ou encore crée une faille dans la sécurité du système.
<DT><CODE>grave</CODE> (grave)
<DD>rend le paquet en question inutilisable ou presque, ou cause
des pertes de données, ou introduit une faille de sécurité permettant l'accès
aux comptes des utilisateurs qui se servent du paquet.
<DT><CODE>serious</CODE> (sérieux) <DD>est une sévère violation de la
politique Debian (c'est-à-dire qu'il viole une directive
<i>« must »</i> ou <i>« required »</i>), ou, dans l'esprit du responsable
du paquet, rend le paquet indistribuable.
<DT><CODE>important</CODE> (important)
<DD>est un bogue ayant un effet majeur sur l'utilité du paquet, tout
en ne le rendant pas complètement inutilisable.
<DT><CODE>normal</CODE> (normal)
<DD>la valeur par défaut, applicable à la plupart des bogues.
<DT><CODE>minor</CODE> (mineur)
<DD>un problème qui n'affecte pas l'utilité du paquet, et qui est à priori
simple à résoudre.
<DT><CODE>wishlist</CODE> (liste de souhaits)
<DD>pour n'importe quelle demande d'une fonctionnalité, et aussi pour
n'importe quel bogue très difficile à résoudre du fait de la conception du
paquet.
<DT><CODE>fixed</CODE> (corrigé)
<DD>pour les bogues qui ont été corrigés mais ne devraient pas encore être
fermés. C'est une exception faite pour les bogues résolus par des
envois de non responsables. Note : l'étiquette « fixed » devrait être
utilisée à la place.
</DL>
<p>Certains niveaux de gravité sont considérés comme <em><a
href="http://bugs.debian.org/release-critical/";>de niveau « édition
entière »</a></em> ; c'est-à-dire que le bogue influera sur
l'introduction du paquet dans la version stable de
Debian. Actuellement, ce sont les niveaux <strong>critical</strong>,
<strong>grave</strong> et <strong>serious</strong>.</p>
<H2><a name="tags">Étiquettes sur les rapports de bogues</a></H2>
<p>Chaque bogue peut avoir zéro, un ou plusieurs ensembles d'étiquettes.
Ces étiquettes sont affichées dans la liste des bogues quand vous regardez la
page d'un paquet, et quand vous regardez l'enregistrement complet du bogue.
<p>Les étiquettes peuvent être indiquées en fournissant une ligne
<code>Tags</code> dans le pseudo-en-tête quand le bogue est soumis (voyez les
<a href="Reporting#pseudoheader">instructions pour signaler des bogues</a>),
ou en utilisant la commande <code>tags</code> avec le
<a href="#requestserv">serveur de requêtes de contrôle</a>.
<p>Les étiquettes disponibles actuellement pour les bogues sont :
<dl>
<dt><code>patch</code> (rustine)
<dd>Une rustine ou une procédure facile à suivre pour résoudre le bogue
est incluse dans les enregistrements du bogue. S'il y a une rustine
mais qu'elle ne résout pas le bogue correctement ou cause d'autres
problèmes, cette étiquette ne devrait pas être utilisée.
<dt><code>wontfix</code> (ne va pas être résolu)
<dd>Ce bogue ne sera pas résolu. Peut-être parce que c'est un choix
entre deux façons arbitraires de faire les choses et que le responsable
et celui qui a soumis le bogue préfèrent des façons différentes de
faire les choses, peut-être parce que changer le fonctionnement
entraînera des problèmes plus graves pour certains, ou peut-être pour
d'autres raisons.
<dt><code>moreinfo</code> (plus d'info)
<dd>Ce bogue ne peut pas être résolu tant que des informations
supplémentaires n'auront pas été fournies par celui qui a soumis le bogue.
Ce bogue sera fermé si celui qui l'a soumis ne fournit pas plus
d'informations pendant une période de temps raisonnable (quelques
mois). C'est pour les bogues du type « Ça ne marche pas ».
Qu'est-ce qui ne marche pas ?
<dt><code>unreproducible</code> (non reproductible)
<dd>Ce bogue ne peut pas être reproduit sur le système du responsable.
L'assistance d'un tiers est nécessaire pour diagnostiquer les
causes du problème.
<dt><code>help</code> (aide)
<dd>Le responsable demande de l'aide pour traiter ce bogue.
<dt><code>pending</code> (en cours)
<dd>Une action est activement menée concernant le problème décrit
dans le rapport de bogue, <i>i.e.</i> une solution est en cours.
<dt><code>fixed</code> (résolu)
<dd>Ce bogue a été résolu ou contourné (par un envoi d'un non-responsable,
par exemple), mais il reste un problème qui doit être résolu. Cette marque
remplace l'ancienne sévérité <i>« fixed »</i>.
<dt><code>security</code> (sécurité)
<dd>Ce bogue décrit un problème de sécurité dans un paquet (par
exemple, mauvaises permissions permettant l'accès à des données
qui ne devraient pas être accessibles ; dépassement de limite de
tampon permettant à des gens de prendre le contrôle d'un système
par des moyens illicites ; attaques par dénis de service
qui devraient être résolues, etc.). La plupart des bogues de sécurité
devraient aussi être signalés par une sévérité critique
(<i>« critical »</i>) ou grave (<i>« grave »</i>).
<dt><code>upstream</code> (original)
<dd>Ce bogue concerne la partie originale du paquet (et non la
partie Debian).
<dt><code>Potato</code>
<dd>Ce bogue s'applique particulièrement à la version Potato de Debian.
<dt><code>Woody</code>
<dd>Ce bogue s'applique particulièrement à la version Woody (non encore
livrée) de Debian.
<dt><code>Sid</code>
<dd>Ce bogue s'applique particulièrement à une architecture qui est
pour l'instant non disponible (c'est-à-dire dans la distribution Sid).
</dl>
<p>Les trois étiquettes qui précèdent sont destinées à être utilisées
principalement pour les bogues critiques pour la sortie de la version,
pour lesquels il est important de savoir quelles distributions sont
affectées afin d'appliquer les corrections (ou les suppressions) au
bon endroit.
<h2><A name="forward">Enregistrer que vous avez traité un rapport de bogue</A></h2>
<P>Quand un développeur envoie un rapport de bogue au développeur du
paquet source original duquel est dérivé le paquet Debian, il devrait
noter cela dans le système de gestion de la manière suivante :</P>
<P>S'assurer que le champ <CODE>To</CODE> de son message à l'auteur
ne comporte que l'adresse du ou des auteurs ; mettre à la fois la personne qui
a rapporté le bogue et
<var>nnn</var><CODE><a href="mailto:-forwarded@bugs.debian.org";>-forwarded@bugs.debian.org</a></CODE> dans le champ <CODE>CC</CODE>.</P>
<P>Demander à l'auteur de garder tel quel le <CODE>CC</CODE> vers
<var>nnn</var><CODE>-forwarded@bugs</CODE> quand il répond, de
façon à ce que le système de gestion des bogues enregistre sa réponse
avec le rapport original.</P>
<P>Quand le système de gestion des bogues reçoit un message à
<var>nnn</var><CODE>-forwarded</CODE> il marquera le bogue correspondant
comme ayant été transmis à(aux) adresse(s) dans le champ <CODE>To</CODE> du
message qu'il reçoit.</P>
<P>Vous pouvez aussi manipuler les informations « forwarded to » en envoyant
des messages à
<A href="server-control"><CODE>control@bugs.debian.org</CODE></A>.</P>
<H2><a name="maintincorrect">Responsables de paquet mal énoncés</a></H2>
<p>Si le responsable d'un paquet est inscrit de manière incorrecte, cela
est généralement dû au fait que le responsable a changé récemment, et que le
nouveau responsable n'a pas encore soumis une nouvelle version du paquet
avec le champ de contrôle <CODE>Maintainer</CODE> modifié. Cela sera
corrigé quand le paquet sera remis à jour ; autrement, les responsables des
archives peuvent annuler à la main les informations concernant le
responsable, par exemple si une reconstruction ou une remise à jour du
paquet n'est pas prévue avant un certain temps. Contactez
<CODE><a href="mailto:override-change@debian.org";>override-change@debian.org</a></CODE> pour les modifications du fichier d'annulation (override file).</p>
<H2><A name="requestserv">Rouvrir, réassigner ou utiliser un rapport de bogue</A></H2>
<p>Il est possible de réassigner des rapports de bogues à d'autres paquets,
de rouvrir des bogues fermés par erreur, de modifier l'information disant
où, s'il y a lieu, un rapport de bogue a été transmis, de changer les
niveaux de gravité et les titres des rapports et de fusionner et de diviser
des rapports de bogue. Ceci se fait en envoyant un message à
<CODE><a href="mailto:control@bugs.debian.org";>control@bugs.debian.org</a>
</CODE>.
</p>
<P>Le <A href="server-control">format de ces messages</A> est décrit
dans un autre document disponible sur la Toile ou dans le fichier
<CODE>bug-maint-mailcontrol.txt</CODE>. Une version en texte pur peut
aussi être obtenue en envoyant le mot <CODE>help</CODE> au serveur à
l'adresse ci-dessus.</P>
<H2><a name="subjectscan">Possibilités plus ou moins obsolètes d'utiliser l'objet des messages</a></H2>
<P>Les messages qui arrivent à <CODE>submit</CODE> ou <CODE>bugs</CODE> et
dont le champ « Objet » (Subject) commence par
<CODE>Bug#</CODE><var>nnn</var> seront traités comme ayant été envoyés à
<var>nnn</var><CODE>@bugs</CODE>. Ceci pour
assurer la compatibilité ascendante avec les messages envoyés depuis les
anciennes adresses, et pour récupérer les réponses envoyées à
<CODE>submit</CODE> par erreur (par exemple, en utilisant la commande
« répondre à tous les destinataires »).</P>
<P>Un schéma identique opère pour <CODE>maintonly</CODE>,
<CODE>done</CODE>, <CODE>quiet</CODE> et <CODE>forwarded</CODE>,
qui traite les messages arrivant avec un tel « Objet » comme ayant été
envoyés à l'adresse correspondante
<var>nnn-XXXXXX</var><CODE>@bugs</CODE>.</P>
<P>Les messages arrivant à <CODE>forwarded</CODE> et <CODE>done</CODE>
sans identificateur — <i>i.e.</i>, sans numéro de rapport de
bogue dans l'adresse — et sans numéro de bogue dans l' « Objet »
seront enregistrés sous <i>« junk »</i> et gardés pendant quelques
semaines, mais néanmoins ignorés.</P>
<H2><a name="x-debian-pr">Fonctionnalité obsolète <CODE>X-Debian-PR: quiet</CODE></a></H2>
<P>Il était possible d'empêcher le système de gestion des bogues de
transmettre les messages qu'il recevait à <CODE>debian-bugs</CODE>,
en mettant une ligne <CODE>X-Debian-PR: quiet</CODE> dans l'en-tête
du message.</P>
<P>Cette ligne d'en-tête est maintenant ignorée. À la place, envoyez votre
message à <CODE>quiet</CODE> ou <var>nnn</var><CODE>-quiet</CODE> (ou
<CODE>maintonly</CODE> ou <var>nnn</var><CODE>-maintonly</CODE>).</P>
<HR>
#use "otherpages.inc"
#use "$(ENGLISHDIR)/Bugs/footer.inc"
Reply to: