Salut à tous, Voici une autre correction du fichier Bugs/Developer.wml
Merci encore à Nicolas Bertolissio pour sa relecture. 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.22" translation_maintainer="Christian Couder <[EMAIL PROTECTED]>"
Informations pour les développeurs concernant le système de traitement des bogues
Initialement, un rapport de bogue est soumis par un utilisateur
comme un message ordinaire à [EMAIL PROTECTED].
Il lui sera alors donné 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 mainteneur connu,
le mainteneur 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.
Fermer un rapport de bogue
Un développeur qui reçoit un bogue du système de gestion, ou qui le voit sur
debian-bugs-dist, et prend la responsabilité de celui-ci
doit répondre à l'aide de son logiciel de courrier préféré,
et modifier le champ To pour y inscrire
nnn[EMAIL PROTECTED] à la place de
nnn@bugs
(nnn-close est fourni comme alias pour
nnn-done).
L'adresse de celui qui a soumis le rapport de bogue sera incluse
dans le champ To par défaut, parce que le système de
gestion des bogues l'a inclus dans le Reply-To.
Les messages « Done » sont automatiquement envoyés à la liste
de diffusion debian-bugs-closed uniquement.
Si d'autres développeurs sont susceptibles d'être intéressés il
peut être parfois utile d'inclure la liste de diffusion
debian-devel@lists.debian.org.
La personne fermant le bogue et la personne l'ayant soumis recevront une notification du changement de statut du rapport.
Messages suivants
Si un développeur souhaite répondre à un rapport de bogue, il peut
simplement répondre au message (cela ne marquera pas le bogue comme
ayant été traité). Sa réponse ira (par défaut s'il respecte le champ
Reply-To:) à nnn@bugs, et à celui qui a
soumis le rapport de bogue original (note : ce sont deux adresses
distinctes). Le système de gestion des bogues recevra le message à
nnn@bugs, le transmettra au mainteneur du
paquet, enregistrera la réponse avec les autres enregistrements
de ce rapport de bogue et le transmettra à debian-bugs-dist.
Un développeur pourra explicitement envoyer un message à celui qui a soumis
le bogue en envoyant un message à
nnn[EMAIL PROTECTED].
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[EMAIL PROTECTED] ou
nnn[EMAIL PROTECTED].
Un message envoyé à nnn[EMAIL PROTECTED] est
enregistré dans le système de gestion des bogues
mais n'est transmis à aucun individu ni aucune liste de diffusion.
Un message envoyé à nnn[EMAIL PROTECTED]
est enregistré dans le système de gestion des bogues
et est transmis au mainteneur 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 d'éditer la liste des destinataires de manière
substantielle.
En particulier, vérifiez que vous n'envoyez pas de réponse à
[EMAIL PROTECTED].
Niveaux de gravité
Le système de bogues enregistre un niveau de gravité avec 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)- rend inexploitables des programmes qui ne lui sont pourtant pas associés ou casse globalement le système ou cause des pertes sévères de données ou, encore, crée une faille dans la sécurité du système.
grave(grave)- 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.
serious(sérieux)- est une sévère violation de la politique Debian (c'est-à-dire qu'il viole une directive « must » ou « required »), ou, dans l'esprit du mainteneur du paquet, rend le paquet inadapté à la livraison.
important(important)- est un bogue ayant un effet majeur sur l'utilité du paquet, tout en ne le rendant pas complètement inutilisable par n'importe qui.
normal(normal)- la valeur par défaut, applicable à la plupart des bogues.
minor(mineur)- un problème qui n'affecte pas l'utilité du paquet, et qui est à priori simple à résoudre.
wishlist(liste de souhaits)- 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.
fixed(corrigé)- 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-mainteneurs. Note : la marque « fixed » devrait être utilisée à la place.
Marques sur les rapports de bogues
Chaque bogue peut avoir zéro, un ou plusieurs ensembles de certaines marques. Ces marques 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 marques 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 marques disponibles actuellement pour les bogues sont :
patch(patch)- Un patch ou une procédure facile à suivre pour résoudre le bogue est incluse dans les enregistrements du bogue. S'il y a un patch mais qu'il ne résoud pas le bogue correctement ou cause d'autres problèmes, cette marque ne devrait pas être utilisée.
wontfix(ne va pas être résolu)- 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 mainteneur 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 causera d'autres problèmes, pires à d'autres, ou peut être pour d'autres raisons.
moreinfo(plus d'info)- 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 ?
unreproducible(non reproductible)- Ce bogue ne peut pas être reproduit sur le système du mainteneur. De l'assistance d'un tiers est nécessaire pour diagnostiquer les causes du problème.
fixed(résolu)- Ce bogue a été résolu ou contourné (par un envoi d'un non-mainteneur, par exemple), mais il reste un problème qui doit être résolu. Cette marque remplace l'ancienne sévérité « fixed ».
security(sécurité)- 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 de façons dont ils ne devraient pas ; attaques par dénis de service qui devraient être résolues, etc). La pluspart des bogues de sécurité devraient aussi être indiqués par une sévérité critique (critical) ou grave (grave).
potato- Ce bogue s'applique particulièrement à la version potato de Debian.
woody- Ce bogue s'applique particulièrement à la version woody (non encore livrée) de woody.
sid- Ce bogue s'applique particulièrement à une architecture qui est pour l'instant non disponible (c'est à dire dans la distribution sid).
Les trois marques 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.
Enregistrer que vous avez traité un rapport de bogue
Quand un développeur envoie un rapport de bogue au développeur du paquet source original depuis lequel le paquet Debian est dérivé, 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[EMAIL PROTECTED] dans le champ
CC.
Demander à l'auteur de garder tel quel le CC vers
nnn[EMAIL PROTECTED] 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 à
[EMAIL PROTECTED].
Résumés postés à debian-bugs-reports
Chaque vendredi une liste de rapports de bogues non encore corrigés est
postée à debian-bugs-reports, triée par date du rapport.
Chaque mardi une liste de rapports de bogues auxquels il n'a pas été répondu
depuis trop longtemps est postée, triée par mainteneur de paquet.
Si le mainteneur d'un paquet est inscrit de manière incorrecte cela
est généralement dû au fait que le mainteneur a changé récemment, et que le
nouveau mainteneur 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 mainteneurs des
archives peuvent écraser à la main les informations concernant le
mainteneur, par exemple si une reconstruction ou une remise à jour du
paquet n'est pas prévue avant un certain temps. Contactez
[EMAIL PROTECTED] pour les modifications du fichier
d'écrasement (override file).
Rouvrir, réassigner et manipuler les bogues
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
gravités et titres des rapports et de fusionner et de diviser des rapports
de bogue. Ceci se fait en envoyant un message à
[EMAIL PROTECTED].
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 seul
peut aussi être obtenue en envoyant le mot help au serveur à
l'adresse ci-dessus.
Possibilités plus ou moins obsolètes d'utiliser l'objet des messages
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
à part cela ignorés.
Fonctionnalité obsolète 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).
