[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Correction d'un fichier du répertoire Bugs

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"

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 à 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.

Fermer un rapport de bogue

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.

Destinataires des messages

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.

Niveaux de gravité

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)
rend inexploitables 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.
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 responsable du paquet, rend le paquet indistribuable.
important (important)
est un bogue ayant un effet majeur sur l'utilité du paquet, tout en ne le rendant pas complètement inutilisable.
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 responsables. Note : l'étiquette « fixed » devrait être utilisée à la place.

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.

Étiquettes sur les rapports de bogues

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)
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.
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 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.
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 responsable. L'assistance d'un tiers est nécessaire pour diagnostiquer les causes du problème.
help (aide)
Le responsable demande de l'aide pour traiter ce bogue.
pending (en cours)
Une action est activement menée concernant le problème décrit dans le rapport de bogue, i.e. une solution est en cours.
fixed (résolu)
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é « 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 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 (« critical ») ou grave (« grave »).
upstream (original)
Ce bogue concerne la partie originale du paquet (et non la partie Debian).
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 Debian.
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 é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.

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 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.

Responsables de paquet mal énoncés

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).

Rouvrir, réassigner ou utiliser un rapport de bogue

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.

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 néanmoins 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).

#use "otherpages.inc" #use "$(ENGLISHDIR)/Bugs/footer.inc"
Reply to: