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.
Avant toute chose, il faut savoir reproduire le bogue afin de bien l'identifier.
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
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
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
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
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.
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
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
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.
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.
Si ce n'est pas déjà fait, pour installer reportbug, il suffit de taper :
apt-get install 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).
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”:
Getting status for glpi... Checking for newer versions at madison...
Will send report to Debian (per lsb_release). Querying Debian BTS for reports on glpi (source)... 8 bug reports found: ....
Looking up dependencies of glpi... Getting changed configuration files...
Briefly describe the problem (max. 100 characters allowed). This will be the bug email subject, so keep the summary as concise as possible, for example: "fails to send email" or "does not start with -q option specified" (enter Ctrl+c to exit reportbug without reporting a bug).
How would you rate the severity of this problem or report? 1 critical makes unrelated software on the system (or the whole system) break, or causes serious data loss, or introduces a security hole on systems where you install the package. 2 grave makes the package in question unusable by most or all users, or causes data loss, or introduces a security hole allowing access to the accounts of users who use the package. 3 serious is a severe violation of Debian policy (that is, the problem is a violation of a 'must' or 'required' directive); may or may not affect the usability of the package. Note that non-severe policy violations may be 'normal,' 'minor,' or 'wishlist' bugs. (Package maintainers may also designate other bugs as 'serious' and thus release-critical; however, end users should not do so.). For the canonical list of issues worthing a serious severity you can refer to this webpage: http://release.debian.org/wheezy/rc_policy.txt . 4 important a bug which has a major effect on the usability of a package, without rendering it completely unusable to everyone. 5 does-not-build a bug that stops the package from being built from source. (This is a 'virtual severity'.) 6 normal a bug that does not undermine the usability of the whole package; for example, a problem with a particular option or menu item. 7 minor things like spelling mistakes and other minor cosmetic errors that do not affect the core functionality of the package. 8 wishlist suggestions and requests for new features.
Do any of the following apply to this report? 1 d-i This bug is relevant to the development of debian-installer. 2 ipv6 This bug affects support for Internet Protocol version 6. 3 l10n This bug reports a localization/internationalization issue. 4 lfs This bug affects support for large files (over 2 gigabytes). 5 patch You are including a patch to fix this problem. 6 upstream This bug applies to the upstream part of the package. 7 none
Dear Maintainer, *** Reporter, please consider answering these questions, where appropriate *** * What led up to the situation? * What exactly did you do (or not do) that was effective (or ineffective)? * What was the outcome of this action? * What outcome did you expect instead? *** End of the template - remove these template lines ***
Un fois le texte validé, le rapport sera envoyé sur https://www.debian.org/Bugs/ , vous recevrez automatiquement une copie sur votre boite mail.