Contribuire agli Ebuilds

1.Iniziamo

Creare un account Bugzilla 

Collegatevi con il vostro browser a http://bugs.gentoo.org. Questo è l'url per il Bugzilla bug tracking database. Nell'elenco dei links disponibili, ce n'è uno che indicato da "Open a new Bugzilla account" (ndt, "Aprire un nuovo account Bugzilla"). Se non lo avete ancora fatto (p.e. per segnalare un bug), cliccate sul link e create un nuovo account.

Non proporre ebuilds CPAN 

Portage fornisce un tool chiamato g-cpan.pl che installa un certo modulo CPAN nel vostro sistema Gentoo utilizzando Portage, memorizzando le necessarie informazioni (quali le dipendenze, file forniti, ecc.) nel database di Portage, proprio come viene fatto quando si installa un normale ebuild. Non è quindi necessario (ne raccomandato) proporre ebuild CPAN

Per maggiori informazioni su g-cpan.pl, consultare la relativa pagina di manuale.

2.Proporre un ebuild

Creare un nuovo bug 

In fondo alla pagina principale o pagina di login, c'è un box giallo. Scegliete il link New (ndt, Nuovo). Oppure potete andare direttamente all'URL http://bugs.gentoo.org/enter_bug.cgi. In entrambi i casi accederete alla pagina Enter Bug (ndt, Inserire bug).

Bugzilla può tenere traccia di molti prodotti. Per esempio, in Gentoo, gli altri prodotti possono includere documentazione o tools per amministrare siti web. Dalla lista dei prodotti, gli Ebuilds dovrebbero sempre essere proposti a Gentoo Linux.

Cliccando sul prodotto Gentoo Linux verrete portati alla pagina contente i campi da completare per inserire un nuovo bug.

Completare i campi nella pagina del nuovo bug 

Il primo campo è quello della version (ndt, versione). Se sapete a quale versione appartiene il vostro pacchetto, potete inserirla qui. In caso contrario, selezionate unspecified (ndt, non specificata). Quindi, selezionate il tipo di componente. Tutti gli scripts ebuild fanno parte del tipo di componente Ebuilds.

Le categorie Platform, OS e Priority non necessitano di essere impostate per gli ebuilds.

Il campo Severity (ndt, Severità) deve essere impostato a enhancement (ndt, aggiunta)

Lasciate bianco il campo Assigned To (ndt, Assegnato a), ma se desiderate tener traccia dello stato del vostro ebuild, inserite la vostra email nel campo CC.

Compilate il campo Summary (ndt, Sommario) con una breve nota relativa a quale pacchetto state proponendo e se si tratta di un aggiornamento o una nuova proposta. Qualcosa di simile a quanto segue dovrebbe andare bene: foo-bar-x.y.z.ebuild (New Package) o foo-x.y.z.ebuild (Update)

Il campo Description (ndt, Descrizione) deve essere compilato nel modo più completo possibile. Questo è un esempio tratto dal Bug Numero 7 (ndt, è stato lasciato in inglese poichè questa è la lingua che andrebbe utilizzata in questi casi):

	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

	

Una volta che il sommario è completo, cliccate su Submit (ndt, Proponi, sottometti).

Allegare lo script Ebuild 

Dopo aver premuto submit nella pagina Enter Bug, accederete alla pagina Posting Bug (ndt, Postare, Spedire il bug). Prendete nota del numero del bug.

Verso la fine di questa pagina, c'è un link Attach a file to this bug (ndt, Allega un file a questo bug). Cliccate su questo link.

Scegliete il file servendovi del riquadro di inserimento del testo o del pulsante Browse. Nel campo Description (ndt, Descrizione), digitate il nome dell'ebuild, dovrebbe essere lo stesso che avete messo nella sezione Summary della pagina precedente.

Assicuratevi che il tipo di contenuto sia impostato a "text/plain" e che il bottone radio select from list sia selezionato.

Non ci sono altri campi da completare in questa pagina. Premete su Submit e avrete finito!

3.Ebuilds multipli

Dipendenze 

Nel caso abbiate intenzione di proporre ebuilds multipli e alcuni di essi dipendano da altri, è veramente d'aiuto che annotiate queste dipendenze. Rivedendo ancora il bug dovreste poter inserire un'altra nota. Aggiungete qui le informazioni relative alle dipendenze.