#use wml::debian::template title="Suivi des bogues Debian - informations pour les développeurs" NOHEADER=yes NOCOPYRIGHT=true #use wml::debian::translation-check translation="1.80" maintainer="Guillaume Delacour" # Premier traducteur: Cyril Brulebois
Initialement, un rapport de bogue est soumis par un utilisateur
comme un message ordinaire à
submit@bugs.debian.org
.
Ce rapport recevra un numéro, un accusé de réception sera envoyé
à l'utilisateur, et il sera transmis à
debian-bugs-dist
. Si celui qui a soumis le rapport a
inclus une ligne
Package
indiquant un paquet ayant un responsable connu,
le responsable recevra aussi une copie.
Bug#
nnn:
sera ajouté à la ligne
Subject
, et l'en-tête
Reply-To
sera modifié pour inclure à la fois celui qui
a soumis le rapport et nnn@bugs.debian.org
.
X-Debian-PR: quiet
Un rapport de bogue devrait être fermé quand le problème est corrigé. On ne peut considérer qu'un problème dans un paquet est corrigé que lorsque le paquet qui comporte la correction est entré dans l'archive Debian.
Normalement, seuls celui qui a envoyé le rapport et le responsable ou les responsables du paquet concerné devraient fermer un rapport de bogue. Il y a des exceptions à cette règle ; par exemple, les rapports 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.
Les rapports de bogue seront fermés en envoyant un courriel à
nnn-done@bugs.debian.org
. Le corps du message doit contenir l'explication de la correction
du bogue.
Avec les courriels reçus du système de suivi 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 l'en-tête To
pour y inscrire
nnn-done@bugs.debian.org
à la place de
nnn@bugs.debian.org
(nnn-close
est fourni comme alias pour
nnn-done
).
Quand cela est possible, veuillez fournir une ligne
Version
dans les pseudo-en-têtes de votre message
quand vous fermez un rapport de bogue, de façon à ce que le système
de suivi des bogues connaisse la version du paquet qui contient le
correctif.
La personne qui a soumis le rapport de bogue, celle qui l'a fermé et la
liste debian-bugs-closed
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é à nnn-done
.
Le système de suivi des bogues indique l'adresse de la personne
qui a soumis le rapport de bogue et l'adresse du rapport
(nnn@bugs.debian.org
) dans l'en-tête
Reply-To
après avoir fait suivre le rapport de
bogue. Veuillez remarquer que ce sont deux adresses différentes.
Si un développeur souhaite répondre à un rapport de bogue, il peut
simplement répondre au message, en respectant l'en-tête Reply-To
.
Cela ne fermera pas le rapport.
Le système de suivi des bogues recevra le message avec
nnn@bugs.debian.org
, l'enverra au responsable
de paquet, enregistrera la réponse avec les autres enregistrements
pour ce rapport de bogue et fera suivre à
debian-bugs-dist
.
Envoyer un courriel à
nnn-submitter@bugs.debian.org
enverra explicitement
un courriel à la personne qui a soumis le bogue et en placera une copie
dans le système de suivi des bogues. Le message ne sera pas envoyé au
responsable du paquet.
Si vous souhaitez envoyer un message de réponse qui n'est pas
approprié pour debian-bugs-dist
vous pouvez le faire en
l'envoyant à nnn-quiet@bugs.debian.org
ou
nnn-maintonly@bugs.debian.org
.
Un message envoyé à nnn-quiet@bugs.debian.org
est enregistré dans le système de suivi des bogues mais n'est
transmis à personne ni à aucune liste de diffusion. Un message envoyé
à nnn-maintonly@bugs.debian.org
est enregistré dans le
système de suivi des bogues ; il n'est transmis qu'au responsable du
paquet en question.
N'utilisez pas 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 à submit@bugs.debian.org
.
Pour plus d'informations sur les en-têtes permettant de supprimer les accusés de réception et sur les moyens d'envoyer des copies de messages en utilisant le système de suivi des bogues, voyez les instructions pour signaler les bogues.
Le système de bogues enregistre un niveau de gravité pour chaque
rapport de bogue. Celui-ci est mis à normal
par défaut,
mais peut être modifié soit en fournissant une ligne
Severity
dans le pseudo-en-tête quand le bogue est soumis
(voir les instructions pour signaler
les bogues), soit en utilisant la commande severity
avec le serveur de requêtes de
contrôle.
Les niveaux de gravité sont :
critical
(critique)grave
(grave)serious
(sérieux)important
(important)normal
(normal)minor
(mineur)wishlist
(liste de souhaits)Certains niveaux de gravité sont considérés comme de niveau « critique pour la sortie de la prochaine version » ; c'est-à-dire que le bogue influera sur l'introduction du paquet dans la version stable de Debian. Actuellement, ce sont les niveaux critical, grave et serious. Pour connaître les règles complètes et canoniques qui indiquent quels problèmes méritent ces gravités, voyez la liste des problèmes critiques pour la sortie de Lenny.
Chaque bogue peut avoir zéro, un ou plusieurs ensembles d'étiquettes. Ces étiquettes sont affichées dans la liste des bogues quand vous consultez la page d'un paquet, et quand vous consultez l'enregistrement complet du bogue.
Les étiquettes peuvent être indiquées en fournissant une ligne
Tags
dans le pseudo-en-tête quand le bogue est soumis (voyez les
instructions pour signaler des bogues),
ou en utilisant la commande tags
avec le
serveur de requêtes de contrôle.
Séparez les différentes étiquettes avec des virgules, des espaces ou
les deux.
Les étiquettes actuellement disponibles sont :
patch
(rustine)wontfix
(ne sera pas corrigé)moreinfo
(plus d'info)unreproducible
(non reproductible)help
(aide)pending
(en cours)fixed
(résolu)security
(sécurité)upstream
(original)confirmed
(confirmé)fixed-upstream
fixed-in-experimental
d-i
ipv6
lfs
l10n
potato
woody
sarge
sarge-ignore
etch
etch-ignore
lenny
lenny-ignore
squeeze
squeeze-ignore
sid
experimental
La signification des 8 dernières étiquettes a changé récemment ; les étiquettes du type *-ignore permettent d'ignorer le bogue afin de pouvoir continuer à intégrer des paquets dans la distribution testing. Les étiquettes ayant le nom d'une distribution, qui indiquaient précédemment uniquement quels bogues affectaient une version spécifique, indiquent maintenant quand le bogue peut être archivé et les différentes versions pour lesquelles un bogue peut être considéré comme trouvé ou résolu.
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 suivi de la manière suivante :
S'assurer que l'en-tête To
de son message à l'auteur
ne comporte que l'adresse du ou des auteurs ; mettre la personne
qui a rapporté le bogue,
nnn-forwarded@bugs.debian.org
et nnn@bugs.debian.org
dans l'en-tête CC
.
Demander à l'auteur de garder tel quel le CC
vers
nnn-forwarded@bugs.debian.org
quand il répond,
de façon à ce que le système de suivi des bogues enregistre sa réponse
avec le rapport original. Ces messages sont simplement enregistrés et
ne sont pas renvoyés ; pour que les messages soient renvoyés
normalement, envoyez-les ausi à
nnn@bugs.debian.org
.
Quand le système de suivi des bogues reçoit un message à
nnn-forwarded
il marquera le bogue correspondant
comme ayant été transmis à(aux) adresse(s) dans l'en-tête To
du
message qu'il reçoit, si le bogue n'est pas déjà marqué comme ayant été
transmis.
Vous pouvez aussi manipuler les informations
« forwarded to » en envoyant des messages à
control@bugs.debian.org
.
Dans les cas où la personne responsable de la correction d'un bogue n'est pas le responsable du paquet associé (par exemple, quand le paquet est maintenu par une équipe), il peut être utile d'enregistrer cette information dans le système de suivi des bogues. Pour aider à le faire, chaque bogue peut éventuellement avoir un propriétaire.
Le propriétaire peut être désigné en fournissant une ligne
Owner
dans le pseudo-en-tête quand le bogue est soumis
(voir les instructions pour signaler
les bogues), ou en utilisant les commandes owner
et
noowner
avec le serveur de requêtes de
contrôle.
Si le responsable d'un paquet est inscrit de manière incorrecte,
c'est généralement dû au fait que le responsable a changé récemment,
et que le nouveau responsable n'a pas encore envoyé une nouvelle
version du paquet avec le champ de contrôle Maintainer
modifié. Cela sera corrigé quand le paquet sera mis à jour ;
autrement, les responsables des archives peuvent annuler à la main les
informations concernant le responsable, par exemple si une
reconstruction ou une mise à jour du paquet n'est pas prévue avant un
certain temps. Contactez override-change@debian.org
pour
les modifications du fichier d'annulation (« override
file »).
Il est possible de réassigner des rapports de bogues à d'autres
paquets, de rouvrir des bogues fermés par erreur, de modifier, s'il y
a lieu, l'information disant où un rapport de bogue a été transmis,
de changer les niveaux de gravité et les titres des rapports, de
déclarer le propriétaire d'un bogue, de fusionner et de diviser
des rapports de bogue, et d'enregistrer les numéros de version
des paquets dans lesquelles les bogues ont été trouvés et celles
où ils ont été corrigés. Cela se fait en envoyant un message à
control@bugs.debian.org
.
Le format de ces messages est décrit
dans un autre document disponible sur la Toile ou dans le fichier
bug-maint-mailcontrol.txt
. Une version texte peut
aussi être obtenue en envoyant le mot help
au serveur à
l'adresse ci-dessus.
Le système de suivi des bogues permet aussi à ceux qui ont soumis
le bogue, aux développeurs et aux tiers intéressés de s'abonner à des
bogues en particulier. Cette fonctionnalité peut être utilisée par
ceux qui souhaitent garder un œil sur un bogue, sans avoir à
s'abonner à un paquet par le biais du
PTS.
Tous les messages reçus sur
nnn@bugs.debian.org
sont envoyés aux abonnés.
S'abonner à un bogue se fait en envoyant un courriel à
nnn-subscribe@bugs.debian.org
. L'objet et le
corps du courriel sont ignorés par le système de suivi des bogues.
Une fois le message traité, les utilisateurs reçoivent un message de
confirmation auquel ils devront répondre avant de pouvoir recevoir les
messages en relation avec ce bogue.
Il est aussi possible de se désabonner d'un bogue.
Se désabonner se fait en envoyant un courriel à
nnn-unsubscribe@bugs.debian.org
. L'objet et le
corps du courriel sont une fois encore ignorés par le système de suivi
des bogues. Les utilisateurs recevront un message de confirmation auquel
ils devront répondre s'ils souhaitent être désabonnés du bogue.
Par défaut, l'adresse abonnée est celle qui se trouve
dans l'en-tête From
. Si vous souhaitez abonner
une autre adresse à un bogue, vous devrez coder l'adresse à
abonner dans le message d'abonnement. Cela ressemble à :
nnn-subscribe-
\
adresse=
\
exemple.com@bugs.debian.org
.
Cet exemple enverrait un message d'abonnement au bogue
nnn à adresse@exemple.com
. Le signe
arobase @
doit être codée par un signe égal
=
. De manière analogue, un désabonnement ressemble à
nnn-unsubscribe-
\
adresse=
\
exemple.com@bugs.debian.org
.
Dans les deux cas, l'objet et le corp du courriel seront transmis à
l'adresse électronique dans la requête de confirmation.
Les messages qui arrivent à submit
ou bugs
et
dont l'en-tête « Objet » (« Subject ») commence par
Bug#
nnn seront traités comme ayant été envoyés à
nnn@bugs.debian.org
. 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 à
submit
par erreur (par exemple, en utilisant la commande
« répondre à tous les destinataires »).
Un schéma identique opère pour maintonly
,
done
, quiet
et forwarded
,
qui traite les messages arrivant avec un tel « Objet » comme ayant été
envoyés à l'adresse correspondante
nnn-XXXXXX@bugs.debian.org
.
Les messages arrivant à forwarded
et done
sans identificateur — i.e., sans numéro de rapport de
bogue dans l'adresse — et sans numéro de bogue dans l'« Objet »
seront enregistrés sous « junk » et gardés pendant quelques
semaines, mais néanmoins ignorés.
X-Debian-PR:
quiet
Il était possible d'empêcher le système de suivi des bogues de
transmettre les messages qu'il recevait à debian-bugs
,
en mettant une ligne X-Debian-PR: quiet
dans l'en-tête
du message.
Cette ligne d'en-tête est maintenant ignorée. À la place, envoyez votre
message à quiet
ou nnn-quiet
(ou
maintonly
ou nnn-maintonly
).