Bugs / Comment corriger un paquet

Chaque paquet installé sur le système Ubuntu a été construit à partir de sources. Chaque source a une page dédiée pour rapporter des bugs touchant le paquets fils ( paquet issu de la compilation des sources ).

Prenons pour exemple, la page des bugs du paquet "hello" à l'adresse suivante : https://launchpad.net/ubuntu/+source/hello/+bugs.

Vous ne savez pas comment corriger un problème ( bug ) reporter mais ça aide ! Il y a certaines choses que n'importe qui peut faire. Pour commencer, beaucoup de bugs touchent la typographie ou la documentation et ils peuvent facilement être corrigés par tous. Si vous connaissez une autre langue, vous pouvez surement corriger les erreurs de traduction. Pour le fonctionnement, vous pouvez essayer d'améliorer les rapports de bugs reportés pour les auteurs du paquet concerné. Ou trouver une solution qui sera incluse dans une autre distribution ( pas clair cette phrase ).

Avant de corriger un bug, assurez-vous que le bug peut être reproduit sur votre machine. Sinon, essayer de corriger un bug que vous ne constatez pas n'est pas prioritaire pour une résolution. Si vous avez besoin d'information pour reproduite le bug, demandez plus d'informations de la part de l'auteur du rapport de bug dans un commentaire de bug.

De nombreux scripts ont été développés pour aider tout en travaillant avec les outils debian et des patchs. Installer ces paquets :

sudo apt-get install devscripts ubuntu-dev-tools

Générer un patch :

Ici le simple exemple pour voir comment créer un patch :

1. Imaginons que vous avez un rapport de bug disant que la description du paquet xicc contient une erreur orthographique touchant le mot "color " et que nous voulons corriger. (Très mauvais exemples je vous l'accorde) Premièrement vérifier que le rapport dit vrai:

    $ apt-cache show xicc
    Package: xicc
    Priority: optional
    Section: universe/x11
    Installed-Size: 72
    Maintainer: Ross Burton <ross@debian.org>
    Architecture: amd64
    Version: 0.2-2
    Depends: libc6 (>= 2.3.4-1), libglib2.0-0 (>= 2.8.0), libice6, libsm6, libx11-6
    Filename: pool/universe/x/xicc/xicc_0.2-2_amd64.deb
    Size: 8224
    MD5sum: a266d60cd721ef91fcb1d3d47ecd6a40
    SHA1: b8da21b8dfba7ed9c7ac6fa5c9c3e70b438d7124
    SHA256: 635c287a1c43df31670a20194e774561479d70d981bf24c143c3711799bd839a
    Description: set the ICC **colour** profile for an X display
     This utility lets you set an ICC colour profile for an X display, so that
     applications can use it to display colour calibrated images.  Applications have
     to specifically look for this atom but several applications such as Gimp and
     Eye Of Gnome already do.
    Bugs: mailto:ubuntu-users@lists.ubuntu.com
    Origin: Ubuntu

1. L'erreur constatée, le rapport de bug est confirmé, c'est le moment d'agir commençons à rapatrier les sources de ce paquet :

dget -xu http://people.ubuntu.com/~dholbach/motu/xicc_0.2-2.dsc

1. Éditez le fichier debian/control qui contient l'erreur et corrigeons ce mot :

    cd xicc-0.2
    sed -i 's/colour/color/g' debian/control

Bien entendu le patch n'est pas toujours si facile et pourrait nécessiter un patch bien plus important touchant beaucoup de parties dans le paquet originel. Reportez-vous à la partie Patch guidelines.

1. Adhérer à DebianMaintainerField: Éditez le fichier debian/control et remplacer :

    Maintainer: Ross Burton <ross@debian.org>

par

    Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>
    XSBC-Original-Maintainer: Ross Burton <ross@debian.org>

Pour cette action, vous pouvez utiliser l'outil update-maintainer ( dans le paquet ubuntu-dev-tools ).

1. Mettre à jour le fichier debian/changelog :

    dch -i

et décrire les changements que vous avez effectués.

1. Générer le nouveau paquet :

    debuild -S

Ou si vous créez un paquet non signé :

    debuild -S -us -uc

1. Regardez avez debdiff :

    cd ..
    debdiff xicc_0.2-2.dsc xicc_0.2-2ubuntu1.dsc | less

1. Pour créer un fichier patch, vous devez envoyer le résultat de debdiff dans un autre fichier :

    debdiff xicc_0.2-2.dsc xicc_0.2-2ubuntu1.dsc > xicc_0.2.2ubuntu1.debdiff

1. C'est fait. Vous pouvez maintenant joindre le patch debdiff à un rapport de bug ou l'envoyer à une personne s'y connaissant ( à revoir ). SponsorshipProcess explique comment envoyer un paquet à Ubuntu. ( )

• Vérifier SponsorshipProcess pour voir comment inclure ce patch à Ubuntu.
• (PackagingGuide contient plus d'informations pour construire un paquet, le patcher et le tester.)
• UbuntuDevelopment/Patches à un guide pour générer de bons patchs.

Une fois que votre patch est généré entrer à nouveau dans le dossier des sources et construire le paquet.

cd hello-2.2
sudo apt-get build-dep hello
debuild -us -uc

Si la construction du paquet échoue, revenez sur vos changements et vérifiez qu'il n'y a pas d'erreurs. Vous pouvez générer votre patch à partir des sources via les commandes suivantes :

rm -rf hello-2.2 dpkg-source -x hello_2.2-1.dsc patch -p0 < hello.patch

Si la construction du paquet réussit, installer le paquet et soyez sûr que vous ne pouvez plus reproduire le bug en question. Le paquet local peu être installé avec la commande suivante :

sudo dpkg -i hello_2.2-1_*.deb

Si votre patch ne corrige pas le problème, ou que vous ne pouvez pas corriger le paquet, mettez à jour le rapport, assigné le par "Nobody" et changer le status à "Confirmed". Vous pouvez aussi ajouter un commentaire descriptif de votre expérience pour aidez d'autres personnes à corriger ce bug.

Si votre patch corrige le bug, ajouter s'il vous plait un commentaire au bug, et joignez le patch. Soyez sûr que avez coché la case patch pour télécharger le patch.

Assignez le bug à "Nobody", et le status à "Confirmed". A ce point, recherchez le développeur pour jeter un œil à votre patch pour l'inclure dans la prochaine version du paquet. Voir SponsorshipProcess. Si vous avez d'autres questions, demandez sur #ubuntu-motu sur InternetRelayChat.

N.B. Si vous connaissez le packaging debian, et voulez préparer une version candidate en incluant le correctif pour corriger le bug, voir MOTU/Contributing pour quelques conseils sur la création d'une nouvelle version. Vérifier sur MOTU/GettingStarted pour voir comment être plus impliqué dans le packagind et l'équipe.

La majorité des changements et des corrections de bugs se font sur la version de développement de Ubuntu. Une fois nous produisons la version stable de Ubuntu, des millions d'utilisateurs travaillent dessus et dépendent de sa stabilité, donc nous limitons les changements entre la sortie des versions, pour ces deux raisons

• Une régression dans une version stable est une catastrophe. Il est préférable de garder une version stable avec des bugs connus dont les utilisateurs apprennent à contourner tout en travaillant, que de briser les fonctionnalités existantes.
• Même certaines des corrections de bugs pouvant causer des confusions, s'ils perturbent la manière dont les utilisateurs ont déjà travaillé avec le logiciel. Cela affecte en particulier l'interface utilisateur et les changements de chaîne ( ??? ), de l'API / ABI des erreurs ( ), etc.

Néanmoins nous voulons offrir des corrections de bugs critiques/données pertent/securités , et dans la plupart des cas des bugs triviaux qui ont des conséquences de régressions presque null. Tous les développeurs sont les bienvenus et sont invités à fournir ces mises à jour. La procédure est détaillée dans les pages SecurityUpdateProcedures et StableReleaseUpdates.

D'un autre côté beaucoup d'utilisateurs ont besoin d'une nouvelle version d'une partie d'un logiciel, sans forcément mettre à jour la distribution complète. Pour ceux là, nous fournissons un dépôt "backports" qui n'est pas activé par défault et permet d'introduire des changements plus importants. La procédure est documenté à https://help.ubuntu.com/community/UbuntuBackports.