Mise =?iso-8859-1?Q?=E0?= jour du =?iso-8859-1?Q?r=E9pertoire?= Bugs

Tue, 20 Nov 2001 16:40:04 -0600 

Salut à tous,

Denis, finalement j'ai eu le temps de mettre à jour les fichiers
suivants :

Bugs/index.wml
Bugs/Reporting.wml

Merci d'avance pour les relectures.

A+,
Christian
#use wml::debian::template title="Système de gestion des bogues Debian" BARETITLE=true NOCOPYRIGHT=true #use wml::debian::translation-check translation="1.39" maintainer="Christian Couder"

Debian a un système de gestion des bogues (bug tracking system ou BTS en anglais) dans lequel nous enregistrons les détails des bogues rapportés par les utilisateurs et les développeurs. Chaque bogue reçoit un numéro, et est répertorié dans un fichier jusqu'à ce qu'il soit marqué comme ayant été traité.

Documentation du système de gestion des bogues

Examiner les rapports de bogues sur la Toile

Trouver un bogue par son numéro :

Trouver les bogues par :

(Only fill in one of the following forms)

  • paquet :
  • paquet source:
  • adresse électronique du responsable :
  • adresse électronique de celui qui l'a soumis :

Autres paramètres (que vous pouvez laisser tels quels, les valeurs par défaut étant correctes) : #include "$(ENGLISHDIR)/Bugs/pkgreport-opts.inc"

Les requêtes ci-dessus peuvent aussi être lancées en visitant des urls de la forme suivante, respectivement :

  • http://bugs.debian.org/numéro
  • http://bugs.debian.org/paquet
  • http://bugs.debian.org/src:paquetsource
  • http://bugs.debian.org/[EMAIL PROTECTED]
  • http://bugs.debian.org/from:[EMAIL PROTECTED]

Les index de rapports de bogues suivants sont disponibles :

Note : une partie des index des rapports de bogues disponible précédemment n'est plus disponible à cause de problèmes internes avec le programme qui les génère. Nous nous excusons de la gène occasionnée. #include "footer.inc" #use wml::debian::template title="Gestion des bogues Debian - signaler les bogues" NOHEADER=yes NOCOPYRIGHT=true #use wml::debian::translation-check translation="1.25" maintainer="Christian Couder"

Comment signaler un bogue dans Debian

Choses importantes à noter avant de signaler un bogue

S'il vous plaît, ne signalez pas plusieurs bogues sans lien entre eux - en particulier s'ils affectent des paquets différents - dans le même rapport de bogue.

Vous devriez vérifier que votre bogue n'a pas déjà été signalé par quelqu'un d'autre avant de le soumettre. Les listes des bogues non encore résolus sont disponibles sur la Toile et ailleurs - voyez la documentation pour plus de détails. Vous pouvez envoyer vos commentaires concernant un rapport de bogue existant n°<numéro> en envoyant un message à <numéro>@bugs.debian.org

Si vous ne pouvez pas déterminer de quel paquet vient le problème, merci d'envoyer un message électronique à la liste de diffusion des utilisateurs de Debian en demandant conseil. Si votre problème n'est pas lié à un unique paquet mais à des services généraux de Debian, il y a plusieurs pseudo-paquets ou même des listes de diffusion que vous pouvez utiliser pour nous faire part de vos messages.

Merci d'utiliser une méthode différente pour envoyer vos rapports de bogues à d'autres destinataires (comme les listes de diffusion), et non les en-têtes habituels de messages.

Utiliser un outil automatique pour envoyer un rapport de bogue

Deux programmes développés par Debian facilitent le signalement de bogues : bug et reportbug. Ces deux programmes vous guideront pas à pas à travers le processus de signalement de bogue, et faciliteront probablement le remplissage du rapport.

Envoyer le rapport de bogue par courrier électronique

Envoyez un message à [EMAIL PROTECTED], comme décrit ci-dessous.

Bien sûr, comme pour tout message électronique, vous inclurez une ligne Objet claire et descriptive dans votre en-tête principal de message électronique. L'objet que vous donnez est utilisé comme le titre initial dans le système de gestion des bogues, aussi merci d'essayer de le rendre informatif !

Vous devez mettre un pseudo-en-tête au début du corps du message. Cela signifie que la première ligne du message devrait être : 

Package: <un_truc>

Remplacez <un_truc> par le nom du paquet défectueux.

La deuxième ligne du message devrait être : 

Version: <un_truc>

Remplacez <un_truc> par la version du paquet.

Vous devez fournir une ligne Package correcte dans le pseudo-en-tête pour que le système de gestion des bogues délivre le message au responsable du paquet. Voyez cet exemple pour savoir comment trouver cette information.

Les champs du pseudo-en-tête devraient commencer au tout début de leur ligne. L'actuel système de gestion des bogues ne comprend pas correctement les messages MIME ou PGP et peut échouer à reconnaître les pseudo-en-têtes dans de tels courriers.

S'il vous plaît, incluez dans votre rapport :

  • Le texte exact et complet de tout message d'erreur affiché ou enregistré. C'est très important !
  • Ce que vous avez exactement tapé ou fait pour faire apparaître le problème.
  • Une description du comportement incorrect : ce que vous attendiez exactement, et ce que vous avez observé. Une transcription d'une session d'exemple est un bon moyen de montrer cela.
  • Une suggestion de correction, ou même une rustine, si vous en avez.
  • Les détails de la configuration du programme posant problème. Incluez le texte complet de son fichier de configuration.
  • Les versions de tous les paquets desquels dépend le paquet défectueux.
  • Quelle version du noyau vous utilisez (tapez uname -a), votre bibliothèque C partagée (tapez ls -l /lib/libc.so.6 ou dpkg -s libc6 | grep ^Version), et tout autre renseignement sur votre système Debian, si cela semble approprié. Par exemple, si vous avez eu un problème avec un script Perl, vous pourriez fournir la version du binaire « perl » (tapez perl -v ou dpkg -s perl-5.005 | grep ^Version:)
  • Les renseignements appropriés sur votre matériel. Si vous rapportez un problème avec un pilote de périphérique, merci de décrire tout le matériel de votre système, car les problèmes sont souvent causés par des conflits d'IRQ et d'adresse E/S.

Incluez tout détail qui semble lié - il y a très peu de risque de rendre votre rapport trop long en incluant trop d'informations. S'ils sont petits, merci d'inclure dans votre rapport tout fichier que vous avez utilisé pour reproduire le problème (en les uuencodant s'ils peuvent contenir des caractères spéciaux).

Exemple

Un rapport de bogue, avec un en-tête de message, ressemble à quelque chose comme ceci : 

  To: [EMAIL PROTECTED]
  From: [EMAIL PROTECTED]
  Subject: Hello says `goodbye'

  Package: hello
  Version: 1.3-16

  When I invoke `hello' without arguments from an ordinary shell
  prompt it prints `goodbye', rather than the expected `hello, world'.
  Here is a transcript:

  $ hello
  goodbye
  $ /usr/bin/hello
  goodbye
  $

  I suggest that the output string, in hello.c, be corrected.

  I am using Debian GNU/Linux 2.2, kernel 2.2.17-pre-patch-13
  and libc6 2.1.3-10.

Note du traducteur : Pour information, une traduction complète de ce message pourrait être : 

  A: [EMAIL PROTECTED]
  De: [EMAIL PROTECTED]
  Objet: Hello affiche « goodbye »

  Package: hello
  Version: 1.3-2

  Quand je lance « hello »  sans arguments depuis un shell ordinaire
  cela affiche « goodbye », plutôt que le « hello, world » attendu.
  Voici une transcription :

  $ hello
  goodbye
  $ /usr/bin/hello
  goodbye
  $

  Je suggère que la chaîne de caractère en sortie, dans hello.c, soit corrigée.

  J'utilise Debian 1.1, noyau version 1.3.99.15z
  et libc 5.2.18.3.2.1.3-beta.

Envoyer des copies de rapports de bogue à d'autres adresses

Il est parfois nécessaire d'envoyer une copie d'un rapport de bogue ailleurs qu'à debian-bugs-dist et au responsable du paquet, auxquels le rapport est normalement envoyé.

Vous pourriez faire cela en utilisant les autres adresses dans le champ Copies-À (CC en anglais) de votre logiciel de messagerie, mais alors les autres copies n'auraient pas de numéro de rapport de bogue mis dans le champ Répondre-À (Reply-To en anglais) et dans la ligne Objet (Subject en anglais). Quand les destinataires répondront ils garderont probablement l'entrée [EMAIL PROTECTED] dans l'en-tête et verront leur message enregistré comme un nouveau rapport de bogue. Cela engendre beaucoup de rapports dupliqués.

La bonne manière de procéder est d'utiliser l'en-tête X-Debbugs-CC. Ajoutez une ligne comme celle ci à votre en-tête de message (pas au pseudo-en-tête contenant le champ Package) : 

 X-Debbugs-CC: [EMAIL PROTECTED]
Cela fera envoyer par le système de gestion des bogues une copie de votre rapport à l'adresse (aux adresses) de la ligne X-Debbugs-CC aussi bien qu'à debian-bugs-dist.

Cette fonctionnalité peut souvent être utilement combinée avec le code de message quiet - voyez ci-dessous.

Niveaux de gravité

Si un rapport concerne un bogue particulièrement grave, ou si c'est plutôt une demande de fonctionnalité, vous pouvez indiquer un niveau de gravité pour le bogue lorsque vous le signalez. Ce n'est cependant pas indispensable et les développeurs assigneront un niveau de gravité approprié à votre rapport si vous ne le faites pas.

Pour indiquer un niveau de gravité mettez une ligne comme celle-ci dans le pseudo-en-tête : 

Severity: <gravité>

Remplacez <gravité> par l'un des niveaux de gravité disponible, comme décrit dans la documentation des développeurs.

Autres adresses pour le signalement (rapports de bogues mineurs ou multiples)

Si un rapport de bogue est mineur, par exemple, une coquille dans la documentation ou tout autre problème trivial de compilation, merci d'indiquer correctement la gravité et de l'envoyer à [EMAIL PROTECTED] au lieu de [EMAIL PROTECTED]. maintonly enverra le rapport au seul responsable du paquet, il ne l'enverra pas aux listes de diffusion du système de gestion des bogues.

Si vous soumettez plusieurs rapports à la fois, vous devriez certainement utiliser [EMAIL PROTECTED] afin de ne pas causer trop de trafic redondant sur les listes de diffusion du système de gestion des bogues. Avant d'envoyer beaucoup de bogues similaires vous devriez peut-être poster un résumé sur debian-bugs-dist.

Si vous souhaitez signaler au système de gestion des bogues un bogue qui a déjà été envoyé au responsable, vous pouvez utiliser [EMAIL PROTECTED]. Les bogues envoyés à [EMAIL PROTECTED] ne sont pas transmis, seulement enregistrés.

Quand vous utilisez une adresse autre que l'adresse [EMAIL PROTECTED] pour soumettre un rapport de bogue, le système de gestion des bogues remplira le champ Reply-To de tout message transmis de façon à ce que les réponses soient par défaut traitées de la même manière que le rapport original. Cela signifie par exemple que les réponses à maintonly iront à nnn[EMAIL PROTECTED] au lieu de nnn@bugs, sauf bien sûr si quelqu'un modifie le champ manuellement.

Rapports de bogues concernant des paquets inconnus

Si le système de gestion des bogues ne peut trouver qui est le responsable du paquet concerné il enverra le rapport à debian-bugs-dist même si le code maintonly a été utilisé.

Quand vous envoyez un message à [EMAIL PROTECTED] ou nnn[EMAIL PROTECTED] vous devriez vérifier que le rapport de bogue est assigné au bon paquet, en remplissant correctement le champ Package en haut de la soumission originale d'un rapport, ou en utilisant le service [EMAIL PROTECTED] pour tout d'abord (ré)assigner correctement le rapport si ce n'est pas déjà correct.

Utiliser dpkg pour trouver le paquet et sa version pour le rapport

Si vous signalez un bogue dans une commande, vous pouvez déterminer quel paquet l'a installée en utilisant dpkg --search. Vous pouvez trouver la version d'un paquet que vous avez installé en utilisant dpkg --list ou dpkg --status.

Par exemple : 

$ which apt-get
/usr/bin/apt-get
$ type apt-get
apt-get is /usr/bin/apt-get
$ dpkg --search /usr/bin/apt-get
apt: /usr/bin/apt-get
$ dpkg --list apt
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Installed/Config-files/Unpacked/Failed-config/Half-installed
|/ Err?=(none)/Hold/Reinst-required/X=both-problems (Status,Err: uppercase=bad)
||/ Name           Version        Description
+++-==============-==============-============================================
ii  apt            0.3.19         Advanced front-end for dpkg
$ dpkg --status apt
Package: apt
Status: install ok installed
Priority: standard
Section: base
Installed-Size: 1391
Maintainer: APT Development Team <[EMAIL PROTECTED]>
Version: 0.3.19
Replaces: deity, libapt-pkg-doc (<< 0.3.7), libapt-pkg-dev (<< 0.3.7)
Provides: libapt-pkg2.7
Depends: libapt-pkg2.7, libc6 (>= 2.1.2), libstdc++2.10
Suggests: dpkg-dev
Conflicts: deity
Description: Advanced front-end for dpkg
 This is Debian's next generation front-end for the dpkg package manager.
 It provides the apt-get utility and APT dselect method that provides a
 simpler, safer way to install and upgrade packages.
  .
 APT features complete installation ordering, multiple source capability
 and several other unique features, see the Users Guide in
 /usr/doc/apt/guide.text.gz
#use "otherpages.inc" #use "footer.inc"

Répondre à