as 2007-08-05 23:58:09 UTC
FreeBSD ports repository
Modified files:
books/porters-handbook book.sgml
Log:
Kapitel 10 formatiert.
Revision Changes Path
1.110 +127 -115 de-docproj/books/porters-handbook/book.sgml
Index: book.sgml
===================================================================
RCS file: /home/cvs/de-docproj/books/porters-handbook/book.sgml,v
retrieving revision 1.109
retrieving revision 1.110
diff -u -I$FreeBSDde.*$ -r1.109 -r1.110
--- book.sgml 5 Aug 2007 21:58:28 -0000 1.109
+++ book.sgml 5 Aug 2007 23:58:09 -0000 1.110
@@ -9995,124 +9995,136 @@
</sect1>
</chapter>
- <chapter id="port-upgrading">
- <title>Einen Port aktualisieren</title>
+ <chapter id="port-upgrading">
+ <title>Einen Port aktualisieren</title>
- <para>Wenn Sie feststellen, dass ein Port verglichen mit
- der neuesten Version des Originalautors nicht mehr auf
- dem aktuellen Stand ist, sollten Sie als Erstes
- sicherstellen, dass Sie die aktuellste Version des Ports
- haben. Diese finden Sie im Verzeichnis
- <filename>ports/ports-current</filename> der FreeBSD
- FTP-Spiegelseiten. Wenn Sie allerdings mit mehr als ein
- paar Ports arbeiten, werden Sie es wahrscheinlich einfacher
- finden <application>CVSup</application> zu benutzen, um Ihre
- gesamte Ports-Sammlung aktuell zu halten, wie es im
- <ulink url="&url.books.handbook;/synching.html#CVSUP-CONFIG">Handbuch</ulink>
- beschrieben wird. Das hat zusätzlich den Vorteil,
- dass Sie so auch alle Abhängigkeiten des Ports
- aktuell halten.</para>
-
- <para>Der nächste Schritt besteht darin festzustellen,
- ob bereits eine Aktualisierung des Ports darauf wartet
- committet zu werden. Um das sicherzustellen haben Sie
- folgende Möglichkeiten. Es gibt eine durchsuchbare
- Schnittstelle zur
- <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">FreeBSD Problembericht Datenbank (PR - Problem Report)</ulink>
- (auch bekannt als <literal>GNATS</literal>). Wählen
- Sie dazu <literal>Ports</literal> im Drop-Down-Menü
- und geben Sie den Namen des Ports ein.</para>
-
- <para>Allerdings wird manchmal vergessen den Namen des Ports eindeutig im
- Feld für die Zusammenfassung anzugeben. In diesem Fall können Sie das
- <link linkend="portsmon">FreeBSD Ports Monitoring System</link> (auch
- bekannt als <literal>portsmon</literal>) nutzen. Dieses versucht PRs von Ports
- nach Portname zu sortieren. Um PRs nach einem bestimmten Port zu
- durchsuchen können Sie die
- <ulink url="http://portsmon.FreeBSD.org/portoverview.py">Übersicht
- eines Ports</ulink> verwenden.</para>
-
- <para>Wenn es keine wartenden PRs gibt, ist der nächste Schritt eine
- E-Mail an den Maintainer des Ports zu schicken, wie von
- <command>make maintainer</command> gezeigt wird. Diese Person arbeitet
- vielleicht schon an einer Aktualisierung, oder hat einen guten Grund
- den Port im Moment nicht zu aktualisieren (z.B. wegen
- Stabilitätsproblemen der neuen Version). Sie wollen sicher nicht die
- Arbeit des Maintainers doppelt machen. Beachten Sie bitte, dass für
- Ports ohne Maintainer <literal>ports(at)FreeBSD.org</literal> eingetragen
- ist. Das ist nur die allgemeine &a.ports;-Mailingliste, deshalb wird es in
- diesem Fall wahrscheinlich nicht helfen eine E-Mail dorthin zu
- schicken.</para>
-
- <para>Wenn Sie der Maintainer bittet die Aktualisierung zu erledigen,
- oder falls es keinen Maintainer gibt, haben Sie Gelegenheit FreeBSD
- zu helfen, indem Sie die Aktualisierung selbst bereitstellen. Bitte
- führen Sie die Änderungen durch und speichern Sie die Ausgabe des
- rekursiven <command>diff</command> des neuen und alten
- Portverzeichnisses (wenn Ihr verändertes Portverzeichnis z.B.
- <filename>superedit</filename> und das Original
- <filename>superedit.bak</filename> heißt, dann speichern Sie bitte die
- Ergebnisse von <command>diff -ruN superedit.bak superedit</command>).
- Sowohl vereinheitlichendes als auch kontextabhängiges
- diff (Auflistung der Unterschiede zweier Dateien) sind akzeptabel, aber
- im Allgemeinen bevorzugen Port-Committer vereinheitlichende
- <command>diff</command>s. Bitte beachten Sie die Verwendung der
- <literal>-N</literal>-Option. Dies ist der gebräuchliche Weg
- <command>diff</command> dazu zu bewegen korrekt damit umzugehen, neue
- Dateien anzulegen und alte zu löschen. Bevor Sie das diff einsenden
- überprüfen Sie bitte die Ausgabe, um sicherzugehen, dass die Änderungen
- sinnvoll sind. Um gängige Operationen mit Korrekturdateien zu
- vereinfachen, können Sie
- <filename>/usr/ports/Tools/scripts/patchtool.py</filename> benutzen.
- Aber lesen Sie bitte vorher
- <filename>/usr/ports/Tools/scripts/README.patchtool</filename>.</para>
-
- <para>Falls der Port keinen Maintainer hat und Sie ihn selbst aktiv
- benutzen, ziehen Sie bitte in Erwägung sich als Maintainer zu melden.
- &os; hat mehr als 2000 Ports ohne Maintainer und in diesem Bereich werden
- immer zusätzliche Freiwillige benötigt (Für eine
- ausführliche Beschreibung der Verantwortlichkeiten eines Maintainers
- lesen Sie bitte im
- <ulink url="&url.books.developers-handbook;/policies.html#POLICIES-MAINTAINER">
- Developer's Handbook</ulink> nach).</para>
-
- <para>Der beste Weg uns das diff zu schicken ist mittels &man.send-pr.1;
- (Kategorie Ports). Wenn Sie der Maintainer des Ports sind, fügen Sie
- bitte <literal>[maintainer update]</literal> an den Anfang Ihrer
- Zusammenfassung und setzen Sie die <quote>Klasse</quote> des PR auf
- <literal>maintainer-update</literal>. Ansonsten sollte die
- <quote>Klasse</quote> des PR <literal>change-request</literal> sein.
- Bitte erwähnen Sie alle hinzugefügten oder gelöschten Dateien in der
- Nachricht, da diese beim Commit ausdrücklich an &man.cvs.1; übergeben
- werden müssen. Wenn das diff größer ist als 20 Kilobyte komprimieren und
- uuencoden Sie es bitte. Ansonsten können Sie es in den PR einfügen wie
- es ist.</para>
-
- <para>Bevor Sie den PR mit &man.send-pr.1; abschicken, sollten Sie den
- Abschnitt <ulink url="&url.articles.problem-reports;/pr-writing.html">
- Den Problembericht schreiben</ulink> im Artikel über Problemberichte
- lesen. Dieser enthält sehr viel mehr Informationen darüber, wie man
- nützliche Problemberichte verfasst.</para>
-
- <important>
- <para>Wenn Sie Ihre Aktualisierung aufgrund von Sicherheitsbedenken
- oder eines schwerwiegenden Fehlers bereitstellen wollen, informieren
- Sie bitte das &a.portmgr;, um einen sofortigen Rebuild und eine
- Neuverteilung des Pakets Ihres Ports durchzuführen. Sonst werden
- ahnungslose Nutzer von &man.pkg.add.1; über mehrere Wochen die alte
- Version durch <command>pkg_add -r</command> installieren.</para>
- </important>
-
- <note>
- <para>Noch einmal: Bitte verwenden Sie &man.diff.1; und nicht
- &man.shar.1;, um Aktualisierungen existierender Ports zu senden.</para>
- </note>
+ <para>Wenn Sie feststellen, dass ein Port verglichen mit der
+ neuesten Version des Originalautors nicht mehr auf dem aktuellen
+ Stand ist, sollten Sie als Erstes sicherstellen, dass Sie die
+ aktuellste Version des Ports haben. Diese finden Sie im
+ Verzeichnis <filename>ports/ports-current</filename> der FreeBSD
+ FTP-Spiegelseiten. Wenn Sie allerdings mit mehr als ein paar
+ Ports arbeiten, werden Sie es wahrscheinlich einfacher finden
+ <application>CVSup</application> zu benutzen, um Ihre gesamte
+ Ports-Sammlung aktuell zu halten, wie es im <ulink
+ url="&url.books.handbook;/synching.html#CVSUP-CONFIG">Handbuch</ulink>
+ beschrieben wird. Das hat zusätzlich den Vorteil, dass Sie
+ so auch alle Abhängigkeiten des Ports aktuell
+ halten.</para>
+
+ <para>Der nächste Schritt besteht darin festzustellen, ob
+ bereits eine Aktualisierung des Ports darauf wartet committet zu
+ werden. Um das sicherzustellen haben Sie folgende
+ Möglichkeiten. Es gibt eine durchsuchbare Schnittstelle zur
+ <ulink
+ url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">FreeBSD
+ Problembericht Datenbank (PR - Problem Report)</ulink> (auch
+ bekannt als <literal>GNATS</literal>). Wählen Sie dazu
+ <literal>Ports</literal> im Drop-Down-Menü und geben Sie
+ den Namen des Ports ein.</para>
+
+ <para>Allerdings wird manchmal vergessen den Namen des Ports
+ eindeutig im Feld für die Zusammenfassung anzugeben. In
+ diesem Fall können Sie das <link linkend="portsmon">FreeBSD
+ Ports Monitoring System</link> (auch bekannt als
+ <literal>portsmon</literal>) nutzen. Dieses versucht PRs von
+ Ports nach Portname zu sortieren. Um PRs nach einem bestimmten
+ Port zu durchsuchen können Sie die <ulink
+ url="http://portsmon.FreeBSD.org/portoverview.py">Übersicht
+ eines Ports</ulink> verwenden.</para>
+
+ <para>Wenn es keine wartenden PRs gibt, ist der nächste
+ Schritt eine E-Mail an den Maintainer des Ports zu schicken, wie
+ von <command>make maintainer</command> gezeigt wird. Diese
+ Person arbeitet vielleicht schon an einer Aktualisierung, oder
+ hat einen guten Grund den Port im Moment nicht zu aktualisieren
+ (z.B. wegen Stabilitätsproblemen der neuen Version). Sie
+ wollen sicher nicht die Arbeit des Maintainers doppelt machen.
+ Beachten Sie bitte, dass für Ports ohne Maintainer
+ <literal>ports(at)FreeBSD.org</literal> eingetragen ist. Das ist
+ nur die allgemeine &a.ports;-Mailingliste, deshalb wird es in
+ diesem Fall wahrscheinlich nicht helfen eine E-Mail dorthin zu
+ schicken.</para>
+
+ <para>Wenn Sie der Maintainer bittet die Aktualisierung zu
+ erledigen, oder falls es keinen Maintainer gibt, haben Sie
+ Gelegenheit FreeBSD zu helfen, indem Sie die Aktualisierung
+ selbst bereitstellen. Bitte führen Sie die Änderungen
+ durch und speichern Sie die Ausgabe des rekursiven
+ <command>diff</command> des neuen und alten Portverzeichnisses
+ (wenn Ihr verändertes Portverzeichnis z.B.
+ <filename>superedit</filename> und das Original
+ <filename>superedit.bak</filename> heißt, dann speichern
+ Sie bitte die Ergebnisse von <command>diff -ruN superedit.bak
+ superedit</command>). Sowohl vereinheitlichendes als auch
+ kontextabhängiges diff (Auflistung der Unterschiede zweier
+ Dateien) sind akzeptabel, aber im Allgemeinen bevorzugen
+ Port-Committer vereinheitlichende <command>diff</command>s.
+ Bitte beachten Sie die Verwendung der
+ <literal>-N</literal>-Option. Dies ist der gebräuchliche
+ Weg <command>diff</command> dazu zu bewegen korrekt damit
+ umzugehen, neue Dateien anzulegen und alte zu löschen.
+ Bevor Sie das diff einsenden überprüfen Sie bitte die
+ Ausgabe, um sicherzugehen, dass die Änderungen sinnvoll
+ sind. Um gängige Operationen mit Korrekturdateien zu
+ vereinfachen, können Sie
+ <filename>/usr/ports/Tools/scripts/patchtool.py</filename>
+ benutzen. Aber lesen Sie bitte vorher
+ <filename>/usr/ports/Tools/scripts/README.patchtool</filename>.</para>
+
----------------------------------------------
Diff block truncated. (Max lines = 200)
----------------------------------------------
To Unsubscribe: send mail to majordomo(at)de.FreeBSD.org
with "unsubscribe de-cvs-doc" in the body of the message
Received on Mon 06 Aug 2007 - 01:59:38 CEST