Table des matières

Reportbug

Introduction

Reportbug est une application proposée par l'équipe Debian pour signaler des bogues aux mainteneurs des paquets. Afin que le bogue soit résolu, et que le rapport soit utile, il faut être précis, fournir le maximun d'information et être prêt à aider le mainteneur.
Tout cela pour faciliter le traitement de votre bogue et trouver une solution le plus rapidement possible.

La communication se fait en Anglais, il faut donc savoir le lire et l'écrire.
Si vous ne maîtrisez pas la langue de Shakespeare, demandez de l'aide sur le forum dans la section “Contribution à Debian, packaging, traductions, bugs, etc”.

Identifier le bogue

Avant toute chose, il faut savoir reproduire le bogue afin de bien l'identifier.

Collecter les informations

Applications en ligne de commande et mode verbose:

Les applications Open Source communiquent beaucoup sous forme de petits messages, surtout quand elles rencontrent des erreurs. Il est possible de voir ces messages en lançant l'application en ligne de commande dans un terminal.

vlc

Certaines applications disposent souvent d'un mode plus verbeux, où l'on pourra voir plus de message.

vlc -v
On peut savoir comment activer les modes verbeux en consultant les manuels des applications avec man vlc ou vlc -h

Il est aussi possible de diriger les messages d'erreurs de l'application dans un fichier texte afin d'en garder une trace:

vlc -v 2> log.txt

Journaux système et application:

Les applications systèmes travaillent le plus souvent en fond de tâche, il faudra passer par les fichiers journaux pour consulter leurs messages.
Ils se présentent, le plus souvent, sous forme texte dans le dossier /var/log.
On peut voir les fichiers se remplir en temps réél avec la commande tail -f, cela peut être utile :

tail -f /var/log/messages

Connaître le paquet

Identifier le paquet concerné

Si dans le message d'erreur, on a la mention d'une erreur à propos d'un fichier, on peut identifier à quel paquet il appartient avec la commande dpkg -S :

dpkg -S /usr/share/vlc/utils/audio-vlc-default.sh
retour de la commande
vlc-data: /usr/share/vlc/utils/audio-vlc-default.sh

Ici, le fichier qui pose problème est donc lié au paquet vlc-data et non au paquet vlc. La nuance permettra d'affecter la fiche bogue au bon paquet.

Utiliser la dernière version du paquet

Toujours, avant de se lancer dans l'ouverture d'un nouveau bug, il est bon de vérifier qu'il n'a pas déjà été signalé ou qu'il n'est pas déjà résolu.
Il est donc important d'avoir une machine à jour et de vérifier que l'on a bien la dernière version du paquet disponible.

On peut voir les différentes versions du paquet disponible dans l'encart “Versions” du tracker Debian, comme ici pour VLC : https://tracker.debian.org/pkg/vlc

Que l'on peut comparer avec celle que l'on a d'installé sur sa machine :

apt-cache policy vlc

Chercher un bogue identique

Avant de créer le bogue, l'application reportbug devrait vous montrer les bogues existant. Vous pouvez aussi les consulter en ligne pour chaque application. Ils sont accessibles depuis l'encart “Bugs” du tracker debian : https://tracker.debian.org/pkg/vlc

En parler sur le forum

Avant de se lancer dans l'ouverture d'un bogue, il est important d'en parler sur le forum en remontant les informations que vous aurez récoltés comme indiqué plus haut.

N'hésitez pas à créer un message dans la section “Contribution à Debian, packaging, traductions, bugs, etc” du forum.

Installer et configurer Reportbug

Reportbug est l'application de référence pour déclarer un bug aux équipes Debian. Il est possible de déclarer un bogue par courriel directement, mais ce sera toujours plus propre, et plus complet en passant par reportbug.

Installer reportbug

Si ce n'est pas déjà fait, pour installer reportbug, il suffit de taper :

apt-get install reportbug

Configurer reportbug

reportbug dispose de plusieurs mode, nécessite une adresse mail pour déclarer les bogues et il est mieux vu de les déclarer avec son vrai nom (real name).
Il est possible de configurer cela au premier lancement, avec :

reportbug --configure

Ou encore en éditant le fichier ~/.reportbugrc
Il est possible de choisir l'interface texte ou graphique en jouant sur le paramètre ui (ui gtk2 ou ui text par exemple).

Rapporter un bogue

Afin de lancer rapporter un bogue lié à un paquet, il suffit de lancer :

reportbug nom-de-mon-paquet

Une fois lancé, reportbug vous guidera à chaque étape, voici les questions proposées pour le niveau “Standard”:

Liens

1)
N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !