<p>Comme il est impossible pour nos développeurs de tester toutes les combinaisons de matériel, ni tous les cas de figure pouvant interagir avec le système d'exploitation, nous comptons sur les utilisateurs pour nous dire si les choses fonctionnent pour eux. puisque Haiku est encore tout jeune, il est très probable que vous rencontriez des bogues. Nous vous remercions de bien vouloir prendre le temps de nous les signaler. Ensemble, nous pourrons, petit à petit, améliorer Haiku.</p>
<p>Afin que le suivi de nos bogues reste efficace, il est essentiel de respecter l'<ahref="http://dev.haiku-os.org/wiki/BugTrackerEtiquette">Étiquette de suivi des bogues</a>.</p>
<p>Pour remplir un rapport (ticket), vous aurez besoin d’un compte utilisateur sur le <ahref="http://dev.haiku-os.org/register"title="Traqueur de bogues de Haiku">Traqueur de bogues de Haiku</a>.<br/>
Lors de la création d’un nouveau compte, pensez à <b>indiquer votre adresse e-mail</b> afin d’obtenir les privilèges basiques de gestions des tickets. N’oubliez pas de <b>Vérifier votre dossier de pourriel</b> après, car les e-mails de vérifications s’y retrouvent souvent.</p>
<p>Avant de rapporter un bogue, veuillez <ahref="http://dev.haiku-os.org/query?status=new&status=assigned&status=reopened&status=closed&summary=%7Etext+you+want+to+search+for&order=priority">vérifier</a> qu’il n’est pas déjà répertorié. Vous pouvez aussi utiliser la <ahref="http://dev.haiku-os.org/search?q=&noquickjump=1&ticket=on">fonction de recherche</a> pour cela.<br/>
Après vous être assuré que votre bogue est unique, obtenez des informations précises sur votre environnement:</p>
<li><p>Indiquez comment vous testez Haiku (sur machine réelle, dans VMware, dans Qemu…)</p></li>
<li><p>Indiquez quelle révision <acronymtitle="Subversion, le système de gestion de code source que nous utilisons">SVN</acronym> de Haiku vous utilisez. Vous pouvez trouver des informations à ce sujet dans le menu « <i>About This System…</i> » de la Deskbar.</p></li>
<li><p>Décrivez le problème que vous rencontrez. soyez aussi précis que possible : décrivez le comportement réel, et celui que vous attendiez.</p></li>
<li><p>Décrivez les actions que vous avez effectuées avant de faire ressortir le bogue. Cela permettra aux développeurs de le reproduire.</p></li>
<li><p>Attachez au rapport le plus d’informations possibles. Si le bogue concerne l’interface graphique ou une application, essayez de faire une capture d’écran (la touche <spanclass="key">IMPRÉCRAN</span> créera une image <acronymtitle="Portable Network Graphics image format">PNG</acronym> dans le dossier <spanclass="path">/boot/home/</span>).</p></li>
<p>Lorsqu'une application se plante, vous devez appeler le débogueur depuis le message d'alerte qui s'affiche. Saisissez <spanclass="cli">bt</span> dans le Terminal de débogage qui est lancé. Vous obtiendrez ainsi une trace de la «pile d'appel» (<i>backtrace</i>) que vous devez joindre à votre rapport de bogue.</p>
<li><spanclass="cli">listdev</span> - fait une liste détaillée de votre matériel, en y incluant les identifiants PCI des fournisseurs, à la manière de <spanclass="cli">lshw</span> ou <spanclass="cli">lspci</span> dans GNU/Linux .</li>
<li><spanclass="cli">listusb -v</span> - en supposant que c'est un problème lié à l'USB, comme le fait <spanclass="cli">lsusb</span>.</li>
le système de journal d’événements principal de Haiku, similaire au déboguage sur écran durant le démarrage. En l’ouvrant dabs un éditeur de texte avec la commande <spanclass="cli">open</span> vous pourrez n’en conserver que la partie utile.</li>
<li><spanclass="cli">listimage | grep drivers/</span> - liste tous les drivers utilisés.</li>
<li><spanclass="cli">ints</span> - seulement disponible dans le <i>mode débogage du noyau</i> (voir ci-dessous). Montre l'utilisation des interruptions.
Il ne devrait pas y avoir trop d'interruptions partagées par plusieurs périphériques.</li>
<p>Ces commandes peuvent être entrées dans le Terminal. Si vous ajoutez <spanclass="cli">> sortie.txt</span> après une commande, sa sortie sera redirigée dans un fichier texte nommé «sortie.txt» que vous pourrez attachez à votre rapport de bogue ou e-mail.</p>
<p>Lorsque certains composants systèmes de bas niveau se plantent, vous pouvez être envoyé dans le débogueur du noyau. Vous pouvez également y entrer volontairement avec <spanclass="key">ALT</span><spanclass="key">SYST</span><spanclass="key">D</span> (<spanclass="key">SYST</span> correspond à <spanclass="key">IMPR ÉCRAN</span> sur la plupart des claviers). Attention : l'ordre des touches compte.</p>
<p>Une fois le bogue rapporté, un développeur le consultera et essayera de le cataloguer. Retenez que tous les développeurs sont des volontaires; un long délai avant réponse peut s’écouler après le rapport de bogue. L’ajout de nouvelles informations une fois celles-ci disponibles peut généralement permettre à un bogue d’être analysé plus rapidement. Néanmoins, n’essayez pas de «faire remonter» un bogue en ajoutant des commentaires non pertinents.</p>
<p>N’oubliez pas, le rapport d’un bogue ne se limite pas à sa soumission. Une fois cette tâche faite, vous ferez partie du processus de développement de Haiku. Les développeurs pourront vous poser des question pour essayer de résoudre votre bogue. Merci de rester disponible pour y répondre. Vous pourrez considérer votre travail «terminé» quand le bogue sera marqué comme étant « corrigé ».</p>
