                      Zur FreeBSD Ports-Sammlung beitragen

  Sam Lawrance

  Mark Linimon

   Version: 43126

   FreeBSD ist ein eingetragenes Warenzeichen der FreeBSD Foundation.

   Viele Produktbezeichnungen von Herstellern und Verka:ufern sind
   Warenzeichen. Soweit dem FreeBSD Project das Warenzeichen bekannt ist,
   werden die in diesem Dokument vorkommenden Bezeichnungen mit dem Symbol
   "(TM)" oder dem Symbol "(R)" gekennzeichnet.

   2013-11-07 von gabor.
   Zusammenfassung

   Dieser Artikel beschreibt, wie man zur FreeBSD Ports-Sammlung beitragen
   kann.

   U:bersetzt von Martin Wilke.

     ----------------------------------------------------------------------

   Inhaltsverzeichnis

   1. Einleitung

   2. Was Sie tun ko:nnen, um uns zu helfen

   3. Erstellen Sie einen neuen Port

   4. U:bernahme eines nicht betreuten Ports

   5. Die Herausforderung als Ports-Maintainer

   6. Defekte Ports finden und reparieren

   7. Sagen Sie Bescheid, wenn Sie einen Port nicht mehr betreuen mo:chten

   8. Ressourcen fu:r Ports-Maintainer und Committer

   Stichwortverzeichnis

1. Einleitung

   Die Ports-Sammlung ist sta:ndig in Bearbeitung. Wir wollen unseren
   Benutzern eine einfach zu verwendende, aktuelle und qualitativ hochwertige
   Quelle fu:r Software von Drittanbietern bereitstellen. Deshalb suchen wir
   immer Personen, die etwas von ihrer Zeit aufwenden ko:nnen, um uns dabei
   zu helfen.

   An der Ports-Sammlung zu arbeiten ist ein hervorragender Weg, um zu helfen
   und dem Projekt etwas zuru:ck zu geben. Egal, ob Sie eine dauerhafte
   Funktion oder eine kleine Aufgabe fu:r einen regnerischen Tag suchen - wir
   wu:rden uns u:ber Ihre Hilfe freuen!

   Als Freiwillige/r setzen Sie sich selbst Grenzen. Sie sollten sich aber
   immer bewusst sein, dass andere Mitglieder der FreeBSD Community
   mo:glicherweise auch etwas von Ihnen erwarten. Sie sollten dies auf jeden
   Fall in Ihre Entscheidung mit einbeziehen.

2. Was Sie tun ko:nnen, um uns zu helfen

   Um die Ports-Sammlung aktuell und in einem sauberen Zustand zu halten,
   sind viele Dinge zu erledigen:

     * Finden Sie eine begehrte oder nu:tzliche Software und erstellen Sie
       einen Port.

     * Es gibt eine grosse Anzahl von Ports, die keinen Maintainer haben.
       Werden Sie Maintainer und betreuen Sie einen Port.

     * Wenn Sie einen Port erstellt haben oder betreuen, vergessen Sie nicht,
       welche Aufgaben ein Maintainer hat.

     * Wenn Sie nur eine kleine Aufgabe suchen, ko:nnten Sie beispielsweise
       einen Bug oder defekten Port fixen.

3. Erstellen Sie einen neuen Port

   Es gibt ein eigenes Handbuch, das beim Erstellen (und Aktualisieren) von
   Ports hilft. Es heisst Porter-Handbuch. Das Porter-Handbuch ist die beste
   Referenz, um mit dem Ports-System zu arbeiten. Es entha:lt Details
   daru:ber, wie das Ports-System funktioniert und wie man mit/an den Ports
   arbeitet.

4. U:bernahme eines nicht betreuten Ports

  4.1. Einen nicht betreuten Port aussuchen

   Die Betreuung eines Ports ist ein guter Weg zu helfen. Nicht betreute
   Ports bleiben nur aktuell und stabil, wenn ein Freiwilliger dafu:r sorgt.
   Es gibt eine grosse Anzahl nicht betreuter Ports, daher ist es eine gute
   Idee fu:r den Einstieg, einen verwaisten Port zu u:bernehmen, den Sie auch
   regelma:ssig selbst verwenden.

   Nicht betreute Ports haben als MAINTAINER den Wert ports@FreeBSD.org. Eine
   Liste der derzeit nicht betreuten Ports sowie Informationen zu deren
   aktuellen Fehlern und Problemen ko:nnen Sie unter FreeBSD Ports Monitoring
   System einsehen.

   Einige Ports beeinflussen durch Abha:ngigkeiten und
   "Slave-Port-Beziehungen" eine grosse Anzahl anderer Ports. Generell ist es
   ratsam, dass Maintainer u:ber ein Mindestmass an Erfahrung verfu:gen,
   bevor Sie derartige Ports betreuen.

   Um herauszufinden, ob ein Port Abha:ngigkeiten oder Slave-Ports hat,
   ko:nnen Sie im "Master-Port-Index" /usr/ports/INDEX nachsehen. (Der Name
   der Datei kann bei den einzelnen Releases von FreeBSD variieren, z.B.
   INDEX-8). Einige Ports haben bedingte Abha:ngigkeiten, die nicht im
   Standard-Index INDEX zu finden sind. Wir erwarten, dass Sie in der Lage
   sind, solche Ports zu erkennen, indem Sie sich die Makefiles anderer Ports
   ansehen.

  4.2. Wie man einen Port u:bernimmt

   Bitte vergewissern Sie sich, dass Sie die Aufgaben eines Maintainers
   verstanden haben. Lesen Sie bitte auch das Porter-Handbuch. U:bernehmen
   Sie nicht mehr Aufgaben, als Sie bewa:ltigen ko:nnen.

   Sie ko:nnen einen nicht reservierten Port jederzeit u:bernehmen, die
   Entscheidung liegt bei Ihnen. Wenn Sie dazu bereit sind, setzen Sie
   MAINTAINER auf Ihre E-Mail-Adresse und reichen einen Problembericht (PR)
   mit den von Ihnen vorgenommenen A:nderungen ein. Wenn beim Kompilieren des
   Ports Fehler auftreten oder eine Aktualisierung notwendig ist, ko:nnen Sie
   derartige A:nderungen dem selben PR beifu:gen. Das ist sehr hilfreich,
   weil sich viele Committer weigern, die Wartung eines Ports zu u:bergeben,
   wenn jemand nicht die no:tige Erfahrung mit FreeBSD vorweisen kann. Das
   Einreichen von PRs, die Kompilierfehler beheben oder Ports aktualisieren,
   ist der beste Weg, um Erfahrung zu sammeln.

   Erstellen Sie Ihren PR mit der category ports und der class
   change-request. Ein Committer wird Ihren PR analysieren, die A:nderungen
   committen und danach den PR abschliessen. Manchmal kann dieser Prozess
   eine Weile dauern (auch Committer sind "nur" freiwillige Helfer!).

5. Die Herausforderung als Ports-Maintainer

   Dieser Abschnitt erkla:rt, warum Ports betreut werden mu:ssen, und
   beschreibt die Pflichten eines Ports-Maintainers.

  5.1. Warum mu:ssen Ports betreut werden?

   Einen Port zu erstellen ist eine einmalige Sache. Sicherzustellen, dass
   ein Port aktuell ist und auch in Zukunft funktioniert, erfordert hingegen
   eine laufende Betreuung und einen nicht zu unterscha:tzenden
   Arbeitsaufwand. Maintainer sind Personen, die einen Teil ihrer Zeit dazu
   verwenden, einen Port fu:r andere FreeBSD-Anwender aktuell und einfach
   installierbar zu halten.

   Der wichtigste Grund fu:r die Betreuung von Ports ist der Wunsch, der
   FreeBSD-Community die neueste und beste Drittanbieter-Software zur
   Verfu:gung zu stellen. Eine zusa:tzliche Herausforderung ist die
   Aufrechterhaltung der Funktionalita:t einzelner Ports innerhalb der sich
   vera:ndernden Ports-Sammlung.

   Als Ports-Maintainer werden Sie folgende Herausforderungen meistern:

     * Neue Software-Versionen und Aktualisierungen. Neue Versionen und
       Aktualisierung von bereits portierter Software werden kontinuierlich
       vero:ffentlicht und mu:ssen in die Ports-Sammlung integriert werden,
       um aktuelle Software ausliefern zu ko:nnen.

     * A:nderungen an Abha:ngigkeiten ihres Ports. Wenn bedeutende
       A:nderungen an den Abha:ngigkeiten Ihres Ports gemacht wurden, kann es
       vonno:ten sein, diesen zu aktualisieren, damit er weiterhin korrekt
       funktioniert.

     * A:nderungen an abha:ngigen Ports. Wenn andere Ports von einem Ihrer
       betreuten Ports abha:ngig sind, mu:ssen A:nderungen eventuell mit
       anderen Maintainern abgesprochen werden.

     * Zusammenwirken von anderen Benutzern, Maintainern und Entwicklern. Ein
       Teil der Aufgabe eines Maintainers ist es, Support zu leisten. Damit
       ist kein Hauptsupport fu:r die Software gemeint (wir haben allerdings
       nichts dagegen, wenn Sie sich dennoch entscheiden, dies zu tun). Ihre
       Aufgabe ist aber, sich um FreeBSD-spezifische Fragen zu Ihren Ports zu
       ku:mmern.

     * Bugs finden. Eine Portierung ko:nnte vielleicht von
       FreeBSD-spezifischen Bugs beeinflusst werden. In einem solchen Fall
       ist es Ihre Aufgabe, den Fehler zu finden und zu beheben. Daher
       sollten Sie Ihren Port umfassend testen, um derartige Probleme zu
       entdecken, bevor Sie einen Port in die Ports-Sammlung aufnehmen.

     * A:nderungen an Ports, Infrastruktur und Lizenzen. Gelegentlich werden
       die Werkzeuge fu:r das Bauen von Ports erneuert oder es wird ein neuer
       Vorschlag zur Infrastruktur der Ports-Sammlung gemacht. Sie sollten
       von diesen A:nderungen wissen, falls Ihre Ports betroffen sind und
       aktualisiert werden mu:ssen.

     * A:nderungen am Basissystem. FreeBSD ist in sta:ndiger Entwicklung.
       A:nderungen an Software, Bibliotheken, dem Kernel oder sogar
       Lizenza:nderungen ko:nnen A:nderungsbedarf an den Ports auslo:sen.

  5.2. Aufgaben eines Maintainers

    5.2.1. Halten Sie Ihre Ports aktuell

   Dieser Abschnitt bietet einen kurzen U:berblick zu diesem Thema.
   Ausfu:hrliche Informationen zur Aktualisierung von Ports finden Sie im
   Porter-Handbuch.

    1. Achten Sie auf Aktualisierungen

       U:berwachen Sie Ihr Programm auf neue Versionen der Software,
       Aktualisierungen und Security-Fixes. Anku:ndigungen in Mailinglisten
       oder auf Nachrichtenseiten im Internet sind dabei sehr hilfreich.
       Manchmal werden Sie von Benutzern gefragt werden, wann Ihr Port eine
       Aktualisierung bekommt. Wenn Sie mit anderen Dingen bescha:ftigt sind
       oder aus sonstigen Gru:nden keine Aktualisierung bereitstellen
       ko:nnen, fragen Sie den Benutzer doch einfach, ob er Ihnen bei der
       Aktualisierung helfen mo:chte.

       Es kann auch vorkommen, dass Sie eine automatisch generierte E-Mail
       vom FreeBSD Ports Version Check bekommen, die Sie daru:ber informiert,
       dass eine aktuellere Version des Distfiles Ihres Ports verfu:gbar ist.
       Weitere Informationen u:ber dieses System (inklusive einer Erkla:rung,
       wie Sie derartige E-Mails in Zukunft vermeiden ko:nnen) finden Sie
       ebenfalls in einer solchen Nachricht.

    2. Aufnehmen von A:nderungen

       Wenn verfu:gbar, integrieren Sie die Vera:nderungen in den Port. Sie
       mu:ssen in der Lage sein, einen Patch zwischen dem alten und dem neuen
       Port zu generieren.

    3. Nachpru:fung und Test

       U:berpru:fen und testen Sie ihre A:nderungen gru:ndlich:

          * Kompilieren, installieren und testen Sie ihren Port auf so vielen
            Plattformen und Architekturen, wie Sie ko:nnen. Es kommt sehr
            ha:ufig vor, dass ein Port auf einem Entwicklungszweig oder einer
            Plattform funktioniert, auf einer anderen Plattform aber Fehler
            erzeugt.

          * Stellen Sie sicher, dass die Abha:ngigkeiten ihres Ports
            vollsta:ndig sind. Die empfohlene Vorgehensweise dafu:r ist, dass
            Sie ihre eigenen Ports in einer Tinderbox kompilieren. Weitere
            Informationen zu diesem Thema finden Sie im Abschnitt Ressourcen
            dieses Artikels.

          * Stellen Sie sicher, dass die Liste der zu installierenden Dateien
            und Verzeichnisse aktuell ist.

          * U:berpru:fen Sie ihren Port mit portlint(1). Sehen Sie sich dazu
            den Abschnitt Ressourcen an. Dieser entha:lt wichtige
            Informationen zum Einsatz von portlint.

          * Achten Sie darauf, dass A:nderungen an Ihrem Port nicht den Bau
            eines anderen Ports verhindern. Ist dies der Fall, besprechen Sie
            die von Ihnen durchgefu:hrten A:nderungen mit den Maintainern der
            betroffenen Ports. Dies ist besonders dann wichtig, wenn Ihre
            Aktualisierung die "Shared Library"-Version a:ndert; in diesem
            Fall werden Sie fu:r die abha:ngigen Ports einen
            PORTREVISION-Bump beno:tigen, damit diese von automatisierten
            Werkzeugen wie portmaster oder portupgrade(1) auf dem neuesten
            Stand gehalten werden.

    4. A:nderungen einreichen

       Reichen Sie ihre Aktualisierungen mit einem PR ein, welcher die
       A:nderungen erkla:rt und einen Patch entha:lt, der die A:nderungen
       zwischen dem Original und Ihrer aktualisierten Version umfasst. Lesen
       Sie bitte zuerst den Artikel Writing FreeBSD Problem Reports, der das
       korrekte Einreichen von Problemberichten beschreibt.

  Anmerkung:

       Bitte schicken Sie kein shar(1)-Archiv des gesamten Ports. Benutzen
       Sie stattdessen diff(1) -ruN. Auf diese Art und Weise ko:nnen
       Committer viel einfacher erkennen, welche A:nderungen vorgenommen
       wurden. Das Porter-Handbuch entha:lt viele nu:tzliche Informationen
       zum Upgrading eines Ports.

    5. Warten

       Es kann nur sehr wenig Zeit vergehen, bis sich ein Committer mit Ihrem
       PR befasst. Es kann aber auch mehrere Wochen dauern, bis eine Reaktion
       erfolgt - haben Sie bitte Geduld.

    6. Feedback geben

       Wenn ein Committer Probleme in Ihren A:nderungen entdeckt, wird er Sie
       daru:ber informieren. Eine schnelle Reaktion Ihrerseits ist hilfreich,
       um Ihren PR rasch bearbeiten zu ko:nnen. Ausserdem hilft es Ihnen, den
       Faden nicht zu verlieren, wenn Sie versuchen, aufgetretene Probleme zu
       lo:sen.

    7. Und zuletzt...

       Ihre A:nderungen werden u:bermittelt und im Anschluss daran wird Ihr
       Port aktualisiert. Der betreffende PR wird danach vom Committer
       geschlossen. Herzlichen Glu:ckwunsch, Sie haben es geschafft!

    5.2.2. Stellen Sie sicher, dass Ihre Ports den Buildprozess weiterhin
    erfolgreich durchlaufen

   Dieser Abschnitt beschreibt, wie Sie Probleme entdecken und beheben, die
   ihre Ports daran hindern, den Buildprozess erfolgreich zu durchlaufen.

   FreeBSD garantiert nur fu:r die -STABLE-Zweige, dass die Ports-Sammlung
   korrekt funktioniert. Sie sollten 7-STABLE oder 8-STABLE benutzen, wobei
   der letztere Zweig bevorzugt wird. Theoretisch sollte es ausreichen, das
   aktuelle "Stable Release" des jeweiligen STABLE-Zweigs einzusetzen (da die
   ABIs in der Regel nicht gea:ndert werden), es empfiehlt sich aber, dem
   jeweiligen STABLE-Zweig zu folgen.

   Seit die Mehrheit von FreeBSD-Installationen auf PC-kompatiblen Maschinen
   arbeitet (i386-Architektur) erwarten wir, dass Ihr Port auf dieser
   Architektur funktioniert. Ebenfalls bevorzugen wir es, wenn Ports nativ
   auf der amd64-Architektur funktionieren. Es ist durchaus in Ordnung, um
   Hilfe zu fragen, wenn Sie keine solche Maschine besitzen.

  Anmerkung:

   Ha:ufige Fehler beim Umgang mit nicht-i386 Maschinen entstehen, weil
   Programmierer u:r Instanzen und Pointer ints verwendeten, oder weil der
   relativ simple gcc-Compiler genutzt wird. Immer mehr Programmautoren
   u:berarbeiten ihren Code, um diese Fehler zu beseitigen - wenn der
   Programmautor seinen Code allerdings nicht aktiv betreut, mu:ssen Sie dies
   eventuell selbst in die Hand nehmen.

   Sie sollten die folgende Liste durchgehen, um sicherzustellen, dass Ihr
   Port gebaut werden kann:

    1. Achten Sie auf Build-Fehler

       U:berpru:fen Sie regelma:ssig den Ports Building Cluster pointyhat und
       den Distfiles-Scanner, um festzustellen, ob einer Ihrer Ports nicht
       gebaut oder die Distfiles nicht geladen werden ko:nnen (lesen Sie den
       Abschnitt Ressourcen dieses Artikels fu:r weitere Informationen zu
       diesen Systemen). Fehlerberichte kommen eventuell auch von anderen
       Benutzern oder als automatisierte Meldungen per E-Mail.

    2. Sammeln Sie Informationen

       Wenn Sie ein Problem entdecken, beno:tigen Sie als Erstes
       Informationen, die Ihnen dabei helfen, dieses Problem zu beheben.
       Build-Fehler, die von pointyhat gemeinsam mit Logdateien verschickt
       werden, zeigen Ihnen, an welcher Stelle der Fehler auftritt. Wenn
       Ihnen ein Fehler von einem anderen Benutzer mitgeteilt wird, fragen
       Sie nach, ob er bereit ist, ihnen Informationen zukommen zu lassen,
       die eventuell bei der Diagnose des Problems helfen ko:nnen, wie z.B.:

          * Build-Logs.

          * Die Werkzeuge und Optionen, mit denen ein Port gebaut wurde
            (inklusive der Optionen in /etc/make.conf).

          * Eine Liste installierter Pakete auf dem System kann mit
            pkg_info(1) erstellt werden.

          * Die FreeBSD-Version, welche benutzt wird, kann mit uname(1) -a
            ermittelt werden.

          * Wann die Ports-Sammlung das letzte Mal aktualisiert wurde.

          * Wann die INDEX-Datei zuletzt aktualisiert wurde.

    3. Suchen und finden Sie eine Lo:sung

       Leider gibt es keinen allgemein gu:ltigen Weg, dies zu tun. Denken Sie
       daran: Wenn Probleme auftauchen bitten Sie einfach jemanden um Hilfe!
       Ein guter Anfang ist die Mailingliste FreeBSD ports. Auch die
       Entwickler der Software selbst sind oft sehr hilfreich.

    4. A:nderungen u:bermitteln

       Genau wie beim Aktualisieren eines Ports sollten A:nderungen
       integriert, gepru:ft und getestet werden. Reichen Sie Ihre Arbeit als
       PR ein und geben Sie Feedback, falls dies notwendig ist.

    5. Patches an Programmautoren senden

       Manchmal mu:ssen Sie Patches erstellen, um einen Port unter FreeBSD
       zum Laufen zu bekommen. Einige (aber nicht alle) Programmautoren
       nehmen diese Patches in Ihren Code fu:r das na:chste Release auf. Dies
       kann den Benutzern anderer BSD-Systeme helfen und einiges an
       unno:tiger Mehrarbeit ersparen. Bitte betrachten Sie das Versenden von
       verwertbaren Patches an die Autoren als ein Gebot der Ho:flichkeit.

    5.2.3. Ermitteln Sie Bug-Reports und PRs, die Ihre Ports betreffen

   FreeBSD-spezifische Bugs werden meistens durch falsche Annahmen u:ber
   Build- und Laufzeitumgebungen, die nicht zu FreeBSD passen, verursacht.
   Derartige Probleme zu entdecken ist oft sehr schwierig, glu:cklicherweise
   sind derartige Probleme aber nicht sehr ha:ufig.

   Folgende Schritte sind notwendig, um sicherzustellen, dass ihr Port
   weiterhin wie gewu:nscht funktioniert:

    1. Antworten Sie auf Bug-Reports

       Bugs ko:nnen Ihnen als E-Mail durch die GNATS Problem Report database
       zugestellt werden, Sie ko:nnen Ihnen aber auch direkt von Benutzern
       gemeldet werden.

       Sie sollten innerhalb von 14 Tagen auf PRs und andere Berichte
       antworten. Versuchen Sie schnellstmo:glich zu antworten, selbst wenn
       Sie nur mitteilen ko:nnen, dass Sie noch etwas Zeit brauchen, bevor
       Sie den PR bearbeiten ko:nnen.

       Sollten Sie nicht innerhalb von 14 Tagen geantwortet haben, darf jeder
       Committer via maintainer-timeout auf einen PR, den Sie nicht
       beantwortet haben, reagieren.

    2. Sammeln Sie Informationen

       Wenn mit dem Bug-Report nicht auch gleichzeitig eine Lo:sung
       u:bermittelt wird, mu:ssen Sie zuerst die zum Beheben des Problems
       no:tigen Informationen sammeln.

       Wenn der Fehler reproduzierbar ist, ko:nnen Sie die meisten
       Informationen selbst sammeln. Wenn nicht, bitten Sie die Person, die
       den Fehler gefunden hat, diese Informationen fu:r Sie zu sammeln:

          * Eine genaue Beschreibung dessen, was Er/Sie getan hat, den
            erwarteten Programmverlauf und den tatsa:chlichen Ablauf.

          * Eine Kopie der Eingabedaten, die den Fehler auslo:sen.

          * Informationen u:ber das System, auf dem der Port gebaut und
            ausgefu:hrt wird, etwa die Liste der installierten Pakete sowie
            die Ausgabe von env(1).

          * Core dumps.

          * Stack traces.

    3. Schliessen Sie falsche Reports aus

       Einige Fehlerberichte sind eventuell falsch. Es kommt vor, dass ein
       Programm falsch benutzt wird. Weiterhin ko:nnen installierten Pakete
       veraltet sein und mu:ssten einfach nur aktualisiert werden. Manchmal
       ist ein gemeldeter Fehler auch nicht FreeBSD-spezifisch. In diesem
       Fall melden Sie den Fehler den derzeitigen Entwicklern der Software.
       Wenn Sie in der Lage sind, den Fehler zu beheben, ko:nnen Sie dies
       natu:rlich trotzdem tun und den Entwicklern Ihren Patch zukommen
       lassen.

    4. Lo:sungen finden

       Bei Build-Fehlern werden Sie eine Lo:sung finden mu:ssen. Denken Sie
       daran zu fragen, wenn Sie nicht weiterkommen!

    5. A:nderungen einreichen oder annehmen

       Genau so wie bei der Aktualisierung eines Ports sollten Sie alle
       A:nderungen zuvor analysieren und testen, um Sie danach als neuen PR
       (oder als Folgebericht (follow-up), falls ein PR zu diesem Problem
       bereits existiert) einzureichen. Falls ein anderer Anwender
       A:nderungen fu:r einen PR eingereicht hat, ko:nnen Sie einen
       Folgebericht erstellen, mit dem Sie die vorgeschlagenen A:nderungen
       akzeptieren oder (mit einer Begru:ndung) ablehnen.

    5.2.4. Support leisten

   Teilaufgabe eines Maintainers ist es, Support zu leisten - nicht den
   Hauptsupport fu:r die Software - aber fu:r seine Ports und
   FreeBSD-spezifische Schlampereien und Probleme. Benutzer kontaktieren Sie
   vielleicht wegen Fragen, Anregungen, Problemen und Patches. Die meiste
   Zeit werden sich derartige Mitteilungen spezifisch auf FreeBSD beziehen.

   Manchmal mu:ssen Sie eventuell ihre diplomatischen Fa:higkeiten
   auffrischen und Benutzer freundlich an die korrekten Anlaufstellen fu:r
   den Hauptsupport verweisen. Nur selten werden Sie auf eine Person treffen,
   die Sie fragt, warum die RPMs nicht aktuell sind oder wie Sie die Software
   unter Foo Linux zum Laufen bringen. Ergreifen Sie die Gelegenheit und
   berichten Sie, dass Ihr Port aktuell ist (natu:rlich nur, wenn er es auch
   tatsa:chlich ist) und schlagen Sie vor, einmal FreeBSD auszuprobieren.

   Wenn Sie Glu:ck haben, werden Benutzer und Entwickler gelegentlich daran
   denken, dass Sie eine sehr bescha:ftigte Person sind, deren Zeit nicht
   unerscho:pflich, sondern kostbar ist, und werden vielleicht ein Teil Ihrer
   Arbeit fu:r Sie u:bernehmen. Beispielsweise ko:nnten sie:

     * Einen PR einreichen oder Ihnen Patches schicken.

     * Einen vorhandenen PR untersuchen und eventuell einen Patch dazu
       erstellen.

     * Ihnen A:nderungen fu:r Ihre Ports zusenden.

   In diesem Fall ist ihre Hauptaufgabe zeitnahes Antworten. Der Timeout fu:r
   nicht ansprechbare Maintainer betra:gt auch hier wieder 14 Tage. Nach
   dieser Periode ko:nnen A:nderungen ohne ihre Pru:fung eingereicht werden.
   Diese Personen haben sich die Arbeit gemacht, etwas fu:r Sie zu
   u:bernehmen, versuchen Sie daher, mo:glichst rasch zu antworten. Danach
   u:berpru:fen, akzeptieren, vera:ndern oder diskutieren Sie diese
   A:nderungen mit den betroffenen Personen so schnell wie mo:glich.

   Wenn Sie vermitteln ko:nnen, dass Sie deren Arbeit zu scha:tzen wissen
   (und das sollten Sie), dann werden Sie eine bessere Chance haben, dass
   diese Personen ihnen auch in Zukunft etwas Arbeit abnehmen. :-)

6. Defekte Ports finden und reparieren

   Es gibt zwei wirklich gute Anlaufstellen, um Ports zu finden, die ihre
   Aufmerksamkeit beno:tigen.

   Sie ko:nnen das Web Interface der Problem Reports-Datenbank nutzen, um
   nach ungelo:sten Problemen zu suchen. Die Mehrheit der PRs, die zu Ports
   eingereicht werden, betreffen Aktualisierungsprobleme, aber mit ein
   bisschen Recherche in den U:bersichten und Zusammenfassungen sollten Sie
   das eine oder andere Interessante finden. (Die Kategorie sw-bug ist ein
   guter Platz, um mit der Arbeit zu beginnen).

   Die zweite Anlaufstelle ist das FreeBSD Ports Monitoring System. Hier
   ko:nnen Sie nicht betreute Ports mit Build-Fehlern und Ports, die als
   BROKEN gekennzeichnet sind, finden. Natu:rlich ist es auch in Ordnung,
   A:nderungen an betreuten Ports zu machen. Denken Sie aber bitte daran, den
   Maintainer zuvor davon zu informieren, da dieser mo:glicherweise bereits
   an diesem Problem arbeitet.

   Sobald Sie einen Fehler oder ein Problem gefunden haben, sammeln Sie dazu
   Informationen und versuchen Sie, den Fehler zu analysieren und zu beheben!
   Wenn sich bereits ein PR mit diesem Problem befasst, knu:pfen Sie dort an.
   Ansonsten reichen Sie einen neuen PR ein. Die von Ihnen vorgeschlagenen
   A:nderungen werden danach gepru:ft. Sind diese in Ordnung, werden Sie
   danach committed.

7. Sagen Sie Bescheid, wenn Sie einen Port nicht mehr betreuen mo:chten

   So wie Ihre Interessen sich a:ndern, haben Sie vielleicht irgendwann auch
   nicht mehr die Zeit, weiterhin einige (oder alle) Ihrer Ports zu betreuen.
   Das ist versta:ndlich. Bitte lassen Sie es uns wissen, wenn Sie keine Zeit
   oder kein Interesse mehr daran haben, Maintainer zu sein oder einen Port
   selbst nicht mehr benutzen und deshalb gerne abgeben wollen. Nur auf diese
   Art und Weise ko:nnen wir vorankommen und anderen anbieten, an diesen
   Ports zu arbeiten, ohne dass diese auf Ihre Antworten warten mu:ssen.
   Denken Sie daran: FreeBSD ist ein Freiwilligen-Projekt. Wenn Ihnen eine
   Aufgabe keinen Spass mehr macht, ist es wahrscheinlich an der Zeit, jemand
   anderen an Ihre Ports zu lassen.

   In jedem Fall beha:lt sich das Ports Management Team (portmgr) das Recht
   vor, Ihnen den Maintainer-Status abzuerkennen, wenn Sie fu:r la:ngere Zeit
   nicht aktiv sind (derzeit liegt diese Grenze bei drei Monaten). Damit ist
   gemeint, dass ungelo:ste Probleme oder ausstehende Aktualisierungen in
   diesem Zeitraum nicht bearbeitet wurden.

8. Ressourcen fu:r Ports-Maintainer und Committer

   Das Porter-Handbuch ist Ihr "Ratgeber zum Ports-System" und sollte stets
   in Ihrer Reichweite sein!

   Der Artikel Writing FreeBSD Problem Reports beschreibt, wie PRs formuliert
   und eingereicht werden sollen. Allein im Jahr 2005 wurden mehr als 11.000
   PRs zu verschiedenen Ports eingereicht! Wenn Sie die Anweisungen dieses
   Artikels befolgen, werden wir weniger Zeit beno:tigen, um Ihre PRs zu
   bearbeiten.

   Die Problem Report Database.

   Pointyhat ist der Ports Build Cluster. Sie ko:nnen Pointyhat nutzen, um
   nach Port-Buildlogs u:ber alle Architekturen und Haupt-Releases zu suchen.

   Das FreeBSD Ports Monitoring System kann verschiedene Informationen u:ber
   Ports enthalten, beispielsweise Build-Fehler und Problemberichte. Als
   Ports-Maintainer ko:nnen Sie hier den Buildstatus Ihres Ports in Erfahrung
   bringen. Als Committer ko:nnen Sie dort defekte und unbetreute Ports
   finden, die gefixt werden mu:ssten.

   Der FreeBSD Ports Distfile-Scanner kann Ihnen die Ports anzeigen, deren
   Distfiles nicht erreichbar sind. Sie ko:nnen damit Ihre eigenen Ports
   pru:fen oder auch herauszufinden, ob die MASTER_SITES-Eintra:ge bestimmter
   Ports nicht mehr aktuell sind.

   Der tinderbox-Port ist die gru:ndlichste Lo:sung, um den Port wa:hrend des
   ganzen Prozesses der Installation, Paketerstellung und Deinstallation zu
   testen. Das Programm bietet sowohl eine Kommandozeilen- als auch eine
   Web-Schnittstelle. Weitere Informationen zu diesem Port finden Sie im
   Verzeichnis ports/ports-mgmt/tinderbox sowie auf der Tinderbox Homepage.

   Mit portlint(1) ko:nnen Sie einen Port auf die Einhaltung von
   stilistischen und funktionellen Richtlinien hin u:berpru:fen. Da es sich
   bei portlint um eine heuristische Anwendung handelt, sollten Sie dessen
   Ausgaben nur als einen Ratgeber verwenden. Wenn portlint zu umfangreiche
   A:nderungen vorschla:gt, lesen Sie nochmal das Porter-Handbuch oder bitten
   Sie jemanden um Rat.

   Die Mailingliste FreeBSD ports ist fu:r allgemeine Diskussionen u:ber
   Ports vorgesehen. Wenn Sie Hilfe beno:tigen ko:nnen Sie dort nachfragen.
   Sie ko:nnen einzelne Mailinglisten auch abonnieren oder in deren Archiven
   suchen und lesen. Die Mailinglisten FreeBSD ports bugs und FreeBSD CVS
   ports commit ko:nnten fu:r Sie ebenfalls von Interesse sein.

Stichwortverzeichnis

  P

   Ports, beitragen, Zur FreeBSD Ports-Sammlung beitragen
