Même remerciements à Philippe et Nicolas pour le fichier (commité) suivant : 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"
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.
La ligne Subject
se verra rajouter
Bug#
nnn:
, et le
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 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.
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.
Les rapports de bogues 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 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 To
pour y inscrire
nnn-done@bugs.debian.org
à la place de
nnn@bugs
(nnn-close
est fourni comme alias pour
nnn-done
).
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 gestion des bogues indique l'adresse de la personne qui a
soumis le rapport de bogue et l'adresse du rapport
(nnn@bugs
) dans le champ 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 gestion des bogues recevra le message
avec nnn@bugs
, 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
.
Un développeur pourra explicitement envoyer un message à celui qui a soumis
le bogue en envoyant un message à
nnn-submitter@bugs
.
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
ou
nnn-maintonly@bugs
. Un message envoyé à
nnn-quiet@bugs
est enregistré dans le système
de gestion des bogues mais n'est transmis à personne ni à aucune liste
de diffusion. Un message envoyé à
nnn-maintonly@bugs
est enregistré dans le
système de gestion 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
.
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)
fixed
(corrigé)
Certains niveaux de gravité sont considérés comme de niveau « édition entière » ; 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.
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.
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.
Les étiquettes disponibles actuellement pour les bogues sont :
patch
(rustine)
wontfix
(ne va pas être résolu)
moreinfo
(plus d'info)
unreproducible
(non reproductible)
help
(aide)
pending
(en cours)
fixed
(résolu)
security
(sécurité)
upstream
(original)
Potato
Woody
Sid
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.
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 :
S'assurer que le champ To
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
nnn-forwarded@bugs.debian.org
dans le champ CC
.
Demander à l'auteur de garder tel quel le CC
vers
nnn-forwarded@bugs
quand il répond, de
façon à ce que le système de gestion des bogues enregistre sa réponse
avec le rapport original.
Quand le système de gestion des bogues reçoit un message à
nnn-forwarded
il marquera le bogue correspondant
comme ayant été transmis à(aux) adresse(s) dans le champ To
du
message qu'il reçoit.
Vous pouvez aussi manipuler les informations « forwarded to » en envoyant
des messages à
control@bugs.debian.org
.
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 Maintainer
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
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 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 à
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 en texte pur peut
aussi être obtenue en envoyant le mot help
au serveur à
l'adresse ci-dessus.
Les messages qui arrivent à submit
ou bugs
et
dont le champ « Objet » (Subject) commence par
Bug#
nnn seront traités comme ayant été envoyés à
nnn@bugs
. 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
.
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 gestion 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
).