[RFR] webwml://Bugs/Developer.wml [MàJ] [NMU]
On Thu, Aug 04, 2005, Script watching translation state wrote:
> Il suffit donc à quiconque de manifester sur la liste debian-l10n-french
> son intention de mettre à jour le document. Le but étant de pallier
Voici le diff anglais et celui que je viens de commiter.
Merci aux relecteurs.
J'ai gardé "système de gestion des bogues", comme l'écrit Christian dans
le reste du document, même si "système de suivi des bogues" est le terme
utilisé dans le manuel du nouveau responsable ou dans les dwn.
Je joins aussi le fichier complet.
--
adn
Mohammed Adnène Trojette
"La confiance se gagne en gouttes et se perd en litres."
Anonyme
#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.59" 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>submit@bugs.debian.org</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="#owner">Changer le propriétaire d'un 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="#subscribe">S'inscrire à des bogues</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 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.</p>
<p>Les rapports de bogue seront fermés en envoyant un courriel à
<var>nnn</var><code>-done@bugs.debian.org</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>-done@bugs.debian.org</CODE> à la place de
<var>nnn</var><CODE>@bugs.debian.org</CODE>
(<var>nnn</var><CODE>-close</CODE> est fourni comme alias pour
<var>nnn</var><CODE>-done</CODE>).</p>
<p>Quand cela est possible, veuillez fournir une ligne
<code>Version</code> dans les <a
href="Reporting.html#pseudoheader">pseudo-en-têtes</a> de votre message
quand vous fermez un rapport de bogue, de façon à ce que le système
de gestion des bogues connaisse la version du paquet qui contient le
correctif.</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.debian.org</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.debian.org</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>Envoyer un courriel à
<var>nnn</var><code>-submitter\@EmailDomain</code> enverra explicitement
un courriel à la personne qui a soumis le bogue et en placera une copie
dans le système de gestion des bogues. Le message ne sera pas envoyé au
responsable du paquet.</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.debian.org</CODE> ou
<VAR>nnn</VAR><CODE>-maintonly@bugs.debian.org</CODE>.
Un message envoyé à <VAR>nnn</VAR><CODE>-quiet@bugs.debian.org</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.debian.org</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>submit@bugs.debian.org</CODE>.</P>
<P>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 gestion des bogues, voyez les <a
href="Reporting">instructions pour signaler les bogues</a>.</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 <a
href="http://release.debian.org/sarge_rc_policy.txt";>sévère violation
de la charte Debian</a> (grossièrement, 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 <i>a priori</i>
simple à résoudre.
<DT><CODE>wishlist</CODE> (liste de souhaits)
<DD>pour une demande d'une fonctionnalité, et aussi pour
un bogue très difficile à résoudre du fait de la conception du
paquet.
</DL>
<p>Certains niveaux de gravité sont considérés comme <em><a
href="http://bugs.debian.org/release-critical/";>de niveau « critique
pour la sortie de la prochaine version »</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>. Pour connaître les règles complètes et
canoniques qui indiquent quels problèmes méritent ces gravités, voyez
la liste des <a
href="http://release.debian.org/sarge_rc_policy.txt";>problèmes
critiques pour la sortie de Sarge</a>.</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 consultez la
page d'un paquet, et quand vous consultez 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>.
Séparez les différentes étiquettes avec des virgules, des espaces ou les deux.
<p>Les étiquettes actuellement disponibles 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 doit pas être utilisée.
<dt><code>wontfix</code> (ne sera pas corrigé)
<dd>Ce bogue ne sera pas corrigé. 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 solution à ce bogue a été trouvée et une mise à jour sera
faite prochainement.
<dt><code>fixed</code> (résolu)
<dd>Ce bogue a été corrigé 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'ancien niveau de gravité <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 le niveau de gravité 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>confirmed</code> (confirmé)
<dd>Le responsable a examiné le bogue. Il le comprend et il est
fondamentalement d'accord avec lui. Mais il reste au responsable
à le corriger. (L'utilisation de cette étiquette est optionnelle ;
elle est destinée principalement aux responsables qui doivent gérer
un grand nombre de bogues ouverts.)
<dt><code>fixed-upstream</code>
<dd>Le bogue a été corrigé par le développeur amont, mais il n'est pas
encore dans le paquet (pour une raison quelconque : peut-être est-il
trop compliqué de rétroporter le changement ou trop insignifiant pour
que cela vaille la peine de s'en occuper).
<dt><code>fixed-in-experimental</code>
<dd>Le bogue a été corrigé dans le paquet de la distribution
Experimental, mais pas encore dans la distribution
Unstable.
<dt><code>d-i</code>
<dd>Ce bogue concerne le développement de l'installateur Debian.
Il est prévu que cette étiquette soit utilisée quand un bogue affecte
le développement de l'installateur mais qu'il n'est pas rempli contre
un paquet qui fait directement partie de l'installateur.
<dt><code>ipv6</code>
<dd>Ce bogue concerne le support du protocole IPv6 « Internet
Protocol version 6 ».
<dt><code>lfs</code>
<dd>Ce bogue concerne le support des gros fichiers (plus de 2 gigaoctets).
<dt><code>l10n</code>
<dd>Ce bogue concerne la localisation du paquet.
<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 de Debian.
<dt><code>sarge</code>
<dd>Ce bogue s'applique particulièrement à la version Sarge de Debian.
<dt><code>sarge-ignore</code>
<dd>Ce bogue, empêchant l'intégration dans la prochaine version,
doit être ignoré pour les objectifs de publication de Sarge.
<strong>Cette étiquette ne doit être utilisée que par le
responsable de publication ; ne la positionnez pas vous-même sans
son autorisation explicite.</strong>
<dt><code>etch</code>
<dd>Ce bogue s'applique particulièrement à la version Etch (pas encore
publiée).
<dt><code>etch-ignore</code>
<dd>Ce bogue, empêchant l'intégration dans la prochaine version,
doit être ignoré pour les objectifs de publication de Etch.
<strong>Cette étiquette ne doit être utilisée que par le
responsable de publication ; ne la positionnez pas vous-même
sans son autorisation explicite.</strong>
<dt><code>sid</code>
<dd>Ce bogue s'applique particulièrement à une architecture qui n'est
pour l'instant pas disponible (c'est-à-dire dans la distribution Sid).
<dt><code>experimental</code>
<dd>Ce bogue s'applique particulièrement à la version Experimental
de Debian.
</dl>
<p>Les cinq étiquettes qui précèdent sont destinées à être utilisées
principalement pour les bogues interdisant toute intégration,
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>-forwarded@bugs.debian.org</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.debian.org</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, si le bogue n'est pas déjà marqué comme ayant été
transmis.</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="owner">Changer le propriétaire d'un bogue</a></h2>
<p>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 gestion des bogues. Pour aider à
le faire, chaque bogue peut éventuellement avoir un propriétaire.
<p>Le propriétaire peut être désigné en fournissant une ligne
<code>Owner</code> dans le pseudo-en-tête quand le bogue est soumis
(voir les <a href="Reporting#pseudoheader">instructions pour signaler
les bogues</a>), ou en utilisant les commandes <code>owner</code> et
<code>noowner</code> avec le <a href="#requestserv">serveur de requêtes de
contrôle</a>.
<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,
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 <CODE>Maintainer</CODE>
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 <CODE>override-change@debian.org</CODE> pour
les modifications du fichier d'annulation (<i>« override
file »</i>).</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, 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 à
<CODE>control@bugs.debian.org</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 texte peut
aussi être obtenue en envoyant le mot <CODE>help</CODE> au serveur à
l'adresse ci-dessus.</P>
<h2><a name="subscribe">S'inscrire à des bogues</a></h2>
<p>Le système de gestion 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'inscrire
à paquet par le biais du PTS. Tous les messages qui sont reçus sur
<var>nnn</var><code>@debian.org</code> sont envoyés aux abonnés.</p>
<p>S'abonner à un bogue se fait en envoyant un courriel à
<var>nnn</var><code>-subscribe@bugs.debian.org</code>. L'objet et le
corps du courriel sont ignorés par le système de gestion 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.</p>
<p>Il est aussi possible de se désabonner d'un bogue.
Se désabonner se fait en envoyant un courriel à
<var>nnn</var><code>-unsubscribe@bugs.debian.org</code>. L'objet et le
corps du courriel sont une fois encore ignorés par le système de gestion
des bogues. Les utilisateurs recevront un message de confirmation auquel
ils devront répondre s'ils souhaitent être désabonnés du bogue.</p>
<p>Par défaut, l'adresse abonnée est celle qui se trouve
dans l'en-tête <code>From</code>. Si vous souhaitez abonner
une autre adresse à un bogue, vous devrez coder l'adresse à
abonner dans le message d'abonnement. Cela ressemble à :
<var>nnn</var><code>-subscribe-</code><var>adresse</var><code>=</code><var>exemple.com</var> <code>@bugs.debian.org</code>.
Cet exemple enverrait un message d'abonnement au bogue
<var>nnn</var> à <code>adresse@exemple.com</code>. Le signe
arrobase <code>@</code> doit être codée par un signe égal
<code>=</code>. De manière analogue, un désabonnement ressemble à
<var>nnn</var><code>-unsubscribe-</code><var>adresse</var><code>=</code> <var>exemple.com</var> <code>@bugs.debian.org</code>.
Dans les deux cas, l'objet et le corp du courriel seront transmis à
l'adresse électronique dans la requête de confirmation.</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 » (<i>« Subject »</i>) commence par
<CODE>Bug#</CODE><var>nnn</var> seront traités comme ayant été envoyés à
<var>nnn</var><CODE>@bugs.debian.org</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.debian.org</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"
===================================================================
RCS file: /cvs/webwml/webwml/english/Bugs/Developer.wml,v
retrieving revision 1.54
retrieving revision 1.59
diff -u -r1.54 -r1.59
--- webwml/english/Bugs/Developer.wml 2005/06/06 21:16:50 1.54
+++ webwml/english/Bugs/Developer.wml 2005/08/01 16:18:56 1.59
@@ -25,6 +25,7 @@
<li><a href="#owner">Changing bug ownership</a></li>
<li><a href="#maintincorrect">Incorrectly listed package maintainers</a></li>
<li><a href="#requestserv">Reopening, reassigning and manipulating bugs</a></li>
+ <li><a href="#subscribe">Subscribing to bugs</a></li>
<li><a href="#subjectscan">More-or-less obsolete subject-scanning feature</a></li>
<li><a href="#x-debian-pr">Obsolete <code>X-Debian-PR: quiet</code> feature</a></li>
</ul>
@@ -56,6 +57,11 @@
(<VAR>nnn</VAR><CODE>-close</CODE> is provided as an alias for
<VAR>nnn</VAR><CODE>-done</CODE>).</P>
+<p>Where applicable, please supply a <code>Version</code> line in the
+<a href="Reporting.html#pseudoheader">pseudo-header</a> of your message when
+closing a bug, so that the bug tracking system knows which releases of the
+package contain the fix.</p>
+
<p>The person closing the bug, the person who submitted it and the
<code>debian-bugs-closed</code> mailing list will each get a notification
about the change in status of the report. The submitter and the mailing list
@@ -79,8 +85,9 @@
package maintainer, file the reply with the rest of the logs for that bug
report and forward it to <CODE>debian-bugs-dist</CODE>.</P>
-<P>A developer may explicitly mail the bug's submitter with an email to
-<var>nnn</var><code>-submitter@bugs.debian.org</code>.</p>
+<p>Sending a message to <var>nnn</var><code>-submitter\@EmailDomain</code>
+will explicitly email the submitter of the bug and place a copy in the
+Bug tracking system. The message will not be sent to package maintainer.</P>
<P>If you wish to send a followup message which is not appropriate for
<CODE>debian-bugs-dist</CODE> you can do so by sending it to
@@ -342,8 +349,9 @@
<P>It is possible to reassign bug reports to other packages, to reopen
erroneously-closed ones, to modify the information saying to where, if
anywhere, a bug report has been forwarded, to change the severities
-and titles of reports, to set the ownership of bugs and to merge and
-unmerge bug reports. This is done by sending mail to
+and titles of reports, to set the ownership of bugs, to merge and unmerge
+bug reports, and to record the versions of packages in which bugs were
+found and in which they were fixed. This is done by sending mail to
<CODE>control@bugs.debian.org</CODE>.</P>
<P>The <A href="server-control">format of these messages</A> is
@@ -352,6 +360,36 @@
can also be obtained by mailing the word <CODE>help</CODE> to the
server at the address above.</P>
+<h2><a name="subscribe">Subscribing to bugs</a></h2>
+
+<p>The bug tracking system also allows bug submitters, developers and other
+interested third parties to subscribe to individual bugs. This feature can be
+used by those wishing to keep an eye on a bug, without having to subscribe to a
+package through the PTS. All messages that are received at
+<var>nnn</var><code>@debian.org</code>, are sent to subscribers.</p>
+
+<p>Subscribing to a bug can be done by sending an email to
+<var>nnn</var><code>-subscribe@bugs.debian.org</code>. The subject and body of
+the email are ignored by the BTS. Once this message is processed, users are
+sent a confirmation message that they will need to reply to before they are
+sent the messages relating to that bug.</p>
+
+<p>It is also possible to unsubscribe from a bug. Unsubscribing can be done by
+sending an email to <var>nnn</var><code>-unsubscribe@bugs.debian.org</code>. The
+subject and body of the email are again ignored by the BTS. Users will be sent
+a confirmation message which they must reply to if they wish to be unsubscribed
+from the bug.</p>
+
+<p>By default, the address subscribed is the one found in the <code>From</code>
+header. If you wish to subscribe another address to a bug, you will need to
+encode the address to be subscribed into the subscription message. This takes the form of:
+<var>nnn</var><code>-subscribe-</code><var>localpart</var><code>=</code><var>example.com</var><code>@bugs.debian.org</code>.
+That example would send <code>localpart@example.com</code> a subscription message
+for bug <var>nnn</var>. The <code>@</code> sign must be encoded by changing it
+to an <code>=</code> sign. Similarly, a unsubscription takes the form
+<var>nnn</var><code>-unsubscribe-</code><var>localpart</var><code>=</code><var>example.com</var><code>@bugs.debian.org</code>.
+In both cases, the subject and body of the email will be forwarded to the email
+address within the request for confirmation.</p>
<h2><a name="subjectscan">More-or-less obsolete subject-scanning feature</a></h2>
Index: Developer.wml
===================================================================
RCS file: /cvs/webwml/webwml/french/Bugs/Developer.wml,v
retrieving revision 1.40
diff -u -r1.40 Developer.wml
--- Developer.wml 14 Jun 2005 04:36:46 -0000 1.40
+++ Developer.wml 5 Aug 2005 08:44:32 -0000
@@ -1,6 +1,6 @@
#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.54" maintainer="Christian Couder"
+#use wml::debian::translation-check translation="1.59" maintainer="Christian Couder"
<H1>Informations pour les développeurs
@@ -32,6 +32,7 @@
<li><a href="#owner">Changer le propriétaire d'un 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="#subscribe">S'inscrire à des bogues</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>
@@ -63,6 +64,13 @@
(<var>nnn</var><CODE>-close</CODE> est fourni comme alias pour
<var>nnn</var><CODE>-done</CODE>).</p>
+<p>Quand cela est possible, veuillez fournir une ligne
+<code>Version</code> dans les <a
+href="Reporting.html#pseudoheader">pseudo-en-têtes</a> de votre message
+quand vous fermez un rapport de bogue, de façon à ce que le système
+de gestion des bogues connaisse la version du paquet qui contient le
+correctif.</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
@@ -87,9 +95,11 @@
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.debian.org</CODE>.</P>
+<p>Envoyer un courriel à
+<var>nnn</var><code>-submitter\@EmailDomain</code> enverra explicitement
+un courriel à la personne qui a soumis le bogue et en placera une copie
+dans le système de gestion des bogues. Le message ne sera pas envoyé au
+responsable du paquet.</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
@@ -382,11 +392,13 @@
<p>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 et de fusionner et de diviser des rapports
-de bogue. Cela se fait en envoyant un message à
-<CODE>control@bugs.debian.org</CODE>. </p>
+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 à
+<CODE>control@bugs.debian.org</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
@@ -394,6 +406,41 @@
aussi être obtenue en envoyant le mot <CODE>help</CODE> au serveur à
l'adresse ci-dessus.</P>
+<h2><a name="subscribe">S'inscrire à des bogues</a></h2>
+
+<p>Le système de gestion 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'inscrire
+à paquet par le biais du PTS. Tous les messages qui sont reçus sur
+<var>nnn</var><code>@debian.org</code> sont envoyés aux abonnés.</p>
+
+<p>S'abonner à un bogue se fait en envoyant un courriel à
+<var>nnn</var><code>-subscribe@bugs.debian.org</code>. L'objet et le
+corps du courriel sont ignorés par le système de gestion 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.</p>
+
+<p>Il est aussi possible de se désabonner d'un bogue.
+Se désabonner se fait en envoyant un courriel à
+<var>nnn</var><code>-unsubscribe@bugs.debian.org</code>. L'objet et le
+corps du courriel sont une fois encore ignorés par le système de gestion
+des bogues. Les utilisateurs recevront un message de confirmation auquel
+ils devront répondre s'ils souhaitent être désabonnés du bogue.</p>
+
+<p>Par défaut, l'adresse abonnée est celle qui se trouve
+dans l'en-tête <code>From</code>. Si vous souhaitez abonner
+une autre adresse à un bogue, vous devrez coder l'adresse à
+abonner dans le message d'abonnement. Cela ressemble à :
+<var>nnn</var><code>-subscribe-</code><var>adresse</var><code>=</code><var>exemple.com</var> <code>@bugs.debian.org</code>.
+Cet exemple enverrait un message d'abonnement au bogue
+<var>nnn</var> à <code>adresse@exemple.com</code>. Le signe
+arrobase <code>@</code> doit être codée par un signe égal
+<code>=</code>. De manière analogue, un désabonnement ressemble à
+<var>nnn</var><code>-unsubscribe-</code><var>adresse</var><code>=</code> <var>exemple.com</var> <code>@bugs.debian.org</code>.
+Dans les deux cas, l'objet et le corp du courriel seront transmis à
+l'adresse électronique dans la requête de confirmation.</p>
<H2><a name="subjectscan">Possibilités plus ou moins obsolètes d'utiliser l'objet des messages</a></H2>
Reply to: