Gentoo Logo

Proposer des scripts ebuilds

Table des matières :

1.  Pour commencer

Créer un compte Bugzilla

Allez sur http://bugs.gentoo.org avec votre navigateur Web. Il s'agit de l'URL du système de suivi de bogues Bugzilla. Dans la liste des liens, l'un d'eux s'appelle « Open a new Bugzilla account ». Si vous ne l'avez pas encore fait (par exemple pour signaler un bogue), cliquez sur ce lien et créez un nouveau compte.

Ne proposez pas d'ebuild CPAN

Portage met à votre disposition un outil appelé g-cpan.pl qui installe un module CPAN donné dans votre système Gentoo en utilisant Portage. C'est-à-dire qu'il conserve les informations nécessaires (telles que les dépendances, les fichiers fournis, etc.) dans la base de données de Portage, de la même manière que lorsque vous installez un ebuild. Ce n'est donc pas la peine (ni même recommandé) de proposer des ebuilds CPAN.

Pour plus d'informations concernant g-cpan.pl, veuillez consulter sa page man.

2.  Proposer un ebuild

Créer un nouveau bogue

En bas de la page principale ou de celle d'authentification se trouve une boîte jaune. Choisissez le lien New - Expert. Vous pouvez également aller directement sur http://bugs.gentoo.org/enter_bug.cgi. Dans les deux cas, vous arriverez sur la page Enter Bug.

Note : Dans le système Bugzilla, toutes les entrées sont des bogues. C'est le cas en particulier des ebuilds proposés. Chaque bogue est associé à un ID de suivi. Notez cet ID, en particulier si vous avez d'autres ebuilds qui dépendent de ce paquet.

Bugzilla peut gérer plusieurs produits. Par exemple, dans Gentoo, les autres produits peuvent être la documentation ou les outils de gestion du site Web. Les ebuilds doivent toujours être associés au produit Gentoo Linux.

Cliquer sur le produit Gentoo Linux devrait faire apparaître un nouveau formulaire de saisie de bogue.

Remplir le formulaire de saisie de bogue

Le premier champ du formulaire est version. Si vous savez de quelle version fait partie votre paquet, indiquez-la ici. Sinon, choisissez unspecified. Ensuite, vous devez choisir le composant. Tous les scripts ebuild sont du type Ebuilds.

Important : Les ebuilds doivent toujours être associés au composant Ebuilds. Des catégories comme GNOME, Libraries et Server pourraient sembler s'appliquer à votre ebuild, mais elles sont là pour les bogues des paquets, pas pour proposer des ebuilds.

Les champs Platform, OS et Priority n'ont pas besoin d'être précisés pour les ebuilds.

Le champ Severity est à placer à enhancement (amélioration).

Laissez le champ Assigned To vide. Si vous n'avez pas modifié vos préférences dans Bugzilla, vous serez automatiquement notifié lorsque des changements sont apportés à votre bogue.

Indiquez dans le champ Summary le paquet que vous proposez et si c'est une mise à jour ou un nouveau paquet. Quelque chose dans ce style est parfait : foo-bar-x.y.z.ebuild (New Package) ou foo-x.y.z.ebuild (Update)

Le champ Description doit être rempli le plus complètement possible. Voici un exemple provenant du bogue numéro 7 :

Exemple de code 2.1 : Exemple de description

Hi!

Please find attached gramps-0.7.0.ebuild and a patch so that it will
compile against python-2.2

gramps is the Genealogical Research and Analysis Management Programming
System.  It is a very cool gnome/python app.  If you are in the US, you
can head over to
http://www.familysearch.com/
and you can probably find a GEDCOM file for your family tree to import
into gramps. (Mormons sure do like geneaology)

I suggest app-misc/gramps Also, this ebuild depend on Imaging and ReportLab
previously submitted

tod

Attention : N.D.T. : Toutes les informations doivent être écrites en anglais !

Une fois le formulaire rempli, cliquez sur Commit.

Joindre le script ebuild

Après avoir cliqué sur submit dans la page Enter Bug, vous arriverez sur la page Posting Bug. Notez le numéro de bogue.

Vers le bas de la page, il y a un lien Create a new attachment. Cliquez sur ce lien.

Choisissez le fichier en entrant son chemin ou en utilisant le bouton Browse qui fera apparaître une boîte de dialogue. Dans le champ Description, tapez le nom du fichier ebuild, comme vous l'aviez fait dans la section Summary de la page précédente.

Assurez-vous que le type de contenu est mis à « text/plain » et que le bouton radio select from list est coché.

Il n'y a pas d'autre champ requis sur ce formulaire. Cliquez sur Submit et c'est fini !

3.  Plusieurs Ebuilds

Dépendances

Si vous soumettez plusieurs ebuilds et que certains dépendent d'autres, il est très utile que ces dépendances soient indiquées. Retourner voir un bogue permet d'ajouter des notes. Merci d'y indiquer les informations de dépendance.



Imprimer

Dernière mise à jour le 24 octobre 2005

La version originale de cette traduction n'est plus maintenue

Résumé : Ce guide explique comment proposer des scripts ebuild à l'aide du système de suivi de bogues Bugzilla.

Matt Butcher
Auteur

Pascal Terjan
Traducteur

Camille Huot
Traducteur

Donate to support our development efforts.

Copyright 2001-2014 Gentoo Foundation, Inc. Questions, Comments? Contact us.