Rapporter un bogue
Un article de Wiki de la communauté Mandriva.
[modifier] Système de signalement de bogues
Le système utilisé par Mandriva Linux pour que les utilisateurs et autres testeurs puissent signaler un bogue est Bugzilla.
[modifier] Avant de rapporter un bogue
[modifier] Utilisez la dernière version du programme
Vérifiez que vous utilisez la dernière version du programme avant de soumettre un nouveau rapport de bogue. Votre problème est peut-être déjà résolu dans une version ultérieure à celle que vous utilisez.
Les logiciels intégrés à Mandriva Linux sont disponibles sous forme de paquetages RPM qui contiennent une liste des évolutions apportées au programme en question. Vous pouvez facilement consulter cette liste en utilisant le gestionnaire de paquetage 
drakrpm.
Toujours essayer la dernière version d'un logiciel avant de rapporter un bogue ; ne pas rapporter de bogues au sujet d'anciennes versions.
[modifier] Effectuer une recherche sur Mandriva Bugzilla
Rappelez-vous que des centaines de bogues sont rapportés quotidiennement ! Votre problème a peut-être déjà été signalé, pensez à faire une recherche minutieuse sur http://qa.mandriva.com avant de rapporter votre bogue !
Effectuez une recherche sur Mandriva Bugzilla afin de vous assurer que le problème auquel vous êtes confronté n'a pas déjà été rapporté, voire résolu. Notez bien que les doublons représentent une perte de temps considérable pour les développeurs.
Par défaut, Bugzilla n'effectue pas de recherche parmi les bogues marqués RÉSOLU. Vous pouvez étendre la recherche à tous les bogues en sélectionnant ALL dans le menu déroulant intitulé Status de la page de recherche simplifiée. Vous pourriez découvrir que votre bogue a déjà été rapporté, résolu et corrigé dans une version plus récente du paquetage. Notez que vous pouvez aussi effectuer une recherche avancée en utilisant des critères très précis.
Si vous n'êtes pas un habitué de Bugzilla, listez tous les bogues rapportés pour le programme qui vous pose problème. Observez attentivement cette liste. Si un vous découvrez un sujet se rapportant à votre problème, ajoutez un commentaire en décrivant votre problème. Si vous désirez uniquement suivre le bug sans commenter, vous pouvez voter pour celui-ci et vous serez tenu au courant des évolutions du rapport de bug.
Ceci doit être effectué en vue d'éviter les doublons. Un seul rapport de bogue bien fourni donne une meilleure image du problème que plusieurs rapports éparpillés.
[modifier] Soumettre un nouveau rapport de bogue
Si vous avez effectué des recherches pour vous assurer que votre rapport de bogue est le tout premier sur ce sujet,
[modifier] Créer un compte Mandriva Bugzilla
Pour être en mesure de rapporter un bogue, vous devez ouvrir un compte Mandriva Bugzilla. Cliquez sur Open a new Bugzilla account afin de remplir le formulaire d'enregistrement.
Les comptes standards ont des privilèges qui vous permettent d'ajouter un bogue, d'ajouter des commentaires à des bogues existants et de changer le statut de bogues qui ont été créés avec ce compte.
[modifier] Créer un nouveau rapport de bug
- Choisissez le lien New en haut à gauche
- La plupart du temps, vous devrez sélectionner Mandriva Linux. Vous pouvez aussi rentrer un bug à propos du système de compilation des paquetages ou de bugzilla lui-même.
[modifier] Ecrire un rapport de bug
- Choisissez le composant global que votre bug cible. "Core Packages" est à choisir la plupart du temps.
- Indiquez avec soin la version de Mandriva Linux que vous utilisez. Prenez garde, si vous laissez le défaut "Cooker", cela signifie que vous demandez à ce que le bug soit réglé dans la version de développement "cooker". Si vous précisez une version stable de Mandriva Linux, le bug sera d'abord résolu dans Cooker, puis rétroporté dans la version stable (s'il est accepté). Des bugs mineurs ou des bugs qui remettent en cause l'interface d'un outil Mandriva ou le fonctionnement complet de Mandriva Linux sont plutôt du domaine de la version de développement "Cooker".
- Ensuite, identifiez le paquetage source en cause. Pour cela, il faut penser que le bug nécessitera pour sa résolution l'application d'un patch sur un certain fichier (de configuration, binaire ou autre). Une fois que vous avez identifié ce fichier, tapez
rpm -qf chemin_fichier --qf '%{SOURCERPM}\n'en remplaçant chemin_fichier par le chemin vers le fichier lui-même. Vérifiez bien aussi que vous possédez la dernière version du paquetage pour votre version de Mandriva Linux, sinon le bug pourrait être refusé. - Si votre rapport de bug fait référence à un fil démarré dans le forum, mentionner le lien dans "URL". Si vous avez trouvé le bug équivalent à celui-ci sur le bugzilla d'un autre projet, mentionner l'URL aussi dans le champ "URL".
- Entrer une description simple de votre bug dans "Summary" tout en étant un minimum explicite
- Dans "details" veuillez rentrer la description du problème. Indiquez votre matériel et la sortie de
lspcidrake -v
, si c'est un problème lié au matériel. Si vous voulez préciser la version d'autres composants impliqués, mentionnez-le dans le second paragraphe. Mentionnez aussi s'il s'agit d'un problème qui apparaît de "temps en temps" au hasard, ou sous quelles conditions il se produit. Enfin, si possible, indiquez une démarche à suivre simple qui fait apparaître le bug à coup sûr. Mentionnez aussi si vous savez précisément à partir de quel version du paquetage le problème a été introduit. - La sévérité est l'importance de ce bug par rapport au composant impliqué. Cela ne signifie pas l'importance du bug dans la distribution entière. Par exemple, une icône pixelisée pour firefox, sera dans "trivial" et un crash dans une application très peu utilisée sera quand même dans "critical". Il existe un deuxième facteur qui sera appliqué par l'équipe de gestion des bugs Mandriva (et qui n'est donc pas visible) qui est la "priorité" : celle-ci tiendra compte de l'importance de l'application, mais ce n'est pas au rapporteur du bogue de juger de cette dernière. Ainsi, pour reprendre l'exemple précédent, le problème d'icône pour firefox aura une priorité plus élevée ou quasi-égale au crash dans une application très peu utilisée.
- Sauf dans des cas très compliqués, vous n'avez généralement rien d'autre à indiquer et le bug sera automatiquement assigné à l'équipe ou au contributeur adéquat. Vous pouvez donc cliquer sur "Submit Bug Report".
[modifier] Chercher soi-même la solution
Par tous les moyens, essayez de résoudre vous-même le problème et proposer ainsi une correction de bogue ! Une caractéristique fabuleuse du logiciel Open Source est que vous n'avez pas à attendre qui que ce soit pour corriger un bogue - vous pouvez le faire vous-même.
Vous pouvez proposer un début de solution, une idée ou même un patch ou demi-patch. Toute contribution est bienvenue.
[modifier] Documents joints au rapport de bogue
Si vous avez un fichier de données qui est relié à votre problème (par ex. un fichier MP3 qui ne fonctionne pas avec xmms), vous pouvez le joindre à votre rapport de bogue. Lorsqu'il s'agit d'un bug "graphique", une copie d'écran est aussi la bienvenue. Faire cela accélère la résolution du bogue.
[modifier] Quand votre bogue est soumis pour correction
Les rapports de bogue ont différents statuts définis par mots-clés quand ils sont en traitement :
[modifier] Cycle de vie d'un bogue
+---------<------------+
| |
NEW (nouveau) --->-- NEEDINFO (besoin d'infos)
|
|---------<------------+
| |
ASSIGNED(assigné)-->-- NEEDINFO
|
|
RESOLVED (résolu)
(FIXED, INVALID, DUPLICATE, WONTFIX, WORKSFORME) (corrigé, invalide, doublon, sans_suite, bogue_non_reproductible)
[modifier] Statut NEW (nouveau)
Votre bogue est confirmé (ou : le mainteneur est d'accord qu'il y a un vrai problème) et attend pour être attribué à un mainteneur de logiciel spécifique.
[modifier] Statut ASSIGNED (assigné)
Un mainteneur de logiciel spécifique a été assigné pour traiter le rapport de bogue.
[modifier] Statut NEEDINFO (besoin d'informations)
Il manque des informations, et le mainteneur les attend. Les mainteneurs accordent une faible priorité aux bogues avec le statut NEEDINFO, puisqu'ils ne peuvent réaliser le correctif avant que l'information ne soit fournie. Ce statut est indiqué par un "mot clé" et non pas par un statut "normal" du bug. Une fois que vous fournissez l'information manquante, supprimez le mot clé pour que le mainteneur sache que le bogue doit être réexaminé.
[modifier] Statut RESOLVED/DUPLICATE (résolu, doublon)
Le mainteneur pense que ce bogue fait doublon avec un autre. C'est votre travail de lire soigneusement le rapport de bogue original et, si ce n'est pas vraiment un doublon, vous devez fournir des informations supplémentaires et rouvrir votre rapport de bogue
Un exemple de faux statut DUPLICATE est ici - 
bug n°9450, bug n°4629.
[modifier] Statut RESOLVED/INVALID (résolu, invalide)
Le mainteneur pense que ce n'est pas un bogue. Peut-être qu'il est normal que le logiciel fonctionne ainsi ; ou, peut-être que quelque chose ne va pas sur votre ordinateur pour le faire fonctionner ainsi. Si vous n'êtes pas d'accord, rouvrez le rapport de bogue et fournissez des informations supplémentaires.
[modifier] Statut RESOLVED/WORKSFORME (résolu, fonctionne pour moi)
Le mainteneur ne peut pas reproduire le bogue.
[modifier] Statut RESOLVED/OLD (résolu, ancien)
La version mentionnée n'est plus supportée, ou le bogue n'est plus d'application (lorsque le système "autour du bug" a totalement changé, par exemple).
[modifier] Contacter les mainteneurs de logiciels
Oui, votre rapport de bogue est important. Cependant, d'autres rapports sont peut-être plus importants que le vôtre ! Si vous ne pouvez pas résoudre le problème vous-même, vous devrez patienter pendant que le mainteneur cherchera une solution.
Merci de ne pas harceler les mainteneurs en les contactant trop souvent à propos de votre bogue. Si vous pensez que votre bogue est important, cherchez d'autres personnes pouvant corroborer le problème et compléter la description de ce dernier. Les bogues importants sont ceux qui affectent un grand nombre de personnes.
[modifier] Pour plus d'information
Les liens suivant (en anglais) apportent un complément d'information sur la gestion des bogues avec Mandriva Linux :
