                  Zur FreeBSD Ports-Sammlung beitragen

  Sam Lawrance

  Mark Linimon

   $FreeBSD:
   release/8.4.0/de_DE.ISO8859-1/articles/contributing-ports/article.xml
   40650 2013-01-16 08:53:39Z bcr $

   $FreeBSD:
   release/8.4.0/de_DE.ISO8859-1/articles/contributing-ports/article.xml
   40650 2013-01-16 08:53:39Z bcr $

   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.

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

   U:bersetzt von Martin Wilke.

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

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

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.

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

     Wenn Sie Fragen zu FreeBSD haben, schicken Sie eine E-Mail an
                   <de-bsd-questions@de.FreeBSD.org>.
Wenn Sie Fragen zu dieser Dokumentation haben, schicken Sie eine E-Mail
                an <de-bsd-translators@de.FreeBSD.org>.
