Ebuilds einreichen

1.  Zu Beginn

Erstellen eines Bugzilla Accounts

Gehen Sie mit Ihrem Browser nach http://bugs.gentoo.org. Dies ist die URL der "Bugzilla Bug Tracking" Datenbank. In der Liste finden Sie einen Link namens "Open a new Bugzilla account". Falls Sie bisher noch keinen Account geöffnet haben sollten (z.B. zum Einreichen eines Bugs), klicken Sie auf diesen Link und erstellen einen neuen Account.

Keine CPAN Ebuilds einreichen

Portage enthält ein Tool namens g-cpan.pl, welches ein angegebenes CPAN Modul mittels Portage in Ihrem System installiert, die notwendigen Informationen (wie Abhängigkeiten, zu diesem Modul gehörende Dateien, etc.) in der Portage Datenbank speichert wie bei der Installation eines Ebuild. Aus diesem Grund ist es weder notwendig noch empfohlen CPAN Ebuilds einzureichen.

Für weitere Informationen zu g-cpan.pl konsultieren Sie bitte die Manpage.

2.  Ein Ebuild einreichen

Erstellen eines neuen Bugs

Unten auf der Hauptseite oder auch der Login Seite finden Sie eine gelbe Box. Wählen Sie den New - Expert Link. Oder Sie gehen einfach direkt zur URL http://bugs.gentoo.org/enter_bug.cgi. Beides bringt Sie zur Enter Bug Seite.

Bugzilla kann mehrere Produkte betreuen. Bei Gentoo zum Beispiel können diese anderen Produkte Dokumentation oder Werkzeuge zum Administrieren der Website beinhalten. Ebuilds sollten hier immer beim "Produkt" Gentoo Linux eingereicht werden.

Durch das Klicken auf das Produkt Gentoo Linux wird ein Formular zum Erstellen eines neuen Bugs geöffnet.

Ausfüllen des Bug Formulars

Das erste Feld heißt version. Wenn Sie die genaue Version wissen, können Sie sie hier setzen. Sollten Sie sie nicht kennen, wählen Sie unspecified. Als nächstes wählen Sie die Komponente (component). Alle Ebuild-Skripte gehören dem Component Typ Ebuilds an.

Die Kategorien Platform, OS und Priority müssen für Ebuilds nicht gesetzt werden.

Das Severity Feld sollte auf enhancement gesetzt werden.

Lassen Sie das Assigned To Feld leer. Wenn Sie die Mail-Einstellungen für Bugzilla nicht verändert haben, werden Sie als Reporter automatisch Emails bei Aktualisierungen des Bugs erhalten.

Füllen Sie das Summary Feld mit einer Kurzen Notiz aus, in welcher Sie beschreiben, welches Paket Sie einreichen und ob es ein Update oder eine ganz neue Version ist. Etwas wie folgend ist großartig: foo-bar-x.y.z.ebuild (New Package) oder foo-x.y.z.ebuild (Update).

Das Description Feld sollte so vollständig wie möglich ausgefüllt werden. Bitte denken Sie an die internationalen Entwickler und User, verfassen Sie die Beschreibung bitte auf Englisch! Hier ist ein Beispiel von Bug Nummer 7:

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

Wenn die Beschreibung komplett ist, klicken Sie auf Commit.

Anhängen des Ebuild-Skripts

Nach dem Klicken auf submit auf der Enter Bug Seite, kommen Sie zur Posting Bug Seite. Beachten Sie bitte die Bug-Nummer.

Zum Ende der Seite hin finden Sie einen Link Create a new attachment. Klicken Sie auf diesen Link.

Wählen Sie die Datei durch die Benutzung der Textbox oder des Browse Dialogs aus. Im Description Feld, geben sie bitte den Namen der Ebuild-Datei ein, in etwa den, den Sie im Summary Abschnitt auf der letzten Seite benutzt haben.

Bitte stellen Sie sicher, das der "Content" Typ auf "text/plain" gestellt ist und der Knopf für select from list markiert wurde.

Es werden keine weitern Felder benötig, klicken Sie Submit und Sie haben es geschafft!

3.  Mehrere Ebuilds

Abhängigkeiten

Im Fall, dass Sie mehrere Ebuilds einreichen sollten und einige von anderen abhängig sind, ist es sehr hilfreich, wenn diese Abhängigkeiten notiert werden. Durch das erneute Ansehen des Bugs, sollten Sie die Möglichkeit haben, eine weitere Notiz zu ergänzen. Bitte ergänzen Sie hier eventuelle Abhängigkeiten.