Une fois un problème identifié, il faut proposer une solution. Cela ne signifie pas nécessairement écrire du code… dans bien des cas, avant d’en arriver au code, il faut définir quel devrait être le comportement correct d’une application.

Un exemple avec le bogue #433290 qui défend l’idée que dpkg -S ne devrait pas échouer sur /usr/bin/man qui est un lien symbolique (n’appartenant à aucun paquet) mais pointant sur le binaire /usr/lib/man-db/man (qui appartient au paquet man-db).

On comprend aisément le besoin de l’utilisateur qui souhaite savoir quel paquet fournit la fonctionnalité /usr/bin/man et qui n’obtient pas la réponse attendue. Mais il faut mettre en balance l’exactitude technique: on ne peut pas dire que /usr/bin/man appartient au paquet man-db si ce n’est pas le cas.

J’ai donc fait une proposition intermédiaire où dpkg informe que /usr/bin/man n’est pas empaqueté mais que c’est un lien symbolique pointant sur un fichier empaqueté.

Pas besoin d’être programmeur pour spécifier le comportement satisfaisant l’utilisateur tout en étant techniquement juste. Il faut juste du temps, des idées et du bon sens. 🙂

N’hésitez pas à donner d’autres exemples dans les commentaires.

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.

C’est vraisemblablement la contribution la plus simple et la plus largement pratiquée. Les utilisateurs avides de nouveautés emploient les versions testing/unstable qui évoluent en permanence. Lorsqu’ils rencontrent des problèmes, ils consultent immédiatement le système de suivi de bogues pour voir s’il est déjà répertorié. Si ce n’est pas le cas, ils se chargent de rédiger un rapport de bogue détaillé, grâce à l’outil reportbug (voir le paquet).

Ensuite, ils répondent du mieux qu’ils peuvent aux sollicitations que le mainteneur leur envoient pour comprendre dans quelles circonstances le problème se manifeste. C’est pourquoi l’usage de la langue anglaise est de rigueur… toutefois si l’anglais vous bloque, il est possible de demander de l’assistance sur la liste de diffusion debian-user-french@lists.debian.org. D’autres pourront peut-être reproduire le problème et signaler le bogue pour vous.

On peut aussi formuler des souhaits d’améliorations (ajout de fonctionnalité, changement d’un comportement par défaut, etc.), la priorité « wishlist » du BTS est dédiée à cela.

Sachez enfin, qu’on peut consulter tous les bogues que l’on a soumis avec une URL comme celle-ci (ici avec mon email hertzog@debian.org) : http://bugs.debian.org/cgi-bin/pkgreport.cgi?submitter=hertzog@debian.org

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.

Dans mon billet précédent, j’ai présenté le travail du trieur de bogues. Pour être efficace dans cette tâche, il est fort pratique de recevoir automatiquement tous les courriers envoyés par le BTS et reçus par le mainteneur (même s’il est toujours possible de les retrouver sur l’interface web). Cela permet d’être informé instantanément des tous derniers changements et de réagir rapidement.

Pour cela, il faut employer le système de suivi de paquets (connu sous le doux nom de PTS). Le PTS se compose d’une interface web résumant toutes les informations d’un paquet source (accessible à l’adresse http://packages.qa.debian.org/paquet-source), et d’une liste de diffusion associée qui permet de recevoir les mêmes informations que le mainteneur Debian (et même plus). Le fonctionnement du PTS est documenté dans la référence du développeur Debian.

Pour s’abonner à la liste de diffusion associée, le plus simple est d’utiliser le formulaire dédié que l’on trouve sur l’interface web du PTS. Il intéressant de noter qu’il y a un mode avancé d’abonnement qui permet de sélectionner finement les informations que l’on souhaite recevoir. En effet, le PTS fait suivre des informations de provenance diverses:

• les messages du système de suivi de bogues (BTS donc) ;
• les messages de notifications d’envoi de nouvelles versions du paquet ;
• les informations de propagation d’un paquet dans la distribution testing ;
• les modifications effectuée sur le paquet par des distributions dérivées (comme Ubuntu) ;
• les notifications de changement dans le système de gestion de sources employé pour gérer le paquet ;
• etc.

L’interface web du PTS rassemble de nombreuses informations concernant chaque paquet (les versions disponibles, des statistiques sur les bogues, l’historique des derniers changements, etc.) et pointent vers d’autres ressources qui peuvent être utiles (les logs de recompilation, les avertissements de lintian, etc.). Voici quelques exemples: dpkg, aptitude, iceweasel, subversion.

Je me sers tellement souvent de ces pages que j’ai configuré mon navigateur web afin que je puisse taper « pts paquet » dans la barre d’adresse et qu’il me renvoie automatiquement sur la page correspondante du PTS. Avec Iceweasel, il faut créer un marque-page spécial dans la catégorie « Quick Searches »: l’adresse doit être « http://packages.qa.debian.org/%s » et le mot-clef associé est « pts ».

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.

Une des premières tâches du mainteneur de paquet Debian est de gérer les bogues que les utilisateurs soumettent sur son paquet. Avec le temps, les rapports de bogue ont tendance à s’accumuler en particulier pour les paquets les plus populaires. Le mainteneur (ou l’équipe de maintenance) n’a souvent pas les ressources nécessaires pour rattraper ce retard et traiter correctement ces rapports.

C’est dans ce contexte que l’aide externe d’un « trieur de bogue » est très appréciée. Je vais illustrer la manière de procéder par le biais de Brice Goglin, trieur de bogues pour l’équipe X Strike Force.

Dans le bogue #378917, il demande à l’utilisateur ayant signalé le bogue de vérifier si le problème existe toujours avec la dernière version de Xorg. Personne d’autre n’ayant rencontré le problème, et n’ayant obtenu aucune réponse de ce dernier en l’espace d’un mois, le bogue a été fermé par ses soins. Dans des conditions similaires, si l’adresse email de l’utilisateur n’est plus valide, le bogue peut être fermé (exemple: #109328).
Il arrive aussi qu’il n’ait plus le matériel nécessaire pour reproduire le problème (exemple: #319750).

Il y a des vieux bogues que Brice est capable de reproduire: dans #93665, le problème sur xcalc est toujours présent et il a donc enregistré le bogue dans le système de suivi Xorg (voir ticket 10578 de Freedesktop.org). Le statut du bogue Debian a été changé pour indiquer que le bogue a été « forwardé » et qu’il est toujours présent dans la version 1:7.2.ds2-1 du paquet (voir le message de Brice responsable de ce changement).

D’autres bogues sont indéniablement corrigés, il s’agit alors de les fermer proprement en indiquant si possible la première version du paquet qui contient le correctif (exemple: #405792). Au passage, le bogue doit parfois être réaffecté à un autre paquet parce que l’utilisateur n’a pas forcément identifié le paquet responsable de son problème.

Parfois les utilisateurs soumettent des rapports de bogues qui ont déjà été soumis, soit parce qu’ils n’ont pas fait attention, soit parce que le problème leur semblait différent de ceux déjà rapportés (bien que le problème sous-jacent soit le même). Ainsi le bogue #425663 n’est pas immédiatement identifié comme un doublon. Mais après quelques explications de Julien Cristau, Brice remarque la similitude avec #164379 et fusionne les deux bogues.

Ce travail de trieur de bogues n’est pas forcément très attrayant aux premiers abords mais le contact direct avec les développeurs permet d’apprendre de nombreuses choses. De plus, lorsque les progrès sont visibles, il y a de quoi être fier et cela donne un surplus de motivation. 🙂

Nombreuses sont les équipes qui acceptent volontiers l’aide de trieur de bogues. L’équipe KDE a même une page dédiée pour les guider.

Pour être efficace, le trieur de bogues est idéalement un utilisateur régulier du logiciel (ou de la suite logicielle). Il doit également investir un peu de temps pour se familiariser avec le système de suivi de bogues de Debian ainsi que celui employé par les développeurs « amont » du logiciel en question.

N’hésitez pas à écrire pour proposer votre aide aux mainteneurs des logiciels que vous connaissez. En naviguant dans les pages du BTS, il est facile de trouver les paquets qui ont besoin de votre aide (un point de départ, un autre).

Cet article fait partie d’une série expliquant – par des exemples – comment contribuer à Debian.