Proposer des scripts ebuilds
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.
Ce document est protégé par la licence Creative
Commons : Paternité - Partage des Conditions Initiales à
l'Identique 2.5.
|