Référence du développeur Debian
Chapitre 10 - Gérer les bogues

10.1 Superviser les rapports de bogues

Si vous voulez être un bon responsable, consultez régulièrement la page du système de suivi des bogues. Cette page contient tous les rapports de bogue qui concernent vos paquets.

Les responsables interagissent avec le système de suivi des bogues en utilisant l'adresse électronique bugs.debian.org. Vous trouverez une documentation sur les commandes disponibles à l'adresse http://www.debian.org/Bugs/ ou, si vous avez installé le paquet doc-debian, dans les fichiers locaux /usr/share/doc/debian/bug-*.

Certains trouvent utile de recevoir régulièrement une synthèse des rapports de bogues ouverts. Si vous voulez recevoir une synthèse hebdomadaire relevant tous les rapports de bogue ouverts pour vos paquets, vous pouvez configurer cron comme suit :

     # Synthèse hebdomadaire des rapports de bogue qui me concernent
     0 17 * * fri   echo "index maint address" | mail request@bugs.debian.org

Remplacez address par votre adresse officielle de responsable Debian.

10.2 Ouvrir un rapport de bogue

En tant que responsable Debian, vous trouvez des bogues dans d'autres paquets En tant que responsable Debian, vous trouvez des bogues dans d'autres paquets, ou bien vous voulez réassigner à d'autres paquets des rapports de bogue concernant vos paquets. La page d'aide du système de suivi des bogues vous explique comment procéder.

Nous vous encourageons à ouvrir des rapports de bogue s'il y a des problèmes. Essayez de soumettre ces rapports depuis un compte utilisateur où vous pouvez recevoir du courrier. Ne les envoyez pas en tant que root.

Vérifiez que le bogue n'a pas encore été déclaré. Essayez de faire un travail propre en déclarant le bogue et en l'envoyant à la bonne adresse.

Pour faire encore mieux, vous pouvez consulter d'autres paquets, grouper les bogues qui ont été rapportés plusieurs fois ou affecter la gravité corrigé (i.e. fixed) à un rapport dont le bogue a été corrigé. Attention, quand vous n'êtes ni le rapporteur d'un bogue ni le responsable du paquet vous ne devez pas clore le rapport (à moins que vous n'ayez l'autorisation du responsable).

10.3 Répondre à des rapports de bogues

Assurez-vous que toutes vos discussions concernant les bogues sont envoyées au rapporteur du bogue et au bogue lui-même (123@bugs.debian.org par exemple).

Vous ne devez jamais fermer un rapport de bogue en envoyant la commande close à l'adresse :

control@bugs.debian.org

Si vous le faites, le rapporteur n'aura aucun retour sur la clôture de son rapport.

10.4 Quand les rapports sont fermés par une mise à jour

Si vous corrigez un bogue dans vos paquets, il est de votre responsabilité de fermer le rapport de bogue associé. Pourtant vous ne devez pas le fermer avant que le paquet n'ait été accepté dans l'archive Debian. C'est pourquoi, vous pouvez et vous devez clore le rapport dans le système de suivi des bogues une fois que vous avez reçu l'avis indiquant que votre nouveau paquet a été installé dans l'archive.

Si vous utilisez une version récente de dpkg-dev et que vous remplissez convenablement le fichier changelog, le logiciel de maintenance de l'archive fermera les rapports de bogue automatiquement. Tout ce que vous avez à faire est de respecter la syntaxe suivante dans votre fichier debian/changelog :

     acme-cannon (3.1415) unstable; urgency=low
     
       * Frobbed with options (closes: Bug#98339)
       * Added safety to prevent operator dismemberment, closes: bug#98765,
         bug#98713, #98714.
       * Added manpage. Closes: #98725.

Techniquement parlant, l'expression régulière suivante est utilisée :

       /closes:\s*(?:bug)?\#\s*\d+(?:,\s*(?:bug)?\#\s*\d+)*/ig

L'auteur préfère la syntaxe (closes: Bug#XXX), car elle est facilement repérable dans le fichier changelog.

Si vous voulez fermer un rapport de bogue manuellement — à l'ancienne — il suffit d'envoyer le fichier .changes à l'adresse XXX-done@bugs.debian.org où XXX est le numéro du bogue.

10.5 Les rapports Lintian

Vous devriez récupérer la dernière version de lintian depuis unstable régulièrement et vérifier tous vos paquets. Vous pouvez aussi chercher votre adresse électronique dans la page de rapport lintian. Cette page, mise à jour automatiquement, contient les rapports lintian concernant la dernière version de la distribution (en général unstable) générés avec la dernière version de lintian.

10.6 Ouvrir un grand nombre de rapports d'un seul coup

Ouvrir un grand nombre de rapports pour le même problème sur un grand nombre de paquet — plus de dix — est une pratique que nous déconseillons. Prenez toutes les mesures possibles pour éviter cette situation. Si le problème peut être détecté automatiquement par exemple, ajoutez un nouveau test dans le paquet lintian pour générer une erreur ou un avertissement.

Si vous ouvrez plus de dix rapports sur le même sujet, il est préférable d'indiquer votre intention sur la liste debian-devel@lists.debian.org. Cela donnera à d'autres développeurs la possibilité de vérifier que le problème existe vraiment. De plus, cela permet d'éviter que plusieurs responsables ne rédigent les mêmes rapports de bogue simultanément.

Quand vous envoyez un grand nombre de rapports sur le même sujet, vous devriez les envoyer à maintonly@bugs.debian.org pour qu'ils ne soient pas redirigés vers les listes de diffusions.

Référence du développeur Debian