diff --git a/de_DE.ISO8859-1/articles/contributing/article.sgml b/de_DE.ISO8859-1/articles/contributing/article.sgml
index bbd7afcce0..1283ff4516 100644
--- a/de_DE.ISO8859-1/articles/contributing/article.sgml
+++ b/de_DE.ISO8859-1/articles/contributing/article.sgml
@@ -1,614 +1,626 @@
 <!--
       The FreeBSD Documentation Project
       The FreeBSD German Documentation Project
 
       $FreeBSD$
-      $FreeBSDde: de-docproj/articles/contributing/article.sgml,v 1.4 2007/07/16 06:25:27 jkois Exp $
-      basiert auf:  1.506
+      $FreeBSDde: de-docproj/articles/contributing/article.sgml,v 1.8 2007/11/11 13:49:28 miwi Exp $
+      basiert auf:  1.508
 -->
 
 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 <!ENTITY % articles.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//DE">
 %articles.ent;
 <!ENTITY % not.published "IGNORE">
 ]>
 
 <article lang="de">
   <articleinfo>
     <title>&os; unterst&uuml;tzen</title>
 
     <pubdate>$FreeBSD$</pubdate>
 
     <abstract>
       <para>Dieser Artikel beschreibt, wie Einzelpersonen oder
         Unternehmen das &os;-Projekt unterst&uuml;tzen
         k&ouml;nnen.</para>
 
       <para><emphasis>&Uuml;bersetzt von Johann Kois</emphasis>.</para>
 
     </abstract>
 
     <authorgroup>
       <author>
 	<firstname>Jordan</firstname>
 	<surname>Hubbard</surname>
 	<contrib>Beigetragen von </contrib>
       </author>
     </authorgroup>
 
     <legalnotice id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.ieee;
       &tm-attrib.general;
     </legalnotice>
   </articleinfo>
 
   <indexterm><primary>Unterst&uuml;tzung</primary></indexterm>
 
   <para>Sie wollen &os; unterst&uuml;tzen?  Das ist gro&szlig;artig!
     &os; ist auf die Unterst&uuml;tzung seiner Anwender
     <emphasis>angewiesen</emphasis>, um zu &uuml;berleben.  Ihre
     Beitr&auml;ge werden nicht nur begr&uuml;&szlig;t, sie sind
     f&uuml;r die Weiterentwicklung von &os; von elementarer
     Bedeutung.</para>
 
   <para>Im Gegensatz zu dem, was einige Leute Ihnen einreden wollen,
     m&uuml;ssen Sie kein Spitzenprogrammierer oder pers&ouml;nlicher
     Freund eines Mitglieds des FreeBSD-Core-Teams sein, damit Ihre
     Beitr&auml;ge akzeptiert werden.  Ein gro&szlig;e und wachsende
     Anzahl von internationalen Unterst&uuml;tzern verschiedenen
     Alters und mit verschiedenen technischen F&auml;higkeiten
     entwickelt FreeBSD weiter.  Es gibt immer mehr zu tun, als
     von den beteiligten Personen bew&auml;ltigt werden kann, daher
     freuen wir uns &uuml;ber jede Hilfe.</para>
 
   <para>Das FreeBSD-Projekt ist f&uuml;r ein komplettes Betriebssytem
     verantwortlich, nicht nur f&uuml;r einen Kernel oder ein paar
     verstreute Werkzeuge.  Daher umfasst unsere
     <filename>TODO</filename>-Liste viele verschiedene Aufgabenbereiche:
     Angefangen von der Dokumentation, &uuml;ber Betatests und
     Pr&auml;sentationen bis zu Systeminstallationen und speziellen
     Weiterentwicklungen des Kernels.  Da F&auml;higkeiten in den
     verschiedensten Bereichen ben&ouml;tigt werden, kann fast jeder
     etwas zu diesem Projekt beitragen.</para>
 
   <para>Personen, die im kommerziellen Umfeld mit FreeBSD zu tun haben,
     sind ebenfalls aufgefordert, sich bei uns zu melden.  Brauchen Sie
     eine spezielle Erweiterung, damit Ihr Produkt funktioniert?  Wir
     kommen Ihren W&uuml;nschen gerne entgegen, vorausgesetzt, sie sind
     nicht zu speziell.  Arbeiten Sie an einem Mehrwertprodukt?  Dann
     informieren Sie uns bitte!  Wir k&ouml;nnten in der Lage sein, an
     einem Teil davon mitzuarbeiten.  Die Welt der freien Software
     fordert viele bestehenden Annahmen &uuml;ber die Entwicklung, den
     Verkauf und die Wartung von Software heraus, und wir bitten Sie,
     ernsthaft dar&uuml;ber nachzudenken.</para>
 
   <sect1 id="contrib-what">
     <title>Was wird gebraucht?</title>
 
     <para>Die folgende Liste von Aufgaben und Unterprojekten
       repr&auml;sentiert eine Zusammenfassung von
       verschiedenen <filename>TODO</filename>-Listen und
       Benutzerw&uuml;nschen.</para>
 
     <sect2 id="non-programmer-tasks">
       <title>Aufgaben f&uuml;r Nicht-Programmierer</title>
 
       <para>Viele Menschen, die an FreeBSD beteiligt sind, sind keine
 	Programmierer.  Es sind Leute, die an der Dokumentation arbeiten,
 	Internetseiten erstellen oder einfach Hilfe anbieten.  Alles, was
 	diese Leute mitbringen m&uuml;ssen, sind Zeit und die
 	Bereitschaft, etwas zu lernen.</para>
 
       <orderedlist>
 	<listitem>
 	  <para>Lesen Sie die h&auml;ufig gestellten Fragen (FAQ) und
 	    das Handbuch gelegentlich.  Wenn etwas schlecht erkl&auml;rt
 	    wird, veraltet oder einfach falsch ist, teilen Sie es uns
 	    mit.  Oder noch besser, korrigieren Sie es (SGML ist nicht
 	    schwer zu erlernen, wir akzeptieren aber auch Vorschl&auml;ge
 	    im ASCII-Format.).</para>
 	</listitem>
 
 	<listitem>
 	  <para>Helfen Sie dabei, die Dokumentation in Ihre Muttersprache
 	    zu &uuml;bersetzen.  Wenn an der &Uuml;bersetzung in Ihre
 	    Sprache bereits gearbeitet wird, helfen Sie, indem Sie
 	    weitere Dokumente &uuml;bersetzen, oder sorgen Sie daf&uuml;r,
 	    dass die &Uuml;bersetzungen aktuell sind.  Lesen Sie zuerst
 	    die <ulink url="&url.books.fdp-primer;/translations.html">
 	    &Uuml;bersetzungs-FAQ</ulink> der Fibel f&uuml;r neue
 	    Mitarbeiter des FreeBSD-Dokumentations-Projekts. Sie
 	    verpflichten sich dabei nicht dazu, jede einzelne Seite zu
 	    &uuml;bersetzen &mdash; als Freiwilliger &uuml;bersetzen
 	    Sie genau so viel, wie Sie wollen.  Wenn jemand mit der
 	    &Uuml;bersetzung beginnt, beteiligen sich fast immer auch
 	    andere Personen daran.  Wenn Sie nur Zeit und
 	    Energie f&uuml;r einen Teil der Dokumentation haben, dann
 	    &uuml;bersetzen Sie bitte die Installationsanleitung.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Lesen Sie &a.questions; sowie die &ng.misc;
 	    gelegentlich (oder sogar regelm&auml;&szlig;ig).  Es kann
 	    sehr befriedigend sein, wenn Sie Ihr Wissen teilen und
 	    anderen Leuten dabei helfen k&ouml;nnen, deren Probleme zu
 	    l&ouml;sen; vielleicht lernen Sie sogar noch etwas Neues!
 	    Diese Foren k&ouml;nnen auch eine Quelle f&uuml;r Ideen
 	    sein, an denen man arbeiten k&ouml;nnte.</para>
 	</listitem>
       </orderedlist>
     </sect2>
 
     <sect2 id="ongoing-programmer-tasks">
       <title>Aufgaben f&uuml;r Programmierer</title>
 
       <para>Die meisten der hier aufgef&uuml;hrten Aufgaben erfordern
 	entweder einen bedeutenden Zeitaufwand oder eine sehr gute
 	Kenntnis des FreeBSD-Kernels, oder beides.  Es gibt jedoch
 	genug Aufgaben, die auch f&uuml;r
 	<quote>Wochenendprogrammierer</quote> geeignet sind.</para>
 
       <orderedlist>
 	<listitem>
 	  <para>Wenn Sie FreeBSD-CURRENT installiert haben und &uuml;ber
 	    eine schnelle Internetanbindung verf&uuml;gen, k&ouml;nnen
 	    Sie von <hostid role="fqdn">current.FreeBSD.org</hostid>
 	    ein t&auml;glich neu erzeugtes Release herunterladen &mdash;
 	    versuchen Sie dann hin und wieder, das neueste Release zu
 	    installieren und melden Sie dabei eventuell auftretende
 	    Fehler.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Lesen Sie &a.bugs;.  Es k&ouml;nnte ein Problem geben,
 	    an dem Sie konstruktiv mitarbeiten k&ouml;nnten, oder
 	    f&uuml;r das es Patches gibt, die Sie testen k&ouml;nnten.
 	    Oder Sie k&ouml;nnten sogar versuchen, eines dieser Probleme
 	    selbst zu beheben.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Wenn Sie von Fehlerbehebungen wissen, die zwar
 	    erfolgreich auf -CURRENT angewendet wurden, die aber nach
 	    einem bestimmten Zeitraum nicht in -STABLE eingebracht
 	    wurden (normalerweise innerhalb einiger Wochen), erinnern
 	    Sie den Committer h&ouml;flich daran.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Verschieben Sie beigetragene Software im Quellcodebaum
 	    nach <filename>src/contrib</filename>.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Stellen Sie sicher, dass der Code in
 	    <filename>src/contrib</filename> aktuell ist.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Bauen Sie den Quellcodebaum (oder einen Teil des
 	    Baumes) mit aktivierten Compilerwarnungen und beheben
 	    Sie auftretende Fehlermeldungen.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Beheben Sie Fehlermeldungen bei der Installation
 	    von Ports, die auf unsauberen Code hinweisen (etwa die
 	    Verwendung von <function>gets()</function> oder die
 	    Einbindung von <filename>malloc.h</filename>).</para>
 	</listitem>
 
 	<listitem>
 	  <para>Wenn Sie einen Port repariert haben, senden Sie Ihre
 	    Patches an die urspr&uuml;nglichen Autoren (die dadurch
 	    die n&auml;chste Version des Ports verbessern
 	    k&ouml;nnen).</para>
 	</listitem>
 
 	<listitem>
 	  <para>Besorgen Sie sich Kopien von wichtigen Standards wie
 	    &posix;.  Als Ausgangspunkt f&uuml;r Ihre Suche k&ouml;nnen
 	    Sie die Seite des <ulink
 	    url="&url.base;/projects/c99/index.html">FreeBSD
 	    C99 & POSIX Standards Conformance Project</ulink> verwenden.
 	    Vergleichen Sie das Verhalten von FreeBSD mit dem von dem
 	    jeweiligen Standard geforderten Verhalten.  Verh&auml;lt
 	    sich FreeBSD in einem Bereich unterschiedlich, sollten Sie
 	    einen Problembericht (PR) einsenden.  Wenn Sie dazu in der
 	    Lage sind, k&ouml;nnen Sie sich auch eine L&ouml;sung des
 	    Problems &uuml;berlegen und Ihrem PR einen Patch
 	    anf&uuml;gen.  Wenn Sie der Meinung sind, dass der Standard
 	    nicht korrekt ist, k&ouml;nnen Sie auch das jeweilige
 	    Standardgremium um weitere Informationen bitten.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Schlagen Sie weitere Aufgaben f&uuml;r diese Liste
 	    vor!</para>
 	</listitem>
       </orderedlist>
     </sect2>
 
     <sect2>
       <title>Die PR-Datenbank durchsehen</title>
 
       <indexterm><primary>problem reports database</primary></indexterm>
 
       <para>Die <ulink
 	url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">FreeBSD
 	PR-Datenbank</ulink> enth&auml;lt alle derzeit offenen
 	Problemberichte und Verbesserungsw&uuml;sche, die von
 	Anwendern eingereicht wurden.  Die PR-Datenbank enth&auml;lt
 	sowohl Aufgaben f&uuml;r Programmierer als auch f&uuml;r
 	Nichtprogrammierer.  Gehen Sie die Liste der offenen PRs durch,
 	um festzustellen, ob Sie ein Problem interessiert.  Bei manchen
 	Berichten geht es nur darum, zu &uuml;berpr&uuml;fen, ob der
 	bereitgestellte Patch korrekt funktioniert.  Andere
 	Problemberichte sind hingegen komplexer, oder beinhalten
 	&uuml;berhaupt keinen L&ouml;sungsvorschlag.</para>
 
       <para>Beginnen Sie mit den PRs, die niemandem zugewiesen sind.
 	Ist ein PR, f&uuml;r den Sie eine L&ouml;sung h&auml;tten,
 	bereits jemandem zugewiesen, nehmen Sie mit dem daf&uuml;r
 	Zust&auml;ndigen Kontakt auf und fragen Sie ihn, ob Sie an
 	der L&ouml;sung mitarbeiten k&ouml;nnen &mdash; es k&ouml;nnte
 	etwa bereits ein Patch existieren, der nur noch getestet werden
 	muss, oder Sie k&ouml;nnten weitere Ideen mit ihm
 	diskutieren.</para>
     </sect2>
+
+    <sect2>
+      <title>W&auml;hlen Sie einen der Eintr&auml;ge auf der
+         <quote>Ideen</quote>-Seite aus</title>
+
+        <para>Die <ulink url="&url.base;/projects/ideas/">Liste
+	  von Projekten und Ideen</ulink> f&uuml;r &os; ist auch
+	  f&uuml;r Freiwillige interessant, die etwas zum &os; Projekt
+	  beitragen m&ouml;chten. Diese Liste wird regelm&auml;&szlig;ig
+	  aktualisiert und enth&auml;lt Eintr&auml;ge f&uuml;r Programmierer
+	  und Nicht-Programmierer sowie Informationen zu jedem Projekt.</para>
+    </sect2>
   </sect1>
 
   <sect1 id="contrib-how">
     <title>Was Sie tun k&ouml;nnen</title>
 
     <para>M&ouml;gliche Beitr&auml;ge lassen sich in f&uuml;nf
       Kategorien einteilen:</para>
 
     <sect2 id="contrib-general">
       <title>Fehlerberichte und allgemeine Vorschl&auml;ge</title>
 
       <para>Eine Idee oder ein Vorschlag von
 	<emphasis>allgemeinem</emphasis> technischen Interesse sollte
 	an &a.hackers; geschickt werden.  Personen, die an solchen
 	Fragen interessiert sind (und kein Problem mit einem
 	<emphasis>hohen</emphasis> Mailaufkommen haben!) k&ouml;nnen
 	die Mailingliste &a.hackers; auch abonnieren.  Informationen
 	zu dieser und anderen Mailinglisten finden Sie im <ulink
 	url="&url.books.handbook;/eresources.html#ERESOURCES-MAIL">
 	FreeBSD Handbuch</ulink>.</para>
 
       <para>Wenn Sie einen Fehler gefunden oder eine Verbesserung
 	entwickelt haben, vergessen Sie nicht, einen Bericht &uuml;ber
 	&man.send-pr.1; oder dessen <ulink
 	url="&url.base;/de/send-pr.html">Internetschnittstelle</ulink>
 	zu erstellen.  Versuchen Sie bitte, jedes Feld auszuf&uuml;llen.
 	Ist Ihr Patch kleiner als 65&nbsp;KB, sollten Sie ihn direkt in
 	den Bericht einbauen.  Kann der Patch direkt auf den Quellcodebaum
 	angewendet werden, f&uuml;gen Sie <literal>[PATCH]</literal>
 	im Synopsis-Feld ein.  Wenn Sie einen Patch einf&uuml;gen,
 	verwenden Sie bitte <emphasis>kein copy-and-paste</emphasis>,
 	weil dadurch Tabulatoren in Leerzeichen umgewandelt werden, was
 	den Patch unbrauchbar macht.  Sind die Patches gr&ouml;&szlig;er
 	als 20&nbsp;KB, sollten Sie sie komprimieren und mit
 	&man.uuencode.1; umwandeln.</para>
 
       <para>Nachdem Sie einen Bericht versandt haben, erhalten Sie eine
 	E-Mail, die eine Best&auml;tigung sowie eine
 	Identifikationsnummer enth&auml;lt.  Geben Sie diese Nummer im
 	Betreff der Nachricht an (<literal>"Re:  kern/3377"</literal>),
 	wenn Sie neue Informationen zu diesem Problem an
 	&a.bugfollowup; senden.
 	Zus&auml;tzliche Informationen zu Problemberichten sollten immer
 	auf diese Art und Weise verschickt werden.</para>
 
       <para>Sollten Sie innerhalb einer Woche keine Best&auml;tigung
 	erhalten, oder &man.send-pr.1; nicht verwenden k&ouml;nnen,
 	k&ouml;nnen Sie &uuml;ber &a.bugs; jemanden bitten, dies
 	f&uuml;r Sie zu erledigen.</para>
 
       <para>Weitere Informationen zum Verfassen von guten
 	Problemberichten finden Sie im entsprechenden <ulink
 	url="&url.articles.problem-reports.en;/article.html">
 	Artikel</ulink>.</para>
     </sect2>
 
     <sect2>
       <title>&Auml;nderungen der Dokumentation</title>
 
       <indexterm><primary>documentation submissions</primary></indexterm>
 
       <para>&Auml;nderungen der Dokumentation werden vom &a.doc;
 	&uuml;berwacht.  Lesen Sie bitte die <ulink
 	url="&url.books.fdp-primer;/index.html">Fibel für neue
 	Mitarbeiter des FreeBSD-Dokumentationsprojekts</ulink> f&uuml;r
 	weitere Informationen.  Korrekturen und Erg&auml;nzungen
 	(selbst kleine &Auml;nderungen sind willkommen!) werden mit
 	&man.send-pr.1; &uuml;bermittelt.  Lesen Sie dazu den Abschnitt
 	<link linkend="contrib-general">Fehlerberichte und allgemeine
 	Vorschl&auml;ge</link>.</para>
     </sect2>
 
     <sect2>
       <title>&Auml;nderungen am vorhandenen Quellcode</title>
 
       <indexterm><primary>FreeBSD-CURRENT</primary></indexterm>
 
       <para>&Auml;nderungen des existierenden Quellcodes sind etwas
 	komplizierter.  Entscheidend ist hier, wie
 	vertraut Sie mit dem aktuellen Entwicklungsstand von
 	FreeBSD sind.  Es existiert eine spezielle, st&auml;ndig
 	aktualisierte Version von FreeBSD, die als
 	<quote>FreeBSD-CURRENT</quote> bekannt ist.  Diese ist auf
 	verschiedenen Wegen erh&auml;ltlich und stellt den
 	aktuellen Stand der Entwicklung dar.  Lesen Sie den Abschnitt
 	<ulink url="&url.books.handbook;/current-stable.html">
 	FreeBSD-CURRENT vs. FreeBSD-STABLE</ulink> des Handbuchs
 	f&uuml;r weitere Informationen zur Installation und Verwendung
 	von FreeBSD-CURRENT.</para>
 
       <para>Arbeiten Sie mit &auml;lteren Quellcodeversionen, kann
 	dies leider bedeuten, das Ihre &Auml;nderungen obsolet sind,
 	oder sich nicht mehr in FreeBSD reintegrieren lassen.  Dieses
 	Risiko l&auml;sst sich verringern, wenn Sie die Mailinglisten
 	&a.announce; und &a.current; abonnieren, auf denen aktuelle
 	System&auml;nderungen diskutiert werden.</para>
 
       <para>Wenn Ihre &Auml;nderungen auf ausreichend aktuellen Quellen
 	beruhen, erstellen Sie als N&auml;chstes einen Differenzensatz,
 	den Sie an die FreeBSD-Entwickler schicken.  Eine solche
 	Differenz erstellen Sie mit &man.diff.1;.</para>
 
       <para>Das bevorzugte &man.diff.1;-Format f&uuml;r das Versenden
 	von Patches ist das sogenannte <foreignphrase>unified
 	output</foreignphrase>-Format, das Sie mit
 	<command>diff -u</command> erstellen.  F&uuml;r
 	gr&ouml;&szlig;ere &Auml;nderungen kann allerdings das
 	<foreignphrase>context output</foreignphrase>-Format
 	(erzeugt mit <command>diff -c</command>) die bessere Wahl
 	sein.</para>
 
       <indexterm>
 	<primary><command>diff</command></primary>
       </indexterm>
 
       <para>Dazu ein Beispiel:</para>
 
       <para>
 	<screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen>
 
 	oder
 
 	<screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen>
 
 	w&uuml;rde einen solchen Satz von Differenzen f&uuml;r die angegebene
 	Verzeichnishierarchie erzeugen.</para>
 
       <para>
 	<screen>&prompt.user; <userinput>diff -u oldfile newfile</userinput></screen>
 
 	oder
 
 	<screen>&prompt.user; <userinput>diff -u -r olddir newdir</userinput></screen>
 
 	h&auml;tte den gleichen Effekt, allerdings erfolgt die Ausgabe
 	im <foreignphrase>unified diff</foreignphrase>-Format.</para>
 
       <para>Lesen Sie dazu auch &man.diff.1;.</para>
 
       <para>Nachdem Sie den Differenzensatz erstellt und mit
 	&man.patch.1; getestet haben, sollten Sie ihn an das
 	FreeBSD-Projekt senden.  Verwenden Sie dazu &man.send-pr.1;
 	(wie im Abschnitt <link
 	linkend="contrib-general">Fehlerberichte und allgemeine
 	Vorschl&auml;ge</link> beschrieben).  Senden Sie die
 	Differenzen <emphasis>nicht nur</emphasis> an &a.hackers;, da
 	diese sonst verloren gehen.  Wir freuen uns &uuml;ber Ihren
 	Beitrag (schlie&szlig;lich ist FreeBSD ein Freiwilligenprojekt);
 	wir sind aber manchmal nicht in der Lage, das Problem sofort
 	anzugehen.  Es verbleibt aber in der PR-Datenbank, bis wir
 	daf&uuml;r Zeit finden.  Verwenden Sie den Begriff
 	<literal>[PATCH]</literal> im Synopsis-Feld des Berichts.</para>
 
       <indexterm>
         <primary><command>uuencode</command></primary>
       </indexterm>
 
       <para>Sie k&ouml;nnen auch ein <command>tar</command>-Archiv
 	erzeugen (was vor allem dann sinnvoll ist, wenn Sie Dateien
 	hinzugef&uuml;gt, gel&ouml;scht oder umbenannt haben) und
 	&man.uuencode.1; auf das Archiv anwenden.  Mit &man.shar.1;
 	erzeugte Archive sind ebenfalls willkommen.</para>
 
       <para>Wenn Ihre &Auml;nderungen potentielle Probleme aufweisen,
 	wie Unklarheiten im Hinblick auf das Copyright, oder Sie
 	einfach eine genaue &Uuml;berpr&uuml;fung Ihrer &Auml;nderungen
 	m&ouml;chten, sollten Sie die &Auml;nderungen an das &a.core;
 	schicken, statt sie mit &man.send-pr.1; zu versenden.  Die
 	Mailingliste &a.core; erreicht nur eine kleine Gruppe von
 	Leuten, die sich um die t&auml;gliche Arbeit an FreeSD
 	k&uuml;mmern.  Beachten Sie aber, dass diese Gruppe
 	<emphasis>sehr besch&auml;ftigt</emphasis> ist.  Daher sollten
 	Sie nur dann eine E-Mail an sie schicken, wenn es absolut
 	notwendig ist.</para>
 
       <para>&man.intro.9; und &man.style.9; beschreiben den zu
 	verwendenden Programmierstil.  Bevor Sie also Code
 	versenden, sollten Sie diese Informationen gelesen
 	haben.</para>
     </sect2>
 
     <sect2>
       <title>Neuer Code oder gro&szlig;e Mehrwertpakete</title>
 
       <para>Handelt es sich um einen bedeutenden Beitrag oder um
 	das Hinzuf&uuml;gen von neuen wichtigen F&auml;higkeiten zu
 	FreeBSD, ist es fast immer notwendig, die &Auml;nderungen
 	als <foreignphrase>uuencoded tar</foreignphrase>-Dateien
 	zu versenden, oder diese auf einer Internetseite oder einem
 	FTP-Server bereitzustellen.  Haben Sie keinen eigenen
 	Speicherplatz im Internet, sollten Sie auf einer
 	entsprechenden Mailinglisten nachfragen, ob jemand diese
 	Aufgabe f&uuml;r Sie &uuml;bernehmen kann.</para>
 
       <para>Arbeitet man mit gro&szlig;en Codebest&auml;nden,
 	kommt man unweigerlich mit den unterschiedlichen Lizenzen
 	in Ber&uuml;hrung.  Code, der in FreeBSD enthalten ist,
 	kann unter den folgenden Lizenzen stehen:</para>
 
       <orderedlist>
   <indexterm><primary>BSD-Lizenz</primary></indexterm>
 	<listitem>
 	  <para>Der BSD-Lizenz.  Diese Lizenz wird von uns bevorzugt,
 	    weil sie an <quote>keine Bedingungen</quote> gekn&uuml;pft
 	    ist und daher f&uuml;r kommerzielle Unternehmen sehr
 	    attraktiv ist.  Das FreeBSD-Projekt unterst&uuml;tzt diese
 	    kommerzielle Verwendung, die manchmal sogar in eine
 	    F&ouml;rderung des FreeBSD-Projekts m&uuml;ndet.</para>
 	</listitem>
 
   <indexterm><primary>GPL</primary><see>GNU General Public License</see></indexterm>
   <indexterm><primary>GNU General Public License</primary></indexterm>
 
 	<listitem>
 	  <para>Der GNU General Public License, oder <quote>GPL</quote>.
 	    Diese Lizenz ist nicht ganz so beliebt bei uns, da sie
 	    die kommerzielle Nutzung des Quellcodes einschr&auml;nkt.
 	    In Anbetracht der schieren Menge an GPL-Quellcode, den
 	    wir derzeit ben&ouml;tigen (wie Compiler, Assembler oder
 	    Textformatierer) w&auml;ren wir aber schlecht beraten,
 	    Beitr&auml;ge, die unter dieser Lizenz stehen, abzulehnen.
 	    Code, der unter der GPL steht, befindet sich in einem
 	    gesonderten Bereich des Quellcodebaums, und zwar unter
 	    <filename>/sys/gnu</filename> oder
 	    <filename>/usr/src/gnu</filename>, und ist daher f&uuml;r
 	    jeden, f&uuml;r den die GPL ein Problem darstellt, sofort
 	    erkennbar.</para>
 	</listitem>
       </orderedlist>
 
       <para>Beitr&auml;ge, die unter einer dieser Lizenzen stehen,
 	m&uuml;ssen sorgf&auml;ltig gepr&uuml;ft werden, bevor ihre
 	Aufnahme in FreeBSD in Betracht gezogen wird.  Beitr&auml;ge,
 	f&uuml;r die besonders restriktive Lizenzen gelten, werden
 	generell abgelehnt, obwohl die Autoren ermutigt werden,
 	ihre Ver&auml;nderungen &uuml;ber ihre eigenen Kan&auml;le
 	verf&uuml;gbar zu machen.</para>
 
       <para>Um Ihre Arbeit unter die <quote>BSD-Lizenz</quote> zu
 	stellen, f&uuml;gen Sie den folgenden Text am Beginn jeder
 	von Ihnen erstellten Quellcodedatei ein, wobei Sie den Text
 	zwischen den <literal>%%</literal>-Zeichen durch die
 	entsprechenden Informationen ersetzt:</para>
 
       <programlisting>Copyright (c) %%Jahr der Ver&ouml;ffentlichung%%
         %%Ihr Name%%, %%Ihr Land%%  %%Ihre Postleitzahl%%.
 	All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer as
    the first lines of this file unmodified.
 2. Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and/or other materials provided with the distribution.
 
 THIS SOFTWARE IS PROVIDED BY %%Ihr Name%% ``AS IS'' AND ANY EXPRESS OR
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 IN NO EVENT SHALL %%Ihr Name%% BE LIABLE FOR ANY DIRECT, INDIRECT,
 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
         &#36;Id&#36;</programlisting>
 
       <para>Eine Kopie dieses Textes finden Sie unter
 	<filename>/usr/share/examples/etc/bsd-style-copyright</filename>.</para>
     </sect2>
 
     <sect2>
       <title>Geld, Hardware oder Internetzugang</title>
 
       <para>Wir freuen uns immer, wenn jemand das FreeBSD-Projekt
 	durch Spenden unterst&uuml;tzen will.  Auch kleine Spenden
 	k&ouml;nnen eine gro&szlig;e Wirkung haben.  Hardwarespenden
 	sind ebenfalls sehr wichtig, um die Liste der von FreeBSD
 	unterst&uuml;tzten Hardware erweitern zu k&ouml;nnen, da
 	uns die Mittel zum Erwerb dieser Hardware fehlen.</para>
 
       <sect3>
 	<title><anchor id="donations">Geldspenden</title>
 
 	<para>Die FreeBSD Foundation ist eine gemeinn&uuml;tzige
 	  Gesellschaft, die zur Unterst&uuml;tzung des FreeBSD-Projekts
 	  geschaffen wurde.  Sie ist nach dem Paragraphen 501(c)3
 	  sowohl von der amerikanischen Einkommenssteuer als auch von
 	  der des Staates Colorado befreit.  Spenden an solche
 	  steuerbefreiten Gesellschaften k&ouml;nnen unter gewissen
 	  Umst&auml;nden steuermindernd geltend gemacht werden.</para>
 
 	<para>Sie k&ouml;nnen Spenden in Scheckform an folgende Adresse
 	  senden:
 	  <address>
 	    The FreeBSD Foundation
 	    <street>7321 Brockway Dr.</street>
 	    <city>Boulder</city>, <state>CO</state> <postcode>80303</postcode>
 	    <country>USA</country>
 	  </address>
 	</para>
 
 	<para>Die FreeBSD Foundation ist nun auch in der Lage, Spenden
 	  durch das PayPal-System entgegenzunehmen.  Solche Spenden
 	  k&ouml;nnen &uuml;ber die <ulink
 	  url="http://www.freebsdfoundation.org">Homepage</ulink> der
 	  Foundation erfolgen.</para>
 
 	<para>F&uuml;r weitere Informationen zur FreeBSD Foundation
 	  sollten Sie den Artikel <ulink
 	  url="http://people.FreeBSD.org/~jdp/foundation/announcement.html">
 	  The FreeBSD Foundation -- an Introduction</ulink> lesen.  Sie
 	  erreichen die FreeBSD Foundation &uuml;ber die
 	  E-Mail-Adresse <email>bod@FreeBSDFoundation.org</email>.</para>
       </sect3>
 
       <sect3>
 	<title>Hardwarespenden</title>
 
 	<indexterm><primary>donations</primary></indexterm>
 
 	<para>Das FreeBSD-Projekt freut sich, wenn jemand ben&ouml;tigte
 	  Hardware spenden will.  Sind Sie daran interessiert, setzen
 	  Sie sich bitte mit dem <ulink
 	  url="&url.base;/donations/">Donations Liaison
 	  Office</ulink> in Verbindung.</para>
       </sect3>
 
       <sect3>
 	<title>Internetzugang zur Verf&uuml;gung stellen</title>
 
 	<para>Wir sind st&auml;ndig auf der Suche nach neuen FTP-,
 	  WWW- oder <command>cvsup</command>-Spiegeln.  Wenn Sie einen
 	  solchen Spiegel einrichten wollen, lesen Sie bitte den Artikel
 	  <ulink
 	  url="&url.articles.hubs.en;/index.html">Mirroring FreeBSD</ulink>,
 	  der weitere Informationen enth&auml;lt.</para>
       </sect3>
     </sect2>
   </sect1>
 
 </article>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.sgml b/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.sgml
index 3d2dc7083a..551e9152c8 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.sgml
@@ -1,381 +1,381 @@
 <!-- Copyright (c) 2000 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/examples/appendix.sgml,v 1.12 2005/08/15 13:32:48 jkois Exp $
-     basiert auf: 1.16
+     $FreeBSDde: de-docproj/books/fdp-primer/examples/appendix.sgml,v 1.13 2007/11/10 15:41:58 miwi Exp $
+     basiert auf: 1.17
 -->
 
 <appendix id="examples">
   <title>Beispiele</title>
 
   <para>In diesem Anhang sind SGML-Beispieldokumente und Befehle
     enthalten, die zeigen, wie man aus DocBook-Dokumenten verschiedene
     Ausgabeformate erzeugen kann. Sofern alle Werkzeuge f&uuml;r das
     Dokumentationsprojekt ordnungsgem&auml;&szlig; installiert wurden,
     k&ouml;nnen die angebotenen Beispiele direkt &uuml;bernommen
     werden.</para>
 
   <para>Die Beispiele dieses Abschnitts sind bewusst einfach aufgebaut.
     Daher fehlen in den Beispielen einige Elemente, insbesondere
     Elemente f&uuml;r die Titelei.  Weitere DocBook-Beispiele
     k&ouml;nnen in den DocBook-Quellen dieses und anderer Dokumente
     des FDPs gefunden werden. Die Quellen des FDPs sind &uuml;ber
     <application>CVSup</application> und online unter <ulink
       url="http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/"></ulink>
     verf&uuml;gbar.</para>
 
   <para>Um Irritationen zu vermeiden, bauen die SGML-Beispiele auf der
     4.1er Standard-DocBook DTD anstatt auf der erweiterten
     FreeBSD-Variante auf. Ebenso werden die Standardstylesheets von
     Norman Welsh, anstatt der angepassten Stylesheets des
     FreeBSD-Dokumentationsprojektes benutzt. Dadurch eignen sich die
     Beispiele auch als generische DocBook-Vorlagen.</para>
 
   <sect1 id="examples-docbook-book">
     <title>DocBook-Buch (<sgmltag>book</sgmltag>)</title>
 
     <example>
       <title>Ein DocBook-Buch (<sgmltag>book</sgmltag>)</title>
 
       <programlisting><![ CDATA [<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
 
 <book>
   <bookinfo>
     <title>Ein Buchbeispiel</title>
 
     <author>
       <firstname>Vorname</firstname>
       <surname>Nachname</surname>
       <affiliation>
         <address><email>vorname.nachname@domain.de</email></address>
       </affiliation>
     </author>
 
     <copyright>
       <year>2000</year>
       <holder>Urheberhinweis</holder>
     </copyright>
 
     <abstract>
       <para>Falls das Buch eine Zusammenfassung hat, sollte sie
         hier stehen.</para>
     </abstract>
   </bookinfo>
 
   <preface>
     <title>Einleitung</title>
 
     <para>Falls das Buch eine Einleitung hat, sollte diese hier
       stehen.</para>
   </preface>
 
   <chapter>
     <title>Das erste Kapitel</title>
 
     <para>Das ist das erste Kapitel des Buches.</para>
 
     <sect1>
       <title>Der erste Abschnitt</title>
 
       <para>Das ist der erste Abschnitte des Buches.</para>
     </sect1>
   </chapter>
 </book>]]></programlisting>
     </example>
   </sect1>
 
   <sect1 id="examples-docbook-article">
     <title>DocBook-Artikel (<sgmltag>article</sgmltag>)</title>
 
     <example>
       <title>Ein DocBook-Artikel (<sgmltag>article</sgmltag>)</title>
 
       <programlisting><![ CDATA [<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
 
 <article>
   <articleinfo>
     <title>Ein Beispielartikel</title>
 
     <author>
       <firstname>Vorname</firstname>
       <surname>Nachname</surname>
       <affiliation>
         <address><email>vorname.nachname@domain.de</email></address>
       </affiliation>
     </author>
 
     <copyright>
       <year>2000</year>
       <holder>Urheberhinweis</holder>
     </copyright>
 
     <abstract>
       <para>Falls der Artikel eine Zusammenfassung hat, sollte sie
         hier stehen.</programlisting>
     </abstract>
   </articleinfo>
 
   <sect1>
     <title>Der erste Abschnitt</title>
 
     <para>Das ist der erste Abschnitt des Artikels.</para>
 
     <sect2>
       <title>Der erste Unterabschnitt</title>
 
       <para>Das ist der erste Unterabschnitt des Artikels.</para>
     </sect2>
   </sect1>
 </article>]]></programlisting>
     </example>
   </sect1>
 
   <sect1 id="examples-formatted">
     <title>Ausgabeformate erzeugen</title>
 
     <para>F&uuml;r diesen Abschnitt wird vorausgesetzt, dass die
       im Port <filename role="package">textproc/docproj</filename>
       enthaltene Software manuell oder &uuml;ber das Portssystem
       installiert wurde. Weiter wird vorausgesetzt, dass alle
       Programme unterhalb des Verzeichnisses
       <filename class="directory">/usr/local</filename> installiert
       worden sind und die Verzeichnisse, die die ausf&uuml;hrbaren
       Programme enthalten, in der Variable <envar>PATH</envar>
       enthalten sind.</para>
 
     <sect2>
       <title>Benutzung von Jade</title>
 
       <example>
 	<title>Ein DocBook-Dokument in eine einzelne HTML-Datei
           umwandeln</title>
 
 	<screen>&prompt.user; <userinput>jade -V nochunks \  <co id="examples-co-jade-1-nochunks">
 -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-1-catalog">
 -c /usr/local/share/sgml/docbook/catalog \
 -c /usr/local/share/sgml/jade/catalog \
 -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-1-dsssl">
 -t sgml <co id="examples-co-jade-1-transform"> datei.sgml &gt; datei.html <co id="examples-co-jade-1-filename"></userinput></screen>
 
 	<calloutlist>
 	  <callout arearefs="examples-co-jade-1-nochunks">
             <para>&Uuml;bergibt den Parameter
               <literal>nochunks</literal> an die Stylesheets. Dadurch
               wird die gesamte Ausgabe nach
               <abbrev>STDOUT</abbrev> geschrieben (bei der Benutzung
               von Norm Walshs Stylesheets).</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-catalog">
             <para>Legt die von Jade zur Verarbeitung ben&ouml;tigten
               drei Kataloge fest. Der erste Katalog enth&auml;lt
               Informationen zu den DSSSL-Stylesheets, der zweite zur
               DocBook DTD und der dritte Jade-spezifische
               Informationen.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-dsssl">
             <para>&Uuml;bergibt den vollen Pfad zum
 	      DSSSL-Stylesheet, das von Jade zur
 	      Verarbeitung des Dokuments benutzt wird.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-transform">
             <para>Weist Jade an, eine
               <emphasis>Transformation</emphasis> von einer DTD zu
               einer anderen DTD vorzunehmen. In diesem Falle, von der
               DocBook DTD zur HTML DTD.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-1-filename">
             <para>Legt fest, welche Datei Jade verarbeiten soll und
               leitet die Ausgabe in die Datei
               <filename>datei.html</filename> um.</para>
 	  </callout>
 	</calloutlist>
       </example>
 
       <example>
         <title>Ein DocBook-Dokument in mehrere kleine HTML-Dateien umwandeln</title>
 
 	<screen>&prompt.user; <userinput>jade \
 -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-2-catalog">
 -c /usr/local/share/sgml/docbook/catalog \
 -c /usr/local/share/sgml/jade/catalog \
 -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-2-dsssl">
 -t sgml <co id="examples-co-jade-2-transform"> <replaceable>datei</replaceable>.sgml <co id="examples-co-jade-2-filename"></userinput></screen>
 
 	<calloutlist>
 	  <callout arearefs="examples-co-jade-2-catalog">
             <para>Legt die von Jade zur Verarbeitung ben&ouml;tigten
               drei Kataloge fest. Der erste Katalog enth&auml;lt
               Informationen zu den DSSSL-Stylesheets, der zweite zur
               DocBook DTD und der dritte Jade-spezifische
               Informationen.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-2-dsssl">
             <para>&Uuml;bergibt den vollen Pfad zum
 	      DSSSL-Stylesheet, das von Jade zur
 	      Verarbeitung des Dokuments benutzt wird.</para>
           </callout>
 
 	  <callout arearefs="examples-co-jade-2-transform">
             <para>Weist Jade an, eine
               <emphasis>Transformation</emphasis> von einer DTD zu
               einer anderen DTD vorzunehmen. In diesem Falle, von der
               DocBook DTD zur HTML DTD.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-2-filename">
             <para>Legt die zu verarbeitende Datei fest. Die
               Stylesheets ermitteln eigenst&auml;ndig die Namen aller
               HTML-Ausgabedateien.</para>
 	  </callout>
 	</calloutlist>
 
         <para>Abh&auml;ngig von der Struktur des zu verarbeitenden
           Dokumentes und den Stylesheetregeln zur Aufteilung des
           Dokumentes, kann dieser Befehl auch nur eine einzelne
           HTML-Datei erzeugen.</para>
       </example>
 
       <example id="examples-docbook-postscript">
 	<title>Ein DocBook-Dokument nach Postscript umwandeln</title>
 
         <para>Um eine Postscript-Ausgabe zu erzeugen, muss zuerst
           die SGML-Quelle in eine &tex;-Datei umgewandelt werden.</para>
 
 	<screen>&prompt.user; <userinput>jade -Vtex-backend \ <co id="examples-co-jade-3-tex-backend">
     -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog">
     -c /usr/local/share/sgml/docbook/catalog \
     -c /usr/local/share/sgml/jade/catalog \
     -d /usr/local/share/sgml/docbook/dsssl/modular/print/docbook.dsl \<co id="examples-co-jade-3-dsssl">
     -t tex <co id="examples-co-jade-3-tex"> <replaceable>datei</replaceable>.sgml</userinput></screen>
 
 	<calloutlist>
 	  <callout arearefs="examples-co-jade-3-tex-backend">
             <para>Weist die Stylesheets an, verschiedene
               &tex;-spezifische Optionen zu benutzen.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-3-catalog">
             <para>Legt die von Jade zur Verarbeitung ben&ouml;tigten
               drei Kataloge fest. Der erste Katalog enth&auml;lt
               Informationen zu den DSSSL-Stylesheets, der zweite zur
               DocBook DTD und der dritte Jade-spezifische
               Informationen.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-3-dsssl">
             <para>&Uuml;bergibt den vollen Pfad zum
 	      DSSSL-Stylesheet, das von Jade zur
 	      Verarbeitung des Dokuments benutzt wird.</para>
 	  </callout>
 
 	  <callout arearefs="examples-co-jade-3-tex">
             <para>Weist Jade an, die Ausgabe in &tex;
               umzuwandeln.</para>
           </callout>
 	</calloutlist>
 
         <para>Die so erzeugte <filename>.tex</filename>-Datei
           muss anschlie&szlig;end mittels <command>tex</command>,
           unter Angabe des Makropakets
           <literal>&amp;jadetex</literal> weiterverarbeitet
           werden.</para>
 
 	<screen>&prompt.user; <userinput>tex "&amp;jadetex" <replaceable>datei</replaceable>.tex</userinput></screen>
 
         <para><command>tex</command> muss <emphasis>mindestens</emphasis>
           dreimal ausgef&uuml;hrt werden. Der erste Lauf ermittelt die
           die Querverweise innerhalb des Dokumentes, die
           f&uuml;r Stichwortverzeichnisse und &auml;hnliches
 	  ben&ouml;tigt werden.</para>
 
         <para>Warnungen, wie <literal>LaTeX Warning: Reference `136'
             on page 5 undefined on input line 728.</literal>, die zu
           diesem Zeitpunkt ausgegeben werden, k&ouml;nnen ohne
           weiteres ignoriert werden.</para>
 
         <para>Der zweite Lauf kann jetzt, da mehr Informationen, wie
           zum Beispiel die Seitenl&auml;ngen, zur Verf&uuml;gung
           stehen, Eintr&auml;ge im Stichwortverzeichnis und
           Querverweise genauer bestimmen.</para>
 
         <para>Der dritte Lauf ist f&uuml;r abschlie&szlig;ende
           Aufr&auml;umarbeiten notwendig. Die so von
           <command>tex</command> erzeugte Ausgabe befindet sich
           anschlie&szlig;end in der Datei
           <filename><replaceable>datei</replaceable>.div</filename>.</para>
 
         <para>Zum Schluss muss noch <command>dvips</command>
           aufgerufen werden, um die <filename>.div</filename>-Datei in
           ein Postscript-Dokument umzuwandeln.</para>
 
 	<screen>&prompt.user; <userinput>dvips -o <replaceable>datei</replaceable>.ps <replaceable>datei.dvi</replaceable></userinput></screen>
       </example>
 
       <example>
 	<title>Eine PDF-Datei aus einem DocBook-Dokument
           erzeugen</title>
 
         <para>Die ersten Schritte, um ein DocBook-Dokument in ein PDF
           umzuwandeln,  stimmen mit denen &uuml;berein, die notwendig sind,
           um eine Postscript-Ausgabe zu erzeugen (<xref
 	    linkend="examples-docbook-postscript">).</para>
 
         <para>Nachdem die <filename>.tex</filename>-Datei durch
           <application>Jade</application> erzeugt wurde, muss
           pdfTex mit mit &amp;pdfjadetex-Paket anstelle von tex
           aufgerufen werden.</para>
 
 	<screen>&prompt.user; <userinput>pdftex "&amp;pdfjadetex" <replaceable>datei</replaceable>.tex</userinput></screen>
 
         <para>Dieser Befehl muss ebenfalls dreimal ausgef&uuml;hrt werden.
           Am Ende liegt mit
           <filename><replaceable>datei</replaceable>.pdf</filename>
           das fertige PDF-Dokument vor. Weitere Schritte sind jetzt
           nicht mehr notwendig.</para>
       </example>
     </sect2>
   </sect1>
 </appendix>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../appendix.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "appendix")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
index e702c7c8bb..0e451ab171 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
@@ -1,1976 +1,1976 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML, HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/sgml-primer/chapter.sgml,v 1.18 2006/11/06 20:04:32 jkois Exp $
-     basiert auf: 1.45
+     $FreeBSDde: de-docproj/books/fdp-primer/sgml-primer/chapter.sgml,v 1.19 2007/11/10 15:58:41 miwi Exp $
+     basiert auf: 1.46
 -->
 
 <!--?
 o SGML-Kontext sollte besser mit Umgebung uebersetzt werden.
 
 Oliver Fischer
 
 -->
 
 <chapter id="sgml-primer">
   <title>Die SGML-Fibel</title>
 
   <para>Die Mehrzahl der Dokumente des FDPs sind in SGML geschrieben.
     Ziel dieses Kapitels ist es, genau zu erkl&auml;ren, was
     das bedeutet und wie man die SGML-Quellen liest und versteht.
     Ebenso werden die in den Quellen genutzten Kniffe erkl&auml;rt,
     auf die man beim Lesen der Dokumente sto&szlig;en wird.</para>
 
   <para>Teile dieses Kapitels basieren auf Mark Galassis <quote><ulink
         url="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html">Get
         Going With DocBook</ulink></quote>.</para>
 
   <sect1 id="sgml-primer-overview">
     <title>&Uuml;berblick</title>
 
     <para>In den guten alten Zeiten war der Umgang mit
       <quote>elektronischem</quote> Text einfach. Man musste
       lediglich wissen, welcher Zeichensatz (ASCII, EBCDIC oder ein
       anderer) vorlag. Text war einfach Text und sah so aus, wie man
       ihn sah. Keine Extras, keine Formatierungen und kein sonstiger
       Schnickschnack.</para>
 
     <para>F&uuml;r viele Zwecke war dies allerdings nicht ausreichend.
       Von einem machinenlesbaren Text wird erwartet, dass er auch von
       Maschinen gelesen und intelligent weiterverarbeitet werden kann.
       Einzelne Stellen sollen hervorgehoben werden, andere sollen in ein
       Glossar aufgenommen werden oder auf andere Textstellen
       verweisen. Dateinamen wiederum sollen in einer
       <quote>schreibmaschinen&auml;hnlichen</quote> Schrift auf dem
       Bildschirm dargestellt werden, der Ausdruck soll jedoch in
       <quote>Schr&auml;gschrift</quote> oder in einer beliebigen anderen
       Darstellungsform erfolgen.</para>
 
     <para>Anf&auml;nglich gab es die Hoffnung, dass die
       K&uuml;nstliche Intelligenz (KI) helfen w&uuml;rde, dieses Ziel
       zu erreichen. Computer sollte den Text lesen und dazu in der Lage
       sein, selbstst&auml;ndig wichtige Formulierungen, Dateinamen,
       Benutzereingaben oder Beispiele zu erkennen.  Leider verlief die
       Entwicklung in diesem Bereich nicht wie gew&uuml;nscht und Computer
       ben&ouml;tigen nach wie vor etwas Unterst&uuml;tzung, bevor sie
       Texte vern&uuml;nftig verarbeiten k&ouml;nnen.</para>
 
     <para>Genauer gesagt, man muss ihnen sagen, was was ist. Sehen
       wir Menschen uns folgende Zeilen an:
 
       <blockquote>
 	<para>L&ouml;schen Sie <filename>/tmp/foo</filename> mittels &man.rm.1;.</para>
 
 	<screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>
       </blockquote>
 
       f&auml;llt es uns leicht zu erkennen, was ein Dateiname, ein
       einzugebender Befehl oder ein Verweis auf eine Hilfeseite ist. Das
       kann ein Computer, der einen Text verarbeitet, nicht. Aus diesem
       Grund ist es notwendig, Texte mit weiteren Informationen
       <quote>auszuzeichnen</quote>.</para>
 
     <!-- Hier bin ich mir nicht sicher, ob die &Uuml;bersetzung
     sprachlich genau bzw. richtig ist.
     Oliver Fischer -->
 
     <para>Der Begriff <quote>Auszeichnung<footnote> <para>Im
             angels&auml;chischschen Sprachraum wird von
             <quote>markup</quote>
             gesprochen.</para></footnote></quote> bedeutet, dass
       sich der Wert eines Textes erh&ouml;ht, aber auch seine Kosten.
       Durch Auszeichnungen wird einem Dokument zus&auml;tzlicher Text
       hinzugef&uuml;gt, der aber von dem eigentlichen Dokumenteninhalt
       auf eine bestimmte Art und Weise unterschieden werden kann, so
       dass Programme die Auszeichnung erkennen k&ouml;nnen und
       mittels dieser Informationen w&auml;hrend der Verarbeitung in
       der Lage sind, Entscheidungen zu treffen. Texteditoren
       k&ouml;nnen diese Auszeichnungselemente vor dem Benutzer
       verbergen, um zu vermeiden, dass er durch sie abgelenkt
       wird.</para>
 
     <!--<para><quote>Markup</quote> is commonly used to describe <quote>adding
     value</quote> or <quote>increasing cost</quote>.  The term takes on both
     these meanings when applied to text.  Markup is additional text included
     in the document, distinguished from the document's content in some way,
     so that programs that process the document can read the markup and use
     it when making decisions about the document.  Editors can hide the
     markup from the user, so the user is not distracted by it.</para>-->
 
 
     <para>Die durch die Auszeichnungselemente im Textdokument
       zus&auml;tzlich abgelegten Informationen erh&ouml;hen den Wert
       des Dokuments. Allerdings muss diese Arbeit in den meisten
       F&auml;llen von einem Menschen getan werden &ndash; w&auml;ren
       Maschinen dazu f&auml;hig, w&auml;ren zus&auml;tzliche
       Auszeichnungselemente unn&ouml;tig. Der damit verbundene Aufwand
       <emphasis>erh&ouml;ht die Kosten</emphasis>, die durch die
       Erstellung des Dokuments entstehen.</para>
 
     <para>Das etwas weiter oben gegebene Beispiel sieht im Quelltext
       so aus:</para>
 
     <programlisting><![ RCDATA [
 <para>L&ouml;schen Sie <filename>/tmp/foo</filename> mittels &man.rm.1;.</para>
 
 <screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>]]></programlisting>
 
     <para>Die Auszeichnungselemente sind deutlich vom eigentlichen
       Inhalt zu unterscheiden.</para>
 
     <para>Die Einf&uuml;hrung von Auszeichnungselementen setzt voraus,
       dass festgelegt wird, welche Bedeutung einzelne Elemente haben
       und wie diese interpretiert werden.  Sie brauchen daher eine
       Auszeichnungssprache, der Sie folgen, wenn Sie eigene
       Dokumente verfassen.</para>
 
     <para>Nat&uuml;rlich kann es keine universelle
       Auszeichnungssprache geben und eine einzige mag nicht
       ausreichend f&uuml;r alle m&ouml;glichen Anwendungsf&auml;lle
       sein. Eine  Sprache f&uuml;r technische Dokumente wird sich
       wahrscheinlich stark von einer f&uuml;r Kochrezepte
       unterscheiden. Die universelle L&ouml;sung ist eine
       Basissprache, mit deren Hilfe weitere Sprachen entwickelt werden
       k&ouml;nnen &ndash; eine
       <emphasis>Meta-Auszeichungssprache</emphasis> also.</para>
 
     <para>Genau diese Anforderung wird von der Standard Generalized
       Markup Language (<abbrev>SGML</abbrev>) erf&uuml;llt. Mit ihrer
       Hilfe wurden viele andere Auszeichungssprachen wie
       beispielsweise HTML und DocBook, welche beide von FDP genutzt
       werden, entwickelt.</para>
 
     <para>Die eigentliche Sprachdefinition erfolgt in einer
       Dokumenten-Typ-Definition (DTD). Innerhalb dieser DTD werden die
       Namen der einzelnen Elemente, deren m&ouml;gliche Reihenfolge
       und Verschachtelung sowie weitere Informationen
       festgelegt.</para>
 
       <!-- Der letzte Satz dieses Absatzes muss noch &uuml;bersetzt werden.
       Ich habe keine gute &Uuml;bersetzung daf&uuml;r bis jetzt
       gefunden. Oliver Fischer -->
 
       <!--<para>Each language definition is more properly called a Document Type
       Definition (DTD).  The DTD specifies the name of the elements that can
       be used, what order they appear in (and whether some markup can be used
       inside other markup) and related information.  A DTD is sometimes
       referred to as an <emphasis>application</emphasis> of SGML.</para>-->
 
     <para id="sgml-primer-validating">Eine DTD ist eine
       <emphasis>vollst&auml;ndige</emphasis> Definition aller
       m&ouml;glichen Sprachelemente, ihrer
       Reihenfolge<footnote><para>Bei nat&uuml;rlichen Sprachen spricht
           man vom Satzbau  &ndash; demjenigen Konstrukt, das unter
           anderem die Position des Subjekts, Objekts und
           Pr&auml;dikats in einem Satz festlegt.</para></footnote>,
       optionaler Elemente und so weiter und so weiter. Dank dieser
       recht formalen Festlegung ist es m&ouml;glich,
       SGML-<emphasis>Parser</emphasis> zu entwickeln, die sowohl ein
       Dokument  als auch seine DTD einlesen und anhand dieser DTD
       pr&uuml;fen k&ouml;nnen, ob das Dokument allen Anforderungen der
       DTD entspricht. Dieser Vorgang wird allgemein als
       <emphasis>Validierung des Dokuments</emphasis>
       bezeichnet.</para>
 
     <note>
       <para>Das Validieren eines SGML-Dokuments gegen eine DTD
         &uuml;berpr&uuml;ft lediglich die korrekte Syntax des
         Dokuments, dass hei&szlig;t, ob nur g&uuml;ltige
         Auszeichnungselemente verwendet wurden und ihre Reihenfolge
         stimmt. Dabei wird <emphasis>nicht</emphasis> gepr&uuml;ft, ob
         die Elemente der DTD <emphasis>sinngem&auml;&szlig;</emphasis>
         verwandt wurden. Sollten beispielsweise alle Dateinamen als
         Funktionsnamen ausgezeichnet worden sein, so w&uuml;rde der
         Parser keinen Fehler signalisieren. Formaler ausgedr&uuml;ckt:
         Der Parser pr&uuml;ft die Syntax, aber nicht die
         Semantik.</para>
       </note>
 
     <para>Es ist anzunehmen, dass, wenn man selber vor hat
       Dokumentation f&uuml;r das FDP zu schreiben, der
       gr&ouml;&szlig;te Teil davon mit Hilfe von HTML oder DocBook
       geschrieben werden wird. Aus diesem Grunde wird an dieser Stelle
       nicht erkl&auml;rt, wie eine DTD entwickelt wird.</para>
     </sect1>
 
     <sect1 id="sgml-primer-elements">
     <title>Von Elementen, Tags und Attributen</title>
 
     <!-- Bei der &Uuml;bersetzung des ersten Satzes bin ich mir nicht
       sicher, ob es einee bessere gibt. Oliver Fischer -->
 
     <para>Alle in SGML geschriebenen DTDs haben bestimmte gemeinsame
       Eigenschaften. Das ist nicht verwunderlich, da sich die hinter
       SGML stehende Idee unweigerlich bemerkbar macht. <!--?
       Kandidat fuer ein Umformulierung. Oliver Fischer --> Zwei der
       markantesten Merkmale dieser Idee sind die Begriffe
       <emphasis>Inhalt</emphasis> und
       <emphasis>Element</emphasis>.</para>
 
     <!--<para>All the DTDs written in SGML share certain characteristics.  This is
     hardly surprising, as the philosophy behind SGML will inevitably show
     through. One of the most obvious manifestations of this philosophy is
     that of <emphasis>content</emphasis> and
     <emphasis>elements</emphasis>.</para>-->
 
     <!--? Vielleicht sollte man nicht von Elementen sondern von Teilen
     sprechen. Oliver Fischer -->
 
     <!--?
     Hier muss die endlose Rekursion noch besser zum Ausdruck kommen.
     -->
     <para>Von einem Dokument, unabh&auml;ngig, ob es sich um  eine
       einzelne Webseite oder ein langes Buch handelt, wird angenommen,
       dass es einen wie auch immer gearteten Inhalt hat. Dieser
       l&auml;sst sich selbst wiederum in Teilelemente
       aufspalten, die ebenso zerlegbar sind. Durch die Aufnahme von
       Auszeichnungselementen in einen Text, werden diese einzelnen
       Elemente eindeutig benannt und voneinander abgegrenzt.</para>
 
       <!--<para>Your documentation (whether it is a single web page, or a lengthy
       book) is considered to consist of content.  This content is then divided
       (and further subdivided) into elements.  The purpose of adding markup is
       to name and identify the boundaries of these elements for further
       processing.</para>-->
 
     <!--? Begriff Element erscheint hier ploetzlich. Sollte
     besser eingefuehrt werden. Oliver Fischer -->
 
     <para>Nimmt man zum Beispiel ein typisches Buch, so kann man es
       auf der obersten Ebene als ein Ganzes, als ein Element
       betrachten. Dieses <quote>Buch</quote>-Element enth&auml;lt nun
       Kapitel, die wiederum selbst als Elemente bezeichnet werden
       k&ouml;nnen. Jedes einzelne Kapitel enth&auml;lt weitere
       Elemente. So gibt es beispielsweise Abs&auml;tze, Zitate und
       Fu&szlig;noten. Jeder Absatz kann wiederum selbst Elemente
       enthalten, die helfen, den Absatzinhalt als direkte Rede oder
       als Namen eines der Protagonisten einer Geschichte zu
       identifizieren.</para>
 
     <para>Wenn man m&ouml;chte, kann man sich das als
       <quote>Unterteilung</quote><footnote><para>Im
           angels&auml;chsichen Sprachraum wird hier von
           <quote>chunking</quote> gesprochen.</para></footnote> des
       Inhalts vorstellen. Auf der obersten Ebene gibt es ein Element:
       das Buch selbst. Schaut man ein wenig tiefer, findet man weitere
       Teilelemente: die einzelnen Kapitel. Diese sind wiederum
       unterteilt in Abs&auml;tze, Fu&szlig;noten, Namen und so weiter
       und so weiter.</para>
 
     <para>Anzumerken ist an dieser Stelle, dass das eben gesagte
       ohne weiteres auf jeden Inhaltstyp angewandt werden kann, auch
       ohne dass von <acronym>SGML</acronym> die Rede ist. Man
       k&ouml;nnte beispielsweise einfach verschiedene Stifte nehmen
       und einen Ausdruck dieser Fibel vor sich hinlegen und dann mit
       verschiedenen Farben die einzelnen Abschnitte des Buchinhalts
       markieren.</para>
 
     <para>Leider gibt es  keinen elektronischen Stift, um das zu tun.
       Deshalb muss ein anderer Weg gew&auml;hlt werden, um zu
       bestimmen, zu welchem Element die einzelnen Inhalte
       geh&ouml;ren. In SGML-basierten Auszeichnungssprachen wie HTML
       und DocBook  werden daf&uuml;r so genannte
       <emphasis>Tags</emphasis> eingesetzt.</para>
 
     <para>Mit einem solchen Tag wird eindeutig festgelegt, wo ein
       bestimmtes Element beginnt und wo es endet. <emphasis>Allerdings
         geh&ouml;rt der Tag selber nicht zum Element.</emphasis> Er
       legt lediglich die Grenzen des Elements fest. Da jede DTD mit dem Ziel
       entwickelt wurde, einen speziellen Inhaltstyp auszuzeichnen,
       wird jede DTD verschiedene Elemente kennen, die daher
       nat&uuml;rlich auch unterschiedlich benannt sein werden.</para>
 
     <para>Der Starttag f&uuml;r ein imagin&auml;res Element mit dem
       Namen <replaceable>elementname</replaceable> ist
       <literal>&lt;<replaceable>elementname</replaceable>&gt;</literal>.
       Sein Gegenst&uuml;ck, der schlie&szlig;ende Endtag, ist
       <literal>&lt;/<replaceable>elementname</replaceable>&gt;</literal>.</para>
 
     <example>
       <title>Verwendung eines Elements (Start- und Endtag)</title>
 
       <para>HTML kennt das Element <literal>p</literal>, um
         festzulegen, dass ein bestimmter abgegrenzter Bereich
         einen Absatz darstellt. Dieses Element hat sowohl einen Start-
         als auch einen Endtag.</para>
 
       <programlisting><![ RCDATA [<p>Das ist ein Absatz. Er beginnt mit Starttag
   f&uuml;r das Element 'p' und endet mit dem Endtag f&uuml;r
   das Element 'p'.</p>
 
 <p>Das ist ein etwas k&uuml;rzerer Absatz.</p>]]></programlisting>
     </example>
 
     <!--?
     Klingt nicht so gut. Mit Orginal vergleichen.
     Oliver Fischer
     -->
     <para>Elemente m&uuml;ssen nicht notwendigerweise einen Endtag
       haben. Ebenso ist es nicht notwendig, dass Elemente einen
       Inhalt haben. Beispielsweise kann in HTML-Dokumenten mittels
       eines speziellen Elements festgelegt werden, dass eine
       horizontale Linie an einer bestimmten Stelle erscheinen soll. Da
       dieses Element offensichtlich keinen Inhalt hat, wird auch kein
       Endtag ben&ouml;tigt.</para>
 
     <example>
       <title>Verwendung eines Elements (nur Starttag)</title>
 
       <para>In HTML kann man mit dem Element <sgmltag>hr</sgmltag>
         festlegen, dass an einer bestimmten Stelle eine
         horizontale Linie angezeigt werden soll. Da dieses Element
         keinen Inhalt umschlie&szlig;t, hat es nur einen
         Starttag.</para>
 
       <programlisting><![ CDATA [<p>Das ist ein Abschnitt.</p>
 
 <hr>
 
 <p>Das ist ein weiterer Absatz. Eine horizontale Linie
   trennt ihn vom vorherigen Absatz.</p>]]></programlisting>
     </example>
 
     <para>Elemente k&ouml;nnen andere Elemente enthalten.  Im
       anfangs erw&auml;hnten Buch enthielt das Buch-Element
       alle Kapitel-Elemente, die wiederum alle Absatz-Elemente
       enthielten und so fort.</para>
 
     <example>
       <title>Verschachtelte Elemente: <sgmltag>em</sgmltag></title>
 
       <programlisting><![ RCDATA [<p>Das ist ein einfacher <em>Abschnitt</em>, in dem
   einige <em>Worte</em> <em>hervorgehoben</em> wurden.]]></programlisting>
     </example>
 
     <para>Welche Elemente andere Elemente enthalten k&ouml;nnen und
       welche das sind, wird innerhalb der DTD eines Dokuments
       festgelegt.</para>
 
     <!--
     <para>The DTD will specify the rules detailing which elements can contain
     other elements, and exactly what they can contain.</para>
     -->
 
     <important>
       <para>Viele Leute sind oft verwirrt, wenn es um die richtige
         Benutzung der Begriffe Tag und Element geht. Im Ergebnis werden
         sie oft so genutzt, als w&auml;ren sie austauschbar.
         Allerdings sind sie das nicht.</para>
 
       <para>Ein Element ist ein konzeptioneller Teil eines Dokuments
         und hat einen festgelegten Anfang und ein festgelegtes
 	Ende. Ein Tag hingegen markiert die Stelle, an der ein Element
 	beginnt und endet.</para>
 
       <para>Wenn in diesem Dokument von dem <quote>Tag
           &lt;p&gt;</quote> gesprochen wird, ist damit der Text
         gemeint, der aus den drei Zeichen <literal>&lt;</literal>,
         <literal>p</literal> und <literal>&gt;</literal> besteht. Wird
         hingegen von dem <quote>Element &lt;p&gt;</quote> gesprochen,
         ist damit das gesamte Element gemeint.</para>
 
       <para>Diese Unterscheidung ist sicherlich subtil. Trotzdem
         sollte man sie sich vergegenw&auml;rtigen.</para>
     </important>
 
     <para>Elemente k&ouml;nnen selber Attribute haben, die aus einem
       Namen und einem Wert bestehen.  Die Attribute haben die Aufgabe,
       dem Element zus&auml;tzliche Informationen hinzuzuf&uuml;gen.
       Denkbar sind hier Festlegungen &uuml;ber die Darstellung,
       Bezeichner, &uuml;ber die das Element eindeutig identifiziert
       werden kann, oder beliebige andere Informationen.</para>
 
     <para>Elementattribute werden in den <emphasis>Starttag</emphasis>
       eingef&uuml;gt und haben die Form
       <literal><replaceable>Attributename</replaceable>="<replaceable>Wert</replaceable>"</literal>.</para>
 
     <para>Bei einigen HTML-Versionen kennt das Element
       <sgmltag>p</sgmltag> das Attribut <literal>align</literal>, mit
       dessen Hilfe die Textausrichtung eines Absatzes bestimmt werden
       kann. <literal>align</literal> akzeptiert einen von vier
       vorgegebenen Werten: <literal>left</literal>,
       <literal>center</literal>, <literal>right</literal> und
       <literal>justify</literal>. Ist <literal>align</literal> nicht
       angegeben, wird vom Standardwert <literal>left</literal>
       ausgegangen.</para>
 
     <example>
       <title>Elemente mit Attributen nutzen</title>
 
       <programlisting><![ RCDATA [<p align="left">Die Verwendung des align-Attributs
   f&uuml;r diesen Absatz ist &uuml;berfl&uuml;ssig, da left
   der Standardwert ist.</p>
 
 <p align="center">Dieser Absatz wird hoffentlich mittig dargestellt.</p>]]></programlisting>
     </example>
 
     <para>Einige Attribute akzeptieren nur bestimmte Werte, wie
       beispielsweise <literal>left</literal> oder
       <literal>justify</literal>. Andere akzeptieren jeden beliebigen
       Wert. Enth&auml;lt Attributwert doppelte Anf&uuml;hrungszeichen
       (<literal>"</literal>), wird der Wert in einfachen
       Anf&uuml;hrungszeichen eingeschlossen.</para>
 
     <example>
       <title>Attribute mit einfachen Anf&uuml;hrungszeichen</title>
 
       <programlisting><![ CDATA [<p align='right'>Ich stehe rechts!</p>]]></programlisting>
     </example>
 
 
     <para>Manchmal k&ouml;nnen die Anf&uuml;hrungszeichen um den
       Attributwert weggelassen werden.  Allerdings sind die Regeln,
       die festlegen wann dies zul&auml;ssig ist, sehr spitzfindig.
       Am besten schlie&szlig;en Sie Attributwerte
       <emphasis>immer</emphasis> in Anf&uuml;hrungszeichen ein.</para>
 
     <para>Die Informationen &uuml;ber Attribute, Elemente und Tags
       sind in SGML-Katalogen abgelegt und werden von den verschiedenen
       Werkzeugen des Dokumentationsprojektes genutzt, um die
       geschriebenen Dokumente zu validieren. Die Programme die durch
       <filename role="package">textproc/docproj</filename> installiert
       werden, bringen ihre eigenen Katalogvarianten mit, zudem pflegt
       das FDP seine  eigenen Kataloge. Beide Katalogarten m&uuml;ssen
       von allen Programmen gefunden werden k&ouml;nnen.</para>
 
     <sect2>
       <title>Was daf&uuml;r getan werden muss;&hellip;</title>
 
       <para>Damit die Beispiele dieser Fibel ausgef&uuml;hrt werden
         k&ouml;nnen, ist es notwendig, dass einige Programme auf
         dem Rechner installiert sind und das eine Umgebungsvariable
         korrekt gesetzt wird.</para>
 
       <procedure>
         <step>
           <para>Der erste Schritt ist die Installation des Ports
             <filename role="package">textproc/docproj</filename>
             &uuml;ber das FreeBSD-Portsystem. <filename
               role="package">textproc/docproj</filename> ist ein
             <emphasis>Metaport</emphasis>, der alle vom FDP
             ben&ouml;tigten Programme und Daten aus dem Netz laden und
             installieren sollte.</para>
         </step>
 
         <step>
           <para>Anschlie&szlig;end muss in den Shellkonfigurationsdateien die
             Variable <envar>SGML_CATALOG_FILES</envar>
             <footnote><simpara>Sofern man nicht an der deutschen
                 Dokumentation arbeitet, m&uuml;ssen die
                 Verzeichnisangaben entsprechend angepasst
                 werden.</simpara>
               </footnote> gesetzt werden.</para>
 
             <example id="sgml-primer-envars">
               <title><filename>.profile</filename>, f&uuml;r &man.sh.1; und
                 &man.bash.1; Benutzer</title>
 
               <programlisting>SGML_ROOT=/usr/local/share/sgml
 SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
 SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/de_DE.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 export SGML_CATALOG_FILES</programlisting>
             </example>
             <!--?
               Hier muesste geprueft werden, ob sich die letzten beiden Zeilen
               vertragen oder nicht. Gibt es Entitaeten, die in beiden
               vorhanden sind, aber unterschiedliche Uebersetzungen haben?
 
               Oliver Fischer
             -->
 
           <example>
             <title><filename>.cshrc</filename>, f&uuml;r &man.csh.1;- und
               &man.tcsh.1;-Benutzer</title>
 
             <programlisting>setenv SGML_ROOT /usr/local/share/sgml
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/de_DE.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES</programlisting>
             </example>
 
           <para>Damit die &Auml;nderungen wirksam werden, meldet man
             sich ab und anschlie&szlig;end wieder an &ndash; oder man
             f&uuml;hrt die obigen Anweisungen direkt in der Shell
             aus und setzt so die ben&ouml;tigten Umgebungsvariablen.</para>
 
         </step>
       </procedure>
 
       <procedure>
         <step>
           <para>Nun sollte man eine Datei
             <filename>beispiel.sgml</filename> anlegen, die den
             folgenden Text enth&auml;lt:</para>
 
             <programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 
 <html>
   <head>
     <title>Eine Beispieldatei in HTML</title>
   </head>
 
   <body>
     <p>Das ist ein Absatz mit etwas Text.</p>
 
     <p>Das ist ein Absatz mit anderem Text.</p>
 
     <p align="right">Dieser Absatz wird rechtsb&uuml;ndig
       ausgerichtet.</p>
   </body>
 </html>]]></programlisting>
         </step>
 
         <step>
           <para>Nachdem die Datei abgespeichert wurde, kann sie
             mit Hilfe eines SGML-Parsers validiert werden.</para>
 
           <para>Bestandteil von <filename role="package">textproc/docproj</filename>
             ist <command>nsgmls</command> - ein <link
             linkend="sgml-primer-validating">validierender Parser</link>.
             <command>nsgmls</command> liest ein Dokument entsprechend einer SGML-DTD
             ein und gibt anschlie&szlig;end ein Element-Structure-Information-Set
             (ESIS) aus. Allerdings ist das an dieser Stelle nicht weiter
             wichtig.</para>
 
           <para>Wird <command>nsgmls</command> mit der Option <option>-s</option>
             aufgerufen, werden nur Fehlermeldungen ausgegeben. Dadurch
             kann leicht gepr&uuml;ft werden, ob ein Dokument g&uuml;ltig
             ist oder nicht.</para>
 
           <para>So pr&uuml;ft man mit <command>nsgmls</command>, ob die neuangelegte
             Beispieldatei g&uuml;ltig ist:</para>
 
             <screen>&prompt.user; <userinput>nsgmls -s beispiel.sgml</userinput></screen>
 
           <para>Sofern das Beispiel korrekt abgetippt wurde, wird sich
             <command>nsgmls</command> ohne jegliche Ausgabe beenden. Das bedeutet,
             dass das Dokument erfolgreich validiert werden konnte
             und somit g&uuml;ltig ist.</para>
         </step>
 
         <step>
           <para>Jetzt sollten die Tags <sgmltag>title</sgmltag> und
             <sgmltag>/title</sgmltag> aus dem Dokument gel&ouml;scht
             und das Dokument erneut validiert werden:</para>
 
             <screen>&prompt.user; <userinput>nsgmls -s beispiel.sgml</userinput>
 nsgmls:beispiel.sgml:5:4:E: character data is not allowed here
 nsgmls:beispiel.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
 
           <para>Die Fehlermeldungen, die von <command>nsgmls</command>
 	    ausgegeben werden, sind in durch Doppelpunkte getrennte
 	    Spalten unterteilt.</para>
 
           <informaltable frame="none" pgwide="1">
             <tgroup cols="2">
               <thead>
                 <row>
                   <entry>Spalte</entry>
                   <entry>Bedeutung</entry>
                 </row>
               </thead>
 
               <tbody>
                 <row>
                   <entry>1</entry>
                   <entry>Der Name des Programms, das den Fehler
                     meldet. Hier wird immer <literal>nsgmls</literal>
                     stehen.</entry>
                 </row>
 
                 <row>
                   <entry>2</entry>
                   <entry>Der Name der fehlerhaften Datei.</entry>
                 </row>
 
                 <row>
                   <entry>3</entry>
                   <entry>Die Zeilennummer des Fehlers.</entry>
                 </row>
 
                 <row>
                   <entry>4</entry>
                     <entry>Die Spaltenummer des Fehlers.</entry>
                 </row>
 
                 <row>
                   <entry>5</entry>
                   <entry>Ein einbuchstabiger Code, der &uuml;ber die
                     Art des Fehlers informiert. <literal>I</literal>
                     steht f&uuml;r eine informelle Meldung,
                     <literal>W</literal> f&uuml;r eine Warnung und
                     <literal>E</literal> f&uuml;r Fehler<footnote>
                       <para>Nicht immer besteht eine Meldung aus
                         f&uuml;nf Spalten. Die Ausgabe von
                         <command>nsgmls -sv</command> ist
                         beispielsweise <literal>nsgmls:I: SP version
                           "1.3"</literal> (nat&uuml;rlich
                         abh&auml;ngig von der Version). Wie man sehen
                         kann, handelt es sich hier um eine informelle
                         Meldung.</para>
                     </footnote> und <literal>X</literal> f&uuml;r
                     einen Querverweis. Bei den oben stehenden Ausgaben
                     handelt es sich also um Fehlermeldungen.</entry>
                   </row>
 
                 <row>
                   <entry>6</entry>
                   <entry>Die Fehlermeldung.</entry>
                 </row>
               </tbody>
             </tgroup>
           </informaltable>
 
           <para>Durch das Weglassen des Tags <sgmltag>title</sgmltag>
             sind zwei unterschiedliche Fehler entstanden.</para>
 
           <para>Der erste Fehler besagt, dass Inhalt (in diesem
             Falle Zeichen anstatt eines Starttags) an einer Stelle
             gefunden wurde, an der der Parser etwas anderes erwartet
             hat. Genauer gesagt wurde der Starttag eines Elements
             erwartet, das innerhalb von <sgmltag>head</sgmltag>
             auftreten kann.</para>
 
           <para>Der zweite Fehler wurde dadurch verursacht, dass
             das Element <sgmltag>head</sgmltag> ein
             Element <sgmltag>title</sgmltag> enthalten
             <emphasis>muss</emphasis> und <command>nsgmls</command>
             nicht ber&uuml;cksichtigt, dass dieser Fehler auf dem
             vorhergehenden beruht. Es wird lediglich festgestellt,
             dass der Endtag von <sgmltag>head</sgmltag> auftritt,
 	    obwohl nicht alle notwendigen Elemente vorhanden sind.</para>
         </step>
 
         <step>
           <para>Zum Schlu&szlig; sollte der Tag
             <literal>title</literal> wieder in die Beispieldatei
             eingef&uuml;gt werden.</para>
           </step>
         </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-doctype-declaration">
     <!--? Oliver Fischer: Man sollte mal feststellen, welche Bezeichung
     von w3c.de oder so hier verwendet wird.-->
     <title>Die DOCTYPE-Deklaration</title>
 
     <para>Am Anfang jedes Dokuments muss der Name der dem
       Dokument zugrundeliegenden DTD angegeben werden. Mit Hilfe
       dieser Information k&ouml;nnen SGML-Parser die verwendete DTD
       feststellen und pr&uuml;fen, ob das Dokument zu ihr konform ist.</para>
 
     <para>&Uuml;blicherweise steht diese Information in einer Zeile,
       die als DOCTYPE-Deklaration bezeichnet wird.</para>
 
 
     <para>Eine Deklaration f&uuml;r ein HTML-Dokument, das nach den
       Vorgaben der DTD f&uuml;r HTML 4.0 geschrieben wurde, sieht so
       aus:</para>
 
     <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN">]]></programlisting>
 
     <para>und besteht aus verschiedenen Teilen.</para>
 
     <!--<para>That line contains a number of different components.</para>-->
 
     <!--?
     Hier bin ich mir nicht sicher, ob ich genau &uuml;bersetzt habe oder
     das Orginal sprachlich ungenau ist. Man sollte hier mal
     in den Standardspezikationen nachschlagen und gegebenenfalls
     das Orginal korrigieren.
     Oliver Fischer
     -->
 
     <variablelist>
       <varlistentry>
         <term><literal>&lt;!</literal></term>
 
         <listitem>
           <para>Die Zeichenkette <literal>&lt;!</literal> dient hier
             als <emphasis>Indikator</emphasis>, dass es sich bei
             diesem Ausdruck um eine SGML-Deklaration handelt und diese
             Zeile den Dokumententyp festlegt.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>DOCTYPE</literal></term>
 
         <listitem>
           <para>Zeigt an, dass dies die SGML-Deklaration f&uuml;r
             den Dokumententyp ist.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>html</literal></term>
 
         <listitem>
           <para>Nennt das erste <link
               linkend="sgml-primer-elements">Element</link>, das im
             Dokument auftaucht.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>PUBLIC "-//W3C//DTD HTML 4.0//EN"</literal></term>
 
         <listitem>
           <para>Nennt den Formalen &Ouml;ffentlichen Bezeichner
             <footnote>
               <simpara>auf Englisch <foreignphrase>Formal Public
                   Identifier (FPI) </foreignphrase></simpara>
             </footnote> der DTD des Dokuments. Diese Information wird
             von SGML-Parsern ausgewertet, um die von dem Dokument
             referenzierte DTD zu bestimmen.</para>
 
           <para>Das Schl&uuml;sselwort <literal>PUBLIC</literal>
             geh&ouml;rt nicht zum &ouml;ffentlichen Bezeichner,
             sondern legt fest, wie ein SGML-Parser die DTD finden
             kann. Alternative Wege eine DTD zu referenzieren werden
             <link linkend="sgml-primer-fpi-alternatives">sp&auml;ter
               gezeigt</link>.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>&gt;</literal></term>
 
         <listitem>
           <para>Schlie&szlig;t den mit <literal>&lt;!</literal> begonnenen
             Ausdruck ab.</para>
         </listitem>
       </varlistentry>
     </variablelist>
 
     <sect2>
       <title>Formale &Ouml;ffentliche Bezeichner</title>
 
       <!--? -->
       <note>
         <para>Dieser Abschnitt braucht nicht unbedingt zu gelesen zu
           werden. Dennoch ist es empfehlenswert, da er n&uuml;tzliche
           Hintergrundinformationen enth&auml;lt, die hilfreich sein
           k&ouml;nnen, falls der SGML-Prozessor die genutzte DTD nicht
           finden kann.</para>
       </note>
 
       <para>Jeder &ouml;ffentliche Bezeichner muss eine bestimmte Syntax
         haben, die wie folgt lautet:</para>
 
       <!-- Oliver Fischer: Ich habe hier Owner mit Besitzer uebersetzt.
       Mein Gef&uuml;hl sagt mir, dass dies nicht 100% richtig ist.
       Vielleicht ist Aussteller bessert? -->
 
       <programlisting>"<replaceable>Besitzer</replaceable>//<replaceable>Schl&uuml;sselwort</replaceable> <replaceable>Beschreibung</replaceable>//<replaceable>Sprache</replaceable>"</programlisting>
 
       <variablelist>
         <varlistentry>
           <term><replaceable>Besitzer</replaceable></term>
 
           <listitem>
             <para>Nennt den Besitzer des &ouml;ffentlichen Bezeichners.</para>
 
             <para>Falls diese Zeichenkette mit <quote>ISO</quote>
               beginnt, geh&ouml;rt der Bezeichner dem ISO-Kommitee.
               Der Bezeichner <literal>"ISO 8879:1986//ENTITIES Greek
                 Symbols//EN"</literal> nennt <quote>ISO
                 8879:1986</quote> als den Besitzer des Satzes von
               Entit&auml;ten f&uuml;r griechische Zeichen. ISO
               8879:1986 ist die ISO-Bezeichnung f&uuml;r den
               SGML-Standard.</para>
 
 
             <!--? Die Formulierung gef&auml;llt mir nicht. Oliver Fischer -->
             <para>Beginnt die Zeichenkette nicht mit
               <quote>ISO</quote>, sieht sie entweder so
               <literal>-//<replaceable>Besitzer</replaceable></literal>
               oder so
               <literal>+//<replaceable>Besitzer</replaceable></literal>
               aus. Beide Varianten unterscheiden sich also nur durch
               das anf&auml;ngliche <literal>+</literal> bzw.
               <literal>-</literal>.</para>
 
             <para>Sofern am Anfang ein <literal>-</literal> steht, ist
               der Bezeichner nicht &ouml;ffentlich registriert, steht
               hingegen ein <literal>+</literal> am Anfang, ist er
               registriert.</para>
 
 
             <!--? Vielleicht besser: Wie Namen registeriert werden?
             Oliver Fischer -->
             <!--? Mit der &Uuml;bersetzung des letzten Satzes bin ich mir
             nicht sicher.... Das muss irgendwie besser ausgedr&uuml;ckt
             werden.... -->
 
             <para>Im ISO-Standard ISO 9070:1991 wurde festgelegt, wie
               registrierte Namen erzeugt werden k&ouml;nnen. Unter
               anderem k&ouml;nnen sie von den Bezeichnungen von
               ISO-Publikationen, von ISBN-Nummern oder einer
               Organisationsbezeichnungen entsprechend ISO 6523
               abgeleitet werden. Antr&auml;ge f&uuml;r neue offiziell
               registrierte Bezeichner werden vom ISO-Kommitee an das
               American National Standards Institute (ANSI)
               weitergeleitet.</para>
 
 
 
             <!--?
             Eine Zeichenkette kann kein Besitzer sein.
             Wie koennte man das besser ausdruecken?
             -->
 
             <para>Da das FreeBSD-Projekt seine Bezeichner nicht hat
               registrieren lassen, ist der Besitzer
               <literal>-//FreeBSD</literal>. Unter anderem kann man
               daran auch sehen, dass das W3C sich nicht hat
               registrieren lassen.</para>
 
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><replaceable>Schl&uuml;sselwort</replaceable></term>
 
           <listitem>
             <para>Es gibt verschiedene Schl&uuml;sselw&ouml;rter mit
               denen man die Art der gegebenen Informationen beschreiben
               kann. Einige der &uuml;blichsten sind
               <literal>DTD</literal>, <literal>ELEMENT</literal>,
               <literal>ENTITIES</literal> und <literal>TEXT</literal>.
               <literal>DTD</literal> wird nur f&uuml;r Dateien mit
               DTDs verwandt, <literal>ELEMENT</literal> findet
               f&uuml;r Dateien mit Fragmenten von DTDs Verwendung, die
               nur Deklarationen f&uuml;r Entit&auml;ten und Elemente
               enthalten. <literal>TEXT</literal> wird f&uuml;r
               SGML-Inhalte (Texte und Tags) verwendet.</para>
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><replaceable>Beschreibung</replaceable></term>
 
           <listitem>
             <para>Eine frei w&auml;hlbare Beschreibung des Inhalts der
               referenzierten Datei. M&ouml;glich sind hier
               Versionsnummern oder ein kurzer und sinnvoller Text, der
               innerhalb der SGML-Welt eindeutig ist.</para>
 
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><replaceable>Sprache</replaceable></term>
 
           <listitem>
             <para>Ein ISO-Code aus zwei Buchstaben, der die f&uuml;r
               die Datei verwendete Sprache nennt.
               <literal>EN</literal> steht hier f&uuml;r Englisch,
               <literal>DE</literal> f&uuml;r Deutsch.</para>
           </listitem>
         </varlistentry>
       </variablelist>
 
       <sect3>
         <title>Die <filename>catalog</filename>-Dateien</title>
 
         <para>Wenn man die oben beschriebene Syntax f&uuml;r
           Bezeichner verwendet und ein Dokument durch einen
           SGML-Prozessor schickt, muss dieser die
           M&ouml;glichkeit haben, den Bezeichner auf eine real
           existierende Datei abzubilden, die die ben&ouml;tigte DTD
           enth&auml;lt.</para>
 
         <para>Einer der m&ouml;glichen Wege hierf&uuml;r sind
           Katalogdateien. Eine solche Datei, die &uuml;blicherweise
           <filename>catalog</filename> hei&szlig;t, besteht aus
           einzelnen Zeilen, die Bezeichner auf Dateinamen abbilden.
           Enth&auml;lt ein Katalog beispielsweise die Zeile</para>
 
         <programlisting>PUBLIC "-//W3C//DTD HTML 4.0//EN"             "4.0/strict.dtd"</programlisting>
 
         <para>kann ein SGML-Prozessor dar&uuml;ber feststellen, dass die
           ben&ouml;tigte DTD in der Datei <filename>strict.dtd</filename>
           im Unterverzeichnis <filename class="directory">4.0</filename>
           des Verzeichnisses des Katalogs zu finden ist.</para>
 
         <para>Ein gutes Beispiel f&uuml;r einen Katalog ist
           <filename>/usr/local/share/sgml/html/catalog</filename>.
           Diese Datei enth&auml;lt den Katalog f&uuml;r alle HTML
           DTDs, die im Zuge der Installation von <filename
             role="package">textproc/docproj</filename> installiert
           wurden.</para>
 
       </sect3>
 
       <sect3>
         <title>Die Variable <envar>SGML_CATALOG_FILES</envar></title>
 
         <para>Nat&uuml;rlich muss einem SGML-Prozessor noch
           mitgeteilt werden k&ouml;nnen, wo er seine Kataloge finden
           kann. Viele Programme bieten hierf&uuml;r
           Kommandozeilenoptionen an, &uuml;ber die man einen oder
           mehrere Kataloge angeben kann.</para>
 
         <para>Zus&auml;tzlich besteht noch die M&ouml;glichkeit mit
           der Umgebungsvariablen <envar>SGML_CATALOG_FILES</envar> auf
           SGML-Kataloge zu verweisen. Die Eintr&auml;ge von
           <envar>SGML_CATALOG_FILES</envar> m&uuml;ssen aus den
           vollst&auml;ndigen Pfadnamen der Kataloge, jeweils durch
           Komma getrennt, bestehen.</para>
 
 
         <!--? Stimmt die Formulierung? Oliver Fischer -->
         <para>&Uuml;blicherweise werden die folgenden Kataloge &uuml;ber
             <envar>SGML_CATALOG_FILES</envar> f&uuml;r
           die Arbeit an den Dokumenten des FDPs eingebunden:</para>
 
         <itemizedlist>
           <listitem>
             <para><filename>/usr/local/share/sgml/docbook/4.1/catalog</filename></para>
           </listitem>
 
           <listitem>
             <para><filename>/usr/local/share/sgml/html/catalog</filename></para>
           </listitem>
 
           <listitem>
             <para><filename>/usr/local/share/sgml/iso8879/catalog</filename></para>
           </listitem>
 
           <listitem>
             <para><filename>/usr/local/share/sgml/jade/catalog</filename></para>
           </listitem>
         </itemizedlist>
 
         <para>Allerdings sollte das
           <link linkend="sgml-primer-envars">schon geschehen
             sein</link>.</para>
 
       </sect3>
     </sect2>
 
     <sect2 id="sgml-primer-fpi-alternatives">
       <title>Alternativen zu Formalen &Ouml;ffentlichen Bezeichnern</title>
 
       <para>Anstatt mit einem Bezeichner die zum Dokument
         geh&ouml;rende DTD zu referenzieren, kann auch explizit auf
         die Datei der DTD verwiesen werden.</para>
 
       <para>Die Syntax des DOCTYPE-Deklaration ist in diesem Falle
         anders:</para>
       <!--<para>The syntax for this is slightly different:</para>-->
 
       <programlisting><![ RCDATA [<!DOCTYPE html SYSTEM "/pfad/zur/dokumenten.dtd">]]></programlisting>
 
       <para>Das Schl&uuml;sselwort <literal>SYSTEM</literal> legt
         fest, dass ein SGML-Prozessor die DTD auf
         <quote>systemspezifische</quote> Art und Weise bestimmen soll.
         Meistens, aber nicht immer, wird so auf eine Datei im
         Dateisystem verwiesen.</para>
 
       <para>Allerdings sollte man &ouml;ffentliche Bezeichner aus
         Gr&uuml;nden der Portabilit&auml;t bevorzugen, da man so
         nicht eine Kopie der DTD mit dem Dokument selber verteilen
         muss, beziehungsweise da man, wenn man mit
         <literal>SYSTEM</literal> arbeitet, nicht davon ausgehen kann,
         dass  die ben&ouml;tigte DTD auf anderen Systemen genau
         unter dem gleichen Pfad verf&uuml;gbar ist.</para>
 
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-sgml-escape">
     <title>Die R&uuml;ckkehr zu SGML</title>
 
     <para>An einer fr&uuml;heren Stelle wurde erw&auml;hnt, dass
       man SGML nur ben&ouml;tigt, falls man selbst eine DTD entwickeln
       m&ouml;chte. Genaugenommen ist das nicht 100%ig richtig. Einige
       Teile der SGML-Syntax k&ouml;nnen auch in normalen Dokumenten
       verwendet werden, falls dies gew&uuml;nscht oder notwendig
       ist.</para>
 
     <para>In diesem Falle muss daf&uuml;r Sorge getragen werden,
       dass ein SGML-Prozessor feststellen kann, dass ein
       bestimmter Abschnitt des Inhalts SGML ist, das er verarbeiteten
       muss.</para>
 
     <para>Solche SGML-Abschnitte werden mittels
       <literal>&lt;!&nbsp;...&nbsp;&gt;</literal> in Dokumenten
       besonders gekennzeichnet. Alles, was sich zwischen diesen
       Begrenzungen befindet, ist SGML, wie es auch in DTDs gefunden
       werden kann.</para>
 
     <para>Demnach ist die <link
         linkend="sgml-primer-doctype-declaration">DOCTYPE-Deklaration</link>
       ein gutes Beispiel f&uuml;r SGML, das in Dokumenten verwendet
       werden muss&hellip;</para>
 
   </sect1>
 
   <sect1 id="sgml-primer-comments">
     <title>Kommentare</title>
 
     <para>Kommentare sind SGML-Konstrukte, die normalerweise nur
       in DTDs g&uuml;ltig sind. Dennoch ist es, wie in
       <xref linkend="sgml-primer-sgml-escape"> gezeigt,
       m&ouml;glich Fragmente mit SGML-Syntax in Dokumenten zu
       verwenden.</para>
 
     <para>Zum Abgrenzen von SGML-Kommentaren wird ein doppelter
       Bindestrich <quote><literal>--</literal></quote> verwendet. Mit
       seinem ersten Auftreten &ouml;ffnet er einen Kommentar, mit
       seinem zweiten schlie&szlig;t er ihn wieder.</para>
 
     <example>
       <title>Beispiele f&uuml;r Kommentare in SGML</title>
 
       <programlisting>&lt;!-- Testkommentar --></programlisting>
 
       <programlisting><![ RCDATA [
 <!-- Text innerhalb eines Kommentars -->
 
 <!-- Ein anderer Kommentar    -->
 
 <!-- So k&ouml;nnen mehrzeilige Kommentare
      genutzt werden -->
 
 <!-- Eine andere M&ouml;glichkeit f&uuml;r --
   -- mehrzeilige Kommentare.     -->]]></programlisting>
     </example>
 
     <!--? Noch zu uebersetzen. Oliver Fischer -->
     <![ %output.print; [
       <important>
 	<title>Es sind zwei Bindestriche</title>
 
 	<para>Es gibt ein Problem mit den PostScript- oder
 	  PDF-Versionen dieses Dokuments.  Das obige Beispiel
 	  zeigt vielleicht nur einen Bindestrich (<literal>-</literal>)
 	  hinter <literal>&lt;!</literal> und vor
 	  <literal>&gt;</literal>.</para>
 
 	<para>Es <emphasis>m&uuml;ssen</emphasis> zwei Bindestriche
 	  und <emphasis>nicht</emphasis> nur einer benutzt werden.
 	  Die PostScript- und PDF-Versionen haben vielleicht
 	  beide Bindestriche zu einem l&auml;ngeren Strich, dem
 	  <emphasis>em-dash</emphasis>, zusammengefasst.</para>
 
 	<para>Die HTML-, nur-Text und RTF-Versionen dieses Dokuments
 	  sind nicht von diesem Problem betroffen.</para>
       </important>
     ]]>
 
     <para>Hat man fr&uuml;her schon Erfahrungen mit HTML gesammelt,
       wird man vielleicht andere Regeln f&uuml;r den Gebrauch von
       Kommentaren kennengelernt haben. Beispielsweise wird oft
       angenommen, dass Kommentare mit <literal>&lt;!--</literal>
       begonnen und nur mit <literal>--&gt;</literal> beendet
       werden.</para>
 
     <para>Dies ist <emphasis>nicht</emphasis> der Fall. Viele
       Webbrowser haben fehlerhafte HTML-Parser, die dies akzeptieren.
       Die SGML-Parser, die vom FDP verwendet werden, halten sich
       strenger an die SGML-Spezifikation und verwerfen Dokumente mit
       solchen Fehlern.</para>
 
     <example>
       <title>Fehlerhafte SGML-Kommentare</title>
 
       <programlisting><![ RCDATA [
 <!-- Innerhalb eines Kommentars --
 
      DIES IST NICHT TEIL EINES KOMMENTARS
 
   -- Wieder innerhalb eines Kommentars -->]]></programlisting>
 
       <para>SGML-Parser w&uuml;rden die mittlere Zeile wie folgt
         interpretieren:</para>
       <!--<para>The SGML parser will treat this as though it were actually;</para>-->
 
       <programlisting>&lt;!DIES IST NICHT TEIL EINES KOMMENTARS&gt;</programlisting>
 
       <para>Da es sich hierbei nicht um g&uuml;ltiges SGML handelt, kann
         diese Zeile zur verwirrenden  Fehlermeldungen f&uuml;hren.</para>
 
       <programlisting><![ CDATA [<!--------------- Eine wirklich schlechte Idee  --------------->]]></programlisting>
 
       <para>Wie das Beispiel zeigt, sollten solche Kommentare
         tunlichst vermieden werden.</para>
 
       <!--<para>As the example suggests, <emphasis>do not</emphasis> write
       comments like that.</para>-->
 
       <programlisting><![ RCDATA [<!--===================================================-->]]></programlisting>
 
       <para>Ein solcher Kommentar ist (ein wenig) besser, kann aber
         jemanden, der mit SGML noch nicht so vertraut ist,
         verwirren.</para>
 
     </example>
 
     <sect2>
       <title>Finger&uuml;bungen&hellip;</title>
 
       <procedure>
         <step>
           <para>Zur &Uuml;bung k&ouml;nnen Sie einige Kommentare in
             die Datei <filename>beispiel.sgml</filename> einf&uuml;gen
             und &uuml;berpr&uuml;fen, ob die Datei nun noch erfolgreich
             von <command>nsgmls</command> validiert werden kann.</para>
         </step>
 
         <step>
           <para>Zu Testzwecken sollten Sie
             auch noch ein paar fehlerhafte Kommentare hinzuf&uuml;gen
             und sich die resultierenden Fehlermeldungen von
 	    <command>nsgmls</command> ansehen.</para>
         </step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-entities">
     <title>Entit&auml;ten</title>
 
     <para>Entit&auml;ten stellen einen Mechanismus dar, mit dem
       einzelnen Dokumententeilen  ein Name zugewiesen werden kann.
       Findet ein SGML-Parser w&auml;hrend des Parsens eine
       Entit&auml;t, ersetzt er diese durch den ihr zugewiesenen
       Inhalt.</para>
 
     <para>Dadurch steht eine einfache M&ouml;glichkeit zur
       Verf&uuml;gung, mit der  variabler Inhalt in SGML-Dokumenten
       eingebunden werden kann. Zus&auml;tzlich sind Entit&auml;ten der
       einzige Weg, &uuml;ber den eine Datei in eine andere Datei mit
       SGML-Mitteln eingebunden werden kann.</para>
 
     <para>Es werden zwei Arten von Entit&auml;ten unterschieden:
       <emphasis>Allgemeine Entit&auml;ten</emphasis> und
       <emphasis>Parameterentit&auml;ten</emphasis>.</para>
 
     <sect2 id="sgml-primer-general-entities">
       <title>Allgemeine Entit&auml;ten</title>
 
       <para>Allgemeine Entit&auml;ten k&ouml;nnen nur in
 	Dokumenten benutzt werden.  Sie k&ouml;nnen zwar im
 	SGML-Kontext definiert aber dort nicht benutzt
 	werden.  Vergleichen Sie dies mit
         Im <link linkend="sgml-primer-parameter-entities">Parameterentit&auml;ten</link>.</para>
 
       <para>Jede allgemeine Entit&auml;t hat einen Namen, &uuml;ber
         den sie angesprochen werden kann, um den von ihr
         referenzierten Inhalt in ein Dokument einzubinden. Daf&uuml;r
         muss an der betreffenden Stelle der Namen der
         Entit&auml;t per
         <literal>&amp;<replaceable>entitaetenname</replaceable>;</literal>
         einf&uuml;gt werden. Eine Entit&auml;t
         <literal>current.version</literal> k&ouml;nnte beispielsweise
         durch die aktuelle Versionsnummer eines Programms ersetzt
         werden. Man k&ouml;nnte also schreiben:</para>
 
       <!--?
       Der vorhergehende Satz ist nicht 100% sinngemae&szlig; uebersetzt.
       Klingt zudem doof.
       Oliver Fischer
       -->
 
       <!--<para>Each general entity has a name.  When you want to reference a
       general entity (and therefore include whatever text it represents in
       your document), you write
       <literal>&amp;<replaceable>entity-name</replaceable>;</literal>.  For
       example, suppose you had an entity called
       <literal>current.version</literal> which expanded to the current
           version number of your product.  You could write;</para>-->
 
       <programlisting><![ CDATA [<para>Die aktuelle Version des
   Programms ist &current.version;.</para>]]></programlisting>
 
       <para>Wenn sich die Versionsnummer &auml;ndert, muss
 	nur die Entit&auml;t angepasst und anschlie&szlig;end
 	das Dokument neu erzeugt werden.</para>
 
       <para>Eine weitere Einsatzm&ouml;glichkeit f&uuml;r Allgemeine
         Entit&auml;ten ist das Einbinden von Zeichen, die auf andere
         Weise nicht in ein SGML-Dokument eingef&uuml;gt werden
         k&ouml;nnten. Ein Beispiel f&uuml;r solche Zeichen sind
         <literal>&lt;</literal> und <literal>&amp;</literal>, die
         normalerweise nicht direkt in
         SGML-Dokumenten erlaubt sind. St&ouml;&szlig;t ein SGML-Parser
         bei seiner Arbeit auf das Symbol <literal>&lt;</literal>,
         nimmt er an, dass der Anfang eines Start- oder Endtags
         gefunden wurde. Bei einem <literal>&amp;</literal> wird er
         annehmen, den Anfang einer Entit&auml;t gefunden zu haben.</para>
 
       <para>Wenn eines der beiden Zeichen ben&ouml;tigt wird, werden
 	daher die allgemeinen Entit&auml;ten <literal>&amp;lt;</literal>
 	und <literal>&amp;amp;</literal> verwendet.</para>
 
       <para>Allgemeine Entit&auml;ten k&ouml;nnen nur in einem
         SGML-Kontext definiert werden. &Uuml;blich ist es, dies direkt
         nach der DOCTYPE-Deklaration zu tun:</para>
 
       <example>
         <title>Allgemeine Entit&auml;ten festlegen</title>
 
         <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY current.version    "3.0-RELEASE">
 <!ENTITY last.version       "2.2.7-RELEASE">
 ]>]]></programlisting>
 
         <para>Wichtig ist an dieser Stelle, dass die
           DOCTYPE-Deklaration durch eine eckige Klammer am Ende der
           ersten Zeile erweitert wurde. Die beiden Entit&auml;ten
           selber werden in den folgenden zwei Zeilen definiert, bevor
           in der letzten Zeile die eckige Klammer und die
           DOCTYPE-Deklaration wieder geschlossen werden.</para>
 
         <!--?
         UEbersetzung mit dem Orginal vergleichen und nach einer
         besseren UEbersetzung suchen.
         -->
 
         <para>Die eckigen Klammern sind notwendig um festzulegen, dass
           man die &uuml;ber DOCTYPE genannte DTD erweitern m&ouml;chte.</para>
 
       </example>
     </sect2>
 
     <sect2 id="sgml-primer-parameter-entities">
       <title>Parameterentit&auml;ten</title>
 
       <para>Genau wie <link
           linkend="sgml-primer-general-entities">Allgemeine
           Entit&auml;ten</link> werden Parameterentit&auml;ten
         eingesetzt um wiederverwendbare Inhaltsteile mit Namen zu
         versehen. Im Gegensatz zu Allgemeinen Entit&auml;ten
         k&ouml;nnen sie aber nur innerhalb eines <link
           linkend="sgml-primer-sgml-escape">SGML-Kontextes</link>
         genutzt werden.</para>
 
       <para>Die Definition von Parameterentit&auml;ten erfolgt
         &auml;hnlich zu der Allgemeiner Entit&auml;ten. Sie werden
         lediglich mit
         <literal>%<replaceable>entitaetenname</replaceable>;</literal>
         anstelle von
         <literal>&amp;<replaceable>entitaetenname</replaceable>;</literal>
         referenziert<footnote>
           <para>Es wird das Prozentzeichen anstelle des
             kaufm&auml;nnischen Unds verwendet.</para>
         </footnote>. Wichtig ist, dass das
         <literal>%</literal>-Zeichen zwischen
         <literal>ENTITY</literal> und dem Entit&auml;tennamen ein Teil
         der Definition ist.</para>
 
       <example>
         <title>Parameterentit&auml;ten festlegen</title>
 
         <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY % param.etwas "etwas">
 <!ENTITY % param.text "Text">
 <!ENTITY % param.neu  "%param.etwas mehr %param.text">
 
 <!-- %param.neu ist jetzt "etwas mehr Text" -->
 ]>]]></programlisting>
         </example>
 
         <!--? Noch nicht &uuml;bersetzt. Oliver Fischer -->
         <!--<para>This may not seem particularly useful.  It will be.</para>-->
       </sect2>
 
     <sect2>
       <title>Finger&uuml;bungen&hellip;</title>
 
       <procedure>
         <step>
           <para>F&uuml;gen Sie in <filename>beispiel.sgml</filename>
             eine Allgemeine Entit&auml;t ein.</para>
 
             <programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
 <!ENTITY version "1.1">
 ]>
 
 <html>
   <head>
     <title>Eine HTML-Beispieldatei</title>
   </head>
 
   <body>
     <p>Das ist ein Absatz mit etwas Text.</p>
 
     <p>Das ist ein Absatz mit anderem Text.</p>
 
     <p align="right">Dieser Absatz wird rechtsb&uuml;ndig
       ausgerichtet.</p>
 
     <p>Die aktuelle Version ist: &amp;version;</p>
   </body>
 </html>]]></programlisting>
         </step>
 
         <step>
           <para>Validieren Sie diese Datei mit
             <command>nsgmls</command></para>
         </step>
 
         <step>
           <para>&Ouml;ffnen Sie nun <filename>beispiel.sgml</filename>
             mit Ihrem Webbrowser. Es kann notwendig sein, dass
             Sie die Datei vorher in <filename>beispiel.html</filename>
             umbenennen m&uuml;ssen, damit die Datei auch als
             HTML-Dokument erkannt wird.</para>
 
           <para>Nur wenn Sie einen sehr modernen Browser haben, werden
             Sie sehen k&ouml;nnen, dass
             <literal>&amp;version;</literal> durch die Versionsnummer
             ersetzt wurde. Leider haben die meisten Webbrowser
             sehr einfache SGML-Parser, die nicht richtig mit SGML
             umgehen k&ouml;nnen<footnote>
               <para>Eigentlich ist das eine Schande. Man stelle sich
                 vor, welche Probleme und Hacks, wie beispielsweise
                 Server Side Includes, man an dieser Stelle h&auml;tte
                 vermeiden k&ouml;nnen.</para>
             </footnote>.</para>
         </step>
 
         <step>
           <para>Die L&ouml;sung hierf&uuml;r ist, das Dokument zu
             <emphasis>normalisieren</emphasis>. Zu diesem Zweck liest
             ein Normer <!--? Sehr freie &Uuml;bersetzung. Oliver -->
             das Dokument ein und gibt anschlie&szlig;end semantisch
             gleichwertiges SGML wieder aus, dass auf verschiedene
             Arten transformiert worden sein kann. Eine dieser
             m&ouml;glichen Transformationen ist das Ersetzen der
             Referenzen auf Entit&auml;ten mit dem von ihnen
             pr&auml;sentierten Inhalt.</para>
 
           <para>Versuchen Sie, die Beispieldatei mittels
             <command>sgmlnorm</command> zu normalisieren:</para>
 
             <screen>&prompt.user; <userinput>sgmlnorm beispiel.sgml > beispiel.html</userinput></screen>
 
           <para>Anschlie&szlig;end sollten Sie eine normalisierte
             Version, dass hei&szlig;t eine, bei der die
             Entit&auml;ten gegen ihren Inhalt ersetzt wurden, in der
             Datei <filename>beispiel.html</filename> finden. Diese
             Datei k&ouml;nnen Sie sich nun mit Ihrem Browser
             ansehen.</para>
 
         </step>
 
         <step>
           <para>Wenn Sie sich die Ausgaben von <command>sgmlnorm</command>
             ansehen, werden Sie feststellen, dass
             die DOCTYPE-Deklaration am Anfang der Datei nicht mehr
             enthalten ist. M&ouml;chten Sie die Deklaration behalten,
             muss <command>sgmlnorm</command> mit der Option
             <option>-d</option> aufrufen werden:</para>
 
           <screen>&prompt.user; <userinput>sgmlnorm -d beispiel.sgml > beispiel.html</userinput></screen>
         </step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-include">
     <title>Dateien mit Entit&auml;ten einbinden</title>
 
     <!--?
     Dieser kleine Absatz klingt ziemlich h&ouml;lzern.
     Oliver Fischer
     -->
 
     <para>Sowohl <link
         linkend="sgml-primer-general-entities">Allgemeine</link> als
       auch <link
         linkend="sgml-primer-parameter-entities">Parameterentit&auml;ten</link>
       sind n&uuml;tzliche Helfer, wenn es darum geht, eine Datei in
       eine andere einzubinden.</para>
 
     <sect2 id="sgml-primer-include-using-gen-entities">
       <title>Dateien mit Allgemeinen Entit&auml;ten einbinden</title>
 
       <para>Angenommen man hat ein Buch geschrieben, dessen Inhalt
         auf mehrere Dateien aufgeteilt und mittels SGML
         ausgezeichnet. Jedes Kapitel wurde dazu in einer eigenen Datei
         (<filename>kapitel1.sgml</filename>,
         <filename>kapitel2.sgml</filename> usw.) abgelegt und
         &uuml;ber eine Datei <filename>buch.sgml</filename> sollen
         alle physischen Dateien wieder mit der Hilfe von
         Entit&auml;ten zu einem logischen Dokument
         zusammengef&uuml;hrt werden.</para>
 
       <para>Damit der Inhalt der Dateien mit Entit&auml;ten
 	eingebunden werden kann, muss die Deklaration der
         Entit&auml;ten das Schl&uuml;sselwort
         <literal>SYSTEM</literal> enthalten. SGML-Parser werden so
         angewiesen, den Inhalt der referenzierten Datei als Wert
         f&uuml;r die jeweilige Entit&auml;t zu nehmen.</para>
 
       <example>
         <title>Dateien mit Allgemeinen Entit&auml;ten einbinden</title>
 
         <programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY kapitel.1 SYSTEM "kapitel1.sgml">
 <!ENTITY kapitel.2 SYSTEM "kapitel2.sgml">
 <!ENTITY kapitel.3 SYSTEM "kapitel3.sgml">
 <!-- Und so weiter... -->
 ]>
 
 <html>
   <!-- Jetzt werden die Kapitel &uuml;ber die Entit&auml;ten eingebunden -->
 
   &amp;kapitel.1;
   &amp;kapitel.2;
   &amp;kapitel.3;
 </html>]]></programlisting>
       </example>
 
       <warning>
         <para>Wenn man Allgemeine Entit&auml;ten benutzt, um andere
           Dateien einzubinden, d&uuml;rfen diese Dateien
           (<filename>kapitel1.sgml</filename>,
           <filename>kapitel2.sgml</filename>, ...)
           <emphasis>keine</emphasis> eigene DOCTYPE-Deklaration
           haben.</para>
       </warning>
     </sect2>
 
     <sect2>
       <title>Dateien mit Parameterentit&auml;ten einbinden</title>
 
       <para>Wie bereits festgestellt, k&ouml;nnen
         Parameterentit&auml;ten nur innerhalb eines SGML-Kontexts
         genutzt werden. Warum m&ouml;chte man aber Dateien innerhalb
         eines SGML-Kontexts einbinden? Der Vorteil liegt in der
         M&ouml;glichkeit, die Deklaration von Entit&auml;ten in eine
         andere Datei auslagern zu k&ouml;nnen, wodurch diese leichter
         wiederverwendbar sind.</para>
 
       <para>Angenommen das Buch aus dem vorherigen Kapitel besteht aus
         sehr vielen Kapiteln und diese sollen auch in einem anderen
         Buch, aber in einer anderen Reihenfolge, verwendet werden.
         Eine M&ouml;glichkeit w&auml;re es, die daf&uuml;r notwendigen
         Entit&auml;ten am Anfang jedes Buches einzeln festzulegen
         &ndash; was allerdings mit der Zeit unhandlich und
         fehlertr&auml;chtig wird.</para>
 
       <para>Alternativ bietet sich dazu an, die Deklarationen in eine
         separate Datei auszulagern und deren Inhalt anschlie&szlig;end
         in beide B&uuml;cher &uuml;ber Parameterentit&auml;ten
         einzubinden.</para>
 
       <example>
         <title>Dateien mit Parameterentit&auml;ten einbinden</title>
 
         <para>Zuerst werden die Entit&auml;ten in einer separaten
           Datei namens <filename>kapitel.ent</filename> deklariert.
           <filename>kapitel.ent</filename> enth&auml;lt f&uuml;r
           dieses Beispiel die folgenden Zeilen:</para>
 
         <programlisting><![ CDATA [<!ENTITY kapitel.1 SYSTEM "kapitel1.sgml">
 <!ENTITY kapitel.2 SYSTEM "kapitel2.sgml">
 <!ENTITY kapitel.3 SYSTEM "kapitel3.sgml">]]></programlisting>
 
         <para>Im zweiten Schritt f&uuml;gt man in beide B&uuml;cher
           eine Parameterentit&auml;t ein, die den Inhalt von
           <filename>kapitel.ent</filename> referenziert, und l&auml;dt
           &uuml;ber diese dann die Deklarationen. Anschlie&szlig;end
           k&ouml;nnen die so geladenen Entit&auml;ten wie gewohnt
           genutzt werden.</para>
 
 	<programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!-- Definieren einer Parameterentit&auml;t um die Allgemeinen Entit&auml;ten f&uuml;r -->
 <!-- die Kapitel laden zu k&ouml;nnen                                        -->
 <!ENTITY % kapitel SYSTEM "kapitel.ent">
 
 <!-- Nun wird der Inhalt der referenzierten Datei geladen -->
 %kapitel;
 ]>
 
 <html>
   &amp;kapitel.1;
   &amp;kapitel.2;
   &amp;kapitel.3;
 </html>]]></programlisting>
       </example>
     </sect2>
 
     <sect2>
       <title>Finger&uuml;bungen&hellip;</title>
 
         <sect3>
           <title>Binden Sie Dateien &uuml;ber Allgemeine Entit&auml;ten ein</title>
 
           <procedure>
             <step>
               <para>Legen Sie drei Dateien (<filename>absatz1.sgml</filename>,
                 <filename>absatz2.sgml</filename> und <filename>absatz3.sgml</filename>)
                 mit jeweils einer Zeile wie
 
                 <!--     <para>Create three files, <filename>para1.sgml</filename>,
                 <filename>para2.sgml</filename>, and
                 <filename>para3.sgml</filename>.</para>-->
 
                 <!--<para>Put content similar to the following in each file;</para>-->
 
                 <programlisting><![ CDATA [<p>Erster Absatz.</p>]]></programlisting>
                 an.</para>
 	  </step>
 
 	  <step>
 	    <para>&Auml;ndern Sie <filename>beispiel.sgml</filename> so
               ab, dass sie wie folgt aussieht:</para>
 
               <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY version "1.1">
 <!ENTITY absatz1 SYSTEM "absatz1.sgml">
 <!ENTITY absatz2 SYSTEM "absatz2.sgml">
 <!ENTITY absatz3 SYSTEM "absatz3.sgml">
 ]>
 
 <html>
   <head>
     <title>Eine HTML-Beispieldatei</title>
   </head>
 
   <body>
     <p>Die aktuelle Version dieses Dokuments ist &version;</p>
 
     &absatz1;
     &absatz2;
     &absatz3;
   </body>
 </html>]]></programlisting>
 	  </step>
 
 	  <step>
 	    <para>Erzeugen Sie nun die Datei
               <filename>beispiel.html</filename>, indem Sie
               <filename>beispiel.sgml</filename> normalisieren:</para>
 
             <screen>&prompt.user; <userinput>sgmlnorm -d beispiel.sgml > beispiel.html</userinput></screen>
           </step>
 
           <step>
             <para>&Ouml;ffnen Sie <filename>beispiel.html</filename>
               nun mit einem Webbrowser und vergewissern Sie sich,
               dass der Inhalt der Dateien
               <filename>absatz<replaceable>N</replaceable>.sgml</filename>
               in <filename>beispiel.html</filename> &uuml;bernommen
               wurde.</para>
           </step>
 	</procedure>
       </sect3>
 
       <sect3>
 	<title>Binden Sie Dateien mit Parameterentit&auml;ten ein</title>
 
 	<note>
 	  <para>Hierf&uuml;r m&uuml;ssen Sie die vorherige Finger&uuml;bung gemacht haben.</para>
 	</note>
 
 	<procedure>
 	  <step>
 	    <para>&Auml;ndern Sie <filename>beispiel.sgml</filename> so
               ab, dass es wie folgt aussieht:</para>
 
 	    <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY % entitaeten SYSTEM "entitaeten.sgml"> %entitaeten;
 ]>
 
 <html>
   <head>
     <title>Eine HTML-Beispieldatei</title>
   </head>
 
   <body>
     <p>Die aktuelle Version dieses Dokuments ist &version;</p>
 
     &absatz1;
     &absatz2;
     &absatz3;
   </body>
 </html>]]></programlisting>
 	  </step>
 
           <step>
             <para>Legen Sie eine weitere Datei <filename>entitaeten.sgml</filename> an,
                 die folgenden Inhalt hat:</para>
 
             <programlisting><![ CDATA [<!ENTITY version "1.1">
 <!ENTITY absatz1 SYSTEM "absatz1.sgml">
 <!ENTITY absatz2 SYSTEM "absatz2.sgml">
 <!ENTITY absatz3 SYSTEM "absatz3.sgml">]]></programlisting>
           </step>
 
           <step>
             <para>Erzeugen Sie die Datei
               <filename>beispiel.html</filename>, indem Sie
               <filename>beispiel.sgml</filename> normalisieren:</para>
 
             <screen>&prompt.user; <userinput>sgmlnorm -d beispiel.sgml > beispiel.html</userinput></screen>
           </step>
 
           <step>
             <para>&Ouml;ffnen Sie <filename>beispiel.html</filename>
               nun mit einem Webbrowser und vergewissern Sie sich,
               dass der Inhalt der Dateien
               <filename>absatz<replaceable>N</replaceable>.sgml</filename>
               in <filename>beispiel.html</filename> &uuml;bernommen
               wurde.</para>
           </step>
         </procedure>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-marked-sections">
     <title>Markierte Bereiche</title>
 
     <para>SGML erlaubt es, dass bestimmte Dokumentabschnitte
       w&auml;hrend der Verarbeitung besonders behandelt werden sollen.
       Diese Abschnitte werden als <quote>markierte Bereiche</quote>
       <footnote><para>auf Englisch <foreignphrase>marked
             sections</foreignphrase>
         </para></footnote>
         bezeichnet.</para>
 
     <example>
       <title>Aufbau eines markierten Bereiches</title>
 
       <programlisting>&lt;![ <replaceable>SCHL&Uuml;SSELWORT</replaceable> [
   Inhalt des markierten Bereiches
 ]]&gt;</programlisting>
     </example>
 
     <para>Da es sich bei markierten Bereichen um SGML-Konstrukte
       handelt, werden sie mit <literal>&lt;!</literal> eingeleitet.
       Der eigentliche Anfang des markierten Bereiches wird von der
       folgenden eckigen Klammer bestimmt. Das darauf folgende
       <replaceable>SCHL&Uuml;SSELWORT</replaceable> legt fest, wie der
       <quote>markierte Inhalt</quote> durch einen SGML-Prozessor
       w&auml;hrend der Verarbeitung behandelt werden soll. Der
       <quote>markierte</quote> Inhalt selbst beginnt erst nach der
       zweiten eckigen Klammer und erstreckt sich bis zu den zwei
       schlie&szlig;enden eckigen Klammern am Ende des Bereiches. Mit
       Hilfe des <literal>&gt;</literal> Zeichens wird der mit
       <literal>&lt;!</literal> begonnene SGML-Kontext wieder
       verlassen.</para>
 
     <sect2>
       <title>Schl&uuml;sselworte f&uuml;r markierte Bereiche</title>
 
       <sect3>
         <title><literal>CDATA</literal> und <literal>RCDATA</literal></title>
 
         <para>Die Schl&uuml;sselworte <literal>CDATA</literal> und
           <literal>RCDATA</literal> bestimmen das
           <emphasis>Inhaltsmodell</emphasis> f&uuml;r markierte
           Bereiche. Dadurch ist es m&ouml;glich, vom Standardmodell
           abzuweichen.</para>
 
         <para>Ein SGML-Prozessor muss w&auml;hrend der
           Verarbeitung eines Dokuments zu jedem Zeitpunkt wissen,
           welches <emphasis>Inhaltsmodell</emphasis> gerade anzuwenden
           ist.</para>
 
         <para>Was ist ein Inhaltsmodell? Kurz gesagt beschreibt das
           Inhaltsmodell, welche Art von Inhalt der Parser zu erwarten
           und wie er damit umzugehen hat.</para>
 
         <para>Bei <literal>CDATA</literal> und
           <literal>RCDATA</literal> handelt es sich wahrscheinlich um
           die n&uuml;tzlichsten Inhaltsmodelle. <!--? Die richtige
           Uebersetzung ist Buchstabendaten. Oliver Fischer -->
           <literal>CDATA</literal> steht f&uuml;r
           Zeichendaten<footnote>
             <para>auf Englisch <foreignphrase>character
                 data</foreignphrase></para></footnote>. Trifft ein
           Parser auf dieses Inhaltsmodell, wird er annehmen, dass
           sich im zugeh&ouml;rigen Dokumentenbereich nur
           <quote>gew&ouml;hnliche</quote> Zeichen befinden. Das
           bedeutet, dass <literal>&lt;</literal> und
           <literal>&amp;</literal> ihre besondere Bedeutung
           verlieren und als einfache Zeichen behandelt werden.</para>
 
         <para><literal>RCDATA</literal> steht f&uuml;r
           Entit&auml;tenreferenzen und Zeichendaten<footnote><para>auf
               Englisch
               <foreignphrase>Entity references and character
                 data</foreignphrase></para></footnote>. F&uuml;r einen
           Bereich mit diesem Inhaltsmodell, wird ein Parser davon
           ausgehen, dass er sowohl Zeichen als auch
           Enit&auml;tenreferenzen finden kann. <literal>&lt;</literal>
           verliert hier zwar auch seine besondere Bedeutung, doch
           <literal>&amp;</literal> wird weiterhin als Anfang einer
           Entit&auml;t interpretiert.</para>
 
         <para>N&uuml;tzlich ist das <literal>CDATA</literal>-Modell
           vor allem dann, wenn es darum geht Texte eins-zu-eins zu
           &uuml;bernehmen, in denen <literal>&lt;</literal> und
           <literal>&amp;</literal> geh&auml;uft
           auftreten. Zwar kann man solche Texte &uuml;berarbeiten und
           jedes <literal>&lt;</literal> durch ein
           <literal>&amp;lt;</literal> und jedes
           <literal>&amp;</literal> durch ein <literal>&amp;amp;</literal>
           ersetzen, doch es wird in den meisten F&auml;llen
           einfacher sein, f&uuml;r den betreffenden Text
           <literal>CDATA</literal> als Inhaltsmodell festzulegen. Ein
           SGML-Parser wird dann, sobald er auf
           <literal>&lt;</literal> oder <literal>&amp;</literal> trifft,
           diese als  Zeichen in einem Text betrachten.</para>
 
         <note>
           <para>Bei der Verwendung von <literal>CDATA</literal> und
             <literal>RCDATA</literal> als Inhaltsmodell f&uuml;r
             SGML-Beispiele, wie sie in diesem Dokument enthalten sind,
             muss bedacht werden, dass der Inhalt eines
             <literal>CDATA</literal>-Bereiches nicht validiert wird.
             dass das SGML in diesen Bereichen g&uuml;ltig ist,
             muss auf andere Weise sichergestellt werden. Denkbar ist
             beispielsweise, es in einem separaten Dokument zu
             erstellen, dort zu pr&uuml;fen und erst dann in das
             eigentliche Dokument einzuf&uuml;gen.</para>
         </note>
           <!-- The nesting of CDATA within the next example is disgusting -->
 
         <example>
           <title>CDATA als Inhaltsmodell f&uuml;r markierte Bereiche</title>
 
           <programlisting>&lt;para>Das ist ein Beispiel, wie man einen Text,
   der viele <literal>&amp;lt;</literal>- und <literal>&amp;amp;</literal>-
   Entit&auml;ten enth&auml;lt, in ein Dokument einbinden kann.
   Das Beispiel selbst, das sich innerhalb des markierten Bereiches befindet,
   ist ein HTML-Fragment. Der diesen Text umschlie&szlig;ende Tag, beginnend mit
   mit <sgmltag>para</sgmltag> und endend mit <sgmltag>/para</sgmltag>, stammt aus der DocBook DTD.&lt;/para>
 
 &lt;programlisting>
   &lt;![ RCDATA [  <![ CDATA [
     <p>Dieses Beispiel demonstriert die Verwendung von HTML-Elementen.
       Da spitze Klammern so oft vorkommen, ist es einfacher, das
       gesamte Beispiel als CDATA Abschnitt auszuweisen, als die
       entsprechenden Entit&auml;ten zu nutzen.</p>
 
     <ul>
       <li>Das ist ein Listenelement.</li>
       <li>Das ist ein zweites Listenelement.</li>
       <li>Das ist ein drittes Listenelement.</li>
     </ul>
 
     <p>Und das hier, das ist das Ende des Beispiels.</p>]]>
   ]]&gt;
 &lt;/programlisting></programlisting>
 
           <para>Liest  man die Quellen dieser Fibel, wird man
             feststellen, dass diese Technik durchg&auml;ngig
             angewandt wurde.</para>
 
         </example>
       </sect3>
 
       <sect3>
 	<title><literal>INCLUDE</literal> und
 	  <literal>IGNORE</literal></title>
 
         <para>Das Schl&uuml;sselwort <literal>INCLUDE</literal> legt
           fest, dass der Inhalt des betreffenden Abschnittes
           mitverarbeitet wird. Demgegen&uuml;ber bestimmt
           <literal>IGNORE</literal>, dass er ignoriert wird,
           dass hei&szlig;t, dass er bei der Verarbeitung
           &uuml;bergangen wird und in der Ausgabe nicht enthalten
           ist.</para>
 
 	<example>
 	  <title>Anwendung von <literal>INCLUDE</literal> und
             <literal>IGNORE</literal> in markierten
             Abschnitten</title>
 
 	  <programlisting>&lt;![ INCLUDE [
   Dieser Text wird verarbeitet und eingebunden.
 ]]&gt;
 
 &lt;![ IGNORE [
   Dieser Text wird weder verarbeitet noch eingebunden.
 ]]&gt;</programlisting>
           </example>
 
         <para>F&uuml;r sich alleine ist <literal>IGNORE</literal> als
           Anweisung nicht besonders n&uuml;tzlich, da ein Bereich, der
           von der Verarbeitung ausgenommen sein soll, auch
           auskommentiert werden kann.</para>
 
         <para>Kombiniert man <literal>IGNORE</literal> hingegen mit
           <link
             linkend="sgml-primer-parameter-entities">Parameterentit&auml;ten</link>,
           steht so ein  Weg zur Verf&uuml;gung, um dessen Anwendung
           besser  steuern zu k&ouml;nnen. Zwar k&ouml;nnen
           Parameterentit&auml;ten nur in einem SGML-Kontext einsetzt
           werden, da aber markierte Bereiche ebenfalls SGML-Konstrukte
           sind, ist diese Einschr&auml;nkung irrelevant.</para>
 
         <para>Soll beispielsweise ein und dasselbe Dokument in zwei
           unterschiedlichen Varianten produziert werden, einer
           gedruckten und einer digitalen, und soll nur die digitale
           zus&auml;tzliche Informationen enthalten, kann dies mit
           einem Trick erreicht werden.</para>
 
         <para>Man definiert eine Parameterentit&auml;t, der man als
           Wert die Zeichenkette <literal>INCLUDE</literal> zuweist und
           deklariert den betreffenden Bereich, der nur in der
           digitalen Variante erscheinen soll, als markierten Abschnitt
           und setzt als Schl&uuml;sselwort die zuvor definierte
           Parameterentit&auml;t ein.</para>
 
         <para>Soll anstelle der digitalen die gedruckte Variante
           produziert werden, muss lediglich der Entit&auml;t
           <literal>IGNORE</literal> als Wert zugewiesen und das
           Ursprungsdokument erneut durch den SGML-Prozessor geschickt
           werden.</para>
 
         <example>
           <title>Kontrolle von markierten Bereichen &uuml;ber
             Parameterentit&auml;ten</title>
 
           <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 &lt;!ENTITY % digitale.kopie "INCLUDE">
 ]]&gt;
 
 ...
 
 &lt;![ %digitale.kopie [
   Dieser Satz sollte nur in der digitalen Version enthalten sein.
 ]]&gt;</programlisting>
 
           <para>Bei der Produktion der gedruckten Variante muss
             der Wert der Entit&auml;t ge&auml;ndert werden.</para>
 
 	  <programlisting>&lt;!ENTITY % digitale.kopie "IGNORE"></programlisting>
 
           <para>Bei der Verarbeitung wird als Schl&uuml;sselwort in
             beiden F&auml;llen der von
             <literal>%digitale.kopie</literal> repr&auml;sentierte
             Wert verwendet. Im ersten Fall wird der Inhalt des
             markierten Bereichs mitverarbeitet, im zweiten Fall
             nicht.</para>
 
 	</example>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Finger&uuml;bung&hellip;</title>
 
       <procedure>
 	<step>
           <para>Legen Sie eine neue Datei
             <filename>abschnitt.sgml</filename> an, die folgenden
             Inhalt hat:</para>
 
 	  <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 &lt;!ENTITY % text.ausgabe "INCLUDE">
 ]&gt;
 
 &lt;html>
   &lt;head>
     &lt;title>Ein Beispiel mit markierten Abschnitten&lt;/title>
   &lt;/head>
 
   &lt;body>
     &lt;p>Dieser Absatz &lt;![ CDATA [beinhaltet viele &lt;
       Zeichen (&lt; &lt; &lt; &lt; &lt;). Weshalb es einfacher ist,
       ihn als CDATA Bereich auszuweisen. ]&gt;&lt;/p>
 
     &lt;![ IGNORE [
     &lt;p>Dieser Absatz wird NICHT in der Ausgabe enthalten sein.&lt;/p>
     ]]&gt;
 
     &lt;![ <![ CDATA [%text.ausgabe]]> [
      &lt;p>Dieser Absatz wird in Abh&auml;ngigkeit von <literal>%text.ausgabe</literal>
        mitausgegeben.&lt;/p>
     ]]&gt;
   &lt;/body>
 &lt;/html></programlisting>
         </step>
 
         <step>
           <para>Normalisieren Sie den Inhalt dieser Datei mit Hilfe
             von <command>sgmlnorm</command> und sehen Sie sich das
             Ergebnis an.  Achten Sie dabei darauf, welche Abs&auml;tze
             enthalten beziehungsweise nicht enthalten sind und was aus
             den <literal>CDATA</literal>-Bereichen geworden ist.</para>
 	</step>
 
         <step>
           <para>&Auml;ndern Sie die Definition von
             <literal>text.ausgabe</literal> so, dass es den
             Wert <literal>IGNORE</literal> zugewiesen bekommt.
             Verarbeiten Sie dann die Datei erneut mit
             <command>sgmlnorm</command> und vergleichen die Ausgabe mit
             der vom ersten <command>sgmlnorm</command> Lauf.</para>
 
         </step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-conclusion">
     <title>Schlu&szlig;bemerkung</title>
 
     <para>Aus Platzgr&uuml;nden, und um der Verst&auml;ndlichkeit
       Willen, wurden viele Gesichtspunkte nicht in aller Tiefe
       beziehungsweise gar nicht besprochen. Trotzdem sollte in den
       bisherigen Kapiteln gen&uuml;gend Wissen &uuml;ber SGML
       vermittelt worden sein, um den Aufbau der Dokumentation des FDPs
       zu verstehen.</para>
 
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
index e189a05717..e50840615e 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
@@ -1,239 +1,239 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/the-website/chapter.sgml,v 1.5 2005/08/15 12:51:03 jkois Exp $
-     basiert auf: 1.21
+     $FreeBSDde: de-docproj/books/fdp-primer/the-website/chapter.sgml,v 1.6 2007/11/10 17:21:27 miwi Exp $
+     basiert auf: 1.23
 -->
 
 <chapter id="the-website">
   <chapterinfo>
     <authorgroup>
       <author>
 	<firstname>Johann</firstname>
 	<surname>Kois</surname>
 	<contrib>&Uuml;bersetzt von </contrib>
       </author>
     </authorgroup>
   </chapterinfo>
 
   <title>Die Webseite</title>
 
   <sect1 id="the-website-prep">
     <title>Vorbereitung</title>
 
     <para>Sie ben&ouml;tigen mindestens 200&nbsp;MB freien Speicherplatz.
       Dieser Platz wird von den SGML-Werkzeugen, den n&ouml;tigen Teilen
       des CVS-Baums, f&uuml;r tempor&auml;ren Speicher zum Bau der Seiten
       sowie f&uuml;r die Installation der Webseiten ben&ouml;tigt.  Sind
       die SGML-Werkzeuge und der CVS-Baum bereits installiert, reichen
       etwa 100&nbsp;MB an freiem Speicherplatz aus.</para>
 
     <note>
       <para>Stellen Sie sicher, dass Ihre Dokumentationsports aktuell
 	sind.  Wenn Sie sich nicht sicher sind, entfernen Sie die alten
 	Ports mit &man.pkg.delete.1;, bevor Sie die neue Version
 	installieren.  Derzeit wird unter anderem jade-1.2 vorausgesetzt.
 	Haben Sie beispielsweise jade-1.1 installiert, deinstallieren Sie
 	es mit:</para>
 
       <screen>&prompt.root; <userinput>pkg_delete jade-1.1</userinput></screen>
     </note>
 
     <para>Legen Sie ein CVS-Repository an.  Sie ben&ouml;tigen die
       Verzeichnisse www, doc sowie ports des CVS-Baums (und
       nat&uuml;rlich CVSROOT).  Lesen Sie bitte den Abschnitt
       <ulink url="&url.books.handbook;/synching.html#CVSUP">
       Synchronisation der Quellen</ulink> des Handbuchs, der die
       Spiegelung eines CVS-Baumes oder eines Teilbaumes
       beschreibt.</para>
 
     <para>Die unbedingt n&ouml;tigen cvsup-Sammlungen sind
       <literal>www</literal>, <literal>doc-all</literal>,
       <literal>cvs-base</literal>, sowie
       <literal>ports-base</literal>.</para>
 
     <para>Diese Sammlungen ben&ouml;tigen etwa 105&nbsp;MB an freiem
       Speicherplatz.</para>
 
     <para>Der komplette CVS-Baum - inklusive <literal>src</literal>,
       <literal>doc</literal>, <literal>www</literal>, und
       <literal>ports</literal> - umfasst derzeit etwa 940&nbsp;MB.</para>
   </sect1>
 
   <sect1 id="the-website-build">
     <title>Die Internetseiten neu bauen</title>
 
     <procedure>
       <step>
 	<para>Erzeugen und wechseln Sie in das Verzeichnis, in dem Sie
 	  die Webseiten bauen wollen.  Sie ben&ouml;tigen dazu mindestens
 	  60&nbsp;MB freien Speicherplatz.</para>
 
 	<screen>&prompt.root; <userinput>mkdir /var/tmp/webbuild</userinput>
 &prompt.root; <userinput>cd /var/tmp/webbuild</userinput></screen>
       </step>
 
       <step>
 	<para>Checken Sie die SGML-Dateien aus dem CVS-Baum aus.</para>
 
 	<screen>&prompt.root; <userinput>cvs -R co www doc</userinput></screen>
       </step>
 
       <step>
 	<para>Wechseln Sie ins Verzeichnis <filename
 	  role="directory">www/en</filename> und
 	  f&uuml;hren Sie &man.make.1; <maketarget>all</maketarget> aus,
 	  um die Webseiten zu erzeugen.</para>
 
 	<screen>&prompt.root; <userinput>cd en</userinput>
 &prompt.root; <userinput>make all</userinput></screen>
       </step>
     </procedure>
   </sect1>
 
   <sect1 id="the-website-install">
     <title>Installieren der Webseiten auf Ihrem Server</title>
 
     <procedure>
       <step>
 	<para>Wechseln Sie wieder in das Verzeichnis
 	  <filename>en</filename>, falls Sie dieses inzwischen
 	  verlassen haben.</para>
 
 	  <screen>&prompt.root; <userinput>cd <replaceable>path</replaceable>/www/en</userinput></screen>
       </step>
 
       <step>
 	<para>F&uuml;hren Sie &man.make.1; <maketarget>install</maketarget>
 	 aus, und setzen Sie die Variable <makevar>DESTDIR</makevar> auf
 	 das Verzeichnis, in das Sie die Webseiten installieren
 	 wollen.</para>
 
 	<screen>&prompt.root; <userinput>make DESTDIR=<replaceable>/usr/local/www</replaceable> install</userinput></screen>
       </step>
 
       <step>
 	<para>Wenn Sie die Webseiten bereits fr&uuml;her in dieses
 	  Verzeichnis installiert haben, wurden w&auml;hrend der
 	  Installation keine veralteten Seiten entfernt.  Wenn
 	  Sie die Webseiten beispielsweise t&auml;glich neu bauen
 	  und installieren, findet und entfernt der folgende Befehl
 	  alle Dateien, die in den letzten drei Tagen nicht aktualisiert
 	  wurden:</para>
 
 	<screen>&prompt.root; <userinput>find <replaceable>/usr/local/www</replaceable> -ctime 3 -print0 | xargs -0 rm</userinput></screen>
       </step>
     </procedure>
   </sect1>
 
   <sect1 id="the-website-env">
     <title>Umgebungsvariablen</title>
 
     <variablelist>
       <varlistentry>
 	<term><envar>CVSROOT</envar></term>
 
 	<listitem>
 	  <para>Der Ort des CVS-Baums.  Unbedingt notwendig.</para>
 
 	  <screen><userinput>&prompt.root; CVSROOT=/home/ncvs; export CVSROOT</userinput></screen>
 	</listitem>
       </varlistentry>
 
       <varlistentry>
 	<term><makevar>ENGLISH_ONLY</makevar></term>
 
 	<listitem>
 	  <para>Ist diese Variable gesetzt und nicht leer, bauen und
 	    installieren die Makefiles ausschlie&szlig;lich die
 	    englischen Dokumente.  S&auml;mtliche &Uuml;bersetzungen
 	    werden dabei ignoriert.  Dazu ein Beispiel:</para>
 
 	  <screen>&prompt.root; <userinput>make ENGLISH_ONLY=YES all install</userinput></screen>
 
 	  <para>Wenn Sie die Variable <makevar>ENGLISH_ONLY</makevar>
 	    deaktivieren und alle Webseiten inklusive aller
 	    &Uuml;bersetzungen bauen wollen, setzen Sie die Variable
 	    <makevar>ENGLISH_ONLY</makevar> auf einen leeren Wert:</para>
 
 	  <screen>&prompt.root; <userinput>make ENGLISH_ONLY="" all install clean</userinput></screen>
 	</listitem>
       </varlistentry>
 
       <varlistentry>
 	<term><makevar>WEB_ONLY</makevar></term>
 
 	<listitem>
 	  <para>Ist diese Variable gesetzt und nicht leer, bauen und
 	    installieren die Makefiles nur die HTML-Seiten des
 	    www-Verzeichnisses.  Alle Dokumente des doc-Verzeichnisses
 	    (Handbuch, FAQ, Artikel) werden dabei ignoriert:</para>
 
 	  <screen>&prompt.root; <userinput>make WEB_ONLY=YES all install</userinput></screen>
 	</listitem>
       </varlistentry>
 
       <varlistentry>
 	<term><makevar>NOPORTSCVS</makevar></term>
 
 	<listitem>
 	  <para>Ist diese Variable gesetzt, checken die Makefiles keine
 	    Dateien aus dem Ports-CVS-Repository aus.  Stattdessen werden
 	    die Dateien aus dem Verzeichnis
 	    <filename>/usr/ports</filename> (oder aus dem Verzeichnis,
 	    auf das die Variable <envar>PORTSBASE</envar> zeigt)
 	     verwendet.</para>
 	</listitem>
       </varlistentry>
     </variablelist>
 
     <para>Bei <envar>CVSROOT</envar> handelt es sich um eine
       Umgebungsvariable.  Sie muss auf der Kommandozeile oder in der
       Konfigurationsdatei <filename>~/.profile</filename> gesetzt
       werden.</para>
 
     <para><makevar>WEB_ONLY</makevar>, <makevar>ENGLISH_ONLY</makevar>
       und <makevar>NOPORTSCVS</makevar> sind Variablen f&uuml;r Makefiles.
       Diese werden entweder in <filename>/etc/make.conf</filename>, in
       <filename>Makefile.inc</filename> oder als Umgebungsvariablen auf
       der Kommandozeile oder in Ihrer Konfigurationsdatei gesetzt.</para>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/handbook/colophon.sgml b/de_DE.ISO8859-1/books/handbook/colophon.sgml
index 9d3a262853..3a1c7f6a4a 100644
--- a/de_DE.ISO8859-1/books/handbook/colophon.sgml
+++ b/de_DE.ISO8859-1/books/handbook/colophon.sgml
@@ -1,32 +1,32 @@
 <!--
      The FreeBSD Documentation Project
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/handbook/colophon.sgml,v 1.6 2003/08/21 23:28:55 mheinen Exp $
-     basiert auf: 1.8
+     $FreeBSDde: de-docproj/books/handbook/colophon.sgml,v 1.7 2007/11/10 16:08:46 miwi Exp $
+     basiert auf: 1.9
 -->
 
 <colophon id="colophon">
   <para>Dieses Buch ist aus den Beitr&auml;gen vieler Freiwilliger zum
     <quote>FreeBSD Documentation Project</quote> entstanden.
     Der Text ist in SGML entsprechend der Docbook DTD verfasst.
     Mit Hilfe von <application>Jade</application>, einem Open Source
     DSSSL-Prozessor, wird er in verschiedene Formate umgewandelt.  Die
     Umwandlung wird von Norm Walsh's DSSSL Stylesheets und eigens
     entwickelten Stylesheets gesteuert.  Die gedruckte Ausgabe des Buchs
     w&auml;re ohne die Satzbeschreibungssprache <application>&tex;</application>
     von Donald Knuth, <application>LaTeX</application> von Leslie Lamport
     oder den <application>JadeTeX</application>-Makros von Sebastian Rahtz
     nicht m&ouml;glich.</para>
 </colophon>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/handbook/eresources/chapter.sgml b/de_DE.ISO8859-1/books/handbook/eresources/chapter.sgml
index cf9681bb19..ed57966ef1 100644
--- a/de_DE.ISO8859-1/books/handbook/eresources/chapter.sgml
+++ b/de_DE.ISO8859-1/books/handbook/eresources/chapter.sgml
@@ -1,1909 +1,1909 @@
 <!--
      The FreeBSD Documentation Project
      The FreeBSD German Documentation Project
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/handbook/eresources/chapter.sgml,v 1.70 2007/08/19 17:16:38 jkois Exp $
-     basiert auf: 1.182
+     $FreeBSDde: de-docproj/books/handbook/eresources/chapter.sgml,v 1.71 2007/11/10 15:11:47 miwi Exp $
+     basiert auf: 1.183
 -->
 
 <appendix id="eresources">
   <title>Ressourcen im Internet</title>
 
   <para>Gedruckte Medien k&ouml;nnen mit der schnellen Entwicklung von
     FreeBSD nicht Schritt halten.  Elektronische Medien sind h&auml;ufig
     die einzige M&ouml;glichkeit, &uuml;ber aktuelle Entwicklungen
     informiert zu sein.  Da FreeBSD ein Projekt von Freiwilligen ist, gibt
     die Benutzergemeinde selbst auch technische Unterst&uuml;tzung.  Die
     Benutzergemeinde erreichen Sie am besten &uuml;ber E-Mail oder
     Usenet-News.</para>
 
   <para>Die wichtigsten Wege, auf denen Sie die FreeBSD-Benutzergemeinde
     erreichen k&ouml;nnen, sind unten dargestellt.  Wenn Sie weitere
     Ressourcen kennen, die hier fehlen, schicken Sie diese bitte an die
     Mailingliste des &a.doc;, damit sie hier aufgenommen werden
     k&ouml;nnen.</para>
 
   <sect1 id="eresources-mail">
     <title>Mailinglisten</title>
 
     <para>Obwohl viele FreeBSD-Entwickler Usenet-News lesen, k&ouml;nnen
       wir nicht garantieren, dass Sie eine z&uuml;gige Antwort auf
       Ihre Fragen bekommen, wenn Sie diese nur in einer der
       <literal>comp.unix.bsd.freebsd.*</literal> Gruppen stellen.  Wenn Sie
       Ihre Fragen auf der passenden Mailingliste stellen, erreichen Sie
       sowohl die Entwickler wie auch die FreeBSD-Benutzergemeinde und
       erhalten damit bessere (oder zumindest schnellere) Antworten.</para>
 
     <para>Die Chartas der verschiedenen Listen sind unten wiedergegeben.
       <emphasis>Bevor Sie sich einer Mailingliste anschlie&szlig;en oder
       E-Mails an eine Liste senden, lesen Sie bitte die Charta der
       Liste.</emphasis>  Die meisten Mitglieder unserer Mailinglisten
       erhalten Hunderte E-Mails zum Thema FreeBSD pro Tag.  Die Chartas und
       Regeln, die den Gebrauch der Listen beschreiben, garantieren die hohe
       Qualit&auml;t der Listen.  Die Listen w&uuml;rden ihren hohen Wert
       f&uuml;r das Projekt verlieren, wenn wir weniger Regeln aufstellen
       w&uuml;rden.</para>
 
     <note>
       <para><emphasis>Um zu testen, ob Sie eine Nachricht an eine
 	&os;-Liste senden k&ouml;nnen, verwenden Sie bitte Die Liste
 	&a.test.name;.</emphasis>  Schicken Sie derartige Nachrichten
 	bitte nicht an eine der anderen Listen.</para>
     </note>
 
     <para>Wenn Sie Sich nicht sicher sind, auf welcher Liste Sie Ihre Frage
       stellen sollen, sollten Sie den Artikel <ulink
       url="&url.articles.freebsd-questions.en;/index.html">How to get best
       results from the FreeBSD-questions mailing list</ulink> lesen.</para>
 
     <para>Bevor Sie eine Nachricht an eine Mailingliste senden, sollten Sie
       die korrekte Nutzung der Mailinglisten erlernen.  Dazu geh&ouml;rt auch
       das Vermeiden von sich h&auml;ufig wiederholenden Diskussionen (lesen
       Sie deshalb zuerst die
       <ulink url="&url.articles.mailing-list-faq.en;/index.html">
       Mailing List Frequently Asked Questions</ulink>).</para>
 
     <para>Alle Mailinglisten werden archiviert und k&ouml;nnen auf dem
       <ulink url="&url.base;/search/index.html">FreeBSD World Wide Web
         Server</ulink> durchsucht werden.  Das nach
       Schl&uuml;sselw&ouml;rtern durchsuchbare Archiv bietet die
       hervorragende M&ouml;glichkeit, Antworten auf h&auml;ufig gestellte
       Fragen zu finden.  Nutzen Sie bitte diese M&ouml;glichkeit, bevor Sie
       Fragen auf einer Liste stellen.</para>
 
     <sect2 id="eresources-summary">
       <title>Beschreibung der Mailinglisten</title>
 
       <para><emphasis>Allgemeine Listen:</emphasis> Jeder kann die
         folgenden allgemeinen Listen abonnieren (und ist dazu
         aufgefordert):</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Mailingliste</entry>
 	      <entry>Zweck</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>&a.cvsall.name;</entry>
 	      <entry>&Auml;nderungen im FreeBSD-Quellbaum</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.advocacy.name;</entry>
 	      <entry>Verbreitung von FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.announce.name;</entry>
 	      <entry>Wichtige Ereignisse und Meilensteine des
 	        Projekts</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.arch.name;</entry>
 	      <entry>Architektur und Design von FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.bugbusters.name;</entry>
 	      <entry>Diskussionen &uuml;ber die Pflege der FreeBSD
 		Fehlerberichte-Datenbank und die dazu benutzten
 		Werkzeuge</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.bugs.name;</entry>
 	      <entry>Fehlerberichte</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.chat.name;</entry>
 	      <entry>Nicht technische Themen, die die FreeBSD-Gemeinschaft
 		betreffen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.current.name;</entry>
 	      <entry>Gebrauch von &os.current;</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.isp.name;</entry>
 	      <entry>F&uuml;r Internet-Service-Provider, die
 	        FreeBSD benutzen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.jobs.name;</entry>
 	      <entry>Anstellung und Beratung im FreeBSD-Umfeld</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.policy.name;</entry>
 	      <entry>Grundsatzentscheidungen des FreeBSD-Core-Teams.  Wenig
 		Verkehr und nur zum Lesen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.questions.name;</entry>
 	      <entry>Benutzerfragen und technische
 	        Unterst&uuml;tzung</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.security-notifications.name;</entry>
 	      <entry>Ank&uuml;ndigungen zum Thema Sicherheit</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.stable.name;</entry>
 	      <entry>Gebrauch von &os.stable;</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.test.name;</entry>
 	      <entry>Schicken Sie Testnachrichten an diese Liste anstelle
 	        der wirklichen Listen</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para><emphasis>Technische Listen:</emphasis> Auf den folgenden
         Listen werden technische Diskussionen gef&uuml;hrt.  Bevor Sie eine
 	der Listen abonnieren oder Nachrichten an sie schicken, lesen Sie
 	sich bitte die Charta der Liste durch, da der Inhalt und Zweck
 	dieser Listen genau festgelegt ist.</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Mailingliste</entry>
 	      <entry>Zweck</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>&a.acpi.name;</entry>
 	      <entry>Entwicklung von ACPI</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.afs.name;</entry>
 	      <entry>Portierung von AFS nach FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.aic7xxx.name;</entry>
 	      <entry>Entwicklung von &adaptec; AIC 7xxx Treibern</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.alpha.name;</entry>
 	      <entry>Portierung von FreeBSD auf Alpha-Maschinen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.amd64.name;</entry>
 	      <entry>Portierung von FreeBSD auf AMD64-Systeme</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.apache.name;</entry>
 	      <entry>Diskussion &uuml;ber Ports, die mit
 	        <application>Apache</application>
 		zusammenh&auml;ngen.</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.arm.name;</entry>
 	      <entry>Portierung von FreeBSD auf &arm;-Prozessoren</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.atm.name;</entry>
 	      <entry>Benutzung von ATM-Netzen mit FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.audit.name;</entry>
 	      <entry>Audit der FreeBSD-Quellen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.binup.name;</entry>
 	      <entry>Design und Entwicklung eines Systems, das es erlaubt,
 	        ein FreeBSD-System mit bin&auml;ren Paketen zu
 	        aktualisieren</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.bluetooth.name;</entry>
 	      <entry>&bluetooth; unter FreeBSD verwenden</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.cluster.name;</entry>
 	      <entry>Benutzung von FreeBSD in einem Cluster</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.cvsweb.name;</entry>
 	      <entry>Pflege von CVSweb</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.database.name;</entry>
 	      <entry>Diskussion &uuml;ber Datenbanken und
 	        Datenbankprogrammierung unter FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.doc.name;</entry>
 	      <entry>Erstellen der FreeBSD-Dokumentation</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.drivers.name;</entry>
 	      <entry>Ger&auml;tetreiber f&uuml;r &os; schreiben</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.eclipse.name;</entry>
 	      <entry>F&uuml;r FreeBSD-Anwender, die die Eclipse IDE, deren
 	        Werkzeuge, Anwendungen und Ports einsetzen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.embedded.name;</entry>
 	      <entry>FreeBSD in eingebetteten Anwendungen
 	        einsetzen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.emulation.name;</entry>
 	      <entry>Emulation anderer Systeme wie Linux, &ms-dos; oder
 	        &windows;</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.eol.name;</entry>
 	      <entry>Support f&uuml;r FreeBSD-bezogene Software, die vom
 	        FreeBSD Project offiziell nicht mehr unterst&uuml;tzt
 	        wird.</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.firewire.name;</entry>
 	      <entry>Technische Diskussion &uuml;ber &firewire;
 	        (iLink, IEEE 1394)</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.fs.name;</entry>
 	      <entry>Dateisysteme</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.geom.name;</entry>
 	      <entry>Diskusion &uuml;ber GEOM</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.gnome.name;</entry>
 	      <entry>Portierung von <application>GNOME</application> und
 		<application>GNOME</application>-Anwendungen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.hackers.name;</entry>
 	      <entry>Allgemeine technische Diskussionen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.hardware.name;</entry>
 	      <entry>Allgemeine Diskussion &uuml;ber Hardware, auf der
 	        FreeBSD l&auml;uft</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.i18n.name;</entry>
 	      <entry>Internationalisierung von FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.ia32.name;</entry>
 	      <entry>FreeBSD f&uuml;r die IA-32 (&intel; x86) Plattform</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.ia64.name;</entry>
 	      <entry>Portierung von FreeBSD auf &intel;s neue
 		IA64-Systeme</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.ipfw.name;</entry>
 	      <entry>Technische Diskussion &uuml;ber die Neubearbeitung der
 		IP-Firewall Quellen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.isdn.name;</entry>
 	      <entry>F&uuml;r Entwickler des ISDN-Systems</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.java.name;</entry>
 	      <entry>F&uuml;r &java; Entwickler und Leute, die &jdk;s nach
 	        FreeBSD portieren</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.kde.name;</entry>
 	      <entry>Portierung von <application>KDE</application> und
 		<application>KDE</application>-Anwendungen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.lfs.name;</entry>
 	      <entry>Portierung von LFS nach FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.libh.name;</entry>
 	      <entry>Das n&auml;chste Installations- und
 	        Paketsystem</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.mips.name;</entry>
 	      <entry>Portierung von FreeBSD zu &mips;</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.mobile.name;</entry>
 	      <entry>Diskussionen &uuml;ber mobiles Rechnen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.mozilla.name;</entry>
 	      <entry>Portierung von <application>Mozilla</application>
 		nach FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.multimedia.name;</entry>
 	      <entry>Multimedia Anwendungen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.newbus.name;</entry>
 	      <entry>Technische Diskussionen &uuml;ber die Architektur von
 	        Bussen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.net.name;</entry>
 	      <entry>Diskussion &uuml;ber Netzwerke und den TCP/IP
 	        Quellcode</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.openoffice.name;</entry>
 	      <entry>Portierung von <application>OpenOffice.org</application>
 		und <application>&staroffice;</application>
 		nach FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.performance.name;</entry>
 	      <entry>Fragen zur Optimierung der Leistung stark
 	        ausgelasteter Systeme</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.perl.name;</entry>
 	      <entry>Pflege der portierten Perl-Anwendungen.</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.pf.name;</entry>
 	      <entry>Diskussionen und Fragen zu <foreignphrase>packet
 	        filter</foreignphrase> als Firewallsystem.</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.platforms.name;</entry>
 	      <entry>Portierungen von FreeBSD auf nicht-&intel;
 	        Architekturen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.ports.name;</entry>
 	      <entry>Diskussion &uuml;ber die Ports-Sammlung</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.ports-bugs.name;</entry>
 	      <entry>Diskussion &uuml;ber Fehler und PRs der Ports</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.ppc.name;</entry>
 	      <entry>Portierung von FreeBSD auf den &powerpc;</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.proliant.name;</entry>
 	      <entry>Technische Diskussionen zum Einsatz von FreeBSD auf
 	        der ProLiant-Serverplattform von HP.</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.python.name;</entry>
 	      <entry>FreeBSD-spezifische Diskussionen zu Python</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.qa.name;</entry>
 	      <entry>Diskussion &uuml;ber Qualit&auml;tssicherung,
 	        normalerweise kurz vor einem Release</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.rc.name;</entry>
 	      <entry>Diskussion &uuml;ber das
 	        <filename>rc.d</filename>-System sowie dessen
 	        Weiterentwicklung</entry>
             </row>
 
 	    <row>
 	      <entry>&a.realtime.name;</entry>
 	      <entry>Entwicklung von Echtzeiterweiterungen f&uuml;r
 	        FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.scsi.name;</entry>
 	      <entry>Diskussion &uuml;ber das SCSI-Subsystem</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.security.name;</entry>
 	      <entry>Sicherheitsthemen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.small.name;</entry>
 	      <entry>Gebrauch von FreeBSD in eingebetteten Systemen
 	        (obsolet; verwenden Sie stattdessen &a.embedded.name;)</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.smp.name;</entry>
 	      <entry>Diskussionen &uuml;ber das Design von asymmetrischen
 	        und symmetrischen Mehrprozessor-Programmen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.sparc.name;</entry>
 	      <entry>Portierung von FreeBSD auf &sparc; Systeme</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.standards.name;</entry>
 	      <entry>Konformit&auml;t von FreeBSD mit den C99- und
 		POSIX-Standards</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.sun4v.name;</entry>
 	      <entry>Portierung von FreeBSD auf &ultrasparc;-T1-basierte
 		Systeme</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.threads.name;</entry>
 	      <entry>Leichgewichtige Prozesse
 		(<foreignphrase>Threads</foreignphrase>) in FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.testing.name;</entry>
 	      <entry>Leistungs- und Stabilit&auml;tstests von FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.tokenring.name;</entry>
 	      <entry>Token-Ring Unterst&uuml;tzung in FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.usb.name;</entry>
 	      <entry>USB-Unterst&uuml;tzung in FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.vuxml.name;</entry>
 	      <entry>Diskussion &uuml;ber die Infratruktur von VuXML</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.x11.name;</entry>
 	      <entry>Wartung und Unterst&uuml;tzung von X11
 		auf FreeBSD</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para><emphasis>Eingeschr&auml;nkte Listen:</emphasis> Die folgenden
         Listen wenden sich an Zielgruppen mit speziellen Anforderungen und
 	sind nicht f&uuml;r die &Ouml;ffentlichkeit gedacht.  Bevor Sie
 	eine dieser Listen abonnieren, sollten Sie einige der technischen
 	Listen abonniert haben, um mit den Umgangsformen vertraut zu
 	sein.</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Mailingliste</entry>
 	      <entry>Zweck</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>&a.hubs.name;</entry>
 	      <entry>Betrieb von FreeBSD-Spiegeln</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.usergroups.name;</entry>
 	      <entry>Koordination von Benutzergruppen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.vendors.name;</entry>
 	      <entry>Koordination von H&auml;ndlern vor einem
 	        Release</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.www.name;</entry>
 	      <entry>Betreuer von <ulink url="&url.base;/index.html">www.FreeBSD.org</ulink></entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para><emphasis>Zusammenfassungen:</emphasis> Alle eben
 	aufgez&auml;hlten Listen sind auch in zusammengefasster
 	Form (<foreignphrase>digest</foreignphrase>) erh&auml;ltlich.
 	In den Einstellungen Ihres Accounts legen Sie fest,
 	in welcher Form Sie die Listen empfangen.</para>
 
       <para><emphasis>CVS Listen:</emphasis> Die folgenden Listen versenden
         die Log-Eintr&auml;ge zu &Auml;nderungen an verschiedenen
 	Teilen des Quellbaums.  Diese Listen sollen <emphasis>nur
 	  gelesen</emphasis> werden, schicken Sie bitte keine Nachrichten
 	an eine der Listen.</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="3">
 	  <thead>
 	    <row>
 	      <entry>Mailingliste</entry>
 	      <entry>Teil des Quellbaums</entry>
 	      <entry>Beschreibung</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>&a.cvsall.name;</entry>
 	      <entry>
 		<filename>/usr/(CVSROOT|doc|ports|projects|src)</filename>
 	      </entry>
 	      <entry>Alle &Auml;nderungen im Quellbaum (Obermenge der
 		anderen Commit-Listen)</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.cvs-doc.name;</entry>
 	      <entry><filename>/usr/(doc|www)</filename></entry>
 	      <entry>&Auml;nderungen in den
 		<filename>doc</filename>- und
 		<filename>www</filename> B&auml;umen</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.cvs-ports.name;</entry>
 	      <entry><filename>/usr/ports</filename></entry>
 	      <entry>&Auml;nderungen im <filename>ports</filename>-Baum</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.cvs-projects.name;</entry>
 	      <entry><filename>/usr/projects</filename></entry>
 	      <entry>&Auml;nderungen im
 		<filename>projects</filename>-Baum</entry>
 	    </row>
 
 	    <row>
 	      <entry>&a.cvs-src.name;</entry>
 	      <entry><filename>/usr/src</filename></entry>
 	      <entry>&Auml;nderungen im <filename>src</filename>-Baum</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect2>
 
     <sect2 id="eresources-subscribe">
       <title>Mailinglisten abonnieren</title>
 
       <para>Um eine Liste zu abonnieren, folgen Sie dem oben angegebenen
 	Hyperlink der Liste oder Sie besuchen die Webseite
 	&a.mailman.lists.link; und klicken dort auf die Liste, die Sie
 	abonnieren wollen.  Sie gelangen dann auf die Webseite der
 	Liste, die weitere Anweisungen enth&auml;lt.</para>
 
       <para>Um eine Nachricht an eine Mailingliste zu schicken, schreiben
         Sie einfach eine E-Mail an
 	<email><replaceable>Liste</replaceable>@FreeBSD.org</email>.  Die
 	E-Mail wird dann an alle Mitglieder der Mailingliste verteilt.</para>
 
       <para>Wenn Sie das Abonnement aufheben wollen, folgen Sie der
 	URL, die am Ende jeder Mail der Liste angegeben ist.  Sie
 	k&ouml;nnen das Abonnement auch mit einer E-Mail an
 	<email><replaceable>Liste</replaceable>-unsubscribe@FreeBSD.org</email>
 	aufheben.</para>
 
       <para>Verwenden Sie bitte die technischen Listen ausschlie&szlig;lich
 	f&uuml;r technische Diskussionen.  Wenn Sie nur an wichtigen
 	Ank&uuml;ndigungen interessiert sind, abonnieren Sie die
 	Mailingliste &a.announce;, auf der nur wenige Nachrichten
 	versendet werden.</para>
     </sect2>
 
     <sect2 id="eresources-charters">
       <title>Chartas der Mailinglisten</title>
 
       <para><emphasis>Alle</emphasis> FreeBSD-Mailinglisten besitzen
         Grundregeln, die von jedem beachtet werden m&uuml;ssen.  F&uuml;r
 	die ersten beiden Male, in denen ein Absender gegen diese Regeln
 	verst&ouml;&szlig;t, erh&auml;lt er jeweils eine Warnung vom
 	FreeBSD-Postmaster <email>postmaster@FreeBSD.org</email>.  Ein
 	dritter Versto&szlig; gegen die Regeln f&uuml;hrt dazu, dass
 	der Absender in allen FreeBSD-Mailinglisten gesperrt wird und
 	weitere Nachrichten von ihm nicht mehr angenommen werden.  Wir
 	bedauern sehr, dass wir solche Ma&szlig;nahmen ergreifen
 	m&uuml;ssen, aber heutzutage ist das Internet eine recht rauhe
 	Umgebung, in der immer weniger Leute R&uuml;cksicht aufeinander
 	nehmen.</para>
 
       <para>Die Regeln:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>Das Thema einer Nachricht soll der Charta der Liste, an die
 	    sie gesendet wird, entsprechen.  Wenn Sie eine Nachricht an
 	    eine technische Liste schicken, sollte die Nachricht auch
 	    technische Inhalte haben.  Fortw&auml;hrendes Geschw&auml;tz
 	    oder Streit mindern den Wert der Liste f&uuml;r alle Mitglieder
 	    und wird nicht toleriert.  Benutzen Sie &a.chat; f&uuml;r
 	    allgemeine Diskussionen &uuml;ber FreeBSD.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Eine Nachricht sollte an nicht mehr als zwei Mailinglisten
 	    gesendet werden.  Schicken Sie eine Nachricht nur dann an
 	    zwei Listen, wenn das wirklich notwendig ist.  Viele Leute
 	    haben mehrere Mailinglisten abonniert und Nachrichten sollten
 	    nur zu ungew&ouml;hnlichen Kombinationen der Listen, wie
 	    <quote>-stable</quote> und <quote>-scsi</quote>, gesendet
 	    werden.  Wenn Sie eine Nachricht erhalten, die im
 	    <literal>Cc</literal>-Feld mehrere Listen enth&auml;lt, sollten
 	    Sie das Feld k&uuml;rzen, bevor Sie eine Antwort darauf
 	    verschicken.  <emphasis>Unabh&auml;ngig von dem
 	      urspr&uuml;nglichen Verteiler sind Sie f&uuml;r Ihre eigenen
 	      Mehrfach-Sendungen selbst verantwortlich.</emphasis></para>
 	</listitem>
 
 	<listitem>
 	  <para>Pers&ouml;nliche Angriffe und Beschimpfungen sind in einer
 	    Diskussion nicht erlaubt.  Dies gilt gleicherma&szlig;en
 	    f&uuml;r Benutzer wie Entwickler.  Grobe Verletzungen der
 	    Netiquette, wie das Verschicken oder Zitieren von privater
 	    E-Mail ohne eine entsprechende Genehmigung, werden nicht
 	    gebilligt.  Die Nachrichten werden aber nicht besonders auf
 	    Verletzungen der Netiquette untersucht.  Es kann sein,
 	    dass eine Verletzung der Netiquette durchaus zu der Charta
 	    einer Liste passt, aber der Absender aufgrund der
 	    Verletzung eine Warnung erh&auml;lt oder gesperrt wird.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Werbung f&uuml;r Produkte oder Dienstleistungen, die nichts
 	    mit FreeBSD zu tun haben, sind verboten.  Ist die Werbung als
 	    Spam verschickt worden, wird der Absender sofort gesperrt.</para>
 	</listitem>
       </itemizedlist>
 
       <para><emphasis>Chartas einzelner Listen:</emphasis></para>
 
       <variablelist>
 	<varlistentry>
 	  <term>&a.acpi.name;</term>
 
 	  <listitem>
 	    <para>Die Entwicklung von ACPI und
 	      Energieverwaltungsfunktionen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.afs.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Andrew File System</emphasis></para>
 
 	    <para>Auf dieser Liste wird die Portierung des AFS von
 	      CMU/Transarc diskutiert.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.announce.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Wichtige Ereignisse und
 	        Meilensteine</emphasis></para>
 
 	    <para>Diese Liste ist f&uuml;r Personen, die nur an den wenigen
 	      Ank&uuml;ndigungen wichtiger Ereignisse interessiert sind.
 	      Die Ank&uuml;ndigungen betreffen Schnappsch&uuml;sse und
 	      Releases, neue Merkmale von FreeBSD und die Suche nach
 	      freiwilligen Mitarbeitern.  Auf der Liste herrscht wenig
 	      Verkehr und sie wird streng moderiert.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.arch.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Architektur und Design
 		von FreeBSD</emphasis></para>
 
 	    <para>Auf dieser technischen Liste wird die FreeBSD-Architektur
 	      diskutiert.  Beispiele f&uuml;r angemessene Themen
 	      sind:</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para>Wie das Bausystem zu ver&auml;ndern ist, damit
 		  verschiedene L&auml;ufe gleichzeitig m&ouml;glich
 		  sind.</para>
 	      </listitem>
 
 	      <listitem>
 		<para>Was am VFS ge&auml;ndert werden muss, damit
 		  Heidemann Schichten eingesetzt werden k&ouml;nnen.</para>
 		</listitem>
 
 	      <listitem>
 		<para>Wie die Schnittstelle der Ger&auml;tetreiber
 		  angepasst werden muss, damit derselbe Treiber
 		  auf verschiedenen Bussen und Architekturen eingesetzt
 		  werden kann.</para>
 	      </listitem>
 
 	      <listitem>
 		<para>Wie ein Netzwerktreiber geschrieben wird.</para>
 	      </listitem>
 	    </itemizedlist>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.audit.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Source Code Audit Project</emphasis></para>
 
 	    <para>Dies ist die Liste des FreeBSD-<quote>Source Code Audit
 	      Projects</quote>.  Urspr&uuml;nglich war vorgesehen, hier nur
 	      sicherheitsrelevante &Auml;nderungen zu diskutieren, doch ist
 	      die Charta auf alle &Auml;nderungen ausgedehnt worden.</para>
 
 	    <para>Zu dieser Liste werden viele Korrekturen gesandt, so
 	      dass sie f&uuml;r den normalen FreeBSD-Benutzer von
 	      wenig Wert ist.  Diskussionen &uuml;ber Sicherheit, die sich
 	      nicht auf die &Auml;nderung von Quellcode beziehen, finden
 	      auf der Mailingliste &a.security; statt.  Auf der anderen
 	      Seite sind aber alle Entwickler aufgefordert, ihre
 	      Korrekturen zur &Uuml;berpr&uuml;fung an diese Liste zu
 	      senden.  Dies trifft besonders auf &Auml;nderungen zu, in
 	      denen ein Fehler die Integrit&auml;t des Gesamtsystems
 	      gef&auml;hrdet.</para>
 
 <!-- I can't actually find a charter for this, but there's this email: http://www.FreeBSD.org/cgi/getmsg.cgi?fetch=223347+225804+/usr/local/www/db/text/2000/cvs-all/20001210.cvs-all -->
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.binup.name;</term>
 
 	  <listitem>
 	    <para><emphasis>FreeBSD Binary Update Project</emphasis></para>
 
 	    <para>Auf dieser Liste wird das Design und die Implementierung
 	      von <application>binup</application> diskutiert.  Weitere
 	      Themen sind Fehlerbehebungen, Fehlerberichte und Anfragen
 	      nach Neuerungen.  Die CVS-Logmeldungen des Projekts werden
 	      ebenfalls auf diese Liste gesendet.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.bluetooth.name;</term>
 
 	  <listitem>
 	    <para><emphasis>&bluetooth; unter FreeBSD</emphasis></para>
 
 	    <para>Diese Liste diskutiert Probleme der Verwendung
 	      von &bluetooth; unter FreeBSD.  Designprobleme,
 	      Implementierungsdetails, Patches, Fehler- und
 	      Statusberichte, Verbesserungsvorschl&auml;ge sowie
 	      alle anderen mit &bluetooth; zusammenh&auml;ngenden
 	      Themen werden hier behandelt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.bugbusters.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Bearbeitung der Fehlerberichte</emphasis></para>
 
 	    <para>Auf dieser Liste wird die Bearbeitung der Fehlerberichte
 	      (PR, engl. <foreignphrase>problem report</foreignphrase>)
 	      koordiniert.  Sie dient dem <quote>Bugmeister</quote> und
 	      allen Leuten, die ein Interesse an der Datenbank der
 	      Fehlerberichte haben, als Diskussionsforum.  Auf dieser Liste
 	      werden keine spezifischen Fehler, Fehlerbehebungen oder PRs
 	      diskutiert.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.bugs.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Fehlerberichte</emphasis></para>
 
 	    <para>Auf dieser Liste werden Fehlerberichte gesammelt.
 	      Fehlerberichte sollten immer mit &man.send-pr.1; oder dem
 	      <ulink url="&url.base;/send-pr.html">Web Formular</ulink>
 	      erstellt werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.chat.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Nicht technische Themen, die die FreeBSD
 	      Gemeinschaft betreffen</emphasis></para>
 
 	    <para>Auf dieser Liste werden nicht-technische soziale Themen
 	      diskutiert, die nicht auf die anderen Listen passen.  Hier
 	      kann diskutiert werden, ob Jordan wie ein Frettchen aus einem
 	      Zeichentrickfilm aussieht oder nicht, ob grunds&auml;tzlich
 	      in Gro&szlig;buchstaben geschrieben werden soll, wer zuviel
 	      Kaffee trinkt, wo das beste Bier gebraut wird und wer Bier in
 	      seinem Keller braut.  Gelegentlich k&ouml;nnen auf den
 	      technischen Listen wichtige Ereignisse wie Feste, Hochzeiten
 	      oder Geburten angek&uuml;ndigt werden, aber nachfolgende
 	      Nachrichten sollten auf die Liste &a.chat; gesendet
 	      werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.core.name;</term>
 
 	  <listitem>
 	    <para><emphasis>FreeBSD Core Team</emphasis></para>
 
 	    <para>Dies ist eine interne Mailingliste des FreeBSD Core
 	      Teams.  Wenn in einer wichtigen Angelegenheit, die FreeBSD
 	      betrifft, entschieden werden muss oder die
 	      Angelegenheit einer genauen Pr&uuml;fung unterzogen werden
 	      muss, k&ouml;nnen Nachrichten an diese Liste gesendet
 	      werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.current.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Gebrauch von &os.current;</emphasis></para>
 
 	    <para>Diese Mailingliste ist f&uuml;r die Benutzer von
 	      &os.current; eingerichtet.  Auf ihr finden sich
 	      Ank&uuml;ndigungen &uuml;ber Besonderheiten von -CURRENT, von
 	      denen Benutzer betroffen sind.  Sie enth&auml;lt weiterhin
 	      Anweisungen, wie man ein System auf -CURRENT h&auml;lt.
 	      Jeder, der ein -CURRENT System besitzt, muss diese Liste
 	      lesen.  Die Liste ist nur f&uuml;r technische Inhalte
 	      bestimmt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.cvsweb.name;</term>
 
 	  <listitem>
 	    <para><emphasis>FreeBSD CVSweb Project</emphasis></para>
 
 	    <para>Technische Diskussion &uuml;ber den Gebrauch, die
 	      Entwicklung und die Pflege von FreeBSD-CVSweb.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.doc.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Documentation Project</emphasis></para>
 
 	    <para>Auf dieser Mailingliste werden Themen und Projekte
 	      diskutiert, die im Zusammenhang mit der Erstellung der FreeBSD
 	      Dokumentation stehen.  <quote>The FreeBSD Documentation
 	        Project</quote> besteht aus den Mitgliedern dieser Liste.
 	      Diese Liste steht jedem offen, Sie sind herzlich eingeladen
 	      teilzunehmen und mitzuhelfen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.drivers.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Ger&auml;tetreiber f&uuml;r &os;
 	      schreiben</emphasis></para>
 
 	    <para>Ein Forum f&uuml;r technische Diskussionen &uuml;ber
 	      das Schreiben von Ger&auml;tetreibern f&uuml;r &os;.
 	      Daher werden hier vor allem Fragen behandelt, die sich
 	      um das Schreiben von Treibern, die die APIs des
 	      Kernels nutzen, drehen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.eclipse.name;</term>
 
 	  <listitem>
 	    <para><emphasis>F&uuml;r FreeBSD-Anwender, die die Eclipse
 	      IDE deren Werkzeuge, Anwendungen und Ports
 	      einsetzen</emphasis></para>
 
 	    <para>Das Ziel dieser Liste ist es, Unterst&uuml;tzung
 	      f&uuml;r all jene zu bieten, die mit der Installation,
 	      Verwendung, Entwicklung und Wartung der Eclipse-IDE
 	      sowie deren Werkzeugen und Anwendungen unter &os; zu
 	      tun haben.  Au&szlig;erdem wird Hilfe bei der
 	      Portierung der IDE und deren Plugins auf &os;
 	      geboten.</para>
 
 	    <para>Zus&auml;tzlich soll diese Liste einen
 	      Informationsaustausch zwischen der Eclipse- und der
 	      &os;-Gemeinde erm&ouml;glichen, von dem beide
 	      Seiten profitieren k&ouml;nnen.</para>
 
 	    <para>Obwohl sich diese Liste auf die Anforderungen von
 	      Anwendern konzentriert, m&ouml;chte sie auch Entwickler
 	      unterst&uuml;tzen, die an der Entwicklung von
 	      &os;-spezifischen Anwendungen unter Nutzung des
 	      Eclipse-Frameworks arbeiten.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.embedded.name;</term>
 
 	  <listitem>
 	    <para><emphasis>FreeBSD in eingebetteten Anwendungen
 	      einsetzen</emphasis></para>
 
 	    <para>Diese Liste diskutiert Themen im Zusammenhang mit dem
 	      Einsatz von ungew&ouml;hnlich kleinen und eingebettenen
 	      FreeBSD-Installationen.   Auf dieser Liste werden
 	      ausschlie&szlig;lich technische Diskussionen
 	      gef&uuml;hrt.  Unter eingebetteten Systemen versteht diese
 	      Liste Systeme, bei denen es sich nicht um Desktopsysteme
 	      handelt, und die in der Regel nur einem einzigen Zweck
 	      dienen (im Gegensatz zu Desktopsystemen, die f&uuml;r die
 	      Bew&auml;ltigung verschiedenster Aufgaben geeignet sind).
 	      In die Gruppe der eingebetteten Systeme geh&ouml;ren
 	      beispielsweise Telephone, Netzwerkger&auml;te wie Router,
 	      Switche oder PBX-Systeme, PDAs, Verkaufsautomaten und
 	      andere mehr.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.emulation.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Emulation anderer Systeme wie Linux,
 	      &ms-dos; oder &windows;</emphasis></para>
 
 	    <para>Hier werden technische Diskussionen zum Einsatz von
 	      Programmen, die f&uuml;r andere Betriebssysteme
 	      geschrieben wurden, gef&uuml;hrt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.eol.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Support f&uuml;r FreeBSD-bezogene Software,
 	      die vom FreeBSD Project offiziell nicht mehr unterst&uuml;tzt
 	      wird.</emphasis></para>
 
 	    <para>Diese Liste ist f&uuml;r all jene interessant, die
 	      Unterst&uuml;tzung f&uuml;r vom FreeBSD Project offiziell
 	      nicht mehr (in Form von Security Advisories oder Patches)
 	      unterst&uuml;tzte Programme ben&ouml;tigen oder anbieten
 	      wollen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.firewire.name;</term>
 
 	  <listitem>
 	    <para><emphasis>&firewire; (iLink, IEEE 1394)</emphasis></para>
 
 	    <para>Auf dieser Liste wird das Design und die Implementierung
 	      eines &firewire;-Subsystems (auch IEEE&nbsp;1394 oder iLink)
 	      f&uuml;r FreeBSD diskutiert.  Relevante Themen sind die
 	      Standards, Busse und ihre Protokolle, sowie Adapter, Karten
 	      und Chips&auml;tze.  Des Weiteren die Architektur und der
 	      Quellcode, die n&ouml;tig sind, diese Ger&auml;te zu
 	      unterst&uuml;tzen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.fs.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Dateisysteme</emphasis></para>
 
 	    <para>Diskussionen &uuml;ber FreeBSD-Dateisysteme.  Dies ist
 	      eine technische Liste, in der nur technische Inhalte erwartet
 	      werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.geom.name;</term>
 
 	  <listitem>
 	    <para><emphasis>GEOM</emphasis></para>
 
 	    <para>Diskussion &uuml;ber GEOM und verwandte
 	      Implementierungen.  Dies ist eine technische Liste,
 	      in der nur technische Inhalte erwartet werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.gnome.name;</term>
 
 	  <listitem>
 	    <para><emphasis>GNOME</emphasis></para>
 
 	    <para>Diskussionen &uuml;ber die grafische
 	      Benutzeroberfl&auml;che <application>GNOME</application>.
 	      Dies ist eine technische Liste, in der nur technische Inhalte
 	      erwartet werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.ipfw.name;</term>
 
 	  <listitem>
 	    <para><emphasis>IP Firewall</emphasis></para>
 
 	    <para>Diskussionen &uuml;ber eine Neubearbeitung des
 	      IP-Firewall Quelltexts in FreeBSD.  Dies ist eine technische
 	      Liste, in der nur technische Inhalte erwartet werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.ia64.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Portierung von FreeBSD auf die
 	      IA64-Plattform</emphasis></para>
 
 	    <para>Dies ist eine technische Liste f&uuml;r diejenigen, die
 	      FreeBSD auf die IA-64 Plattform von &intel; portieren.  Themen
 	      sind die Probleme bei der Portierung und deren L&ouml;sung.
 	      Interessierte, die der Diskussion folgen wollen, sind
 	      ebenfalls willkommen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.isdn.name;</term>
 
 	  <listitem>
 	    <para><emphasis>ISDN Subsystem</emphasis></para>
 
 	    <para>Mailingliste f&uuml;r die Entwickler des ISDN Subsystems
 	      von FreeBSD.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.java.name;</term>
 
 	  <listitem>
 	    <para><emphasis>&java; Entwicklung</emphasis></para>
 
 	    <para>Mailingliste, auf der die Entwicklung von &java;
 	      Anwendungen f&uuml;r FreeBSD sowie die Portierung und Pflege
 	      von &jdk;s diskutiert wird.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry id="eresources-charters-jobs">
 	  <term>&a.jobs.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Stellenangebote und
 	      Stellengesuche</emphasis></para>
 
 	    <para>In diesem Forum k&ouml;nnen Sie Stellenangebote
 	      und Stellengesuche, die mit &os; zu tun haben, aufgeben.
 	      Wenn Sie beispielsweise eine Besch&auml;ftigung im
 	      &os;-Umfeld suchen oder eine freie Stelle haben,
 	      die mit &os; zu tun hat, ist dies der richtige Ort.
 	      Diese Mailingliste ist <emphasis>nicht</emphasis>
 	      der Ort, um &uuml;ber allgemeine Besch&auml;ftigungsprobleme
 	      zu diskutieren; dazu gibt es anderswo geeignete
 	      Foren.</para>
 
 	    <para>Beachten Sie bitte, dass diese Liste, wie die
 	      anderen
 	      <hostid role="domainname">FreeBSD.org</hostid>-Listen,
 	      weltweit gelesen wird.  Geben Sie daher bitte den Arbeitsort
 	      genau an.  Geben Sie bitte auch an, ob Telearbeit
 	      m&ouml;glich ist und ob Hilfen f&uuml;r einen Umzug
 	      angeboten werden.</para>
 
 	    <para>Benutzen Sie in der E-Mail bitte nur offene
 	      Formate &ndash; vorzugsweise nur das Textformat.
 	      Andere Formate, wie <acronym>PDF</acronym> oder
 	      HTML, werden von den Lesern akzeptiert.  Nicht offene
 	      Formate wie &microsoft;&nbsp;Word (<filename>.doc</filename>)
 	      werden vom Server der Liste abgelehnt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.hackers.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Technische Diskussionen</emphasis></para>
 
 	    <para>Dies ist ein Forum f&uuml;r technische Diskussionen
 	      &uuml;ber FreeBSD.  Leute, die aktiv an FreeBSD arbeiten,
 	      k&ouml;nnen hier Probleme und deren L&ouml;sungen
 	      diskutieren.  Interessierte, die den Diskussionen folgen
 	      wollen, steht die Liste ebenfalls offen.  Auf dieser Liste
 	      finden nur technische Diskussionen statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.hardware.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Allgemeine Diskussionen &uuml;ber
 	        Hardware</emphasis></para>
 
 	    <para>Allgemeine Diskussionen &uuml;ber die Hardware, auf der
 	      FreeBSD l&auml;uft: Probleme und Ratschl&auml;ge welche
 	      Hardware man kaufen sollte und welche nicht.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.hubs.name;</term>
 
 	  <listitem>
 	    <para><emphasis>FreeBSD-Spiegel</emphasis></para>
 
 	    <para>Ank&uuml;ndigungen und Diskussionsforum f&uuml;r Leute,
 	      die FreeBSD-Spiegel betreiben.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.isp.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Themen f&uuml;r Internet Service
 		Provider</emphasis></para>
 
 	    <para>Diese Liste ist f&uuml;r Internet Service Provider (ISP),
 	      die FreeBSD benutzen.  Auf dieser Liste finden nur technische
 	      Diskussionen statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.kde.name;</term>
 
 	  <listitem>
 	    <para><emphasis>KDE</emphasis></para>
 
 	    <para>Diskussionen &uuml;ber <application>KDE</application>
 	      auf FreeBSD-Systemen.
 	      Dies ist eine technische Liste, in der nur technische Inhalte
 	      erwartet werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.openoffice.name;</term>
 
 	  <listitem>
 	    <para><emphasis>OpenOffice.org</emphasis></para>
 
 	    <para>Portierung und Pflege von
 	      <application>OpenOffice.org</application> und
 	      <application>&staroffice;</application>.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.performance.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Diskussionsforum mit dem Ziel, die
 	      Leistung von FreeBSD zu verbessern.</emphasis></para>
 
 	    <para>Auf dieser Liste diskutieren Hacker,
 	      Systemadministratoren und andere Interessierte die
 	      Leistung von FreeBSD.  Zul&auml;ssige Themen sind
 	      beispielsweise Systeme unter hoher Last, Systeme
 	      mit Leistungsproblemen oder Systeme, die Leistungsgrenzen
 	      von FreeBSD &uuml;berwinden.  Jeder, der mithelfen will,
 	      die Leistung von FreeBSD zu verbessern, sollte diese
 	      Liste abonnieren.  Die Liste ist technisch anspruchsvoll
 	      und geeignet f&uuml;r erfahrene FreeBSD-Benutzer,
 	      Hacker oder Administratoren, die FreeBSD schnell,
 	      robust und skalierbar halten wollen.  Auf der Liste
 	      werden Beitr&auml;ge gesammelt oder Fragen nach
 	      ungel&ouml;sten Problemen beantwortet.  Sie ist kein
 	      Ersatz f&uuml;r das gr&uuml;ndliche Studium der
 	      Dokumentation.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.pf.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Diskussionen und Fragen zu
 	      packet filter als Firewallsystem.</emphasis></para>
 
 	    <para>FreeBSD-spezische Diskussionen zur Benutzung von
 	      <foreignphrase>packet filter</foreignphrase> (pf) als
 	      Firewallsystem.  Sowohl technische Diskussionen als auch
 	      Anwenderfragen sind auf dieser Liste willkommen.  Fragen
 	      zum ALTQ QoS Framework k&ouml;nnen ebenfalls gestellt
 	      werden.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.platforms.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Portierung auf nicht-&intel;
 	      Plattformen</emphasis></para>
 
 	    <para>Plattform&uuml;bergreifende Themen und Vorschl&auml;ge
 	      f&uuml;r die Portierung auf nicht-&intel; Plattformen.
 	      Auf dieser Liste finden nur technische Diskussionen
 	      statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.policy.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Grundsatzentscheidungen des Core
 		Teams</emphasis></para>
 
 	    <para>Diese Mailingliste ist f&uuml;r Grundsatzentscheidungen
 	      des FreeBSD-Core-Teams.  Sie tr&auml;gt wenige Nachrichten und
 	      ist nur zum Lesen gedacht.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.ports.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Diskussion &uuml;ber die
 		Ports-Sammlung</emphasis></para>
 
 	    <para>Diskussionen &uuml;ber die FreeBSD-Ports-Sammlung und
 	      die Infrastruktur der Sammlung.  Die
 	      Liste dient auch der allgemeinen Koordination der Dinge, die
 	      die Ports-Sammlung betreffen.  Auf dieser Liste finden nur
 	      technische Diskussionen statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.ports-bugs.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Diskussion &uuml;ber Fehler in
 	      den Ports</emphasis></para>
 
 	    <para>Diskussion &uuml;ber Fehler in der Ports-Sammlung
 	      (<filename>/usr/ports</filename>), neue Ports oder
 	      &Auml;nderungen an bestehenden Ports.  Auf dieser Liste
 	      finden nur technische Diskussionen statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.proliant.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Technische Diskussionen zum Einsatz von
 	      FreeBSD auf der ProLiant-Serverplattform von
 	      HP</emphasis></para>
 
 	    <para>Diese Mailingliste bietet technische Diskussionen
 	      zum Einsatz von FreeBSD auf der ProLiant-Serverplattform
 	      von HP, darunter Fragen zu ProLiant-spezifischen
 	      Treibern, Konfigurationswerkzeugen sowie
 	      BIOS-Aktualisierungen.  Daher ist sie die erste
 	      Anlaufstelle, um die Module hpasmd, hpasmcli, sowie
 	      hpacucli zu diskutieren.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.python.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Python unter FreeBSD</emphasis></para>
 
 	    <para>Diese technische Liste dient der Verbesserung der
 	      Python-Unterst&uuml;tzung unter FreeBSD.  Sie wird von
 	      Personen gelesen, die an der Portierung von Python, von
 	      Python-Modulen Dritter und von
 	      <application>Zope</application> nach FreeBSD arbeiten.
 	      Personen, die diese technischen Diskussion verfolgen
 	      wollen, sind ebenfalls willkommen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.questions.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Benutzerfragen</emphasis></para>
 
 	    <para>Auf dieser Mailingliste k&ouml;nnen Fragen zu
 	      FreeBSD gestellt werden.  Fragen Sie bitte nicht nach
 	      Anleitungen, wenn Sie nicht sicher sind, dass Ihre
 	      Frage wirklich technischer Natur ist.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.scsi.name;</term>
 
 	  <listitem>
 	    <para><emphasis>SCSI Subsystem</emphasis></para>
 
 	    <para>Diese Mailingliste ist f&uuml;r die Entwickler des SCSI
 	      Subsystems von FreeBSD.  Auf dieser Liste finden nur
 	      technische Diskussionen statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.security.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Sicherheitsthemen</emphasis></para>
 
 	    <para>Sicherheitsthemen, die FreeBSD betreffen, wie DES,
 	      Kerberos, bekannte Sicherheitsl&ouml;cher und Fehlerbehebungen.
 	      Stellen Sie bitte auf dieser Liste keine allgemeinen Fragen
 	      zum Thema Sicherheit.  Willkommen sind allerdings Beitr&auml;ge
 	      zur FAQ, das hei&szlig;t eine Frage mit der passenden
 	      Antwort.  Auf dieser Liste finden nur technische Diskussionen
 	      statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.security-notifications.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Ank&uuml;ndigungen zum Thema
 		Sicherheit</emphasis></para>
 
 	    <para>Ank&uuml;ndigungen &uuml;ber Sicherheitsprobleme von
 	      FreeBSD und deren Behebungen.  Diese Liste ist kein
 	      Diskussionsforum, benutzen Sie &a.security;, um
 	      Sicherheitsthemen zu diskutieren.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.small.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Gebrauch von FreeBSD in
 	      eingebetteten Systemen.</emphasis></para>
 
 	    <para>Diese Liste f&uuml;r ungew&ouml;hnlich kleine FreeBSD
 	      Installation oder den Einsatz von FreeBSD in eingebetteten
 	      Systemen gedacht.  Auf dieser Liste finden nur technische
 	      Diskussionen statt.</para>
 
 	    <note>
 	      <para>Diese Liste wurde durch &a.embedded.name;
 	        ersetzt.</para>
 	    </note>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.stable.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Gebrauch von &os.stable;.</emphasis></para>
 
 	    <para>Diese Mailingliste ist f&uuml;r die Benutzer von
 	      &os.stable; eingerichtet.  Auf ihr finden sich
 	      Ank&uuml;ndigungen &uuml;ber Besonderheiten von -STABLE, von
 	      denen Benutzer betroffen sind.  Sie enth&auml;lt weiterhin
 	      Anweisungen, wie man ein System auf -STABLE h&auml;lt.  Jeder,
 	      der ein -STABLE System besitzt, muss diese Liste lesen.  Die
 	      Liste ist nur f&uuml;r technische Inhalte bestimmt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.standards.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Konformit&auml;t von FreeBSD mit den C99- und
 	      &posix; Standards</emphasis></para>
 
 	    <para>Dieses Forum ist f&uuml;r technische Diskussionen
 	      &uuml;ber die Konformit&auml;t von FreeBSD mit den C99- und
 	      POSIX-Standards.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.usb.name;</term>
 
 	  <listitem>
 	    <para><emphasis>USB-Unterst&uuml;tzung in
 	      &os;.</emphasis></para>
 
 	    <para>Auf dieser Liste finden nur technische Diskussionen
 	      statt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.usergroups.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Koordination von Benutzergruppen</emphasis></para>
 
 	    <para>Diese Liste ist f&uuml;r Koordinatoren lokaler
 	      Benutzergruppen und einem ausgesuchten Mitglied des Core Teams
 	      eingerichtet worden.  Der Inhalt sollte Inhalte von Treffen
 	      und die Koordination von Projekten mehrerer Benutzergruppen
 	      beschr&auml;nkt sein.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>&a.vendors.name;</term>
 
 	  <listitem>
 	    <para><emphasis>Koordination von H&auml;ndlern</emphasis></para>
 
 	    <para>Koordination zwischen dem FreeBSD Project und
 	      H&auml;ndlern, die Soft- und Hardware f&uuml;r FreeBSD
 	      verkaufen.</para>
 	  </listitem>
 	</varlistentry>
 
       </variablelist>
     </sect2>
 
     <sect2 id="eresources-mailfiltering">
       <title>Filter der Mailinglisten</title>
 
       <para>Um die Verbreitung von Spam, Viren und anderen nicht
 	erw&uuml;nschten E-Mails zu verhindern, werden auf den
 	&os;-Mailinglisten Filter eingesetzt.  Dieser Abschnitt
 	beschreibt nur einen Teil der zum Schutz der Listen
 	eingesetzten Filter.</para>
 
       <para>Auf den Mailinglisten sind nur die unten aufgef&uuml;hrten
 	Anh&auml;nge erlaubt.  Anh&auml;nge mit einem anderen
 	MIME-Typ werden entfernt, bevor eine E-Mail an eine
 	Liste verteilt wird.</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>application/octet-stream</para>
 	</listitem>
 
 	<listitem>
 	  <para>application/pdf</para>
 	</listitem>
 
 	<listitem>
 	  <para>application/pgp-signature</para>
 	</listitem>
 
 	<listitem>
 	  <para>application/x-pkcs7-signature</para>
 	</listitem>
 
 	<listitem>
 	  <para>message/rfc822</para>
 	</listitem>
 
 	<listitem>
 	  <para>multipart/alternative</para>
 	</listitem>
 
 	<listitem>
 	  <para>multipart/related</para>
 	</listitem>
 
 	<listitem>
 	  <para>multipart/signed</para>
 	</listitem>
 
 	<listitem>
 	  <para>text/html</para>
 	</listitem>
 
 	<listitem>
 	  <para>text/plain</para>
 	</listitem>
 
 	<listitem>
 	  <para>text/x-diff</para>
 	</listitem>
 
 	<listitem>
 	  <para>text/x-patch</para>
 	</listitem>
       </itemizedlist>
 
       <note>
 	<para>Einige Mailinglisten erlauben vielleicht Anh&auml;nge
 	  mit anderem MIME-Typ.  F&uuml;r die meisten Mailinglisten
 	  sollte die obige Aufz&auml;hlung aber richtig sein.</para>
       </note>
 
       <para>Wenn eine E-Mail sowohl aus einer HTML-Version wie auch
 	aus einer Text-Version besteht, wird die HTML-Version entfernt.
 	Wenn eine E-Mail nur im HTML-Format versendet wurde, wird
 	sie in reinen Text umgewandelt.</para>
     </sect2>
   </sect1>
 
   <sect1 id="eresources-news">
     <title>Usenet-News</title>
 
     <para>Neben den Gruppen, die sich ausschlie&szlig;lich mit BSD
       besch&auml;ftigen, gibt es viele weitere in denen &uuml;ber FreeBSD
       diskutiert wird, oder die f&uuml;r FreeBSD-Benutzer wichtig sind.
       Warren Toomey <email>wkt@cs.adfa.edu.au</email> stellte
       gro&szlig;z&uuml;gig <ulink
         url="http://minnie.tuhs.org/BSD-info/bsdnews_search.html">suchbare
 	Archive</ulink> einiger dieser Gruppen bereit.</para>
 
     <sect2>
       <title>BSD spezifische Gruppen</title>
 
       <itemizedlist>
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.bsd.freebsd.announce">comp.unix.bsd.freebsd.announce</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.bsd.freebsd.misc">comp.unix.bsd.freebsd.misc</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:de.comp.os.unix.bsd">de.comp.os.unix.bsd</ulink> (deutsch)</para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:fr.comp.os.bsd">fr.comp.os.bsd</ulink> (franz&ouml;sisch)</para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:it.comp.os.bsd">it.comp.os.bsd</ulink> (italienisch)</para>
 	</listitem>
 	<listitem>
 	  <para><ulink
 	      url="news:tw.bbs.comp.386bsd">tw.bbs.comp.386bsd</ulink> (Traditionelles Chinesisch)</para>
 	</listitem>
       </itemizedlist>
     </sect2>
 
     <sect2>
       <title>Weitere UNIX Gruppen</title>
 
       <itemizedlist>
 	<listitem>
 	  <para><ulink url="news:comp.unix">comp.unix</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.questions">comp.unix.questions</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.admin">comp.unix.admin</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.programmer">comp.unix.programmer</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.shell">comp.unix.shell</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.user-friendly">comp.unix.user-friendly</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.security.unix">comp.security.unix</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.sources.unix">comp.sources.unix</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.advocacy">comp.unix.advocacy</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.misc">comp.unix.misc</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.bugs.4bsd">comp.bugs.4bsd</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.bugs.4bsd.ucb-fixes">comp.bugs.4bsd.ucb-fixes</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.unix.bsd">comp.unix.bsd</ulink></para>
 	</listitem>
       </itemizedlist>
     </sect2>
 
     <sect2>
       <title>X Window System</title>
 
       <itemizedlist>
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x.i386unix">comp.windows.x.i386unix</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x">comp.windows.x</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x.apps">comp.windows.x.apps</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x.announce">comp.windows.x.announce</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x.intrinsics">comp.windows.x.intrinsics</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x.motif">comp.windows.x.motif</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.windows.x.pex">comp.windows.x.pex</ulink></para>
 	</listitem>
 
 	<listitem>
 	  <para><ulink
 	      url="news:comp.emulators.ms-windows.wine">comp.emulators.ms-windows.wine</ulink></para>
 	</listitem>
       </itemizedlist>
     </sect2>
   </sect1>
 
   <sect1 id="eresources-web">
     <title>World Wide Web Server</title>
 
     &chap.eresources.www.inc;
   </sect1>
 
   <sect1 id="eresources-email">
     <title>E-Mail Adressen</title>
 
     <para>Die folgenden Benutzergruppen stellen ihren Mitgliedern f&uuml;r
       die Arbeit an FreeBSD E-Mail-Adressen zur Verf&uuml;gung.  Der
       aufgef&uuml;hrte Administrator beh&auml;lt sich das Recht vor,
       die Adresse zu sperren, wenn sie missbraucht wird.</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="4">
         <thead>
 	  <row>
 	    <entry>Domain</entry>
 	    <entry>Angebot</entry>
 	    <entry>Benutzergruppe</entry>
 	    <entry>Administrator</entry>
           </row>
 	</thead>
 
 	<tbody>
 	  <row>
 	    <entry>ukug.uk.FreeBSD.org</entry>
 	    <entry>nur zum Weiterleiten</entry>
 	    <entry><email>freebsd-users@uk.FreeBSD.org</email></entry>
 	    <entry>Lee Johnston
 	      <email>lee@uk.FreeBSD.org</email></entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
   </sect1>
 
   <sect1 id="eresources-shell">
     <title>Shell Accounts</title>
 
     <para>Die folgenden Benutzergruppen stellen Personen, die das FreeBSD
       Projekt aktiv unterst&uuml;tzen, Shell-Accounts zur Verf&uuml;gung.
       Der aufgef&uuml;hrte Administrator beh&auml;lt sich das Recht vor,
       den Account zu sperren, wenn er missbraucht wird.</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="4">
 	<thead>
 	  <row>
 	    <entry>Rechner</entry>
 	    <entry>Zugriff</entry>
 	    <entry>Angebot</entry>
 	    <entry>Administrator</entry>
           </row>
 	</thead>
 
 	<tbody>
 	  <row>
 	    <entry>dogma.freebsd-uk.eu.org</entry>
 	    <entry>Telnet/FTP/SSH</entry>
 	    <entry>E-Mail, Webseiten, Anonymous FTP</entry>
             <entry>Lee Johnston
 		<email>lee@uk.FreeBSD.org</email></entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
   </sect1>
 </appendix>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../appendix.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "appendix")
      End:
 -->
 
diff --git a/de_DE.ISO8859-1/books/handbook/introduction/chapter.sgml b/de_DE.ISO8859-1/books/handbook/introduction/chapter.sgml
index 4c79749451..5949ed8d2d 100644
--- a/de_DE.ISO8859-1/books/handbook/introduction/chapter.sgml
+++ b/de_DE.ISO8859-1/books/handbook/introduction/chapter.sgml
@@ -1,1230 +1,1230 @@
 <!--
      The FreeBSD Documentation Project
      The FreeBSD German Documentation Project
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/handbook/introduction/chapter.sgml,v 1.53 2007/08/19 16:59:47 jkois Exp $
-     basiert auf: 1.120
+     $FreeBSDde: de-docproj/books/handbook/introduction/chapter.sgml,v 1.54 2007/11/09 07:51:52 jkois Exp $
+     basiert auf: 1.121
 -->
 
 <chapter id="introduction">
   <chapterinfo>
     <authorgroup>
       <author>
 	<firstname>Jim</firstname>
 	<surname>Mock</surname>
 	<contrib>Neu zusammengestellt, umstrukturiert und um
 	  Abschnitte erweitert durch </contrib>
       </author>
     </authorgroup>
     <authorgroup>
       <author>
 	<firstname>Sascha</firstname>
 	<surname>Edelburg</surname>
 	<contrib>&Uuml;bersetzt von </contrib>
       </author>
     </authorgroup>
   </chapterinfo>
 
   <title>Einf&uuml;hrung</title>
 
   <sect1 id="introduction-synopsis">
     <title>&Uuml;bersicht</title>
 
     <para>Herzlichen Dank f&uuml;r Ihr Interesse an FreeBSD!  Das
       folgende Kapitel behandelt verschiedene Aspekte des
       FreeBSD Projects wie dessen geschichtliche Entwicklung,
       dessen Ziele oder dessen Entwicklungsmodell.</para>
 
     <para>Nach dem Durcharbeiten des Kapitels wissen Sie &uuml;ber
       folgende Punkte Bescheid:</para>
 
     <itemizedlist>
       <listitem>
 	<para>Wo FreeBSD im Vergleich zu anderen Betriebssystemen
 	  steht</para>
       </listitem>
 
       <listitem>
 	<para>Die Geschichte des FreeBSD Projects</para>
       </listitem>
 
       <listitem>
 	<para>Die Ziele des FreeBSD Projects</para>
       </listitem>
 
       <listitem>
 	<para>Die Grundlagen des
 	  FreeBSD-Open-Source-Entwicklungsmodells</para>
       </listitem>
 
       <listitem>
 	<para>Und nat&uuml;rlich wo der Name <quote>FreeBSD</quote>
 	  herr&uuml;hrt</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 id="nutshell">
     <title>Willkommen bei FreeBSD!</title>
 
     <indexterm>
       <primary>4.4BSD-Lite</primary>
     </indexterm>
 
     <para>FreeBSD ist ein auf 4.4BSD-Lite basierendes Betriebssystem
       f&uuml;r Intel (x86 und &itanium;), AMD64, <trademark>Alpha</trademark>
       und Sun &ultrasparc; Rechner.  An
       Portierungen zu anderen Architekturen wird derzeit gearbeitet.
       Mehr zu Geschichte von FreeBSD k&ouml;nnen Sie im <link
         linkend="history">kurzen geschichtlichen Abriss zu FreeBSD</link>
       oder im Abschnitt <link linkend="relnotes">Das aktuelle
         FreeBSD-Release</link> nachlesen.
       Falls Sie das FreeBSD Project unterst&uuml;tzen wollen
       (mit Quellcode, Hardware- oder Geldspenden), sollten Sie den
       Artikel <ulink url="&url.articles.contributing;/index.html">
       FreeBSD unterst&uuml;tzen</ulink> lesen.</para>
 
     <sect2 id="os-overview">
       <title>Was kann FreeBSD?</title>
 
       <para>FreeBSD hat zahlreiche bemerkenswerte Eigenschaften.
 	Um nur einige zu nennen:</para>
 
       <itemizedlist>
 	<indexterm>
 	  <primary>Pr&auml;emptives Multitasking</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>Pr&auml;emptives Multitasking</emphasis> mit
 	    dynamischer Priorit&auml;tsanpassung zum reibungslosen und
 	    ausgeglichenen Teilen der Systemressourcen zwischen
 	    Anwendungen und Anwendern, selbst unter schwerster
 	    Last.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Mehrbenutzerbetrieb</primary>
 	</indexterm>
 
 	<listitem>
 	  <para>Der <emphasis>Mehrbenutzerbetrieb</emphasis> von
 	    FreeBSD erlaubt es, viele Anwender gleichzeitig am System
 	    mit verschiedenen Aufgaben arbeiten zu lassen.
 	    Beispielsweise Ger&auml;te wie Drucker oder Bandlaufwerke,
 	    die sich nur schwerlich unter allen Anwendern des Systems
 	    oder im Netzwerk teilen lassen, k&ouml;nnen durch Setzen
 	    von Verwendungsbeschr&auml;nkungen auf Benutzer oder
 	    Benutzergruppen wichtige Systemressourcen vor
 	    &Uuml;berbeanspruchung sch&uuml;tzen.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>TCP/IP-Netzwerkf&auml;higkeit</primary>
 	</indexterm>
 
 	<listitem>
 	  <para>Hervorragende
 	    <emphasis>TCP/IP-Netzwerkf&auml;higkeit</emphasis> mit
 	    Unterst&uuml;tzung von Industriestandards wie SCTP, DHCP,
 	    NFS, NIS, PPP, SLIP, IPsec und IPv6.  Das hei&szlig;t,
 	    Ihr FreeBSD-System kann in einfachster Weise mit anderen
 	    Systemen interagieren.  Zudem kann es als Server-System im
 	    Unternehmen wichtige Aufgaben &uuml;bernehmen,
 	    beispielsweise als NFS- oder E-Mail-Server oder es kann
 	    Ihren Betrieb durch HTTP- und FTP-Server beziehungsweise
 	    durch Routing und Firewalling Internet-f&auml;hig machen.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Speicherschutz</primary>
 	</indexterm>
 
 	<listitem>
 	  <para>Der <emphasis>Speicherschutz</emphasis> stellt sicher,
 	    dass Anwendungen (oder Anwender) sich nicht gegenseitig
 	    st&ouml;ren.  St&uuml;rzt eine Anwendung ab, hat das
 	    keine Auswirkung auf andere Prozesse.</para>
 	</listitem>
 
 	<listitem>
 	  <para>FreeBSD ist ein
 	    <emphasis>32-Bit</emphasis>-Betriebssystem
 	    (<emphasis>64-Bit</emphasis> auf Alpha, &itanium;, AMD64,
 	    und &ultrasparc;) und wurde als solches von Grund auf
 	    neu entworfen.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>X-Window-System</primary>
 	  <seealso>XFree86</seealso>
 	</indexterm>
 
 	<listitem>
 	  <para>Das <emphasis>X-Window-System</emphasis> (X11R7) als
 	    Industriestandard bietet eine grafische Benutzeroberfl&auml;che
 	    (GUI).  Minimale Voraussetzung zur Verwendung ist
 	    lediglich eine Grafikkarte und ein Bildschirm, die beide
 	    den VGA-Modus unterst&uuml;tzen.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Bin&auml;rkompatibilit&auml;t</primary>
 	  <secondary>Linux</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>Bin&auml;rkompatibilit&auml;t</primary>
 	  <secondary>SCO</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>Bin&auml;rkompatibilit&auml;t</primary>
 	  <secondary>SVR4</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>Bin&auml;rkompatibilit&auml;t</primary>
 	  <secondary>BSD/OS</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>Bin&auml;rkompatibilit&auml;t</primary>
 	  <secondary>NetBSD</secondary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>Bin&auml;rkompatibilit&auml;t</emphasis> mit
 	    vielen unter verschiedenen Betriebssystemen erstellten
 	    Programmen wie Linux, SCO, SVR4, BSDI und NetBSD.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Tausende von <emphasis>sofort
 	    lauff&auml;higen</emphasis> Anwendungen sind aus den
 	    <emphasis>Ports</emphasis>- und
 	    <emphasis>Packages</emphasis>-Sammlungen f&uuml;r FreeBSD
 	    verf&uuml;gbar.  Warum m&uuml;hselig im Netz Software
 	    suchen, wenn sie bereits hier vorhanden ist?</para>
 	</listitem>
 
 	<listitem>
 	  <para>Tausende zus&auml;tzliche <emphasis>leicht zu
 	    portierende</emphasis> Anwendungen sind &uuml;ber das
 	    Internet zu beziehen.  FreeBSD ist Quellcode-kompatibel
 	    mit den meisten kommerziellen &unix; Systemen.  Daher
 	    bed&uuml;rfen Anwendungen h&auml;ufig nur geringer oder
 	    gar keiner Anpassung, um auf einem FreeBSD-System zu
 	    kompilieren.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>virtueller Speicher</primary>
 	</indexterm>
 
 	<listitem>
 	  <para>Seitenweise anforderbarer <emphasis>Virtueller
 	    Speicher</emphasis> und der <quote>merged VM/buffer
 	    cache</quote>-Entwurf bedient effektiv den gro&szlig;en
 	    Speicherhunger mancher Anwendungen bei gleichzeitigem
 	    Aufrechterhalten der Bedienbarkeit des Systems f&uuml;r
 	    weitere Benutzer.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Symmetrisches Multi-Processing (SMP)</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>SMP</emphasis>-Unterst&uuml;tzung f&uuml;r
 	    Mehrprozessorsysteme</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Kompiler</primary>
 	  <secondary>C</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>Kompiler</primary>
 	  <secondary>C++</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>Kompiler</primary>
 	  <secondary>FORTRAN</secondary>
 	</indexterm>
 
 	<listitem>
 	  <para>Ein voller Satz von <emphasis>C</emphasis>,
 	    <emphasis>C++</emphasis> und <emphasis>Fortran</emphasis>-
 	    Entwicklungswerkzeugen.  Viele
 	    zus&auml;tzliche Programmiersprachen f&uuml;r Wissenschaft
 	    und Entwicklung sind aus der Ports- und Packages-Sammlung
 	    zu haben.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Quellcode</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>Quellcode</emphasis> f&uuml;r das gesamte
 	    System bedeutet gr&ouml;&szlig;tm&ouml;gliche Kontrolle
 	    &uuml;ber Ihre Umgebung.  Warum sollte man sich durch
 	    propriet&auml;re L&ouml;sungen knebeln und sich auf Gedeih
 	    und Verderb der Gnade eines Herstellers ausliefern, wenn
 	    man doch ein wahrhaft offenes System haben kann?</para>
 	</listitem>
 
 	<listitem>
 	  <para>Umfangreiche
 	    <emphasis>Online-Dokumentation</emphasis>.</para>
 	</listitem>
       </itemizedlist>
 
       <indexterm>
 	<primary>4.4BSD-Lite</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Computer Systems Research Group (CSRG)</primary>
       </indexterm>
 
       <indexterm>
 	<primary>U.C. Berkeley</primary>
       </indexterm>
 
       <para>FreeBSD basiert auf dem 4.4BSD-Lite-Release der Computer
 	Systems Research Group (CSRG) der Universit&auml;t von
 	Kalifornien in Berkeley und f&uuml;hrt die namhafte
 	Tradition der Entwicklung von BSD-Systemen fort.
 	Zus&auml;tzlich zu der herausragenden Arbeit der CSRG hat das
 	FreeBSD Project tausende weitere Arbeitsstunden investiert,
 	um das System zu verfeinern und maximale Leistung und
 	Zuverl&auml;ssigkeit bei Alltagslast zu bieten.  W&auml;hrend
 	viele kommerzielle Riesen Probleme haben PC-Betriebssysteme
 	mit derartigen Funktionen, Leistungpotential und
 	Zuverl&auml;ssigkeit anzubieten, kann FreeBSD damit schon
 	<emphasis>jetzt</emphasis> aufwarten!</para>
 
       <para> Die Anwendungsm&ouml;glichkeiten von FreeBSD werden nur
 	durch Ihre Vorstellungskraft begrenzt.  Von
 	Software-Entwicklung bis zu Produktionsautomatisierung, von
 	Lagerverwaltung &uuml;ber Abweichungskorrektur bei Satelliten;
 	Falls etwas mit kommerziellen &unix; Produkten machbar ist, dann
 	ist es h&ouml;chstwahrscheinlich auch mit FreeBSD
 	m&ouml;glich.  FreeBSD profitiert stark von tausenden
 	hochwertigen Anwendungen aus wissenschaftlichen Instituten und
 	Universit&auml;ten in aller Welt.  H&auml;ufig sind diese
 	f&uuml;r wenig Geld oder sogar kostenlos zu bekommen.
 	Kommerzielle Anwendungen sind ebenso verf&uuml;gbar und es
 	werden t&auml;glich mehr.</para>
 
       <para>Durch den freien Zugang zum Quellcode von FreeBSD ist es
 	in unvergleichbarer Weise m&ouml;glich, das System f&uuml;r
 	spezielle Anwendungen oder Projekte anzupassen.  Dies ist
 	mit den meisten kommerziellen Betriebssystemen einfach nicht
 	m&ouml;glich.  Beispiele f&uuml;r Anwendungen, die unter
 	FreeBSD laufen, sind:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para><emphasis>Internet-Dienste</emphasis>:  Die robuste
 	    TCP/IP-Implementierung in FreeBSD macht es zu einer
 	    idealen Plattform f&uuml;r verschiedenste
 	    Internet-Dienste, wie zum Beispiel:</para>
 
 	  <itemizedlist>
 	    <indexterm>
 	      <primary>FTP-Server</primary>
 	    </indexterm>
 
 	    <listitem>
 	      <para>FTP-Server</para>
 	    </listitem>
 
 	    <indexterm>
 	      <primary>HTTP-Server</primary>
 	    </indexterm>
 
 	    <listitem>
 	      <para>HTTP-Server (Standard-Web-Server oder mit
 		SSL-Verschl&uuml;sselung)</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>IPv4- und IPv6-Routing</para>
             </listitem>
 
 	    <indexterm>
 	      <primary>Firewall</primary>
 	    </indexterm>
 
 	    <indexterm>
 	      <primary>NAT</primary>
 	    </indexterm>
 
 	    <listitem>
 	      <para>Firewalls und NAT-Gateways
 		(<quote>IP-Masquerading</quote>)</para>
 	    </listitem>
 
 	    <indexterm>
 	      <primary>E-Mail</primary>
 	    </indexterm>
 
 	    <listitem>
 	      <para>E-Mail-Server</para>
 	    </listitem>
 
 	    <indexterm>
 	      <primary>Usenet</primary>
 	    </indexterm>
 
 	    <listitem>
 	      <para>Usenet-News und Foren (BBS)</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>Zum Betreiben von FreeBSD reicht schon ein
 	    g&uuml;nstiger 386-PC.  Wenn es das Wachstum Ihres
 	    Unternehmens verlangt, kann FreeBSD aber auch auf einem
 	    hochger&uuml;steten 4-Wege-System mit Xeon-Prozessoren
 	    und RAID-Plattenspeicher Verwendung finden.</para>
 	</listitem>
 
 	<listitem>
 	  <para><emphasis>Bildung</emphasis>:  Sind Sie
 	    Informatikstudent oder Student eines verwandten
 	    Studiengangs?  Die praktischen Einblicke in FreeBSD sind
 	    die beste M&ouml;glichkeit etwas &uuml;ber Betriebssysteme,
 	    Rechnerarchitektur und Netzwerke zu lernen.  Einige frei
 	    erh&auml;ltliche CAD-, mathematische und grafische Anwendungen
 	    sind sehr n&uuml;tzlich, gerade f&uuml;r diejenigen, die
 	    FreeBSD nicht zum Selbstzweck, sondern als
 	    <emphasis>Arbeitsmittel</emphasis> einsetzen.</para>
 	</listitem>
 
 	<listitem>
 	  <para><emphasis>Wissenschaft</emphasis>:  Mit dem frei
 	    verf&uuml;gbaren Quellcode f&uuml;r das gesamte System
 	    bildet FreeBSD ein exzellentes Studienobjekt in der
 	    Disziplin der Betriebssysteme, wie auch in anderen Zweigen
 	    der Informatik.  Es ist beispielsweise denkbar, das
 	    r&auml;umlich getrennte Gruppen gemeinsam an einer Idee
 	    oder Entwicklung arbeiten.  Das Konzept der freien
 	    Verf&uuml;gbarkeit und -nutzung von FreeBSD
 	    erm&ouml;glicht so einen Gebrauch, auch ohne sich
 	    gro&szlig; Gedanken &uuml;ber Lizenzbedingungen oder
 	    -beschr&auml;nkungen machen zu m&uuml;ssen.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Router</primary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>DNS-Server</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>Netzwerkf&auml;higkeit</emphasis>:  Brauchen
 	    Sie einen neuen Router?  Oder einen Name-Server (DNS)?  Eine
 	    Firewall zum Schutze Ihres Intranets vor Fremdzugriff?
 	    FreeBSD macht aus dem in der Ecke verstaubenden 386- oder
 	    486-PC im Handumdrehen einen leistungsf&auml;higen Router
 	    mit anspruchsvollen Packet-Filter-F&auml;higkeiten.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>X-Window-System</primary>
 	  <secondary>XFree86</secondary>
 	</indexterm>
 
 	<indexterm>
 	  <primary>X-Window-System</primary>
 	  <secondary>Accelerated-X</secondary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>X-Window-Workstation</emphasis>:  FreeBSD ist
 	    eine gute Wahl f&uuml;r kosteng&uuml;nstige X-Terminals
 	    mit dem frei verf&uuml;gbaren X11-Server.
 	    Im Gegensatz zu einem X-Terminal erlaubt es FreeBSD, viele
 	    Anwendungen lokal laufen zu lassen, was die Last eines
 	    zentralen Servers erleichtern kann.  FreeBSD kann selbst
 	    <quote>plattenlos</quote> starten, was einzelne
 	    Workstations noch g&uuml;nstiger macht und die Wartung
 	    erleichtert.</para>
 	</listitem>
 
 	<indexterm>
 	  <primary>GNU-Compiler-Collection</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><emphasis>Software-Entwicklung</emphasis>:  Das
 	    Standard-System von FreeBSD wird mit einem kompletten Satz
 	    an Entwicklungswerkzeugen bereitgestellt, unter anderem
 	    mit dem bekannten GNU C/C++-Kompiler und -Debugger.</para>
 	</listitem>
       </itemizedlist>
 
       <para>&os; ist sowohl in Form von Quellcode als auch in
 	Bin&auml;rform auf CD-ROM, DVD und &uuml;ber anonymous FTP
 	erh&auml;ltlich.  N&auml;heres zum Bezug von FreeBSD
 	enth&auml;lt <xref linkend="mirrors">.</para>
     </sect2>
 
     <sect2>
       <title>Wer benutzt FreeBSD?</title>
 
       <indexterm>
 	<primary>Anwender</primary>
 	<secondary>Bekannte FreeBSD-Anwender</secondary>
       </indexterm>
 
       <para>Unter FreeBSD laufen einige der gr&ouml;&szlig;ten
 	Internet-Auftritte, beispielsweise:</para>
 
       <itemizedlist>
 	<indexterm>
 	  <primary>Yahoo!</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink
 	    url="http://www.yahoo.com/">Yahoo!</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Apache</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink
 	    url="http://www.apache.org/">Apache</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Blue Mountain Arts</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink url="http://www.bluemountain.com/">Blue
 	    Mountain Arts</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Pair Networks</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink url="http://www.pair.com/">Pair
 	    Networks</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Sony Japan</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink url="http://www.sony.co.jp/">Sony
 	    Japan</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Netcraft</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink
 	    url="http://www.netcraft.com/">Netcraft</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Weathernews</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink
 	    url="http://www.wni.com/">Weathernews</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Supervalu</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink
 	    url="http://www.supervalu.com/">Supervalu</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>TELEHOUSE America</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink url="http://www.telehouse.com/">TELEHOUSE
 	    America</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>Sophos Anti-Virus</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink url="http://www.sophos.com/">Sophos
 	    Anti-Virus</ulink></para>
 	</listitem>
 
 	<indexterm>
 	  <primary>JMA Wired</primary>
 	</indexterm>
 
 	<listitem>
 	  <para><ulink url="http://www.jmawired.com/">JMA
 	    Wired</ulink></para>
 	</listitem>
       </itemizedlist>
     </sect2>
   </sect1>
 
   <sect1 id="history">
     <title>Das FreeBSD Project</title>
 
     <para>Der folgende Abschnitt bietet einige
       Hintergrundinformationen zum FreeBSD Project,
       einschlie&szlig;lich einem kurzen geschichtlichen Abriss,
       den Projektzielen und dem Entwicklungsmodell.</para>
 
     <sect2 id="intro-history">
       <sect2info role="firstperson">
 	<authorgroup>
 	  <author>
 	    <firstname>Jordan</firstname>
 	    <surname>Hubbard</surname>
 	    <contrib>Beigesteuert von </contrib>
 	  </author>
 	</authorgroup>
       </sect2info>
 
       <title>Kurzer geschichtlicher Abriss zu FreeBSD</title>
 
       <indexterm>
 	<primary>386BSD Patchkit</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Hubbard, Jordan</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Williams, Nate</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Grimes, Rod</primary>
       </indexterm>
 
       <indexterm>
 	<primary>FreeBSD Project</primary>
 	<secondary>Geschichte</secondary>
       </indexterm>
 
       <para>Das FreeBSD Project erblickte das Licht der Welt Anfang
 	1993 teils als Auswuchs des <quote>Unofficial 386BSD
 	Patchkit</quote> unter der Regie der letzten drei
 	Koordinatoren des Patchkits:  Nate Williams, Rod Grimes und
 	mir.</para>
 
       <indexterm>
 	<primary>386BSD</primary>
       </indexterm>
 
       <para>Unser eigentliches Ziel war es, einen zwischenzeitlichen
 	Abzug von 386BSD zu erstellen, um ein paar Probleme zu
 	beseitigen, die das Patchkit-Verfahren nicht l&ouml;sen
 	konnte.  Einige von Ihnen werden sich in dem Zusammenhang noch
 	an die fr&uuml;hen Arbeitstitel <quote>386BSD 0.5</quote> oder
 	<quote>386BSD Interim</quote> erinnern.</para>
 
       <indexterm>
 	<primary>Jolitz, Bill</primary>
       </indexterm>
 
       <para>386BSD war das Betriebssystem von Bill Jolitz.  Dieses
 	litt bis zu diesem Zeitpunkt heftig unter fast
 	einj&auml;hriger Vernachl&auml;ssigung.  Als das Patchkit mit
 	jedem Tag anschwoll und unhandlicher wurde, waren wir
 	einhellig der Meinung, es m&uuml;sse etwas geschehen.  Wir
 	entschieden uns Bill Jolitz zu helfen, indem wir den
 	&uuml;bergangsweise <quote>bereinigten</quote> Abzug zur
 	Verf&uuml;gung stellten.  Diese Pl&auml;ne wurden unsch&ouml;n
 	durchkreuzt als Bill Jolitz pl&ouml;tzlich seine Zustimmung
 	zu diesem Projekt zur&uuml;ckzog, ohne einen Hinweis darauf,
 	was stattdessen geschehen sollte.</para>
 
       <indexterm>
 	<primary>Greenman, David</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Walnut Creek CDROM</primary>
       </indexterm>
 
       <para>Es hat nicht lange gedauert zu entscheiden, dass das Ziel
 	es wert war, weiterverfolgt zu werden, selbst ohne Bills
 	Unterst&uuml;tzung.  Also haben wir den von David Greenman
 	gepr&auml;gten Namen <quote>FreeBSD</quote> angenommen.
 	Unsere anf&auml;nglichen Ziele setzten wir nach
 	R&uuml;cksprache mit den damaligen Benutzern des Systems fest.
 	Und als deutlich wurde, das Projekt w&uuml;rde
 	m&ouml;glicherweise Realit&auml;t, nahm ich Kontakt mit Walnut
 	Creek CDROM auf, mit einem Auge darauf, den Vertriebsweg
 	f&uuml;r die vielen Missbeg&uuml;nstigten zu verbessern,
 	die keinen einfachen Zugang zum Internet hatten.  Walnut Creek
 	CDROM unterst&uuml;tzte nicht nur die Idee des
 	CD-ROM-Vertriebs, sondern stellte sogar dem Projekt einen
 	Arbeitsrechner und eine schnelle Internetverbindung zur
 	Verf&uuml;gung.  Ohne den beispiellosen Glauben von Walnut
 	Creek CDROM in ein zu der Zeit absolut unbekanntes Projekt,
 	g&auml;be es FreeBSD in der heutigen Form wohl nicht.</para>
 
       <indexterm>
 	<primary>4.3BSD-Lite</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Net/2</primary>
       </indexterm>
 
       <indexterm>
 	<primary>U.C. Berkeley</primary>
       </indexterm>
 
       <indexterm>
 	<primary>386BSD</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Free Software Foundation</primary>
       </indexterm>
 
       <para>Die erste auf CD-ROM (und netzweit) verf&uuml;gbare
 	Ver&ouml;ffentlichung war FreeBSD&nbsp;1.0 im Dezember
 	1993.  Diese basierte auf dem Band der 4.3BSD-Lite
 	(<quote>Net/2</quote>) der Universit&auml;t von Kalifornien in
 	Berkeley.  Viele Teile stammten aus 386BSD und von der Free
 	Software Foundation.  Gemessen am ersten Angebot, war
 	das ein ziemlicher Erfolg und wir lie&szlig;en dem das extrem
 	erfolgreiche FreeBSD&nbsp;1.1 im Mai 1994 folgen.</para>
 
       <indexterm>
 	<primary>Novell</primary>
       </indexterm>
 
       <indexterm>
 	<primary>U.C. Berkeley</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Net/2</primary>
       </indexterm>
 
       <indexterm>
 	<primary>AT&amp;T</primary>
       </indexterm>
 
       <para>Zu dieser Zeit formierten sich unerwartete Gewitterwolken am
 	Horizont, als Novell und die Universit&auml;t von Kalifornien
 	in Berkeley (UCB) ihren langen Rechtsstreit &uuml;ber den
 	rechtlichen Status des Berkeley Net/2-Bandes mit einem
 	Vergleich beilegten.  Eine Bedingung dieser Einigung war es,
 	dass die UCB gro&szlig;e Teile des Net/2-Quellcodes als
 	<quote>belastet</quote> zugestehen musste, und dass diese
 	Besitz von Novell sind, welches den Code selbst einige Zeit vorher
 	von AT&amp;T bezogen hatte.  Im Gegenzug bekam die UCB den
 	<quote>Segen</quote> von Novell, dass sich das 4.4BSD-Lite-Release
 	bei seiner endg&uuml;ltigen Ver&ouml;ffentlichung als
 	unbelastet bezeichnen darf.  Alle Net/2-Benutzer sollten
 	auf das neue Release wechseln.  Das betraf auch FreeBSD.  Dem
 	Projekt wurde eine Frist bis Ende Juli 1994 einger&auml;umt,
 	das auf Net/2-basierende Produkt nicht mehr zu vertreiben.
 	Unter den Bedingungen dieser &Uuml;bereinkunft war es dem
 	Projekt noch erlaubt ein letztes Release vor diesem
 	festgesetzten Zeitpunkt herauszugeben.  Das war
 	FreeBSD&nbsp;1.1.5.1.</para>
 
       <para>FreeBSD machte sich dann an die beschwerliche Aufgabe,
 	sich St&uuml;ck f&uuml;r St&uuml;ck, aus einem neuen und
 	ziemlich unvollst&auml;ndigen Satz von 4.4BSD-Lite-Teilen,
 	wieder aufzubauen.  Die
 	<quote>Lite</quote>-Ver&ouml;ffentlichungen waren deswegen
 	leicht, weil Berkeleys CSRG gro&szlig;e Code-Teile,
 	die f&uuml;r ein start- und lauff&auml;higes System gebraucht
 	wurden, aufgrund diverser rechtlicher Anforderungen entfernen
 	musste und weil die 4.4-Portierung f&uuml;r Intel-Rechner extrem
 	unvollst&auml;ndig war.  Das Projekt hat bis November 1994
 	gebraucht diesen &Uuml;bergang zu vollziehen, was dann zu dem
 	im Netz ver&ouml;ffentlichten FreeBSD&nbsp;2.0 und zur
 	CD-ROM-Version (im sp&auml;ten Dezember) f&uuml;hrte.  Obwohl
 	FreeBSD gerade die ersten H&uuml;rden genommen hatte, war
 	dieses Release ein ma&szlig;geblicher Erfolg.  Diesem folgte
 	im Juni 1995 das robustere und einfacher zu installierende
 	FreeBSD&nbsp;2.0.5.</para>
 
       <para>Im August 1996 ver&ouml;ffentlichten wir
 	FreeBSD&nbsp;2.1.5.  Es schien unter ISPs und der Wirtschaft
 	beliebt genug zu sein, ein weiteres Release aus dem
 	2.1-STABLE-Zweig zu rechtfertigen.  Das war
 	FreeBSD&nbsp;2.1.7.1.  Es wurde im Februar 1997
 	ver&ouml;ffentlicht und bildete das Ende des
 	Hauptentwicklungszweiges 2.1-STABLE.  Derzeit unterliegt
 	dieser Zweig dem Wartungsmodus, das hei&szlig;t, es werden nur
 	noch Sicherheitsverbesserungen und die Beseitigung von
 	kritischen Fehlern vorgenommen (RELENG_2_1_0).</para>
 
       <para>FreeBSD&nbsp;2.2 entsprang dem Hauptentwicklungszweig
 	(<quote>-CURRENT</quote>) im November 1996 als
 	RELENG_2_2-Zweig und das erste komplette Release (2.2.1) wurde
 	im April 1997 herausgegeben.  Weitere Ver&ouml;ffentlichungen
 	des 2.2-Zweiges gab es im Sommer und Herbst 1997.  Das letzte
 	Release des 2.2-Zweiges bildete die Version 2.2.8, die im
 	November 1998 erschien.  Das erste offizielle 3.0-Release
 	erschien im Oktober 1998 und l&auml;utete das Endes des
 	2.2-Zweiges ein.</para>
 
       <para>Am 20.&nbsp;Januar&nbsp;1999 teilte sich der Quellbaum
 	in die Zweige 4.0-CURRENT und 3.X-STABLE.  Auf dem
 	3.X-STABLE-Zweig wurden folgende
 	Releases erstellt:  3.1 am 15.&nbsp;Februar&nbsp;1999,
 	3.2 am 15.&nbsp;Mai&nbsp;1999,
 	3.3 am 16.&nbsp;September&nbsp;1999,
 	3.4 am 20.&nbsp;Dezember&nbsp;1999 und
 	3.5 am 24.&nbsp;Juni&nbsp;2000.  Letzterem
 	folgte ein paar Tage sp&auml;ter das Release 3.5.1, welches
 	einige akute Sicherheitsl&ouml;cher von Kerberos stopfte und
 	die letzte Ver&ouml;ffentlichung des 3.X-Zweiges
 	darstellte.</para>
 
       <para>Eine weitere Aufspaltung, aus dem der 4.X-STABLE-Zweig
 	hervorging, erfolgte am 13.&nbsp;M&auml;rz&nbsp;2000.
 	Bisher gab es mehrere Ver&ouml;ffentlichungen
 	aus diesem Zweig:  4.0-RELEASE erschien im M&auml;rz&nbsp;2000.
 	Das letzte Release, 4.11-RELEASE, erschien im Januar 2005.</para>
 
       <para>Das lang erwartete 5.0-RELEASE wurde am
         19.&nbsp;Januar&nbsp;2003 ver&ouml;ffentlicht.  Nach nahezu
 	drei Jahren Entwicklungszeit brachte dieses Release die
 	Unterst&uuml;tzung f&uuml;r Mehrprozessor-Systeme sowie
 	f&uuml;r Multithreading.  Mit diesem Release lief &os;
 	erstmalig auf den Plattformen &ultrasparc;
 	und <literal>ia64</literal>.  Im Juni&nbsp;2003 folgte
 	5.1-RELEASE.  Das letzte 5.X-Release aus dem CURRENT-Zweig war
 	5.2.1-RELEASE, das im Februar 2004 ver&ouml;ffentlicht
 	wurde.</para>
 
       <para>Der Zweig RELENG_5 wurde im August 2004 erzeugt.  Als
 	erstes Release dieses Zweiges wurde 5.3-RELEASE
 	ver&ouml;ffentlicht, bei dem es sich gleichzeitig auch um
 	das erste 5-STABLE-Release handelte.  Das aktuelle
 	&rel2.current;-RELEASE (dem keine RELENG_5-Versionen mehr
 	folgen werden) erschien im <!--&rel2.current.date; -->
 	Mai 2006.</para>
 
       <para>Der Zweig RELENG_6 wurde im Juli 2005 erzeugt. 6.0-RELEASE,
 	das erste Release des 6.X-Zweiges, wurde im November 2005
 	ver&ouml;ffentlicht.  Das aktuelle &rel.current;-RELEASE (dem
 	weitere RELENG_6-Versionen folgen werden) erschien im
 	<!--&rel.current.date;--> Mai 2006.</para>
 
       <para>Zurzeit werden Projekte mit langem Entwicklungshorizont
 	im Zweig 7.X-CURRENT verfolgt, Schnappsch&uuml;sse
 	von 7.X auf CD-ROM (und nat&uuml;rlich im Netz) werden bei
 	fortlaufender Entwicklung auf dem <ulink
 	url="ftp://current.FreeBSD.org/pub/FreeBSD/snapshots/">
 	Snapshot-Server</ulink> zur Verf&uuml;gung gestellt.</para>
     </sect2>
 
     <sect2 id="goals">
       <sect2info>
 	<authorgroup>
 	  <author>
 	    <firstname>Jordan</firstname>
 	    <surname>Hubbard</surname>
 	    <contrib>Beigesteuert von </contrib>
 	  </author>
 	</authorgroup>
       </sect2info>
 
       <title>Ziele des FreeBSD Projects</title>
 
       <indexterm>
 	<primary>FreeBSD Project</primary>
 	<secondary>Ziele</secondary>
       </indexterm>
 
       <para>Das FreeBSD Project stellt Software her, die ohne
 	Einschr&auml;nkungen f&uuml;r beliebige Zwecke eingesetzt
 	werden kann.  Viele
 	von uns haben betr&auml;chtlich in Quellcode und Projekt
 	investiert und h&auml;tten sicher nichts dagegen, hin und
 	wieder ein wenig finanziellen Ausgleich daf&uuml;r zu
 	bekommen.  Aber in keinem Fall bestehen wir darauf.  Wir
 	glauben unsere erste und wichtigste <quote>Mission</quote> ist
 	es, Software f&uuml;r jeden Interessierten und zu jedem Zweck
 	zur Verf&uuml;gung zu stellen, damit die Software
 	gr&ouml;&szlig;tm&ouml;gliche Verbreitung erlangt und
 	gr&ouml;&szlig;tm&ouml;glichen Nutzen stiftet.  Das ist,
 	glaube ich, eines der grundlegenden Ziele freier Software,
 	welche wir mit gr&ouml;&szlig;ter Begeisterung
 	unterst&uuml;tzen.</para>
 
       <indexterm>
 	<primary>GNU General Public License (GPL)</primary>
       </indexterm>
 
       <indexterm>
 	<primary>GNU Lesser General Public License (LGPL)</primary>
       </indexterm>
 
       <indexterm>
 	<primary>BSD Copyright</primary>
       </indexterm>
 
       <para>Der Code in unserem Quellbaum, der unter die General
 	Public License (GPL) oder die Library General Public License
 	(LGPL) f&auml;llt, stellt geringf&uuml;gig mehr Bedingungen.
 	Das aber vielmehr im Sinne von eingefordertem Zugriff, als das
 	&uuml;bliche Gegenteil der Beschr&auml;nkungen.  Aufgrund
 	zus&auml;tzlicher Abh&auml;ngigkeiten, die sich durch die
 	Verwendung von GPL-Software bei kommerziellem Gebrauch
 	ergeben, bevorzugen wir daher Software unter dem
 	transparenteren BSD-Copyright, wo immer es angebracht ist.</para>
     </sect2>
 
     <sect2 id="development">
       <sect2info>
 	<authorgroup>
 	  <author>
 	    <firstname>Satoshi</firstname>
 	    <surname>Asami</surname>
 	    <contrib>Beigesteuert von </contrib>
 	  </author>
 	</authorgroup>
       </sect2info>
 
       <title>Das Entwicklungsmodell von FreeBSD</title>
 
       <indexterm>
 	<primary>FreeBSD Project</primary>
 	<secondary>Entwicklungsmodell</secondary>
       </indexterm>
 
       <para>Die Entwicklung von FreeBSD ist ein offener und
 	vielseitiger Prozess.  FreeBSD besteht aus Beisteuerungen
 	von Hunderten Leuten rund um die Welt, wie Sie aus der
 	<ulink url="&url.articles.contributors.en;/article.html">Liste
 	der Beitragenden</ulink> ersehen k&ouml;nnen.  Die vielen
 	Entwickler k&ouml;nnen aufgrund der Entwicklungs-Infrastruktur
 	von &os; &uuml;ber das Internet zusammenarbeiten.  Wir suchen
 	st&auml;ndig nach neuen Entwicklern, Ideen und jenen, die sich
 	in das Projekt tiefer einbringen wollen.  Nehmen Sie einfach
 	auf der Mailingliste &a.hackers; Kontakt mit uns auf.
 	Die Mailingliste &a.announce; steht f&uuml;r wichtige
 	Ank&uuml;ndigungen, die alle FreeBSD-Benutzer betreffen,
 	zur Verf&uuml;gung.</para>
 
       <para>Unabh&auml;ngig davon ob Sie alleine oder mit
 	anderen eng zusammen arbeiten, enth&auml;lt die folgende
 	Aufstellung n&uuml;tzliche Informationen &uuml;ber das
 	FreeBSD Project und dessen Entwicklungsabl&auml;ufe.</para>
 
       <variablelist>
 	<varlistentry>
 	  <term>Das CVS-Repository<anchor
 	    id="development-cvs-repository"></term>
 
 	  <indexterm>
 	    <primary>CVS</primary>
 	    <secondary>Repository</secondary>
 	  </indexterm>
 
 	  <indexterm>
 	    <primary>Concurrent-Versions-System</primary>
 	    <see>CVS</see>
 	  </indexterm>
 
 	  <listitem>
 	    <para>Der Hauptquellbaum von FreeBSD wird mit <ulink
 	      url="http://ximbiot.com/cvs/wiki/">CVS</ulink> gepflegt, einem
 	      frei erh&auml;ltlichen Versionskontrollsystem, welches
 	      mit FreeBSD geliefert wird.  Das Haupt- <ulink
 	      url="http://www.FreeBSD.org/cgi/cvsweb.cgi">CVS-Repository</ulink>
 	      l&auml;uft auf einer Maschine in
 	      Santa Clara, Kalifornien, USA.  Von dort wird es auf
 	      zahlreiche Server in aller Welt gespiegelt.  Der
 	      CVS-Quellbaum, der die Zweige
 	      <link linkend="current">-CURRENT</link> und
 	      <link linkend="stable">-STABLE</link> enth&auml;lt,
 	      kann einfach auf Ihr eigenes System gespiegelt
 	      werden.  N&auml;heres dazu k&ouml;nnen Sie im Handbuch unter
 	      <link linkend="synching">Synchronisation der Quellen</link>
 	      in Erfahrung bringen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>Die Committer-Liste<anchor
 	    id="development-committers"></term>
 
 	  <indexterm>
 	    <primary>Committer</primary>
 	  </indexterm>
 
 	  <listitem>
 	    <para>Die <firstterm>Committer</firstterm> sind Personen
 	      mit <emphasis>Schreibzugriff</emphasis> auf den
 	      CVS-Quellbaum (der Begriff <quote>Committer</quote>
 	      stammt vom &man.cvs.1;-Befehl <command>commit</command>,
 	      der zum Einspeisen von &Auml;nderungen ins Repository
 	      gebraucht wird).  Der beste Weg, Vorschl&auml;ge zur
 	      Pr&uuml;fung durch die Mitglieder der Committer-Liste
 	      einzureichen, bietet der Befehl &man.send-pr.1;.  Sollte es
 	      unerwartete Probleme mit diesem Verfahren geben, besteht
 	      immer noch die M&ouml;glichkeit eine E-Mail an die Liste
 	      &a.committers; zu schicken.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>Das FreeeBSD-Core-Team<anchor
 	    id="development-core"></term>
 
 	  <indexterm>
 	    <primary>Core-Team</primary>
 	  </indexterm>
 
 	  <listitem>
 	    <para>W&uuml;rde man das FreeBSD Project mit einem
 	      Unternehmen vergleichen, so w&auml;re das
 	      <firstterm>FreeBSD-Core-Team</firstterm> das
 	      Gegenst&uuml;ck zum Vorstand.  Die Hauptaufgabe des
 	      Core-Teams ist es, das Projekt als Ganzes in gesunder
 	      Verfassung zu halten und die weitere Entwicklung in die
 	      richtige Bahn zu lenken.  Das Anwerben leidenschaftlicher
 	      und verantwortungsbewusster Entwickler ist eine
 	      Aufgabe des Core-Team, genauso wie die Rekrutierung
 	      neuer Mitglieder f&uuml;r das Core-Team, im Falle, dass
 	      Altmitglieder aus dem Projekt aussteigen.  Das
 	      derzeitige Core-Team wurde im Juli&nbsp;2006 aus einem Kreis
 	      kandidierender Committer gew&auml;hlt.  Wahlen
 	      werden alle zwei Jahre abgehalten.</para>
 
 	    <para>Einige Core-Team-Mitglieder haben auch spezielle
 	      Verantwortungsbereiche.  Das bedeutet, sie haben sich
 	      darauf festgelegt, sicherzustellen, dass ein
 	      gr&ouml;&szlig;erer Teil des Systems so funktioniert wie
 	      ausgewiesen.  Eine vollst&auml;ndige Liste an FreeBSD
 	      beteiligter Entwickler und ihrer Verantwortungsbereiche
 	      kann in der <ulink
 	      url="&url.articles.contributors.en;/article.html">Liste der
 	      Beitragenden</ulink> eingesehen werden.</para>
 
 	    <note>
 	      <para>Die Mehrzahl der Mitglieder des Core-Teams sind
 		Freiwillige in Bezug auf die FreeBSD-Entwicklung und
 		profitieren nicht finanziell vom Projekt.  Daher
 		sollte <quote>Verpflichtung</quote> nicht als
 		<quote>garantierter Support</quote> fehlinterpretiert
 		werden.  Der oben angef&uuml;hrte Vergleich mit einem
 		Vorstand hinkt und es w&auml;re angebrachter zu
 		erw&auml;hnen, dass diese Leute &ndash; wider besseres
 		Wissen &ndash; ihr eigenes Leben f&uuml;r FreeBSD
 		aufgegeben haben!</para>
 	    </note>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>Weitere Beitragende</term>
 
 	  <indexterm>
 	    <primary>Beitragende</primary>
 	  </indexterm>
 
 	  <listitem>
 	    <para>Die gr&ouml;&szlig;te Entwicklergruppe sind
 	      nicht zuletzt die Anwender selbst, die
 	      R&uuml;ckmeldungen und Fehlerbehebungen in einem anhaltend
 	      hohen Ma&szlig;e an uns senden.  Der bevorzugte Weg an
 	      dem weniger zentralisierten Bereich der
 	      FreeBSD-Entwicklung teilzuhaben, ist die
 	      M&ouml;glichkeit sich bei der Liste &a.hackers;
 	      anzumelden.  Weitere Informationen &uuml;ber die
 	      verschiedenen FreeBSD-Mailinglisten erhalten Sie in
 	      <xref linkend="eresources">.</para>
 
 	    <para><citetitle><ulink
 	      url="&url.articles.contributors.en;/article.html">Die Liste
 	      der zu FreeBSD Beitragenden</ulink></citetitle> ist eine
 	      lange und wachsende.  Also warum nicht selbst dort
 	      stehen, indem Sie gleich pers&ouml;nlich etwas zu
 	      FreeBSD beitragen?</para>
 
 	    <para>Quellcode ist nicht der einzige Weg, etwas zum
 	      Projekt beizusteuern.  Eine genauere &Uuml;bersicht
 	      &uuml;ber offene Aufgaben finden Sie auf der <ulink
 	      url="&url.base;/index.html">FreeBSD-Web-Site</ulink>.</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
 
       <para>Zusammengefasst bildet unser Entwicklungsmodell einen
 	losen Verbund konzentrischer Kreise.  Das zentralisierte
 	Modell ist auf die Bed&uuml;rfnisse der
 	<emphasis>Anwender</emphasis> zugeschnitten, mit der einfachen
 	M&ouml;glichkeit eine zentrale Code-Basis zu verfolgen und
 	m&ouml;glichen neuen Beitragenden nicht das Leben zu
 	erschweren!  Unser Ziel ist es, ein stabiles Betriebssystem mit
 	einer gro&szlig;en Zahl passender
 	<link linkend="ports">Programme</link> zu bieten, die der Anwender
 	leicht installieren und anwenden kann.  Und dieses Modell
 	funktioniert f&uuml;r diese Aufgabe ziemlich gut.</para>
 
       <para>Das Einzige was wir von m&ouml;glichen neuen Mitgliedern
 	fordern, ist die gleiche Hingabe, mit der die jetzigen
 	Mitglieder am dauerhaften Erfolg arbeiten!</para>
     </sect2>
 
     <sect2 id="relnotes">
       <title>Das aktuelle FreeBSD-Release</title>
 
       <indexterm>
 	<primary>NetBSD</primary>
       </indexterm>
 
       <indexterm>
 	<primary>OpenBSD</primary>
       </indexterm>
 
       <indexterm>
 	<primary>386BSD</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Free Software Foundation</primary>
       </indexterm>
 
       <indexterm>
 	<primary>U.C. Berkeley</primary>
       </indexterm>
 
       <indexterm>
 	<primary>Computer Systems Research Group (CSRG)</primary>
       </indexterm>
 
       <para>FreeBSD ist ein (mit vollem Quellcode und ein frei
 	erh&auml;ltliches) auf 4.4BSD-Lite-basierendes Release
 	f&uuml;r Intel &i386;, &i486;, &pentium;,
 	&pentium;&nbsp;Pro,
 	&celeron;,
 	&pentium;&nbsp;II,
 	&pentium;&nbsp;III,
 	&pentium;&nbsp;4 (oder ein dazu kompatibler Prozessor),
 	&xeon;, DEC <trademark>Alpha</trademark> und
 	Sun &ultrasparc; Systeme.
 	Es st&uuml;tzt sich zum gr&ouml;&szlig;ten
 	Teil auf Software der Computer Systems Research Group (CSRG)
 	der Universit&auml;t von Kalifornien in Berkeley mit einigen
 	Verbesserungen aus NetBSD, OpenBSD, 386BSD und der Free
 	Software Foundation.</para>
 
       <para>Seit unserem FreeBSD&nbsp;2.0 von Ende 1994 hat sich
 	Leistung, Funktionsvielfalt und Stabilit&auml;t dramatisch
 	verbessert.
 	<!-- XXX is the rest of this paragraph still true ? -->
 	Die gr&ouml;&szlig;te &Auml;nderung erfuhr das virtuelle
 	Speichermanagement durch eine Kopplung von virtuellem Speicher
 	und dem Buffer-Cache, das nicht nur die Leistung
 	steigert, sondern auch den Hauptspeicherverbrauch reduziert
 	und ein 5&nbsp;MB-System zu einem nutzbaren Minimal-System
 	verhilft.  Weitere Verbesserungen sind volle NIS-Client- und
 	Server-Unterst&uuml;tzung, T/TCP, Dial-On-Demand-PPP,
 	integriertes DHCP, ein verbessertes SCSI-Subsystem,
 	ISDN-Support, Unterst&uuml;tzung f&uuml;r ATM-, FDDI-, Fast-
 	und Gigabit-Ethernet-Karten (1000&nbsp;Mbit), verbesserter
 	Support der neusten Adaptec-Controller und tausende
 	Fehlerkorrekturen.</para>
 
       <para>Zus&auml;tzlich zur Standard-Distribution bietet FreeBSD
 	eine Sammlung von portierter Software mit tausenden begehrten
 	Programmen.  Zum Verfassungszeitpunkt waren &uuml;ber
 	&os.numports;  Anwendungen in der Ports-Sammlung!  Das Spektrum
 	der Ports-Sammlung reicht von HTTP-Servern &uuml;ber Spiele,
 	Programmiersprachen, Editoren und so ziemlich allem
 	dazwischen.  Die gesamte Ports-Sammlung ben&ouml;tigt
 	&ports.size; an Speicherplatz, wobei jeder Port anhand eines
 	<quote>Deltas</quote> zu den Quellen angegeben wird.  Das
 	macht es f&uuml;r uns erheblich leichter, Ports zu
 	aktualisieren und es verringert den Plattenbedarf im Vergleich
 	zur &auml;lteren 1.0-Port-Sammlung.  Um ein Port zu
 	&uuml;bersetzen, m&uuml;ssen Sie einfach ins Verzeichnis des
 	Programms wechseln und ein <command>make install</command>
 	absetzen.  Den Rest erledigt das System.  Die originalen
 	Quellen jedes zu installierenden Port werden dynamisch von
 	CD-ROM oder einem FTP-Server bezogen.  Es reicht also f&uuml;r
 	gen&uuml;gend Plattenplatz zu sorgen, um die gew&uuml;nschten
 	Ports zu erstellen.  Allen, die Ports nicht selbst kompilieren
 	wollen:  Es gibt zu fast jedem Port ein vorkompiliertes
 	Paket, das einfach mit dem Befehl (<command>pkg_add</command>)
 	installiert wird.  Pakete und Ports werden in
 	<xref linkend="ports"> beschrieben.</para>
 
       <para>Eine Reihe von weiteren Dokumenten, die sich als hilfreich
 	bei der Installation oder dem Arbeiten mit FreeBSD erweisen
 	k&ouml;nnten, liegen auf neueren &os;-Systemen im Verzeichnis
 	<filename>/usr/share/doc</filename>.  Die lokal installierten
 	Anleitungen lassen sich mit jedem HTML-f&auml;higen Browser
 	unter folgenden Adressen betrachten:</para>
 
       <variablelist>
 	<varlistentry>
 	  <term>Das FreeBSD-Handbuch</term>
 
 	  <listitem>
 	    <para><ulink type="html"
 	      url="file://localhost/usr/share/doc/handbook/index.html"><filename>/usr/share/doc/handbook/index.html</filename></ulink></para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>Die FreeBSD-FAQ</term>
 
 	  <listitem>
 	    <para><ulink type="html"
 	      url="file://localhost/usr/share/doc/faq/index.html"><filename>/usr/share/doc/faq/index.html</filename></ulink></para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
 
       <para>Es besteht auch die M&ouml;glichkeit, sich die jeweils
         aktuellste Version der Referenzdokumente unter <ulink
         url="http://www.FreeBSD.org"></ulink> anzusehen.</para>
     </sect2>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/porters-handbook/book.sgml b/de_DE.ISO8859-1/books/porters-handbook/book.sgml
index 231d68ceb6..38c7c90783 100644
--- a/de_DE.ISO8859-1/books/porters-handbook/book.sgml
+++ b/de_DE.ISO8859-1/books/porters-handbook/book.sgml
@@ -1,13981 +1,14023 @@
 <!--
     The FreeBSD Documentation Project
     The FreeBSD German Documentation Project
 
     $FreeBSD$
-    $FreeBSDde: de-docproj/books/porters-handbook/book.sgml,v 1.139 2007/10/19 09:09:01 jkois Exp $
-    basiert auf: 1.878
+    $FreeBSDde: de-docproj/books/porters-handbook/book.sgml,v 1.142 2007/11/09 08:21:44 jkois Exp $
+    basiert auf: 1.885
 -->
 
 <!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 <!ENTITY % books.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Books Entity Set//DE">
 %books.ent;
 ]>
 
 <book id="of" lang="de">
   <bookinfo>
     <title>Das FreeBSD Porter-Handbuch</title>
 
     <authorgroup>
       <corpauthor>The FreeBSD German Documentation Project</corpauthor>
     </authorgroup>
 
     <pubdate>April 2000</pubdate>
 
     <copyright>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <holder role="mailto:doc@FreeBSD.org">The FreeBSD German
        Documentation Project</holder>
     </copyright>
 
     &bookinfo.trademarks;
     &bookinfo.legalnotice;
   </bookinfo>
 
   <chapter id="why-port">
     <title>Einf&uuml;hrung</title>
 
     <para>Die Ports-Sammlung von FreeBSD ist der gebr&auml;uchlichste
       Weg, um Anwendungen ("Ports") unter FreeBSD zu installieren.
       Wie alles andere in FreeBSD auch, ist sie haupts&auml;chlich
       das Ergebnis der Arbeit von Freiwilligen. Es ist wichtig,
       diesen Aspekt beim Lesen im Hinterkopf zu behalten.</para>
 
     <para>In FreeBSD kann jeder einen neuen Port einsenden oder sich
       dazu bereit erkl&auml;ren, einen bereits vorhandenen Port zu
       pflegen, sofern der Port derzeit keinen Maintainer
       hat&nbsp;&ndash;&nbsp;dazu sind keine besonderen Rechte
       n&ouml;tig.</para>
   </chapter>
 
   <chapter id="own-port">
     <title>Einen neuen Port erstellen</title>
 
     <para>Sie sind also daran interessiert, einen neuen Port zu
       erstellen oder einen vorhandenen zu aktualisieren?
       Gro&szlig;artig!</para>
 
     <para>Die folgenden Kapitel beinhalten einige Richtlinien, um
       einen neuen Port f&uuml;r FreeBSD zu erstellen. Wenn Sie
       einen vorhandenen Port auf den neuesten Stand bringen
       wollen, sollten Sie mit <xref linkend="port-upgrading">
       fortfahren.</para>
 
     <para>Wenn Ihnen dieses Dokument nicht detailliert genug ist,
       sollten Sie einen Blick in
       <filename>/usr/ports/Mk/bsd.port.mk</filename> werfen. Das
       Makefile jedes Ports bindet diese Datei ein. Auch wenn Sie
       nicht t&auml;glich mit Makefiles arbeiten, sollten Sie gut
       damit zurecht kommen, da die Datei gut dokumentiert ist und
       Sie eine Menge Wissen daraus erlangen k&ouml;nnen.
       Zus&auml;tzlich k&ouml;nnen Sie speziellere Fragen an die
       &a.ports;-Mailingliste stellen.</para>
 
     <note>
       <para>Nur ein Bruchteil der Variablen
 	(<makevar><replaceable>VAR</replaceable></makevar>), die von
 	Ihnen gesetzt werden k&ouml;nnen, finden hier
 	Erw&auml;hnung. Die meisten von ihnen (wenn nicht sogar
 	alle) sind am Anfang von
 	<filename>/usr/ports/Mk/bsd.port.mk</filename>
 	erl&auml;utert. Beachten Sie bitte, dass diese Datei eine
 	nicht standardkonforme Tabulator-Einstellung
 	verwendet. <application>Emacs</application> und
 	<application>Vim</application> sollten diese Einstellung
 	jedoch automatisch beim &Ouml;ffnen der Datei setzen. Sowohl
 	&man.vi.1; als auch &man.ex.1; k&ouml;nnen mit dem Befehl
 	<command>:set tabstop=4</command> dazu gebracht werden, die
 	Datei richtig anzuzeigen, wenn sie ge&ouml;ffnet wird.</para>
     </note>
   </chapter>
 
   <chapter id="quick-porting">
     <title>Port erstellen auf die Schnelle</title>
 
     <para>Dieser Abschnitt beschreibt, wie Sie schnell einen Port
       erstellen k&ouml;nnen. In vielen F&auml;llen ist dies
       allerdings nicht ausreichend, dann werden Sie in diesem Buch
       weiterlesen m&uuml;ssen.</para>
 
     <para>Als Erstes besorgen Sie sich das Original-Tarball
       (komprimiertes Archiv) und legen es im
       <makevar>DISTDIR</makevar> ab, welches
       standardm&auml;&szlig;ig
       <filename>/usr/ports/distfiles</filename> ist.</para>
 
     <note>
       <para>Im Folgenden wird angenommen, dass die Software
 	unver&auml;ndert kompiliert werden konnte, dass also keinerlei
 	&Auml;nderungen n&ouml;tig waren, um den Port auf Ihrem
 	FreeBSD-Rechner zum Laufen zu bringen. Falls Sie
 	&Auml;nderungen vornehmen mussten, werden Sie auch den
 	n&auml;chsten Abschnitt beachten m&uuml;ssen.</para>
     </note>
 
     <sect1 id="porting-makefile">
       <title>Das <filename>Makefile</filename> schreiben</title>
 
       <para>Ein minimales <filename>Makefile</filename> sieht in etwa
 	so aus:</para>
 
 	<programlisting># New ports collection makefile for:   oneko
 # Date created:        5 December 1994
 # Whom:                asami
 #
 # &dollar;FreeBSD&dollar;
 #
 
 PORTNAME=      oneko
 PORTVERSION=   1.1b
 CATEGORIES=    games
 MASTER_SITES=  ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/
 
 MAINTAINER=    asami@FreeBSD.org
 COMMENT=       A cat chasing a mouse all over the screen
 
 MAN1=          oneko.1
 MANCOMPRESSED= yes
 USE_IMAKE=     yes
 
 .include &lt;bsd.port.mk&gt;</programlisting>
 
       <para>Versuchen Sie es zu verstehen. Machen Sie sich keine
 	Gedanken um die
 	<literal>&dollar;FreeBSD&dollar;</literal>-Zeile, diese wird
 	automatisch vom CVS eingef&uuml;gt, wenn der Port in den
 	Haupt-Ports-Tree importiert wird. Ein detailliertes Beispiel
 	finden Sie im Abschnitt
 	<link linkend="porting-samplem">sample Makefile</link>.</para>
     </sect1>
 
     <sect1 id="porting-desc">
       <title>Die Beschreibungsdateien erstellen</title>
 
       <para>Es gibt zwei Beschreibungsdateien, die f&uuml;r jeden Port
 	ben&ouml;tigt werden, ob sie tats&auml;chlich im Paket
 	enthalten sind oder nicht. Dies sind
 	<filename>pkg-descr</filename> und
 	<filename>pkg-plist</filename>. Der <filename>pkg-</filename>
 	Pr&auml;fix unterscheidet sie von anderen Dateien.</para>
 
       <sect2>
 	<title><filename>pkg-descr</filename></title>
 
 	<para>Diese enth&auml;lt eine l&auml;ngere Beschreibung des
 	  Ports. Einer oder mehrere Abs&auml;tze, die kurz und
 	  pr&auml;gnant erkl&auml;ren, was der Port macht, sind
 	  ausreichend.</para>
 
 	<note>
 	  <para><filename>pkg-descr</filename> enth&auml;lt
 	    <emphasis>keine</emphasis> Anleitung oder detaillierte
 	    Beschreibung wie der Port benutzt oder kompiliert wird!
 	    <emphasis>Bitte seien Sie vorsichtig, wenn Sie aus dem
 	    <filename>README</filename> oder der Manualpage kopieren
 	    </emphasis>; Diese sind oft keine pr&auml;gnanten
 	    Beschreibungen des Ports oder sie sind in einem
 	    ung&uuml;nstigen Format (Manualpages haben z.B.
 	    b&uuml;ndige Zwischenr&auml;ume). Wenn es f&uuml;r die
 	    portierte Software eine offizielle Webseite gibt, sollten
 	    Sie diese hier angeben. F&uuml;gen Sie hierzu
 	    <emphasis>eine</emphasis> der Webseiten mit dem
 	    Pr&auml;fix <literal>WWW:</literal> ein, damit
 	    automatische Werkzeuge korrekt arbeiten.</para>
 	</note>
 
 	<para>Das folgende Beispiel zeigt wie Ihre
 	  <filename>pkg-descr</filename> aussehen sollte:</para>
 
 	<programlisting>This is a port of oneko, in which a cat chases a poor mouse all over
 the screen.
  :
 (etc.)
 
 WWW: http://www.oneko.org/</programlisting>
       </sect2>
 
       <sect2>
 	<title><filename>pkg-plist</filename></title>
 
 	<para>Diese Datei enth&auml;lt eine Liste aller Dateien, die
 	  von diesem Port installiert werden. Sie wird auch die
 	  <quote>Packliste</quote> genannt, da das Paket durch die
 	  hier aufgef&uuml;hrten Dateien erstellt wird. Die
 	  Pfadangaben sind relativ zum Installationspr&auml;fix
 	  (f&uuml;r gew&ouml;hnlich <filename>/usr/local</filename>
 	  oder <filename>/usr/X11R6</filename>). Wenn Sie die
 	  <makevar>MAN<replaceable>n</replaceable></makevar>-Variablen
 	  verwenden (was Sie auch machen sollten), f&uuml;hren Sie hier
 	  keine Manualpages auf. Wenn der Port w&auml;hrend der
 	  Installation Verzeichnisse erstellt, stellen Sie sicher
 	  entsprechende <literal>@dirrm</literal>-Zeilen
 	  einzuf&uuml;gen, um die Verzeichnisse zu entfernen, wenn das
 	  Paket gel&ouml;scht wird.</para>
 
 	<para>Hier ist ein kleines Beispiel:</para>
 
 	<programlisting>bin/oneko
 lib/X11/app-defaults/Oneko
 lib/X11/oneko/cat1.xpm
 lib/X11/oneko/cat2.xpm
 lib/X11/oneko/mouse.xpm
 @dirrm lib/X11/oneko</programlisting>
 
 	<para>F&uuml;r weitere Details zur Packliste lesen Sie in der
 	  &man.pkg.create.1; Manualpage nach.</para>
 
 	<note>
 	  <para>Es wird empfohlen alle Dateinamen in dieser Datei
 	    alphabetisch sortiert zu halten. Das erlaubt Ihnen die
 	    &Auml;nderungen bei einem Upgrade Ihres Ports deutlich
 	    einfacher zu &Uuml;berpr&uuml;fen.</para>
 	</note>
 
 	<note>
 	  <para>Eine Packlist von Hand zu erzeugen kann eine sehr
 	    m&uuml;hsame Aufgabe sein. Wenn der Port eine gro&szlig;e
 	    Anzahl Dateien installiert, kann es Zeit sparen,
 	    <link linkend="plist-autoplist">eine Packliste automatisch
 	    zu erstellen</link>.</para>
 	</note>
 
 	<para>Es gibt nur einen Fall, in dem
 	  <filename>pkg-plist</filename> weggelassen werden kann.
 	  Wenn der Port nur eine handvoll Dateien und Verzeichnisse
 	  installiert, k&ouml;nnen diese in den Variablen
 	  <makevar>PLIST_FILES</makevar> und
 	  <makevar>PLIST_DIRS</makevar> im
 	  <filename>Makefile</filename> aufgelistet werden. Zum
 	  Beispiel k&ouml;nnten wir im obigen Beispiel ohne
 	  <filename>pkg-plist</filename> f&uuml;r den
 	  <filename>oneko</filename>-Port auskommen, indem wir die
 	  folgenden Zeilen ins <filename>Makefile</filename>
 	  einf&uuml;gen:</para>
 
 	<programlisting>PLIST_FILES=    bin/oneko \
                 lib/X11/app-defaults/Oneko \
                 lib/X11/oneko/cat1.xpm \
                 lib/X11/oneko/cat2.xpm \
                 lib/X11/oneko/mouse.xpm
 PLIST_DIRS=     lib/X11/oneko</programlisting>
 
 	<para>Nat&uuml;rlich sollte <makevar>PLIST_DIRS</makevar>
 	  ungesetzt bleiben, wenn der Port keine eigenen Verzeichnisse
 	  installiert.</para>
 
 	<para>Der Preis f&uuml;r diese Art die Dateien eines Ports
 	  anzugeben ist, dass man keine Befehlsfolgen wie in
 	  &man.pkg.create.1; nutzen kann. Deshalb ist es nur
 	  f&uuml;r einfache Ports geeignet und macht diese noch
 	  einfacher. Gleichzeitig bringt es den Vorteil die Anzahl
 	  der Dateien in der Ports-Sammlung zu reduzieren. Deshalb
 	  ziehen Sie bitte diese Vorgehensweise in Erw&auml;gung,
 	  bevor Sie <filename>pkg-plist</filename> benutzen.</para>
 
 	<para>Sp&auml;ter werden wir uns ansehen, wie
 	  <filename>pkg-plist</filename> und
 	  <makevar>PLIST_FILES</makevar> benutzt werden k&ouml;nnen,
 	  um <link linkend="plist">anspruchsvollere Aufgaben</link> zu
 	  erf&uuml;llen.</para>
       </sect2>
     </sect1>
 
     <sect1 id="porting-checksum">
       <title>Die Checksummendatei erzeugen</title>
 
       <para>Geben Sie einfach <command>make makesum</command> ein.
 	Die Regeln von Make sorgen daf&uuml;r, dass die Datei
 	<filename>distinfo</filename> automatisch erstellt
 	wird.</para>
 
       <para>Wenn sich die Checksumme einer heruntergeladenen Datei
 	regelm&auml;&szlig;ig &auml;ndert und Sie sicher sind, dass
 	Sie der Quelle trauen k&ouml;nnen (weil sie z.B. von einer
 	Hersteller-CD oder t&auml;glich erstellter Dokumentation
 	stammt), sollten Sie diese Dateien in der Variable
 	<makevar>IGNOREFILES</makevar> angeben. Dann wird die
 	Checksumme f&uuml;r diese Datei bei
 	<command>make makesum</command> nicht berechnet, sondern auf
 	<literal>IGNORE</literal> gesetzt.</para>
     </sect1>
 
     <sect1 id="porting-testing">
       <title>Den Port testen</title>
 
       <para>Sie sollten sicherstellen, dass die Port-Regeln genau das
 	einhalten, was Sie von ihnen erwarten, auch beim Erzeugen eines
 	Pakets aus dem Port. Dies sind die wichtigen Punkte, die Sie
 	&uuml;berpr&uuml;fen sollten.</para>
 
       <itemizedlist>
 	<listitem>
 	  <para><filename>pkg-plist</filename> enth&auml;lt nichts,
 	    das nicht von Ihrem Port installiert wurde.</para>
 	</listitem>
 
 	<listitem>
 	  <para><filename>pkg-plist</filename> enth&auml;lt alles,
 	    was von Ihrem Port installiert wurde.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Ihr Port kann mit Hilfe von
 	    <command>make reinstall</command> mehrmals installiert
 	    werden.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Ihr Port
 	    <link linkend="plist-cleaning">r&auml;umt</link> bei der
 	    Deinstallation hinter sich auf.</para>
 	</listitem>
       </itemizedlist>
 
       <procedure>
 	<title>Empfohlene Testreihenfolge</title>
 
 	<step>
 	  <para><command>make install</command></para>
 	</step>
 
 	<step>
 	  <para><command>make package</command></para>
 	</step>
 
 	<step>
 	  <para><command>make deinstall</command></para>
 	</step>
 
 	<step>
 	  <para><command>pkg_add <replaceable>Paket-Name</replaceable>
 	    </command></para>
 	</step>
 
 	<step>
 	  <para><command>make deinstall</command></para>
 	</step>
 
 	<step>
 	  <para><command>make reinstall</command></para>
 	</step>
 
 	<step>
 	  <para><command>make package</command></para>
 	</step>
       </procedure>
 
       <para>Stellen Sie bitte sicher, dass w&auml;hrend
 	<command>make package</command> und
 	<command>make deinstall</command> keine Warnungen ausgegeben
 	werden. Nach Schritt 3 &uuml;berpr&uuml;fen Sie bitte, ob alle
 	neuen Verzeichnisse korrekt entfernt wurden. Und versuchen Sie
 	die Software nach Schritt 4 zu benutzen, um sicherzustellen,
 	dass sie korrekt funktioniert, wenn diese aus einem Paket
 	installiert wird.</para>
 
       <para>Der gr&uuml;ndlichste Weg diese Schritte zu automatisieren
 	ist eine <application>Tinderbox</application> zu installieren.
 	Diese verwaltet <literal>Jails</literal>, in denen Sie alle
 	oben genannten Schritte durchf&uuml;hren k&ouml;nnen, ohne den
 	Zustand Ihres laufenden Systems zu ver&auml;ndern. Mehr
 	Informationen hierzu ent&auml;lt
 	<filename>ports/ports-mgmt/tinderbox</filename></para>
     </sect1>
 
     <sect1 id="porting-portlint">
       <title>Ihren Port mit <command>portlint</command>
 	&uuml;berpr&uuml;fen</title>
 
       <para>Bitte verwenden Sie <command>portlint</command>, um
 	festzustellen, ob Ihr Port unseren Richtlinien entspricht.
 	Das Programm
 	<filename role="package">ports-mgmt/portlint</filename> ist
 	Teil der Ports-Sammlung. Stellen Sie vor allem sicher, dass
 	das <link linkend="porting-samplem">Makefile</link> in der
 	richtigen Form und das
 	<link linkend="porting-pkgname">Paket</link> passend benannt
 	ist.</para>
     </sect1>
 
     <sect1 id="porting-submitting">
       <title>Den Port einreichen</title>
 
       <para>Als Erstes sorgen Sie bitte daf&uuml;r, dass Sie den
 	Abschnitt <link linkend="porting-dads">DOs and DON'Ts</link>
 	gelesen haben.</para>
 
       <para>Nun, da Sie mit Ihrem Port zufrieden sind, m&uuml;ssen Sie
 	ihn nur noch in den Haupt-Ports-Tree von FreeBSD einbringen,
 	damit alle daran teilhaben k&ouml;nnen. Wir ben&ouml;tigen
 	nicht Ihr <filename>work</filename>-Verzeichnis oder Ihr
 	<filename>pkgname.tgz</filename>-Paket&nbsp;&ndash;&nbsp;diese
 	k&ouml;nnen Sie nun l&ouml;schen. Als N&auml;chstes f&uuml;gen
 	Sie bitte einfach die Ausgabe von
 	<command>shar `find port_dir`</command> in einen Fehlerbericht
 	(PR - Problem Report) und senden diesen mittels
 	&man.send-pr.1; (unter <ulink
 	url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">
 	Bug Reports and General Commentary</ulink> finden Sie weitere
 	Informationen &uuml;ber &man.send-pr.1;). Ordnen Sie den
 	Fehlerbericht bitte in die Kategorie <literal>Ports</literal>
 	mit der Klasse <literal>Change-Request</literal> ein
 	(Markieren Sie den Bericht nicht als
 	<literal>vertraulich</literal>
 	(<literal>confidential</literal>)!). F&uuml;gen Sie bitte eine
 	kurze Beschreibung des Programms, das Sie portiert haben, in
 	das <quote>Beschreibungs</quote>-Feld des Problemberichts und
 	das Shar (Shell-Archiv) in das <quote>Fix</quote>-Feld
 	ein.</para>
 
       <note>
 	<para>Sie k&ouml;nnen uns die Arbeit um einiges vereinfachen,
 	  wenn Sie eine gute Beschreibung in der Zusammenfassung des
 	  Problemberichtes verwenden. Wir bevorzugen etwas wie
 	  <quote>Neuer Port:
 	  &lt;Kategorie&gt;/&lt;Portname&gt;&lt;Kurzbeschreibung des
 	  Ports&gt;</quote> f&uuml;r neue Ports und <quote>Update
 	  Port: &lt;Kategorie&gt;/&lt;Portname&gt;
 	  &lt;Kurzbeschreibung des Updates&gt;</quote> f&uuml;r
 	  Portupdates. Wenn Sie sich an dieses Schema halten, ist die
 	  Chance, dass sich jemand bald Ihren Bericht ansieht,
 	  deutlich besser.</para>
       </note>
 
       <para>Noch einmal: <emphasis>Bitte f&uuml;gen Sie nicht das
 	distfile der Originalquelle, das
 	<filename>work</filename>-Verzeichnis oder das Paket, das Sie mit
 	<command>make package</command> erstellt haben, ein.
 	</emphasis></para>
 
       <para>Haben Sie bitte etwas Geduld, nachdem Sie den Port
 	eingereicht haben. Manchmal kann es einige Monate dauern,
 	bevor ein Port in FreeBSD eingef&uuml;gt wird, obwohl es
 	wahrscheinlich nur ein paar Tage dauert. Sie k&ouml;nnen sich
 	die <ulink
 	url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports">
 	Liste der Ports, die darauf warten in FreeBSD committet zu
 	werden</ulink>, ansehen.</para>
 
       <para>Nachdem wir einen Blick auf Ihren Port geworfen haben,
 	werden wir, wenn n&ouml;tig, bei Ihnen nachfragen und ihn in
 	die Ports-Sammlung &uuml;bernehmen. Ihr Name taucht dann auch
 	in der Liste der <ulink
 	url="&url.articles.contributors;/contrib-additional.html">Additional
 	FreeBSD Contributors</ulink> und in anderen Dateien auf.
 	Ist das nicht toll?! <!-- smiley -->:-)</para>
     </sect1>
   </chapter>
 
   <chapter id="slow">
     <title>Einen Port in aller Ruhe erstellen</title>
 
     <para>Ok, das war nicht ganz einfach und der Port hat einige
       Ver&auml;nderungen erfordert, um funktionieren zu k&ouml;nnen.
       In diesem Abschnitt werden wir Schritt f&uuml;r Schritt
       erkl&auml;ren, wie man den funktionierenden Port den Vorgaben
       der Ports entsprechend anpasst.</para>
 
     <sect1 id="slow-work">
       <title>Die Funktionsweise</title>
 
       <para>Beginnen wir mit der Abfolge der Ereignisse, die
 	eintreten, wenn der Nutzer das erste <command>make</command>
 	in Ihrem Portsverzeichnis ausf&uuml;hrt. Sie empfinden es
 	f&uuml;r das Verst&auml;ndnis vielleicht hilfreich
 	<filename>bsd.port.mk</filename> in einem anderen Fenster
 	offen zu haben, w&auml;hrend Sie diesen Abschnitt
 	lesen.</para>
 
       <para>Aber machen Sie sich keine Sorgen, falls Sie nicht
 	wirklich verstehen, was <filename>bsd.port.mk</filename>
 	macht, die Wenigsten begreifen dies... <!-- smiley -->
 	<emphasis>:&gt;</emphasis></para>
 
       <procedure>
 	<step>
 	  <para>Das Target <maketarget>fetch</maketarget> wird
 	    aufgerufen. Es ist daf&uuml;r verantwortlich
 	    sicherzustellen, dass der Tarball lokal im
 	    <makevar>DISTDIR</makevar> verf&uuml;gbar ist. Falls
 	    <maketarget>fetch</maketarget> die ben&ouml;tigten Dateien
 	    in <makevar>DISTDIR</makevar> nicht finden kann,
 	    durchsucht es die URL <makevar>MASTER_SITES</makevar>,
 	    welche im Makefile gesetzt ist, ebenso wie unsere
 	    Haupt-FTP-Seite unter <ulink
 	    url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles">
             ftp://ftp.freebsd.org/pub/FreeBSD/ports/distfiles/
 	    </ulink>, wo wir genehmigte Distfiles als Backup
 	    aufbewahren. Danach wird versucht, so eine direkte
 	    Internetverbindung besteht, dass genannte Distfile mit
 	    <makevar>FETCH</makevar> herunterzuladen. Falls dies
 	    gelingt, wird die Datei in <makevar>DISTDIR</makevar>
 	    f&uuml;r weitere Nutzung abgelegt und f&auml;hrt
 	    fort.</para>
 	</step>
 
 	<step>
 	  <para>Das Target <maketarget>extract</maketarget> wird
 	    aufgerufen. Es sucht nach den Distfiles Ihres Ports
 	    (normalerweise ein gzip-komprimierter Tarball) in
 	    <makevar>DISTDIR</makevar> und entpackt diese in ein
 	    tempor&auml;res Unterverzeichnis, welches von <makevar>
 	    WRKDIR</makevar> festgelegt wird (standardm&auml;&szlig;ig
 	    <filename>work</filename>).</para>
 	</step>
 
 	<step>
 	  <para>Das Target <maketarget>patch</maketarget> wird
 	    aufgerufen. Zuerst werden alle in
 	    <makevar>PATCHFILES</makevar> festgelegten Patches
 	    eingespielt. Anschlie&szlig;end werden, falls Patches der
 	    Form
 	    <filename>patch-<replaceable>*</replaceable></filename> in
 	    <makevar>PATCHDIR</makevar> (standardm&auml;&szlig;ig das
 	    <filename>files</filename>-Unterverzeichnis) gefunden
 	    werden, diese in alphabetischer Reihenfolge
 	    eingespielt.</para>
 	</step>
 
 	<step>
 	  <para>Das Target <maketarget>configure</maketarget> wird
 	    aufgerufen. Dieses kann viele verschiedene Dinge
 	    machen.</para>
 
 	  <orderedlist>
 	    <listitem>
 	      <para>Existiert <filename>scripts/configure</filename>,
 		so wird es aufgerufen.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Falls <makevar>HAS_CONFIGURE</makevar> oder
 		<makevar>GNU_CONFIGURE</makevar> gesetzt sind, wird
 		<filename><makevar>WRKSRC</makevar>/configure
 		</filename>ausgef&uuml;hrt.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Falls <makevar>USE_IMAKE</makevar> gesetzt ist,
 		wird <makevar>XMKMF</makevar>
 		(standardm&auml;&szlig;ig <command>xmkmf -a</command>)
 		ausgef&uuml;hrt.</para>
 	    </listitem>
 	  </orderedlist>
 	</step>
 
 	<step>
 	  <para>Das Target <maketarget>build</maketarget> wird
 	    aufgerufen. Es ist f&uuml;r das Wechseln in das private
 	    Arbeitsverzeichnis (<makevar>WRKSRC</makevar>) und das
 	    Bauen des Ports zust&auml;ndig. Ist
 	    <makevar>USE_GMAKE</makevar> gesetzt, so wird GNU
 	    <command>make</command> verwendet, sonst das
 	    System-<command>make</command>.</para>
 	</step>
       </procedure>
 
       <para>Die oben genannten Schritte sind die Standardaktionen.
 	Zus&auml;tzlich k&ouml;nnen Sie <maketarget>pre-<replaceable>
 	irgendwas</replaceable></maketarget> oder
 	<maketarget>post-<replaceable>irgendwas</replaceable>
 	</maketarget> als Targets definieren oder Skripten mit diesen
 	Namen in das <filename>scripts</filename>-Unterverzeichnis
 	legen. Sie werden dann vor bzw. nach den Standardaktionen
 	aufgerufen.</para>
 
       <para>Angenommen Sie haben das Target <maketarget>post-extract
 	</maketarget> in Ihrem <filename>Makefile</filename>
 	definiert und eine Datei <filename>pre-build</filename> im
 	<filename>scripts</filename> Unterverzeichnis, so wird das
 	Target <maketarget>post-extract</maketarget> nach dem normalen
 	Entpacken aufgerufen und das Skript
 	<filename>pre-build</filename>
 	ausgef&uuml;hrt, bevor die vordefinierten Bau-Regeln
 	abgearbeitet sind. Es wird empfohlen, dass Sie
 	<filename>Makefile</filename>-Targets verwenden, falls die
 	Aktionen es erlauben, da es so f&uuml;r jemanden einfacher
 	sein wird herauszufinden, was f&uuml;r eine
 	nicht-standardm&auml;&szlig;ige Aktion der Port
 	ben&ouml;tigt.</para>
 
       <para>Die Standardaktionen werden aus den Targets
 	<filename>bsd.port.mk</filename>
 	<maketarget>do-<replaceable>irgendwas</replaceable>
 	</maketarget> &uuml;bernommen. Zum Beispiel sind die Befehle
 	zum Entpacken eines Ports im Target
 	<maketarget>do-extract</maketarget> zu finden. Falls Sie mit
 	einem vorgegebenen Target nicht zufrieden sind, k&ouml;nnen
 	Sie es ver&auml;ndern, indem Sie das Target
 	<maketarget>do-<replaceable>irgendwas</replaceable>
 	</maketarget> in Ihrem <filename>Makefile</filename> neu
 	definieren.</para>
 
       <note>
 	<para>Die <quote>Haupt</quote>-Targets (z.B.
 	  <maketarget>extract</maketarget>,
 	  <maketarget>configure</maketarget> usw.) machen nicht mehr
 	  als sicherzustellen, dass bis hierhin alle Abschnitte
 	  abgeschlossen sind, um danach die eigentlichen Targets oder
 	  Skripte aufzurufen. Und es ist nicht beabsichtigt, dass
 	  diese ge&auml;ndert werden. Falls Sie das Entpacken
 	  ver&auml;ndern wollen, ver&auml;ndern Sie
 	  <maketarget>do-extract</maketarget>, aber niemals die Art,
 	  wie <maketarget>extract</maketarget> arbeitet!</para>
       </note>
 
       <para>Jetzt, da Sie verstehen, was geschieht, wenn der Benutzer
 	<command>make</command> eingibt, lassen Sie uns durch die
 	empfohlenen Schritte gehen, um den perfekten Port zu
 	erstellen.</para>
     </sect1>
 
     <sect1 id="slow-sources">
       <title>Den originalen Quelltext besorgen</title>
 
       <para>Normalerweise liegt der original Quelltext als gepackte
 	Datei (<filename><replaceable>foo</replaceable>.tar.gz
 	</filename> oder
 	<filename><replaceable>foo</replaceable>.tar.Z</filename>)
 	vor. Kopieren Sie diese nach <makevar>DISTDIR</makevar>.
 	Nutzen Sie, soweit m&ouml;glich, immer die Quellen aus dem
 	<emphasis>Hauptzweig</emphasis>.</para>
 
       <para>Es ist notwendig die Variable
 	<makevar>MASTER_SITES</makevar> anzupassen, um anzugeben, wo
 	sich der originale Quelltext befindet. In
 	<filename>bsd.sites.mk</filename> finden sich hilfreiche
 	Definitionen f&uuml;r die gebr&auml;uchlichsten Seiten. Bitte
 	nutzen Sie diese Seiten und die zugeh&ouml;rigen Definitionen,
 	soweit dies m&ouml;glich ist. Damit wird vermieden, immer und
 	immer wieder dieselben Informationen zu wiederholen. Da die
 	Hauptseiten regelm&auml;&szlig;ig angepasst werden
 	m&uuml;ssen, vereinfacht dieses Vorgehen die Pflege der
 	Dateien f&uuml;r jeden Beteiligten.</para>
 
       <para>Falls keine zuverl&auml;ssige und gut erreichbare
 	FTP/HTTP-Seite zu finden ist, oder nur Seiten auffindbar sind,
 	die keinen Standards entsprechen, sollte eine Kopie des
 	Quelltextes auf einer zuverl&auml;ssigen Seite abgelegt
 	werden. Dies k&ouml;nnte z.B. die eigene Internetseite
 	sein.</para>
 
       <para>Ist kein geeigneter Ort zum Ablegen des Quelltextes
 	auffindbar, ist es m&ouml;glich diesen <quote>intern</quote>
 	auf <hostid>ftp.FreeBSD.org</hostid> abzulegen; dies sollte
 	jedoch als letzte M&ouml;glichkeit angesehen werden. Das
 	Distfile muss in diesem Fall in <filename>~/public_distfiles/
 	</filename> eines <hostid>freefall</hostid>-Accounts abgelegt
 	werden. Bitten Sie den Committer Ihres Ports dies zu erledigen.
 	Er wird au&szlig;erdem <makevar>MASTER_SITES</makevar> nach
 	<makevar>MASTER_SITE_LOCAL</makevar> und <makevar>
 	MASTER_SITE_SUBDIR</makevar> auf den
 	<hostid>freefall</hostid>-Benutzernamen angepasst.</para>
 
       <para>Sollte sich das Distfile des Ports regelm&auml;&szlig;ig
 	ohne Versionsanpassungen des Autors &auml;ndern, sollte
 	&uuml;berlegt werden, das Disfile auf der eigenen
 	Internetseite abzulegen und diese in der Liste der
 	<makevar>MASTER_SITES</makevar> an die erste Stelle zu setzen.
 	Falls m&ouml;glich, sollte der Autor des Ports gebeten werden,
 	dies zu erledigen; hier&uuml;ber wird die Kontrolle des Quelltextes
 	verbessert. Wird eine eigene Version des Quelltextes auf
 	eigenen Internetseiten verf&uuml;gbar gemacht, verhindert dies
 	Warnungen von <errorname>checksum mismatch</errorname> und
 	reduziert den Arbeitsaufwand der Maintainer der FTP-Seiten.
 	Auch wenn nur eine Quelle f&uuml;r den Quelltext des Ports zur
 	Verf&uuml;gung steht, ist es empfohlen, ein Backup auf einer
 	weiteren Seite abzulegen und diese als zweiten Eintrag in
 	<makevar>MASTER_SITES</makevar> aufzunehmen.</para>
 
       <para>Sind f&uuml;r den Port zus&auml;tzlich aus dem Internet
 	verf&uuml;gbare Patches erforderlich, sollten diese ebenfalls
 	in <makevar>DISTDIR</makevar> abgelegt werden. Sollten diese
 	Patches von anderer Quelle als der Hauptseite des Ports
 	stammen, ist das kein Grund zur Sorge. Es gibt Wege diesem
 	Umstand gerecht zu werden (beachten Sie die unten stehende
 	Beschreibung zu <link linkend="porting-patchfiles">PATCHFILES
 	</link>).</para>
     </sect1>
 
     <sect1 id="slow-modifying">
       <title>Den Port bearbeiten</title>
 
       <para>Entpacken Sie eine Kopie des Tarballs in ein privates
 	Verzeichnis und nehmen Sie alle &Auml;nderungen
 	vor, die n&ouml;tig sind, um den Port unter einer aktuellen
 	FreeBSD-Version kompilieren zu k&ouml;nnen.
 	<emphasis>Protokollieren Sie sorgf&auml;ltig</emphasis> alle
 	Schritte, die Sie vornehmen, da Sie den Prozess in K&uuml;rze
 	automatisieren werden. Alles, auch das Entfernen,
 	Hinzuf&uuml;gen oder Bearbeiten von Dateien, sollte von einem
 	automatisierten Skript oder einer Patch-Datei machbar sein,
 	wenn Ihr Port fertig ist.</para>
 
       <para>Falls Ihr Port bedeutende Interaktionen/Ver&auml;nderungen
 	durch den Benutzer ben&ouml;tigt, um ihn zu Kompilieren oder
 	zu Installieren, sollten Sie einen Blick auf Larry Walls
 	klassische <application>Configure</application>-Skripte werfen
 	oder vielleicht etwas &Auml;hnliches selbst erstellen. Das
 	Ziel der Ports-Sammlung ist es, jeden Port so
 	<quote>plug-and-play-f&auml;hig</quote> wie m&ouml;glich
 	f&uuml;r den Endbenutzer zu machen, w&auml;hrend ein Minimum
 	an Speicherplatz gebraucht wird.</para>
 
       <note>
 	<para>Solange nicht anders angegeben wird von Patch-Dateien,
 	  Skripten und anderen Dateien, die Sie erstellt und der FreeBSD
 	  Ports-Sammlung hinzugef&uuml;gt haben, angenommen, dass Sie
 	  unter den standardm&auml;&szlig;igen BSD-Copyright-Bedingungen
 	  stehen.</para>
       </note>
     </sect1>
 
     <sect1 id="slow-patch">
       <title>Fehlerbehebung (Patches)</title>
 
       <para>Bei der Vorbereitung eines Ports k&ouml;nnen die Dateien,
 	die hinzugef&uuml;gt oder ver&auml;ndert wurden, mittels
 	&man.diff.1; abgefangen werden, um Sie sp&auml;ter an
 	&man.patch.1; zu &uuml;bergeben. Jeder Patch, der dem
 	Quelltext &uuml;bergeben werden soll, sollte in einer Datei
 	<filename>patch-<replaceable>*</replaceable></filename>
 	abgelegt werden, wobei <replaceable>*</replaceable> dem
 	Pfadnamen der zu korrigierenden Datei entspricht, wie er auch
 	in <filename>patch-Imakefile</filename> oder im
 	<filename>patch-src-config.h</filename> erscheint. Diese
 	Dateien sollten in <makevar>PATCHDIR</makevar> (normalerweise
 	<filename>files</filename>) abgelegt sein, von wo sie
 	automatisch &uuml;bernommen werden. Alle Patches m&uuml;ssen
 	sich relativ zur <makevar>WRKSRC</makevar>-Variable
 	(normalerweise dem Verzeichnis, in dem sich der Quelltext des
 	Ports entpackt und wo auch der Bau stattfindet)
 	befinden.</para>
 
       <para>Um Korrekturen und Updates zu vereinfachen, sollte es
 	vermieden werden, mehr als einen Patch f&uuml;r eine Datei zu
 	nutzen (z.B. <filename>patch-file</filename> und
 	<filename>patch-file2</filename>, welche beide
 	<filename><makevar>WRKSRC</makevar>/foobar.c</filename>
 	ver&auml;ndern).</para>
 
       <para>F&uuml;r die Benennung der Patches sollten nur die Zeichen
 	<literal>[-+._a-zA-Z0-9]</literal> genutzt werden. Bitte
 	verwenden Sie keine weiteren Zeichen als die angegebenen. Die
 	Namensvergabe sollte nicht <filename>patch-aa</filename> oder
 	<filename>patch-ab</filename> etc. entsprechen, erw&auml;hnen
 	Sie immer den Pfad und Dateinamen.</para>
 
       <para>RCS-Zeichenketten sollten vermieden werden, da CVS diese
 	verst&uuml;mmeln w&uuml;rde, sobald wir diese Dateien in die
 	Ports-Sammlung einpflegen. Wenn wir die Dateien wieder abrufen
 	w&auml;ren diese ver&auml;ndert und der Patch w&uuml;rde
 	fehlschlagen. RCS-Zeichenketten sind in Dollar-Zeichen
 	(<literal>&dollar;</literal>) eingef&uuml;gte Zeichen und
 	beginnen &uuml;blicherweise mit <literal>&dollar;Id</literal>
 	oder <literal>&dollar;RCS</literal>.</para>
 
       <para>Die Option rekursiv (<option>-r</option>) zu nutzen
 	&man.diff.1;, um Patches zu erstellen, ist zul&auml;ssig,
 	jedoch sollte  der Patch anschlie&szlig;end gepr&uuml;ft
 	werden, um Unn&ouml;tiges aus dem Patch zu entfernen. Im
 	Einzelnen bedeutet dies, dass Diffs zwischen zwei
 	Backup-Dateien, <filename>Makefile</filename>s oder wenn der
 	Port <command>Imake</command> oder GNU
 	<command>configure</command> usw. nutzt, &uuml;berfl&uuml;ssig
 	sind und entfernt werden sollten. Falls es es notwendig war,
 	<filename>configure.in</filename> zu bearbeiten und es soll
 	<command>autoconf</command> zum Neuerstellen von
 	<command>configure</command> genutzt werden, sollten die Diffs
 	aus <command>configure</command> nicht genutzt werden (diese
 	werden oft einige tausend Zeilen
 	gro&szlig;!);&nbsp;&ndash;&nbsp;hier sollte
 	<literal>USE_AUTOTOOLS=autoconf:261</literal> definiert und
 	das Diff aus <filename>configure.in</filename> genutzt
 	werden.</para>
 
       <para>War es notwendig eine Datei zu entfernen, wird dies besser
 	mittels des <maketarget>post-extract</maketarget>-Targets als
 	&uuml;ber den Patch selbst realisiert.</para>
 
       <para>Ein einfacher Austausch kann direkt &uuml;ber das
 	<filename>Makefile</filename> des Ports umgesetzt werden,
 	indem der in-place-Modus von &man.sed.1; genutzt wird. Dies
 	ist sehr hilfreich, wenn variable Werte korrigiert werden
 	sollen. Beispiel:</para>
 
       <programlisting>post-patch:
       @${REINPLACE_CMD} -e 's|for Linux|for FreeBSD|g' ${WRKSRC}/README
 	  @${REINPLACE_CMD} -e 's|-pthread|${PTHREAD_LIBS}|' ${WRKSRC}/configure
       </programlisting>
 
       <para>Relativ h&auml;ufig ergibt sich die Situation, in der die
 	portierte Software die CR/LF-Konventionen f&uuml;r Zeilenenden
 	nutzt (dies ist bei unter &windows; entwickelter Software
 	h&auml;ufig der Fall). Dies kann bei weiteren Patches Probleme
 	(Compiler-Warnungen, Fehlermeldungen bei der Ausf&uuml;hrung
 	von Skripten wie z.B. <command>/bin/sh^M</command> not found)
 	und anderes ergeben. Um schnell alle Dateien von CR/LF
 	nach LF zu konvertieren, kann
 	<literal>USE_DOS2UNIX=yes</literal> in das
 	<filename>Makefile</filename> des Ports geschrieben werden.
 	Hierzu kann eine Liste der zu konvertierenden Dateien erstellt
 	werden:</para>
 
       <programlisting>USE_DOS2UNIX=    util.c util.h</programlisting>
 
       <para>Sollen Gruppen von Dateien &uuml;ber verschiedene
 	Unterverzeichnisse konvertiert werden, kann
 	<makevar>DOS2UNIX_REGEX</makevar> genutzt werden, dessen
 	Argumente <command>find</command>-kompatible, regul&auml;re
 	Ausdr&uuml;cke sind. Mehr zur Formatierung findet sich in
 	&man.re.format.7;. Diese Option ist beim Konvertieren aller
 	Dateien mit definierter Endung, z.B. aller Dateien im
 	Quellcode, wobei bin&auml;re Dateien unber&uuml;hrt bleiben,
 	sinnvoll:</para>
 
       <programlisting>USE_DOS2UNIX=    yes
       DOS2UNIX_REGEX=  .*\.(c|cpp|h)</programlisting>
     </sect1>
 
     <sect1 id="slow-configure">
       <title>Konfigurieren</title>
 
       <para>F&uuml;gen Sie alle zus&auml;tzlichen
 	Ver&auml;nderungsbefehle Ihrem Skript
 	<filename>configure</filename> hinzu und speichern Sie es im
 	<filename>scripts</filename>-Unterverzeichnis. Wie vorstehend
 	schon erw&auml;hnt, k&ouml;nnen Sie dies auch mit den Targets
 	<filename>Makefile</filename> und/oder Skripte mit dem Namen
 	<filename>pre-configure</filename> oder
 	<filename>post-configure</filename> erledigen.</para>
     </sect1>
 
     <sect1 id="slow-user-input">
       <title>Handhabung von Benutzereingaben</title>
 
       <para>Sollte der Port Eingaben vom Benutzer ben&ouml;tigen,
 	muss <makevar>IS_INTERACTIVE</makevar> im
 	<filename>Makefile</filename> des Ports gesetzt werden. Dies
 	erlaubt <quote>overnight builds</quote> Ihren Port zu
 	&uuml;berspringen, falls der Nutzer die Variable
 	<envar>BATCH</envar> setzt (setzt der Nutzer hingegen die
 	Variable <envar>INTERACTIVE</envar>, werden
 	<emphasis>nur</emphasis> Ports gebaut, die Interaktion vom
 	Nutzer erwarten). Dies erspart den Rechnern, welche
 	kontinuierlich Ports bauen, eine Menge Zeit (siehe
 	unten).</para>
 
       <para>Zudem ist es empfohlen, falls sinnvolle Vorgaben f&uuml;r
 	interaktive Optionen gesetzt sind, die
 	<makevar>PACKAGE_BUILDING</makevar>-Variable zu pr&uuml;fen
 	und das interaktive Skript abzuschalten. Dies macht es uns
 	m&ouml;glich, Pakete f&uuml;r CDROMs und FTP-Server zu
 	bauen.</para>
     </sect1>
   </chapter>
 
   <chapter id="makefile">
     <title>Die Konfiguration des Makefile</title>
 
     <para>Das Konfigurieren des <filename>Makefile</filename> ist
       sehr einfach und wir schlagen vor, dass Sie zun&auml;chst
       einen Blick auf vorhandene Beispiele werfen. Zus&auml;tzlich
       gibt es ein
       <link linkend="porting-samplem">Beispiel eines Makefile</link>
       in diesem Handbuch. Schauen Sie es sich an und verfolgen Sie
       bitte die Abfolge der Variablen und Abschnitte in dieser
       Vorlage. Damit erleichtern Sie es anderen,
       Ihren Port zu lesen.</para>
 
     <para>Bedenken Sie bitte die folgenden Probleme in der hier
       vorgegebenen Abfolge der Unterabschnitte dieses Kapitels, wenn
       Sie Ihr neues <filename>Makefile</filename> erstellen:</para>
 
     <sect1 id="makefile-source">
       <title>Der originale Quelltext</title>
 
       <para>Liegt der Quelltext in <makevar>DISTDIR</makevar> als eine
 	standardisierte und mit gzip gepackte Datei in der Art
 	<filename>foozolix-1.2.tar.gz</filename>? Falls ja,
 	k&ouml;nnen Sie zum n&auml;chsten Schritt &uuml;bergehen.
 	Falls nicht, sollten Sie versuchen, die Variablen
 	<makevar>DISTVERSION</makevar>, <makevar>DISTNAME</makevar>,
 	<makevar>EXTRACT_CMD</makevar>,
 	<makevar>EXTRACT_BEFORE_ARGS</makevar>,
 	<makevar>EXTRACT_AFTER_ARGS</makevar>,
 	<makevar>EXTRACT_SUFX</makevar>, oder
 	<makevar>DISTFILES</makevar> zu &auml;ndern. Das h&auml;ngt
 	davon ab, wie fremdartig das Distributionsfile Ihres Ports ist
 	(der h&auml;ufigste Fall ist
 	<literal>EXTRACT_SUFX=.tar.Z</literal>, wenn der Tarball durch
 	ein normales <command>compress</command> und nicht durch
 	<command>gzip</command> gepackt wurde).</para>
 
       <para>Im schlimmsten Fall k&ouml;nnen Sie einfach Ihre eigene
 	Vorgabe mittels <maketarget>do-extract</maketarget> erzeugen
 	und die Standardvorgabe &uuml;berschreiben; aber dies sollte
 	in den wenigsten F&auml;llen, wenn &uuml;berhaupt, notwendig
 	sein.</para>
     </sect1>
 
     <sect1 id="makefile-naming">
       <title>Bezeichnungen</title>
 
       <para>Der erste Teil des <filename>Makefile</filename>
 	beschreibt die Versionsnummer des Ports und f&uuml;hrt ihn in
 	der richtigen Kategorie auf.</para>
 
       <sect2>
 	<title><makevar>PORTNAME</makevar> und
 	  <makevar>PORTVERSION</makevar></title>
 
 	<para>Setzen Sie bitte die Variable
 	  <makevar>PORTNAME</makevar> auf den Basisnamen Ihres Ports
 	  und die Variable <makevar>PORTVERSION</makevar> auf dessen
 	  Versionsnummer.</para>
       </sect2>
 
       <sect2 id="makefile-naming-revepoch">
 	<title><makevar>PORTREVISION</makevar> und
 	  <makevar>PORTEPOCH</makevar></title>
 
 	<sect3>
 	  <title><makevar>PORTREVISION</makevar></title>
 
 	  <para>Die <makevar>PORTREVISION</makevar>-Variable ist ein
 	    streng monoton wachsender Wert, welcher auf 0
 	    zur&uuml;ckgesetzt wird, nachdem
 	    <makevar>PORTVERSION</makevar> erh&ouml;ht wurde (d.h.
 	    jedes Mal, wenn ein offizielles Release erfolgt). Sie wird
 	    an den Namen des Pakets angeh&auml;ngt, wenn sie ungleich
 	    0 ist. &Auml;nderungen an <makevar>PORTREVISION</makevar>
 	    werden von automatisierten Werkzeugen (z.B.
 	    &man.pkg.version.1;) genutzt, um anzuzeigen, dass ein
 	    neues Paket verf&uuml;gbar ist.</para>
 
 	  <para><makevar>PORTREVISION</makevar> sollte jedes Mal
 	    erh&ouml;ht werden, wenn eine &Auml;nderung am Port
 	    erfolgt, die betr&auml;chtliche Auswirkungen auf den
 	    Inhalt oder Struktur des aus dem Port erzeugten Pakets
 	    zur Folge hat.</para>
 
 	  <para>Beispiele daf&uuml;r, wann
 	    <makevar>PORTREVISION</makevar> erh&ouml;ht werden
 	    sollte:</para>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para>Hinzuf&uuml;gen von Patches, welche
 		Sicherheitsl&uuml;cken schlie&szlig;en, Fehler
 		beseitigen oder neue Funktionalit&auml;t zum Port
 		hinzuf&uuml;gen.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>&Auml;nderungen am <filename>Makefile</filename>
 		des Ports, welche compile-time-Optionen
 		hinzuf&uuml;gen oder entfernen.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>&Auml;nderungen bez&uuml;glich Packliste oder am
 		Verhalten w&auml;hrend der Installation des Pakets
 		(d.h. &Auml;nderungen an einem Skript, welches
 	        Ausgangsdaten f&uuml;r das Paket erzeugt, wie z.B.
 		SSH-Hostschl&uuml;ssel).</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Versionssprung einer Shared-Library, welche eine
 		Abh&auml;ngigkeit dieses Ports ist (In diesem Fall
 		w&uuml;rde ein Anwender bei der Installation des alten
 		Pakets scheitern, falls er eine neue Version der
 		Abh&auml;ngigkeit bereits installiert hat, weil nach
 		der alten Bibliothek libfoo.x anstatt nach
 		libfoo.(x+1)) gesucht wird).</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Schleichende &Auml;nderungen am Distfile, welche
 		bedeutende funktionale &Auml;nderungen verursachen,
 		d.h. &Auml;nderungen des Distfile erfordern eine
 		Korrektur an <filename>distinfo</filename>, ohne dass
 		damit zusammenh&auml;ngend die
 		<makevar>PORTVERSION</makevar> ver&auml;ndert wird,
 		obwohl ein <command>diff -ru</command> zwischen der
 		alten und der neuen Version bedeutende
 		Ver&auml;nderungen am Code nachweist.</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>Beispiele f&uuml;r &Auml;nderungen, welche keine
 	    Erh&ouml;hung von <makevar>PORTREVISION</makevar>
 	    erfordern:</para>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para>Stilistische &Auml;nderungen am Grundger&uuml;st
 		des Ports ohne funktionale &Auml;nderungen am daraus
 		resultierenden Paket.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>&Auml;nderungen an der Variable
 		<makevar>MASTER_SITES</makevar> oder andere
 		funktionale &Auml;nderungen, welche das resultierende
 	        Paket nicht ver&auml;ndern.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Marginale Patches am Distfile wie die Korrektur
 		von Tippfehlern, welche nicht wichtig genug sind, um
 		dem Benutzer die B&uuml;rde eines Upgrades
 		aufzuerlegen.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Build fixes, die ein Paket erst kompilierbar
 		machen, welches ohne diese &Auml;nderungen vorher
 		nicht erzeugt werden konnte (solange die
 		&Auml;nderungen keine funktionale Differenz bringen
 		auf Plattformen, auf denen dieses Paket schon vorher
 	        gebaut werden konnte). Da
 		<makevar>PORTREVISION</makevar> den Inhalt des Pakets
 		wiederspiegelt, ist es nicht notwendig
 	        <makevar>PORTREVISION</makevar> zu erh&ouml;hen, wenn
 		das Paket vorher nicht erstellt werden konnte.</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>Als Faustregel gilt: Stellen Sie sich die Frage, ob
 	    die durchgef&uuml;hrte &Auml;nderung am Port jedem hilft
 	    (entweder aufgrund einer Verbesserung, Beseitigung eines
 	    Fehlers, oder der Annahme, dass das neue Paket
 	    &uuml;berhaupt erst funktioniert) und w&auml;gen Sie es
 	    gegen den Umstand ab, dass jedermann, der seine
 	    Ports-Sammlung regelm&auml;ssig auf dem neuesten Stand
 	    h&auml;lt, zu einer Aktualisierung gezwungen wird.
 	    Falls Sie die Frage positiv beantworten sollten,
 	    erh&ouml;hen Sie die Variable
 	    <makevar>PORTREVISION</makevar>.</para>
 	</sect3>
 
 	<sect3>
 	  <title><makevar>PORTEPOCH</makevar></title>
 
 	  <para>Von Zeit zu Zeit geschieht es, dass irgendjemand
 	    (Drittanbieter von Software oder FreeBSD Ports Committer)
 	    etwas Dummes tut und eine Version einer Software
 	    ver&ouml;ffentlicht, deren Versionsnummer niedriger ist
 	    als die der vorherigen. Ein Beispiel hierf&uuml;r ist
 	    ein Port, der von foo-20000801 auf foo-1.0 ge&auml;ndert
 	    wird (der Erstere wird f&auml;lschlicherweise als neue
 	    Version behandelt, weil 2000801 ein numerisch
 	    gr&ouml;&szlig;erer Wert ist als 1).</para>
 
 	  <para>In Situationen wie diesen sollte die Variable
 	    <makevar>PORTEPOCH</makevar> erh&ouml;ht werden. Wenn
 	    <makevar>PORTEPOCH</makevar> gr&ouml;&szlig;er als 0 ist,
 	    wird sie an den Namen des Pakets angeh&auml;ngt, wie in
 	    Abschnitt 0 oberhalb bereits beschrieben.
 	    <makevar>PORTEPOCH</makevar> darf niemals verringert oder
 	    auf 0 gesetzt werden, weil der Vergleich des Pakets mit
 	    einem fr&uuml;heren Zeitpunkt scheitern w&uuml;rde (d.h.
 	    das Paket w&uuml;rde niemals als veraltet erkannt werden):
 	    Die neue Versionsnummer (<literal>1.0,1</literal> im
 	    obigen Beispiel) ist immer noch numerisch kleiner als die
 	    vorherige Version (2000801), aber das Suffix
 	    <literal>,1</literal> wird von automatisierten Werkzeugen
 	    gesondert behandelt und wird als gr&ouml;&szlig;er
 	    erkannt, als das implizit angenommene Suffix
 	    <literal>,0</literal> im fr&uuml;heren Paket.</para>
 
 	  <para>Das Entfernen oder Zur&uuml;cksetzen von
 	    <makevar>PORTEPOCH</makevar> f&uuml;hrt zu unendlichem
 	    &Auml;rger. Wenn Sie die obigen Ausf&uuml;hrungen nicht
 	    vollst&auml;ndig verstanden haben, lesen Sie es bitte
 	    unbedingt nochmals bis Sie es vollst&auml;ndig
 	    verinnerlicht haben, oder fragen Sie vor jeder
 	    &Auml;nderung auf den Mailinglisten nach!</para>
 
 	  <para>Es wird erwartet, dass <makevar>PORTEPOCH</makevar>
 	    f&uuml;r die weitaus &uuml;berwiegende Zahl der Ports
 	    nicht verwendet wird und der verantwortungsvolle und
 	    vorausschauende Umgang mit <makevar>PORTVERSION</makevar>
 	    macht es meist &uuml;berfl&uuml;ssig, falls ein
 	    sp&auml;teres Release die Versionsstruktur &auml;ndern
 	    sollte. Vorsicht ist geboten, wenn ein Release einer
 	    Drittanbieter-Software ohne eine offizielle Versionsnummer
 	    ver&ouml;ffentlicht wird, wie z.B. bei
 	    <quote>Snapshot-Versionen</quote>. Man ist versucht,
 	    das Release mit dem jeweiligen Datum zu bezeichnen,
 	    was unweigerlich zu den oben beschriebenen Problemen
 	    f&uuml;hrt, wenn das n&auml;chste
 	    <quote>offizielle</quote> Release erscheint.</para>
 
 	  <para>Wenn z.B. ein Snapshot zum Datum 20000917
 	    ver&ouml;ffentlicht wird und die vorherige Version der
 	    Software war 1.2, dann sollte der Snapshot die
 	    <makevar>PORTVERSION</makevar> 1.2.20000917 oder
 	    &auml;hnlich erhalten und nicht 20000917, damit das
 	    nachfolgende Release, angenommen 1.3, immer noch einen
 	    gr&ouml;&szlig;eren numerischen Wert aufweist.</para>
 	</sect3>
 
 	<sect3>
 	  <title>Beispiel f&uuml;r den Gebrauch von
 	    <makevar>PORTREVISION</makevar> und
 	    <makevar>PORTEPOCH</makevar></title>
 
 	  <para>Der <literal>gtkmumble</literal>-Port, Version
 	    <literal>0.10</literal>, befindet sich in der
 	    Ports-Sammlung:</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.10</programlisting>
 
 	  <para><makevar>PKGNAME</makevar> wird zu
 	    <literal>gtkmumble-0.10</literal>.</para>
 
 	  <para>Ein Sicherheitsloch wurde entdeckt, das einen lokalen
 	    Patch von FreeBSD erforderlich macht.
 	    <makevar>PORTREVISION</makevar> wird entsprechend
 	    erh&ouml;ht.</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.10
 PORTREVISION=   1</programlisting>
 
 	  <para><makevar>PKGNAME</makevar> wird zu
 	    <literal>gtkmumble-0.10_1</literal></para>
 
 	  <para>Eine neue Version wird vom Software-Drittanbieter
 	    ver&ouml;ffentlicht, bezeichnet mit der Version
 	    <literal>0.2</literal> (es stellt sich heraus, dass der
 	    Autor beabsichtigte, dass <literal>0.10</literal>
 	    eigentlich <literal>0.1.0</literal> bedeuten sollte,
 	    nicht <quote>was kommt nach 0.9</quote>
 	    &nbsp;&ndash;&nbsp;Hoppla, aber nun ist es zu sp&auml;t).
 	    Da die neue Unterversion <literal>2</literal> numerisch
 	    kleiner ist als die vorherige Version
 	    <literal>10</literal>, muss <makevar>PORTEPOCH</makevar>
 	    erh&ouml;ht werden, um sicherzustellen, dass das neue
 	    Paket auch als <quote>neuer</quote> erkannt wird. Da es
 	    ein neues Release des Drittanbieters ist, wird
 	    <makevar>PORTREVISION</makevar> auf 0 zur&uuml;ckgesetzt
 	    (oder aus dem <filename>Makefile</filename>
 	    entfernt).</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.2
 PORTEPOCH=      1</programlisting>
 
 	  <para><makevar>PKGNAME</makevar> wird zu
 	    <literal>gtkmumble-0.2,1</literal></para>
 
 	  <para>Das n&auml;chste Release ist 0.3. Da
 	    <makevar>PORTEPOCH</makevar> niemals verringert wird,
 	    sind die Versionsvariablen nun wie folgt:</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.3
 PORTEPOCH=      1</programlisting>
 
 	  <para><makevar>PKGNAME</makevar> wird zu
 	    <literal>gtkmumble-0.3,1</literal></para>
 
 	  <note>
 	    <para>Falls <makevar>PORTEPOCH</makevar> mit diesem
 	      Upgrade auf <literal>0</literal> zur&uuml;ckgesetzt
 	      worden w&auml;re, dann w&uuml;rde jemand, der das Paket
 	      <literal>gtkmumble-0.10_1</literal> installiert
 	      h&auml;tte, das Paket <literal>gtkmumble-0.3</literal>
 	      nicht als neuer erkennen, da <literal>3</literal> immer
 	      noch numerisch kleiner ist als <literal>10</literal>.
 	      Bedenken Sie, dass genau dies der springende Punkt an
 	      <makevar>PORTEPOCH</makevar> ist.</para>
 	  </note>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title><makevar>PKGNAMEPREFIX</makevar> und
 	  <makevar>PKGNAMESUFFIX</makevar></title>
 
 	<para>Zwei optionale Variablen,
 	  <makevar>PKGNAMEPREFIX</makevar> und
 	  <makevar>PKGNAMESUFFIX</makevar>, werden verkn&uuml;pft mit
 	  <makevar>PORTNAME</makevar> und
 	  <makevar>PORTVERSION</makevar>, um
 	  <makevar>PKGNAME</makevar> zu bilden als <literal>
 	  ${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}
 	  </literal>. Stellen Sie bitte unbedingt sicher, dass diese
 	  Variablen den <link linkend="porting-pkgname">Richtlinien
 	  f&uuml;r einen guten Paketnamen</link> entsprechen.
 	  Insbesondere d&uuml;rfen Sie
 	  <emphasis>keinesfalls</emphasis> einen Bindestrich
 	  (<literal>-</literal>) in <makevar>PORTVERSION</makevar>
 	  verwenden. Falls das Paket den
 	  <replaceable>language-</replaceable> oder
 	  <replaceable>-compiled.specifics</replaceable>-Teil aufweist
 	  (siehe unten) benutzen Sie <makevar>PKGNAMEPREFIX</makevar>
 	  oder <makevar>PKGNAMESUFFIX</makevar> respektive. Machen Sie
 	  diese Variablen nicht zum Bestandteil von
 	  <makevar>PORTNAME</makevar>!</para>
       </sect2>
 
       <sect2>
 	<title><makevar>LATEST_LINK</makevar></title>
 
 	<para>In einigen F&auml;llen k&ouml;nnen mehrere Versionen
 	  einer Applikation gleichzeitig in der Ports-Sammlung sein.
 	  Das index build- und das package build-System m&uuml;ssen
 	  nun in der Lage sein, diese als unterschiedliche Ports zu
 	  erkennen, obwohl diese Versionen alle die gleichen Variablen
 	  <makevar>PORTNAME</makevar>,
 	  <makevar>PKGNAMEPREFIX</makevar> und sogar
 	  <makevar>PKGNAMESUFFIX</makevar> aufweisen. In solchen
 	  F&auml;llen sollte die optionale Variable
 	  <makevar>LATEST_LINK</makevar> auf einen unterschiedlichen
 	  Wert f&uuml;r alle Ports gesetzt werden mit Ausnahme des
 	  <quote>Haupt-Ports</quote>. Beispiele hierf&uuml;r sind die
 	  <filename>editors/vim5</filename> und
 	  <filename>editors/vim</filename>-Ports und die
 	  <filename>www/apache*</filename>-Familie. Beachten Sie
 	  bitte, dass die Frage der Auswahl der
 	  <quote>wichtigsten</quote> Version
 	  (<quote>am popul&auml;rsten</quote>,
 	  <quote>am besten Unterst&uuml;tzt</quote>,
 	  <quote>zuletzt gepatcht</quote> usw.) ausserhalb der
 	  M&ouml;glichkeiten dieses Handbuches liegt. Wir sagen Ihnen
 	  nur, wie Sie die anderen Ports spezifizieren, nachdem Sie
 	  den <quote>Haupt-Port</quote> erkoren haben.</para>
       </sect2>
 
       <sect2 id="porting-pkgname">
 	<title>Namensregeln f&uuml;r Pakete</title>
 
 	<para>Im Folgenden finden Sie die Regeln f&uuml;r die
 	  Benennung Ihrer Pakete. Diese sollen gew&auml;hrleisten,
 	  dass das Paketverzeichnis leicht zu durchsuchen ist, da es
 	  bereits abertausende Pakete gibt und die Nutzer sich mit
 	  Schauder abwenden, wenn Ihre Augen &uuml;berstrapaziert
 	  werden!</para>
 
 	<para>Der Paketname soll aussehen wie
 	  <filename><replaceable><optional>language<optional>_region</optional></optional>-name<optional><optional>-</optional>compiled.specifics</optional>-version.numbers</replaceable></filename>.</para>
 
 	<para>Der Paketname ist definiert als
 	  <literal>
 	  ${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}
 	  </literal>. Stellen Sie bitte sicher, dass die Variablen
 	  Ihres Ports diesem Format entsprechen.</para>
 
 	<orderedlist>
 	  <listitem>
 	    <para>FreeBSD bem&uuml;ht sich ausserordentlich, die
 	      Landessprachen seiner Nutzer zu unterst&uuml;tzen.
 	      Die <replaceable>language-</replaceable>Variable soll
 	      eine Abk&uuml;rzung mit 2 Buchstaben sein der Sprachen
 	      gem&auml;&szlig; ISO-639, falls der Port f&uuml;r eine
 	      bestimmte Sprache spezifisch ist.
 	      Beispiele hierf&uuml;r sind <literal>ja</literal>
 	      f&uuml;r Japanisch, <literal>ru</literal> f&uuml;r
 	      Russisch, <literal>vi</literal> f&uuml;r Vietnamesisch,
 	      <literal>zh</literal> f&uuml;r Chinesisch,
 	      <literal>ko</literal> f&uuml;r Koreanisch und
 	      <literal>de</literal> f&uuml;r Deutsch.</para>
 
 	    <para>Sollte der Port spezifisch sein f&uuml;r eine
 	      gewisse Region innerhalb eines Sprachraumes, dann
 	      f&uuml;gen Sie bitte auch den L&auml;ndercode mit 2
 	      Buchstaben hinzu. Beispiele sind
 	      <literal>en_US</literal> f&uuml;r nordamerikanisches
 	      Englisch und <literal>fr_CH</literal> f&uuml;r
 	      schweizerisches Franz&ouml;sisch.</para>
 
 	    <para>Der <replaceable>language-</replaceable>Teil muss
 	      in der <makevar>PKGNAMEPREFIX</makevar>-Variable gesetzt
 	      werden.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Der erste Buchstabe des
 	      <filename>name</filename>-Teils muss kleingeschrieben
 	      werden (der Rest des Namens kann Gro&szlig;buchstaben
 	      enthalten. Daher seien Sie bitte umsichtig, wenn Sie den
 	      Namen einer Software konvertieren, welche
 	      Grossbuchstaben enth&auml;lt).
 	      Es ist Tradition, <literal>Perl 5</literal>-Module durch
 	      ein vorstehendes <literal>p5-</literal> und durch
 	      Umwandlung des doppelten Doppelpunktes in Bindestriche
 	      zu bezeichnen. So wird z.B. aus dem
 	      <literal>Data::Dumper</literal>-Modul der
 	      <literal>p5-Data-Dumper</literal>-Port.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Vergewissern Sie sich, dass der Name des Ports und
 	      seine Versionsnummer klar getrennt sind und in den
 	      Variablen <makevar>PORTNAME</makevar> und
 	      <makevar>PORTVERSION</makevar> stehen. Der einzige
 	      Grund, um in <makevar>PORTNAME</makevar> einen
 	      Versionsteil aufzunehmen ist der, dass die Software
 	      wirklich so bezeichnet wird, wie z.B. die Ports
 	      <filename>textproc/libxml2</filename> oder
 	      <filename>japanese/kinput2-freewnn</filename>.
 	      Ansonsten sollte <makevar>PORTNAME</makevar> keine
 	      versionsspezifischen Bestandteile aufweisen. Es ist
 	      vollkommen normal, dass viele Ports den gleichen
 	      <makevar>PORTNAME</makevar> aufweisen wie z.B. die
 	      <filename>www/apache*</filename>-Ports. In diesem Falle
 	      werden unterschiedliche Versionen (und unterschiedliche
 	      Indexeintr&auml;ge) unterschieden durch die Werte von
 	      <makevar>PKGNAMEPREFIX</makevar>,
 	      <makevar>PKGNAMESUFFIX</makevar> und
 	      <makevar>LATEST_LINK</makevar>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Falls der Port mit verschiedenen, <link
 	      linkend="makefile-masterdir">fest kodierten
 	      Vorgaben</link> (&uuml;blicherweise Teil des
 	      Verzeichnisnamens in einer Familie von Ports) gebaut
 	      werden kann, dann soll der
 	      <replaceable>-compiled.specifics</replaceable>-Teil die
 	      einkompilierten Vorgaben anzeigen (der Bindestrich ist
 	      optional). Beispiele hierf&uuml;r sind
 	      Papiergr&ouml;&szlig;en und Font-Einheiten.</para>
 
 	    <para>Der
 	      <replaceable>-compiled.specifics</replaceable>-Teil
 	      muss in der Variablen <makevar>PKGNAMESUFFIX</makevar>
 	      gesetzt werden.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Die Versionszeichenfolge sollte einen Bindestrich
 	      (<literal>-</literal>) am Schluss haben und eine von
 	      Punkten getrennte Liste von Integer-Zahlen und
 	      kleingeschriebenen Buchstaben sein.
 	      Es ist nicht zul&auml;ssig, einen weiteren Bindestrich
 	      innerhalb des Versionsstrings zu verwenden! Die einzige
 	      Ausnahme hiervon ist die Zeichenfolge
 	      <literal>pl</literal> (bedeutet
 	      <quote>patchlevel</quote>), welche
 	      <emphasis>nur</emphasis> dann gebraucht werden darf,
 	      wenn die Applikation &uuml;ber keine
 	      Haupt&ndash;&nbsp;oder Unterversionsnummern
 	      verf&uuml;gt. Wenn die Versionsbezeichnung der Software
 	      Zeichenketten wie <quote>alpha</quote>,
 	      <quote>beta</quote>, <quote>rc</quote> oder
 	      <quote>pre</quote> enth&auml;lt, dann nehmen Sie bitte
 	      den ersten Buchstaben daraus und setzen ihn unmittelbar
 	      hinter einen Punkt.
 	      Falls die Versionszeichenfolge nach diesem Punkt
 	      fortgesetzt wird, sollen die Zahlen ohne einen Punkt
 	      zwischen den einzelnen Buchstaben folgen.</para>
 
 	    <para>Das Ziel ist es, die Ports anhand der
 	      Versionszeichenfolge zu sortieren. Stellen Sie bitte
 	      unbedingt sicher, dass die Bestandteile der
 	      Versionsnummer immer durch einen Punkt getrennt sind
 	      und falls Datumsangaben verwandt werden diese im Format
 	      <literal>
 	      <replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable>
 	      </literal> und nicht <literal><replaceable>dd</replaceable>.<replaceable>mm</replaceable>.<replaceable>yyyy</replaceable>
 	      </literal> oder gar dem nicht Y2K-kompatiblen Format
 	      <literal>
 	      <replaceable>yy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable>
 	      </literal> vorliegen.</para>
 	  </listitem>
 	</orderedlist>
 
 	<para>Hier sind einige reale Beispiele, die aufzeigen,
 	  wie man den Namen einer Applikation zu einem
 	  vern&uuml;nftigen Paketnamen umwandelt:</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="6">
 	    <thead>
 	      <row>
 		<entry>Softwarename</entry>
 		<entry><makevar>PKGNAMEPREFIX</makevar></entry>
 		<entry><makevar>PORTNAME</makevar></entry>
 		<entry><makevar>PKGNAMESUFFIX</makevar></entry>
 		<entry><makevar>PORTVERSION</makevar></entry>
 		<entry>Grund</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>mule-2.2.2</entry>
 		<entry>(leer)</entry>
 		<entry>mule</entry>
 		<entry>(leer)</entry>
 		<entry>2.2.2</entry>
 		<entry>Keine &Auml;nderung erforderlich</entry>
 	      </row>
 
 	      <row>
 		<entry>EmiClock-1.0.2</entry>
 		<entry>(leer)</entry>
 		<entry>emiclock</entry>
 		<entry>(leer)</entry>
 		<entry>1.0.2</entry>
 		<entry>keine Gro&szlig;buchstaben f&uuml;r einzelne
 		  Applikationen</entry>
 	      </row>
 
 	      <row>
 		<entry>rdist-1.3alpha</entry>
 		<entry>(leer)</entry>
 		<entry>rdist</entry>
 		<entry>(leer)</entry>
 		<entry>1.3.a</entry>
 		<entry>Keine Zeichenketten wie
 		  <literal>alpha</literal> erlaubt</entry>
 	      </row>
 
 	      <row>
 		<entry>es-0.9-beta1</entry>
 		<entry>(leer)</entry>
 		<entry>es</entry>
 		<entry>(leer)</entry>
 		<entry>0.9.b1</entry>
 		<entry>keine Zeichenketten wie <literal>beta</literal>
 		  erlaubt</entry>
 	      </row>
 
 	      <row>
 		<entry>mailman-2.0rc3</entry>
 		<entry>(leer)</entry>
 		<entry>mailman</entry>
 		<entry>(leer)</entry>
 		<entry>2.0.r3</entry>
 		<entry>keine Zeichenketten wie <literal>rc</literal>
 		  erlaubt</entry>
 	      </row>
 
 	      <row>
 		<entry>v3.3beta021.src</entry>
 		<entry>(leer)</entry>
 		<entry>tiff</entry>
 		<entry>(leer)</entry>
 		<entry>3.3</entry>
 		<entry>Was sollte denn das eigentlich sein?</entry>
 	      </row>
 
 	      <row>
 		<entry>tvtwm</entry>
 		<entry>(leer)</entry>
 		<entry>tvtwm</entry>
 		<entry>(leer)</entry>
 		<entry>pl11</entry>
 		<entry>Versionsstring zwingend erforderlich</entry>
 	      </row>
 
 	      <row>
 		<entry>piewm</entry>
 		<entry>(leer)</entry>
 		<entry>piewm</entry>
 		<entry>(leer)</entry>
 		<entry>1.0</entry>
 		<entry>Versionsstring zwingend erforderlich</entry>
 	      </row>
 
 	      <row>
 		<entry>xvgr-2.10pl1</entry>
 		<entry>(leer)</entry>
 		<entry>xvgr</entry>
 		<entry>(leer)</entry>
 		<entry>2.10.1</entry>
 		<entry><literal>pl</literal> nur erlaubt, wenn keine
 		  Versionsnummer vorhanden</entry>
 	      </row>
 
 	      <row>
 		<entry>gawk-2.15.6</entry>
 		<entry>ja-</entry>
 		<entry>gawk</entry>
 		<entry>(leer)</entry>
 		<entry>2.15.6</entry>
 		<entry>Japanische Sprachversion</entry>
 	      </row>
 
 	      <row>
 		<entry>psutils-1.13</entry>
 		<entry>(leer)</entry>
 		<entry>psutils</entry>
 		<entry>-letter</entry>
 		<entry>1.13</entry>
 		<entry>Papergr&ouml;&szlig;e beim Paketbau fix
 		  kodiert</entry>
 	      </row>
 
 	      <row>
 		<entry>pkfonts</entry>
 		<entry>(leer)</entry>
 		<entry>pkfonts</entry>
 		<entry>300</entry>
 		<entry>1.0</entry>
 		<entry>Paket f&uuml;r 300 DPI Schriftarten</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 	<para>Falls es in der Originalquelle &uuml;berhaupt keinen
 	  Anhaltspunkt f&uuml;r irgendeine Versionsbezeichnung gibt
 	  und es unwahrscheinlich ist, dass der Autor jemals eine neue
 	  Version ver&ouml;ffentlichen wird, dann setzen Sie bitte die
 	  Version einfach auf <literal>1.0</literal> (wie im obigen
 	  Beispiel <literal>piewm</literal>). Sie k&ouml;nnen auch den
 	  Autor fragen oder eine Datumszeichenfolge
 	  (<literal><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
 	  als Version verwenden.</para>
       </sect2>
     </sect1>
 
     <sect1 id="makefile-categories">
       <title>Kategorisierung</title>
 
       <sect2>
 	<title><makevar>CATEGORIES</makevar></title>
 
 	<para>Wenn ein Paket erzeugt wird, dann wird es unter
 	  <filename>/usr/ports/packages/All</filename> abgelegt und
 	  von einem oder mehreren Unterverzeichnissen werden auf
 	  <filename>/usr/ports/packages</filename> Links erstellt.
 	  Die Namen dieser Unterverzeichnisse werden durch die
 	  Variable <makevar>CATEGORIES</makevar> festgelegt.
 	  Dies geschieht, um dem Nutzer zu helfen, eine gro&szlig;e
 	  Zahl von Paketen auf einer FTP-Webseite oder einer CD/DVD
 	  zu durchsuchen.
 	  Bitte werfen Sie einen Blick auf die <link
 	  linkend="porting-categories">Aktuelle Liste der
 	  Kategorien</link> und suchen Sie die beste Kategorie
 	  f&uuml;r Ihren Port aus.</para>
 
 	<para>Diese Liste legt auch fest, an welcher Stelle in der
 	  Ports-Sammlung der Port eingef&uuml;gt wird. Falls Sie
 	  mehrere Kategorien angeben wird angenommen, dass die Dateien
 	  des Ports im Unterverzeichnis mit dem Namen der ersten
 	  angegebenen Kategorie liegen. Schauen Sie bitte <link
 	  linkend="choosing-categories">unten</link> f&uuml;r weitere
 	  Informationen dar&uuml;ber, wie man die richtige Kategorie
 	  bestimmt.</para>
       </sect2>
 
       <sect2 id="porting-categories">
 	<title>Aktuelle Liste der Kategorien</title>
 
 	<para>Hier ist die aktuelle Liste der Kategorien. Die mit
 	  einem Asterisk (<literal>*</literal>) bezeichneten sind
 	  <emphasis>virtuelle</emphasis> Kategorien, also solche,
 	  welche &uuml;ber kein eigenes Unterverzeichnis in der
 	  Ports-Sammlung verf&uuml;gen. Sie werden nur als
 	  Sekund&auml;rkategorien benutzt und sind nur f&uuml;r
 	  Suchzwecke eingerichtet worden.</para>
 
 	<note>
 	  <para>F&uuml;r nicht-virtuelle Kategorien finden Sie eine
 	    einzeilige Beschreibung in der Variable
 	    <makevar>COMMENT</makevar> im
 	    <filename>Makefile</filename> des jeweiligen
 	    Unterverzeichnisses.</para>
 	</note>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>Kategorie</entry>
 		<entry>Beschreibung</entry>
 		<entry>Anmerkung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><filename>accessibility</filename></entry>
 		<entry>Ports f&uuml;r behinderte Menschen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>afterstep*</filename></entry>
 		<entry>Ports f&uuml;r den <ulink
 		  url="http://www.afterstep.org">AfterStep</ulink>
 		  Window Manager.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>arabic</filename></entry>
 		<entry>Arabische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>archivers</filename></entry>
 		<entry>Archivierungswerkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>astro</filename></entry>
 		<entry>Ports f&uuml;r Astronomie.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>audio</filename></entry>
 		<entry>Sound-Unterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>benchmarks</filename></entry>
 		<entry>Benchmarking-Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>biology</filename></entry>
 		<entry>Software f&uuml;r Biologie.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>cad</filename></entry>
 		<entry>CAD-Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>chinese</filename></entry>
 		<entry>Chinesische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>comms</filename></entry>
 		<entry>Kommunikationsprogramme.</entry>
 		<entry>Haupts&auml;chlich Software f&uuml;r serielle
 		  Schnittstellen.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>converters</filename></entry>
 		<entry>Zeichensatz-Konverter.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>databases</filename></entry>
 		<entry>Datenbanken.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>deskutils</filename></entry>
 		<entry>Dinge, die vor der Erfindung des Computers
 		  auf dem Schreibtisch waren.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>devel</filename></entry>
 		<entry>Entwicklungs-Werkzeuge.</entry>
 		<entry>Legen Sie keine Bibliotheken hier ab, nur weil
 		  es Bibliotheken sind, es sei denn, sie geh&ouml;ren
 		  wirklich nirgendwo anders hin.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>dns</filename></entry>
 		<entry>DNS-bezogene Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>editors</filename></entry>
 		<entry>allgemeine Editoren.</entry>
 		<entry>Spezielle Editoren geh&ouml;ren in Ihre
 		  jeweilige Kategorie, (z.B. geh&ouml;rt ein
 		  mathematischer Formeleditor in
 		  <filename>math</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>elisp*</filename></entry>
 		<entry>Emacs-lisp-Ports.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>emulators</filename></entry>
 		<entry>Emulatoren f&uuml;r andere Betriebssysteme.
 		  </entry>
 		<entry>Terminal-Emulatoren geh&ouml;ren
 		  <emphasis>nicht</emphasis> hierher; X-basierende
 		  geh&ouml;ren zu <filename>x11</filename> und
 		  text-basierende zu <filename>comms</filename> oder
 		  <filename>misc</filename>, abh&auml;ngig von deren
 		  genauer Funktionalit&auml;t.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>finance</filename></entry>
 		<entry>Finanz-Software und &auml;hnliches.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>french</filename></entry>
 		<entry>Franz&ouml;sische Sprachunterst&uuml;tzung.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>ftp</filename></entry>
 		<entry>FTP Client- und Server-Werkzeuge.</entry>
 		<entry>Falls Ihr Port sowohl FTP als auch HTTP
 		  unterst&uuml;tzt, stellen Sie ihn in
 		  <filename>ftp</filename> mit der Zweitkategorie
 	          <filename>www</filename>.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>games</filename></entry>
 		<entry>Spiele.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>geography*</filename></entry>
 		<entry>geografische Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>german</filename></entry>
 		<entry>Deutsche Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>gnome*</filename></entry>
 		<entry>Ports f&uuml;r <ulink
 		  url="http://www.gnome.org">GNOME</ulink></entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>graphics</filename></entry>
 		<entry>grafische Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>gnustep*</filename></entry>
 		<entry>Software f&uuml;r GNUstep.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>hamradio*</filename></entry>
 		<entry>Software f&uuml;r Amateurfunk.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>haskell*</filename></entry>
 		<entry>Software f&uuml;r die
 		  Haskell-Programmiersprache.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>hebrew</filename></entry>
 		<entry>Hebr&auml;ische Sprachunterst&uuml;tzung.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>hungarian</filename></entry>
 		<entry>Ungarische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>ipv6*</filename></entry>
 		<entry>IPv6-bezogene Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>irc</filename></entry>
 		<entry>Internet Relay Chat (IRC)-Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>japanese</filename></entry>
 		<entry>Japanische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>java</filename></entry>
 		<entry>Software f&uuml;r die Java-Programmiersprache.
 		  </entry>
 		<entry>Die <filename>java</filename>-Kategorie sollte
 		  nicht die Einzige f&uuml;r einen Port sein mit
 		  Ausnahme der direkt nur mit der Programmiersprache
 		  zusammenh&auml;ngenden Applikationen. Porter sollten
 		  <filename>java</filename> nicht als Hauptkategorie
 		  eines Ports w&auml;hlen.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>kde*</filename></entry>
 		<entry>Ports f&uuml;r das <ulink
 		  url="http://www.kde.org">K Desktop Environment
 		  (KDE)</ulink>-Projekt.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>kld*</filename></entry>
 		<entry>Kernelmodule.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>korean</filename></entry>
 		<entry>Koreanische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>lang</filename></entry>
 		<entry>Programmiersprachen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>linux*</filename></entry>
 		<entry>Linux-Applikationen und -Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>lisp*</filename></entry>
 		<entry>Software f&uuml;r die Lisp-Programmiersprache.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>mail</filename></entry>
 		<entry>Mail-Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>math</filename></entry>
 		<entry>Numerische Berechnungen und andere
 		  mathematische Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>mbone</filename></entry>
 		<entry>MBone-Applikationen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>misc</filename></entry>
 		<entry>Verschiedene Werkzeuge.</entry>
 		<entry>Haupts&auml;chlich Werkzeuge, die nicht
 		  anderswo hingeh&ouml;ren. Versuchen Sie, falls
 		  irgend m&ouml;glich, eine bessere Kategorie
 		  f&uuml;r Ihren Port zu finden als
 		  <literal>misc</literal>, weil Ports hier leicht
 		  untergehen.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>multimedia</filename></entry>
 		<entry>Multimedia-Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>net</filename></entry>
 		<entry>Verschiedene Netzwerk-Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>net-im</filename></entry>
 		<entry>Instant Messaging-Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>net-mgmt</filename></entry>
 		<entry>Netzwerk-Management-Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>net-p2p</filename></entry>
 		<entry>Peer to peer-Netzwerkprogramme.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>news</filename></entry>
 		<entry>USENET News-Software.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>palm</filename></entry>
 		<entry>Software f&uuml;r <ulink
 		  url="http://www.palm.com/">Palm&trade;</ulink>.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>parallel*</filename></entry>
 		<entry>Applikationen f&uuml;r paralleles Rechnen.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>pear*</filename></entry>
 		<entry>Ports f&uuml;r das Pear PHP-Framework.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>perl5*</filename></entry>
 		<entry>Ports, welche <application>Perl</application>
 		  Version 5 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>plan9*</filename></entry>
 		<entry>Verschiedene Programme von <ulink
 		  url="http://www.cs.bell-labs.com/plan9dist/">Plan9</ulink>.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>polish</filename></entry>
 		<entry>Polnische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>ports-mgmt</filename></entry>
 		<entry>Hilfsprogramme f&uuml;r das Installieren und
 		  Entwickeln von FreeBSD Ports und Paketen.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>portuguese</filename></entry>
 		<entry>Portugiesische Sprachunterst&uuml;tzung.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>print</filename></entry>
 		<entry>Drucker-Software.</entry>
 		<entry>Desktop Ver&ouml;ffentlichungs-Werkzeuge (DTP,
 		  Betrachter etc.) geh&ouml;ren auch hierher.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>python*</filename></entry>
 		<entry>Software f&uuml;r <ulink
 		  url="http://www.python.org/">Python</ulink>.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>ruby*</filename></entry>
 		<entry>Software f&uuml;r <ulink
 		  url="http://www.ruby-lang.org/">Ruby</ulink>.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>rubygems*</filename></entry>
 		<entry>Ports f&uuml;r <ulink
 		  url="http://www.rubygems.org/">RubyGems</ulink>-Pakete.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>russian</filename></entry>
 		<entry>Russische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>scheme*</filename></entry>
 		<entry>Software f&uuml;r die
 		  Scheme-Programmiersprache.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>science</filename></entry>
 		<entry>Wissenschaftliche Programme, die in keine
 		  andere Kategorie passen wie z.B.
 		  <filename>astro</filename>,
 		  <filename>biology</filename> und
 		  <filename>math</filename>.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>security</filename></entry>
 		<entry>Security-Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>shells</filename></entry>
 		<entry>Shells.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>spanish*</filename></entry>
 		<entry>Spanische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>sysutils</filename></entry>
 		<entry>System-Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tcl*</filename></entry>
 		<entry>Ports, welche Tcl ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tcl80*</filename></entry>
 		<entry>Ports, welche Tcl 8.0 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tcl82*</filename></entry>
 		<entry>Ports, welche Tcl 8.2 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tcl83*</filename></entry>
 		<entry>Ports, welche Tcl 8.3 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tcl84*</filename></entry>
 		<entry>Ports, welche Tcl 8.4 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>textproc</filename></entry>
 		<entry>Textverarbeitungsprogramme.</entry>
 		<entry>Dies beinhaltet nicht DTP-Werkzeuge, diese
 		  geh&ouml;ren in <filename>print</filename>.
 		  </entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tk*</filename></entry>
 		<entry>Ports, welche Tk ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tk80*</filename></entry>
 		<entry>Ports, welche Tk 8.0 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tk82*</filename></entry>
 		<entry>Ports, welche Tk 8.2 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tk83*</filename></entry>
 		<entry>Ports, welche Tk 8.3 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tk84*</filename></entry>
 		<entry>Ports, welche Tk 8.4 ben&ouml;tigen.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tkstep80*</filename></entry>
 		<entry>Ports, welche TkSTEP 8.0 ben&ouml;tigen.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>ukrainian</filename></entry>
 		<entry>Ukrainische Sprachunterst&uuml;tzung.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>vietnamese</filename></entry>
 		<entry>Vietnamesische Sprachunterst&uuml;tzung.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>windowmaker*</filename></entry>
 		<entry>Ports f&uuml;r den WindowMaker Window-Manager.
 		  </entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>www</filename></entry>
 		<entry>Software f&uuml;r das World Wide Web (WWW).
 		  </entry>
 		<entry>HTML-Werkzeuge geh&ouml;ren auch hierher.
 		  </entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11</filename></entry>
 		<entry>X-Window-System und dergleichen.</entry>
 		<entry>Diese Kategorie ist nur f&uuml;r Software,
 		  welche direkt X unterst&uuml;tzt.
 		  F&uuml;gen Sie keine normalen X-Applikationen hinzu.
 		  Die meisten davon geh&ouml;ren in eine andere
 		  <filename>x11-*</filename>-Kategorie (siehe unten).
 		  Falls Ihr Port eine X-Applikation
 		  <emphasis>ist</emphasis>, dann definieren Sie bitte
 		  <makevar>USE_XLIB</makevar> (impliziert durch
 		  <makevar>USE_IMAKE</makevar>) und f&uuml;gen ihn der
 		  entsprechenden Kategorie hinzu.</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-clocks</filename></entry>
 		<entry>X11-Uhren.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-drivers</filename></entry>
 		<entry>X11-Treiber.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-fm</filename></entry>
 		<entry>X11-Dateimanager.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-fonts</filename></entry>
 		<entry>X11-Schriftarten und Werkzeuge.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-servers</filename></entry>
 		<entry>X11-Server.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-themes</filename></entry>
 		<entry>X11-Themes.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-toolkits</filename></entry>
 		<entry>X11-Toolkits.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-wm</filename></entry>
 		<entry>X11-Window-Manager.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>xfce*</filename></entry>
 		<entry>Ports in Zusammenhang mit <ulink
 		  url="http://www.xfce.org/">Xfce</ulink>.</entry>
 		<entry></entry>
 	      </row>
 
 	      <row>
 		<entry><filename>zope*</filename></entry>
 		<entry><ulink
 		  url="http://www.zope.org/">Zope</ulink>-Unterst&uuml;tzung.
 		  </entry>
 		<entry></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
       </sect2>
 
       <sect2 id="choosing-categories">
 	<title>W&auml;hlen der richtigen Kategorie</title>
 
 	<para>Da viele der Kategorien sich &uuml;berlappen,
 	  m&uuml;ssen Sie oft festlegen, welches die prim&auml;re
 	  Kategorie Ihres Ports ist. Hierzu gibt es einige Regeln,
 	  welche diese Auswahl bestimmen. Hier ist die Liste der
 	  Regeln mit abnehmender Wichtigkeit:</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para>Die erste (prim&auml;re) Kategorie muss eine
 	      physische (keine virtuelle, siehe <link
 	      linkend="porting-categories">oben</link>) sein. Dies
 	      ist notwendig damit Pakete erstellt werden k&ouml;nnen.
 	      Die nachfolgenden Kategorien k&ouml;nnen wahllos
 	      virtuelle oder physische Kategorien sein.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Sprachspezifische Kategorien kommen immer zuerst.
 	      Wenn Ihr Port z.B. Japanische X11-Schriftarten
 	      installiert, dann muss Ihre
 	      <makevar>CATEGORIES</makevar>-Zeile
 	      <filename>japanese x11-fonts</filename>
 	      enthalten.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Spezifische Kategorien werden vor weniger
 	      spezifischen Kategorien aufgelistet. Ein HTML-Editor
 	      sollte z.B. als <filename>www editors</filename>
 	      aufgef&uuml;hrt werden und nicht umgekehrt.
 	      Genauso sollten Sie keinen Port unter
 	      <filename>net</filename> auff&uuml;hren, wenn er zu
 	      <filename>irc</filename>, <filename>mail</filename>,
 	      <filename>mbone</filename>, <filename>news</filename>,
 	      <filename>security</filename> oder
 	      <filename>www</filename> passt, da
 	      <filename>net</filename> stillschweigend eingeschlossen
 	      ist in diesen Kategorien.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><filename>x11</filename> wird nur als sekund&auml;re
 	      Kategorie benutzt, wenn die prim&auml;re Kategorie eine
 	      sprachspezifische ist. Keinesfalls sollten Sie
 	      <filename>x11</filename> in die Kategorie-Zeile einer
 	      X-Applikation setzen.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><application>Emacs</application> modes geh&ouml;ren
 	      in die gleiche Kategorie wie die vom jeweiligen mode
 	      unterst&uuml;tzte Applikation und nicht in
 	      <filename>editors</filename>. Ein
 	      <application>Emacs</application> mode z.B. f&uuml;r das
 	      Editieren von Quelltext einer bestimmten
 	      Programmiersprache geh&ouml;rt zur Kategorie
 	      <filename>lang</filename>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>F&uuml;r Ports, die vom Benutzer ladbare Kernelmodule
 	      installieren, sollte die virtuelle Kategorie
 	      <filename>kld</filename> in die
 	      <makevar>CATEGORIES</makevar>-Zeile aufgenommen
 	      werden.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><filename>misc</filename> sollte nicht zusammen mit
 	      irgendeiner anderen nicht-virtuellen Kategorie
 	      auftreten. Falls Sie <literal>misc</literal> mit einer
 	      anderen Kategorie in <makevar>CATEGORIES</makevar> haben
 	      bedeutet dies, dass Sie gefahrlos
 	      <literal>misc</literal> streichen und die andere
 	      Kategorie alleine verwenden k&ouml;nnen!</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Falls Ihr Port wirklich in keine andere Kategorie
 	      passt, verwenden Sie bitte
 	      <filename>misc</filename>.</para>
 	  </listitem>
 	</itemizedlist>
 
 	<para>Falls Sie sich &uuml;ber die Kategorie im Unklaren sind,
 	  hinterlassen Sie bitte einen Kommentar in Ihrem per
 	  &man.send-pr.1; eingereichten Bericht, damit wir diese Frage
 	  vor dem Import diskutieren k&ouml;nnen. Falls Sie ein
 	  Committer sind, schicken Sie bitte eine Nachricht an
 	  &a.ports;, damit die Frage im Vorhinein er&ouml;rtert werden
 	  kann. Neue Ports werden zu h&auml;ufig falsch kategorisiert
 	  und werden sofort wieder verschoben. Das bl&auml;ht das
 	  Master Source Repository unn&ouml;tig auf.</para>
       </sect2>
 
       <sect2 id="proposing-categories">
 	<title>Eine neue Kategorie vorschlagen</title>
 
 	<para>Da die Ports-Sammlung &uuml;ber viele Jahre gewachsen
 	  ist, wurden viele neue Kategorien hinzugef&uuml;gt. Neue
 	  Kategorien k&ouml;nnen <emphasis>virtuell</emphasis> (ohne
 	  eigenes Unterverzeichnis in der Ports-Sammlung) oder
 	  <emphasis>physisch</emphasis> sein.
 	  Der nachfolgende Text f&uuml;hrt einige Punkte auf, welche
 	  bei der Neueinf&uuml;hrung einer physischen Kategorie
 	  beachtet werden m&uuml;ssen, damit Sie dies bei einem
 	  eventuellen Vorschlag Ihrerseits ber&uuml;cksichtigen
 	  k&ouml;nnen.</para>
 
 	<para>Unsere bestehende Maxime ist die Vermeidung der
 	  Neuanlage von physischen Kategorien, solange nicht eine
 	  gro&szlig;e Zahl von Ports zugeordnet werden k&ouml;nnen
 	  oder falls ihr nicht Ports zugeh&ouml;ren w&uuml;rden,
 	  welche eine logisch abgegrenzte Gruppe von limitiertem
 	  &ouml;ffentlichem Interesse zugeh&ouml;ren w&uuml;rden
 	  (zum Beispiel neue Sprachkategorien) oder vorzugsweise
 	  beides.</para>
 
 	<para>Die Erkl&auml;rung daf&uuml;r ist, dass eine Neuanlage
 	  einer physischen Kategorie einen <ulink
 	  url="&url.articles.committers-guide;/#ports">erheblichen
 	  Arbeitsaufwand</ulink> sowohl f&uuml;r die Committer als
 	  auch diejenigen Nutzer bedeutet, welche die &Auml;nderungen
 	  der Ports-Sammlung nachvollziehen. Zus&auml;tzlich
 	  verursachen Vorschl&auml;ge f&uuml;r neue Kategorien oftmals
 	  Kontroversen (nat&uuml;rlich deswegen, weil es keinen klaren
 	  Konsens dar&uuml;ber gibt, welche Kategorie als <quote>zu
 	  gro&szlig;</quote> betrachtet werden muss noch ob sich
 	  bestimmte Kategorien zur einfachen Suche eignen (und wie
 	  viele Kategorien &uuml;berhaupt ideal w&auml;ren) und so
 	  weiter).</para>
 
 	<para>Hier ist das Prozedere:</para>
 
 	<procedure>
 	  <step>
 	    <para>Schlagen Sie die neue Kategorie auf &a.ports; vor.
 	      Sie sollten eine detaillierte Begr&uuml;ndung f&uuml;r
 	      die neue Kategorie beif&uuml;gen einschlie&szlig;lich
 	      einer Erkl&auml;rung, warum Sie meinen, die
 	      existierenden Kategorien seien nicht ausreichend.
 	      Zeigen Sie au&szlig;erdem eine Liste der zu
 	      verschiebenden Ports (falls neue Ports in
 	      <application>GNATS</application> auf ihren commit
 	      warten, die in diese Kategorie passen w&uuml;rden.
 	      Listen Sie diese bitte auch mit auf). Sind Sie der
 	      Maintainer oder Einreicher dieser Ports, erw&auml;hnen
 	      Sie es bitte. Es verleiht Ihrem Vorschlag mehr
 	      Gewicht.</para>
 	  </step>
 
 	  <step>
 	    <para>Nehmen Sie an der Diskussion teil.</para>
 	  </step>
 
 	  <step>
 	    <para>Falls es Unterst&uuml;tzung f&uuml;r Ihren Vorschlag
 	      geben sollte, reichen Sie bitte einen PR ein, welcher
 	      die Begr&uuml;ndung und die Liste der betroffenen Ports
 	      enth&auml;lt, die verschoben werden m&uuml;ssen.
 	      Idealerweise sollte der PR Patches f&uuml;r Folgendes
 	      enthalten:</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para><filename>Makefile</filename>s f&uuml;r die
 		  neuen Ports nach dem Repocopy</para>
 	      </listitem>
 
 	      <listitem>
 		<para><filename>Makefile</filename> f&uuml;r die neue
 		  Kategorie</para>
 	      </listitem>
 
 	      <listitem>
 		<para><filename>Makefile</filename> f&uuml;r die alten
 		  Kategorien der betroffenen Ports</para>
 	      </listitem>
 
 	      <listitem>
 		<para><filename>Makefile</filename>s f&uuml;r Ports,
 		  welche von den alten Ports abh&auml;ngen</para>
 	      </listitem>
 
 	      <listitem>
 		<para>F&uuml;r zus&auml;tzliches Ansehen sorgen Sie,
 		  wenn Sie die anderen Dateien, die ge&auml;ndert
 		  werden m&uuml;ssen, beif&uuml;gen wie in der
 		  Direktive des Committer's Guide beschrieben.</para>
 	      </listitem>
 	    </itemizedlist>
 	  </step>
 
 	  <step>
 	    <para>Da es die Ports-Infrastruktur beeinflusst und nicht
 	      nur die Durchf&uuml;hrung von Repocopies und
 	      m&ouml;glicherweise sogar Regressionstests auf dem Build
 	      Cluster durchgef&uuml;hrt werden m&uuml;ssen, sollte der
 	      PR dem Ports Management Team &a.portmgr; zugeordnet
 	      werden.</para>
 	  </step>
 
 	  <step>
 	    <para>Sobald der PR best&auml;tigt wurde muss ein
 	      Committer den Rest der Prozedur durchf&uuml;hren, welche
 	      im <ulink url="&url.articles.committers-guide;/#ports">
 	      Committers Guide</ulink> beschrieben ist.</para>
 	  </step>
 	</procedure>
 
 	<para>Das Vorschlagen einer neuen virtuellen Kategorie ist
 	  &auml;hnlich, aber wesentlich weniger aufwendig, weil
 	  keine Ports verschoben werden m&uuml;ssen. In diesem Falle
 	  m&uuml;ssen nur die Patches an den PR beigef&uuml;gt werden,
 	  welche die neue Kategorie zur Variable
 	  <makevar>CATEGORIES</makevar> der betroffenen Ports
 	  hinzuf&uuml;gen.</para>
       </sect2>
 
       <sect2 id="proposing-reorg">
 	<title>Vorschlagen einer Neuorganisation aller
 	  Kategorien</title>
 
 	<para>Von Zeit zu Zeit schl&auml;gt jemand eine komplette
 	  Neuorganisation aller Ports, entweder mit einer zweistufigen
 	  Struktur oder irgendeiner Art von
 	  Schl&uuml;sselw&ouml;rtern, vor. Bis heute wurde keiner
 	  dieser Vorschl&auml;ge umgesetzt, weil sie zwar einfach
 	  zu machen sind, aber der Aufwand zur Umsetzung und
 	  Reorganisation der kompletten Ports-Sammlung schlichtweg
 	  m&ouml;rderisch w&auml;re. Bitte lesen Sie die Geschichte
 	  dieser Vorschl&auml;ge in den Archiven der Mailinglisten
 	  nach, bevor Sie diese Ideen nochmals unterbreiten. Zudem
 	  sollten Sie gewappnet sein, dass man Sie auffordert, einen
 	  arbeitsf&auml;higen Prototyp vorzulegen.</para>
       </sect2>
     </sect1>
 
     <sect1 id="makefile-distfiles">
       <title>Die Distributionsdateien</title>
 
       <para>Der zweite Teil des <filename>Makefile</filename>
 	beschreibt die Dateien, welche heruntergeladen werden
 	m&uuml;ssen, um den Port zu bauen und wo diese Dateien zu
 	finden sind.</para>
 
       <sect2>
 	<title><makevar>DISTVERSION/DISTNAME</makevar></title>
 
 	<para><makevar>DISTNAME</makevar> ist der Name der Applikation
 	   wie er von den Autoren vergeben wurde.
 	   <makevar>DISTNAME</makevar> hat als Vorgabe
 	   <literal>${PORTNAME}-${PORTVERSION}</literal> also
 	   &uuml;berschreiben Sie diese Vorgabe nur, wenn es notwendig
 	   ist. <makevar>DISTNAME</makevar> wird nur an zwei Stellen
 	   genutzt. Erstens: (<makevar>DISTFILES</makevar>) hat als
 	   Vorgabe
 	   <makevar>${DISTNAME}</makevar><makevar>${EXTRACT_SUFX}</makevar>.
 	   Zweitens: Die Distributionsdatei soll in einem
 	   Unterverzeichnis namens <makevar>WRKSRC</makevar>
 	   extrahiert werden, dessen Vorgabe
 	   <filename>work/<makevar>${DISTNAME}</makevar></filename>
 	   ist.</para>
 
 	<para>Manche Drittanbieter-Namen, welche nicht in das Schema
 	  <literal>${PORTNAME}-${PORTVERSION}</literal> passen,
 	  k&ouml;nnen durch Setzen von <makevar>DISTVERSION</makevar>
 	  automatisch behandelt werden. <makevar>PORTVERSION</makevar>
 	  und <makevar>DISTNAME</makevar> werden automatisch
 	  abgeleitet, k&ouml;nnen aber nat&uuml;rlich manuell
 	  &uuml;berschrieben werden. Die folgende Tabelle f&uuml;hrt
 	  einige Beispiele auf:</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry><makevar>DISTVERSION</makevar></entry>
 		<entry><makevar>PORTVERSION</makevar></entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>0.7.1d</entry>
 		<entry>0.7.1.d</entry>
 	      </row>
 	      <row>
 		<entry>10Alpha3</entry>
 		<entry>10.a3</entry>
 	      </row>
 	      <row>
 		<entry>3Beta7-pre2</entry>
 		<entry>3.b7.p2</entry>
 	      </row>
 	      <row>
 		<entry>8:f_17</entry>
 		<entry>8f.17</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 	<note>
 	  <para><makevar>PKGNAMEPREFIX</makevar> und
 	    <makevar>PKGNAMESUFFIX</makevar> beeinflussen
 	    <makevar>DISTNAME</makevar> nicht. Beachten Sie bitte
 	    auch, dass Sie <makevar>DISTNAME</makevar>
 	    unver&auml;ndert lassen sollten, falls
 	    <makevar>WRKSRC</makevar> denselben Wert hat wie
 	    <filename>work/<makevar>${PORTNAME}-${PORTVERSION}</makevar></filename>
 	    und gleichzeitig dass Archiv des originalen Quelltextes
 	    anders benannt ist als
 	    <makevar>${PORTNAME}-${PORTVERSION}${EXTRACT_SUFX}</makevar>.
 	    Es ist einfacher
 	    <makevar>DISTFILES</makevar> zu definieren, als
 	    <makevar>DISTNAME</makevar> und <makevar>WRKSRC</makevar>
 	    (und m&ouml;glicherweise <makevar>EXTRACT_SUFX</makevar>)
 	    zu setzen.</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><makevar>MASTER_SITES</makevar></title>
 
 	<para>Dokumentieren Sie das Verzeichnis der FTP/HTTP-URL,
 	  welche auf den originalen Tarball zeigt, in der Variable
 	  <makevar>MASTER_SITES</makevar>. Bitte vergessen Sie
 	  niemals den Schr&auml;gstrich (<filename>/</filename>)
 	  am Ende!</para>
 
 	<para>Die <command>make</command>-Makros werden versuchen,
 	  diese Festlegung f&uuml;r die Aufbereitung der
 	  Distributionsdateien mittels <makevar>FETCH</makevar> zu
 	  benutzen, falls sie diese nicht schon auf dem System
 	  finden.</para>
 
 	<para>Es wird empfohlen, mehrere Webseiten in dieser Liste
 	  aufzuf&uuml;hren, vorzugsweise auf verschiedenen
 	  Kontinenten. Dies ist ein Schutz gegen Probleme bei
 	  gr&ouml;&szlig;eren Ausf&auml;llen im Internet.
 	  Wir planen sogar Unterst&uuml;tzung einzubauen,
 	  die automatisch einen Server in der N&auml;he zum
 	  Herunterladen bestimmt. Die Verf&uuml;gbarkeit von
 	  vielen Webseiten wird dieses Vorhaben betr&auml;chtlich
 	  erleichtern.</para>
 
 	<para>Falls der originale Tarball Teil eines popul&auml;ren
 	  Archivs ist, wie X-contrib, GNU oder Perl CPAN, k&ouml;nnen
 	  Sie m&ouml;glicherweise auf diese Seiten in einer einfachen
 	  und kompakten Form mittels
 	  <makevar>MASTER_SITE_<replaceable>*</replaceable></makevar>
 	  (d.h., <makevar>MASTER_SITE_XCONTRIB</makevar>,
 	  <makevar>MASTER_SITE_GNU</makevar> und
 	  <makevar>MASTER_SITE_PERL_CPAN</makevar>) referenzieren.
 	  Setzen Sie einfach <makevar>MASTER_SITES</makevar> auf eine
 	  dieser Variablen und <makevar>MASTER_SITE_SUBDIR</makevar>
 	  auf den Pfad innerhalb des Archivs. Hier ist ein
 	  Beispiel:</para>
 
 	<programlisting>MASTER_SITES=         ${MASTER_SITE_XCONTRIB}
 MASTER_SITE_SUBDIR=   applications</programlisting>
 
 	<para>Diese Variablen werden in
 	  <filename>/usr/ports/Mk/bsd.sites.mk</filename> definiert.
 	  Es werden st&auml;ndig neue Eintr&auml;ge hinzugef&uuml;gt,
 	  daher stellen Sie bitte unbedingt sicher, dass Sie die
 	  neueste Version verwenden, bevor Sie einen Port
 	  einschicken.</para>
 
 	<para>Der Nutzer kann ebenfalls die Variable
 	  <makevar>MASTER_SITE_*</makevar> in der
 	  <filename>/etc/make.conf</filename> setzen. Dadurch werden
 	  unsere Vorgaben &uuml;berschrieben und stattdessen werden
 	  die Spiegel-Server seiner Wahl für die popul&auml;ren
 	  Archive genutzt.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>EXTRACT_SUFX</makevar></title>
 
 	<para>Falls Sie eine Distributionsdatei haben, die ein
 	  eigent&uuml;mliches Suffix nutzt, um die Art der
 	  Kompression anzuzeigen, dann setzen Sie
 	  <makevar>EXTRACT_SUFX</makevar>.</para>
 
 	<para>Ist die Distributionsdatei zum Beispiel im Stil von
 	  <filename>foo.tgz</filename> anstatt des normalen
 	  <filename>foo.tar.gz</filename> benannt, w&uuml;rden Sie
 	  schreiben:</para>
 
 	<programlisting>DISTNAME=      foo
 EXTRACT_SUFX=  .tgz</programlisting>
 
 	<para>Falls erforderlich, setzen die Variablen
 	  <makevar>USE_BZIP2</makevar> und <makevar>USE_ZIP</makevar>
 	  automatisch <makevar>EXTRACT_SUFX</makevar> auf
 	  <literal>.tar.bz2</literal> oder <literal>.zip</literal>.
 	  Falls keine der beiden gesetzt ist, dann verwendet
 	  <makevar>EXTRACT_SUFX</makevar> die Vorgabe
 	  <literal>.tar.gz</literal>.</para>
 
 	<note>
 	  <para>Sie m&uuml;ssen niemals beide Variablen
 	    <makevar>EXTRACT_SUFX</makevar> und
 	    <makevar>DISTFILES</makevar> setzen.</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><makevar>DISTFILES</makevar></title>
 
 	<para>Manchmal haben die zu ladenden Dateien keinerlei
 	  &Auml;hnlichkeit mit dem Namen des Ports. Es k&ouml;nnte
 	  z.B. <filename>source.tar.gz</filename> oder &auml;hnlich
 	  hei&szlig;en. In anderen F&auml;llen k&ouml;nnte der
 	  Quelltext in mehreren Archiven sein und alle m&uuml;ssen
 	  heruntergeladen werden.</para>
 
 	<para>Falls dies der Fall ist, setzen Sie
 	  <makevar>DISTFILES</makevar> als eine durch Leerzeichen
 	  getrennte Liste aller Dateien, die geladen werden
 	  m&uuml;ssen.</para>
 
 	<programlisting>DISTFILES=     source1.tar.gz source2.tar.gz</programlisting>
 
 	<para>Wenn nicht ausdr&uuml;cklich gesetzt, verwendet
 	  <makevar>DISTFILES</makevar> als Vorgabe
 	  <literal>${DISTNAME}${EXTRACT_SUFX}</literal>.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>EXTRACT_ONLY</makevar></title>
 
 	<para>Falls nur einige der <makevar>DISTFILES</makevar>
 	  extrahiert werden m&uuml;ssen (z.B. eine Datei ist der
 	  Quelltext und eine andere ist ein unkomprimiertes Dokument),
 	  dann listen Sie die zu extrahierenden Dateien in
 	  <makevar>EXTRACT_ONLY</makevar> auf.</para>
 
 	<programlisting>DISTFILES=     source.tar.gz manual.html
 EXTRACT_ONLY=  source.tar.gz</programlisting>
 
 	<para>Falls <emphasis>keine</emphasis> der
 	  <makevar>DISTFILES</makevar> unkomprimiert sein sollte,
 	  dann setzen Sie <makevar>EXTRACT_ONLY</makevar> auf einen
 	  leeren String.</para>
 
 	<programlisting>EXTRACT_ONLY=</programlisting>
       </sect2>
 
       <sect2 id="porting-patchfiles">
 	<title><makevar>PATCHFILES</makevar></title>
 
 	<para>Falls Ihr Port zus&auml;tzliche Patches ben&ouml;tigt,
 	  welche per FTP oder HTTP verf&uuml;gbar sind, dann setzen
 	  Sie <makevar>PATCHFILES</makevar> auf den Namen der Dateien
 	  und <makevar>PATCH_SITES</makevar> auf die URL des
 	  Verzeichnisses, das diese Patches enth&auml;lt (das Format
 	  ist das gleiche wie <makevar>MASTER_SITES</makevar>).</para>
 
 	<para>Falls ein Patch wegen einiger zus&auml;tzlicher
 	  Pfadnamen nicht relativ zum Anfang des Quelltextbaumes
 	  (d.h., <makevar>WRKSRC</makevar>) liegt, dann setzen Sie
 	  bitte <makevar>PATCH_DIST_STRIP</makevar> entsprechend.
 	  Wenn z.B. alle Pfadnamen in diesem Patch ein
 	  zus&auml;tzliches <literal>foozolix-1.0/</literal> vor ihren
 	  Dateinamen aufweisen, dann setzen Sie bitte
 	  <literal>PATCH_DIST_STRIP=-p1</literal>.</para>
 
 	<para>K&uuml;mmern Sie sich nicht darum, ob die Patches
 	  komprimiert sind. Sie werden automatisch dekomprimiert,
 	  wenn die Dateinamen auf <filename>.gz</filename> oder
 	  <filename>.Z</filename> enden.</para>
 
 	<para>Falls der Patch zusammen mit anderen Dateien in einem
 	  gezippten Tarball verteilt wird (z.B. mit Dokumentation),
 	  dann k&ouml;nnen Sie nicht <makevar>PATCHFILES</makevar>
 	  verwenden. In diesem Fall f&uuml;gen Sie den Namen und den
 	  Ort dieses Tarballs zu <makevar>DISTFILES</makevar> und
 	  <makevar>MASTER_SITES</makevar>. Benutzen Sie dann die
 	  <makevar>EXTRA_PATCHES</makevar>-Variable, um auf diese
 	  Dateien zu zeigen und <filename>bsd.port.mk</filename>
 	  wird automatisch diese Dateien nutzen. Kopieren Sie
 	  <emphasis>niemals</emphasis> Patch-Dateien in das
 	  <makevar>PATCHDIR</makevar>-Verzeichnis, weil es
 	  m&ouml;glicherweise nicht beschreibbar ist.</para>
 
 	<note>
 	  <para>Der Tarball wird zusammen mit dem anderen Quelltext
 	    extrahiert werden. Eine ausdr&uuml;ckliche Dekomprimierung
 	    eines mit gzip oder compress erzeugten Tarball ist nicht
 	    notwendig. Sollten Sie dies dennoch vorgeben, so beachten
 	    Sie bitte peinlich genau, dass Sie nichts
 	    &uuml;berschreiben, was bereits im Verzeichnis vorhanden
 	    ist. Vergessen Sie auch nicht den kopierten Patch im
 	    Target von <maketarget>pre-clean</maketarget> zu
 	    entfernen.</para>
 	</note>
       </sect2>
 
       <sect2 id="porting-master-sites-n">
 	<title>Verschiedene Distributionsdateien oder Patches von
 	  verschiedenen Seiten und Verzeichnissen
 	  (<literal>MASTER_SITES:n</literal>)</title>
 
 	<para>(Betrachten Sie es als in irgendeiner Form
 	  <quote>fortgeschrittenes Thema</quote>.
 	  Neulinge sollten m&ouml;glicherweise diesen Abschnitt
 	  beim ersten Lesen &uuml;berspringen).</para>
 
 	<para>Dieser Abschnitt stellt Informationen &uuml;ber
 	  die Mechanismen zum Herunterladen von Dateien zur
 	  Verf&uuml;gung und behandelt die Variablen
 	  <literal>MASTER_SITES:n</literal> und
 	  <literal>MASTER_SITES_NN</literal>.
 	  Wir beziehen uns im weiteren Text auf diese Variablen
 	  als <literal>MASTER_SITES:n</literal>.</para>
 
 	<para>Etwas Hintergrundinformation zu Beginn: OpenBSD
 	  verf&uuml;gt &uuml;ber eine sehr elegante Option
 	  innerhalb der Variablen <makevar>DISTFILES</makevar> und
 	  <makevar>PATCHFILES</makevar>. Sowohl Dateien als auch
 	  Patches k&ouml;nnen mit angeh&auml;ngten
 	  <literal>:n</literal>-Bezeichnern versehen werden wobei
 	  <literal>n</literal> in beiden F&auml;llen
 	  <literal>[0-9]</literal> sein kann und eine
 	  Gruppenzugeh&ouml;rigkeit anzeigt. Ein Beispiel
 	  hierf&uuml;r ist:</para>
 
 	<programlisting>DISTFILES=      alpha:0 beta:1</programlisting>
 
 	<para>In OpenBSD wird die Datei <filename>alpha</filename>
 	  mit der Variable <makevar>MASTER_SITES0</makevar>
 	  verkn&uuml;pft anstatt dem in FreeBSD gebr&auml;uchlichen
 	  <makevar>MASTER_SITES</makevar> und
 	  <filename>beta</filename> mit
 	  <makevar>MASTER_SITES1</makevar>.</para>
 
 	<para>Das ist eine sehr interessante M&ouml;glichkeit,
 	  die endlose Suche nach der richtigen Download-Seite zu
 	  verk&uuml;rzen.</para>
 
 	<para>Stellen Sie sich zwei Dateien in
 	  <makevar>DISTFILES</makevar> und 20 Webseiten in der
 	  Variable <makevar>MASTER_SITES</makevar> vor. Alle Seiten
 	  sind erschreckend langsam, <filename>beta</filename>
 	  findet sich auf allen Seiten in
 	  <makevar>MASTER_SITES</makevar> und
 	  <filename>alpha</filename> kann nur auf der zwanzigsten
 	  Seite gefunden werden. W&auml;re es nicht reine
 	  Verschwendung, wenn der Maintainer alle Seiten zuvor
 	  &uuml;berpr&uuml;fen m&uuml;sste? Kein guter
 	  Start f&uuml;r das wundervolle Wochenende!</para>
 
 	<para>&Uuml;bertragen Sie diesen Umstand auf noch mehr
 	  <makevar>DISTFILES</makevar> und mehr
 	  <makevar>MASTER_SITES</makevar>. Ganz sicher w&uuml;rde
 	  unser <quote>distfiles survey master</quote> die
 	  Erleichterung sehr zu sch&auml;tzen wissen, die eine
 	  solche Verringerung der Netzwerkbelastung bringen
 	  w&uuml;rde.</para>
 
 	<para>In den n&auml;chsten Abschnitten sehen Sie die
 	  Implementierung dieser Idee durch FreeBSD. Dabei wurde das
 	  Konzept von OpenBSD ein wenig verbessert.</para>
 
 	<sect3>
 	  <title>Prinzipielle Information</title>
 
 	  <para>Dieser Abschnitt informiert Sie, wie Sie schnell
 	    ein fein granuliertes Herunterladen von vielen Dateien
 	    und Fehlerbereinigungen von verschiedenen Webseiten und
 	    Unterverzeichnissen bewerkstelligen. Wir beschreiben
 	    hier den Fall der vereinfachten Nutzung von
 	    <literal>MASTER_SITES:n</literal>. Das ist f&uuml;r die
 	    meisten Szenarien ausreichend. Falls Sie weitere
 	    Informationen ben&ouml;tigen, sollten Sie den
 	    n&auml;chsten Abschnitt lesen.</para>
 
 	  <para>Einige Programme bestehen aus mehreren Dateien,
 	    welche von verschiedenen Webseiten heruntergeladen werden
 	    m&uuml;ssen. Zum Beispiel besteht
 	    <application>Ghostscript</application> aus dem Kern des
 	    Programms und einer gro&szlig;en Zahl von Treiberdateien,
 	    die vom Drucker des Benutzers abh&auml;ngen. Einige dieser
 	    Treiberdateien werden mit der Kernapplikation mitgeliefert
 	    aber viele m&uuml;ssen von verschiedenen Webseiten
 	    heruntergeladen werden.</para>
 
 	  <para>Um das zu unterst&uuml;tzen, muss jeder Eintrag in
 	    <makevar>DISTFILES</makevar> mit einem Komma und
 	    einem <quote>tag name</quote> abgeschlossen werden.
 	    Jeder in <makevar>MASTER_SITES</makevar> aufgef&uuml;hrte
 	    Webseite folgt ein Komma und eine Marke (tag), die
 	    anzeigt, welche Datei von dieser Webseite heruntergeladen
 	    werden kann.</para>
 
 	  <para>Stellen Sie sich bitte eine Applikation vor, deren
 	    Quelltext in zwei Teile aufgeteilt ist,
 	    <filename>source1.tar.gz</filename>
 	    und <filename>source2.tar.gz</filename>, welche von zwei
 	    verschiedenen Webseiten heruntergeladen werden
 	    m&uuml;ssen. Das <filename>Makefile</filename> des Port
 	    w&uuml;rde Zeilen enthalten wie in
 	    <xref
 	    linkend="ports-master-sites-n-example-simple-use-one-file-per-site">.</para>
 
 	  <example
 	    id="ports-master-sites-n-example-simple-use-one-file-per-site">
 	    <title>Vereinfachtes Beispiel f&uuml;r den Gebrauch von
 	      <literal>MASTER_SITES:n</literal> mit einer Datei pro
 	      Webseite</title>
 
 	    <programlisting>MASTER_SITES=   ftp://ftp.example1.com/:source1 \
 	ftp://ftp.example2.com/:source2
 DISTFILES=      source1.tar.gz:source1 \
 	source2.tar.gz:source2</programlisting>
 	  </example>
 
 	  <para>Verschiedene Dateien k&ouml;nnen die gleiche Marke
 	    aufweisen. Ausgehend vom vorherigen Beispiel nehmen wir
 	    an, dass es noch eine dritte Datei gibt
 	    (<filename>source3.tar.gz</filename>), welche von
 	    <hostid>ftp.example2.com</hostid> heruntergeladen werden
 	    soll. Das <filename>Makefile</filename> w&uuml;rde dann
 	    aussehen wie <xref
 	    linkend="ports-master-sites-n-example-simple-use-more-than-one-file-per-site">.</para>
 
 	  <example
 	    id="ports-master-sites-n-example-simple-use-more-than-one-file-per-site">
 	    <title>Vereinfachtes Beispiel f&uuml;r den Gebrauch von
 	      <literal>MASTER_SITES:n</literal> mit mehr als einer
 	      Datei pro Webseite</title>
 
 	    <programlisting>MASTER_SITES=   ftp://ftp.example1.com/:source1 \
 	ftp://ftp.example2.com/:source2
 DISTFILES=      source1.tar.gz:source1 \
 	source2.tar.gz:source2 \
 	source3.tar.gz:source2</programlisting>
 	  </example>
 	</sect3>
 
 	<sect3>
 	  <title>Ausf&uuml;hrliche Information</title>
 
 	  <para>In Ordnung, das vorherige Beispiel reicht nicht
 	    f&uuml;r Ihre Bed&uuml;rfnisse? In diesem Abschnitt
 	    werden wir im Detail erkl&auml;ren, wie der fein
 	    granulierte Mechanismus zum Herunterladen
 	    (<literal>MASTER_SITES:n</literal>) funktioniert
 	    und wie Sie Ihre Ports modifizieren, um ihn zu
 	    nutzen.</para>
 
 	  <orderedlist>
 	    <listitem>
 	      <para>Elemente k&ouml;nnen nachstehend bezeichnet werden
 		mit <literal>:<replaceable>n</replaceable></literal>
 		wobei <replaceable>n</replaceable> in diesem Falle
 	        <literal>[^:,]+</literal> ist. Das hei&szlig;t
 	        <replaceable>n</replaceable> k&ouml;nnte theoretisch
 		jede alphanumerische Zeichenkette sein, aber wir
 		beschr&auml;nken sie auf
 		<literal>[a-zA-Z_][0-9a-zA-Z_]+</literal> f&uuml;r
 	        diesen Moment.</para>
 
 	      <para>Zudem ist die Zeichenkette case sensitive; d.h.
 	        <literal>n</literal> unterscheidet sich von
 	        <literal>N</literal>.</para>
 
 	      <para>Allerdings d&uuml;rfen die folgenden W&ouml;rter
 		nicht gebraucht werden, da sie spezielle Bedeutungen
 		haben: <literal>default</literal>,
 		<literal>all</literal> und <literal>ALL</literal>
 		(diese W&ouml;rter werden intern genutzt in Punkt
 		<xref linkend="porting-master-sites-n-what-changes-in-port-targets">).
 	        Ausserdem ist <literal>DEFAULT</literal> ein
 		reserviertes Wort (beachten Sie <xref
 		linkend="porting-master-sites-n-DEFAULT-group">).</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Elemente mit angeh&auml;ngtem
 		<literal>:n</literal> geh&ouml;ren zur Gruppe
 		<literal>n</literal>, <literal>:m</literal>
 		geh&ouml;rt zur Gruppe <literal>m</literal>
 		und so weiter.</para>
 	    </listitem>
 
 	    <listitem id="porting-master-sites-n-DEFAULT-group">
 	      <para>Elemente ohne Anh&auml;ngsel sind gruppenlos,
 		d.h. sie geh&ouml;ren alle zu der speziellen Gruppe
 	        <literal>DEFAULT</literal>. Falls sie an irgendeinem
 		Element <literal>DEFAULT</literal> h&auml;ngen, ist
 		dies &uuml;berfl&uuml;ssig, es sei denn Sie wollen,
 		dass ein Element sowohl zu <literal>DEFAULT</literal>
 		als auch anderen Gruppen gleichzeitig geh&ouml;rt
 		(beachten Sie <xref
 		linkend="porting-master-sites-n-comma-operator">).</para>
 
 	      <para>Die folgenden Beispiele sind gleichwertig, aber
 		das erste Beispiel ist vorzuziehen:</para>
 
 	      <programlisting>MASTER_SITES=   alpha
 
 MASTER_SITES=   alpha:DEFAULT</programlisting>
 	    </listitem>
 
 	    <listitem>
 	      <para>Gruppen sind nicht ausschliessend, d.h. ein
 		Element kann mehreren Gruppen gleichzeitig
 		angeh&ouml;ren und eine Gruppe wiederum kann entweder
 		mehrere Elemente oder &uuml;berhaupt keine aufweisen.
 		Wiederholte Elemente sind schlicht nur wiederholte
 		Elemente.</para>
 	    </listitem>
 
 	    <listitem id="porting-master-sites-n-comma-operator">
 	      <para>Wenn Sie wollen, dass ein Element gleichzeitig zu
 	        mehreren Gruppen geh&ouml;rt, dann k&ouml;nnen Sie
 		diese durch ein Komma (<literal>,</literal>)
 		trennen.</para>
 
 	      <para>Anstatt jedes Mal ein anderes Anh&auml;ngsel zu
 		verwenden und Wiederholungen aufzuf&uuml;hren,
 		k&ouml;nnen Sie mehrere Gruppen auf einmal in einem
 		einzigen Anh&auml;ngsel bestimmen. Zum Beispiel
 	        markiert <literal>:m,n,o</literal> ein Element,
 		welches zu den Gruppen <literal>m</literal>,
 	        <literal>n</literal> und <literal>o</literal>
 		geh&ouml;rt.</para>
 
 	      <para>Alle folgenden Beispiele sind gleichwertig,
 		aber das erste Beispiel ist vorzuziehen:</para>
 
 	      <programlisting>MASTER_SITES=   alpha alpha:SOME_SITE
 
 MASTER_SITES=   alpha:DEFAULT alpha:SOME_SITE
 
 MASTER_SITES=   alpha:SOME_SITE,DEFAULT
 
 MASTER_SITES=   alpha:DEFAULT,SOME_SITE</programlisting>
 	    </listitem>
 
 	    <listitem>
 	      <para>Alle Webseiten in einer Gruppe werden
 		gem&auml;&szlig; <makevar>MASTER_SORT_AWK</makevar>
 		sortiert. Alle Gruppen innerhalb von
 		<makevar>MASTER_SITES</makevar> und
 	        <makevar>PATCH_SITES</makevar> werden genauso
 		sortiert.</para>
 	    </listitem>
 
 	    <listitem id="porting-master-sites-n-group-semantics">
 	      <para>Gruppensemantik kann benutzt werden in den
 		folgenden Variablen: <makevar>MASTER_SITES</makevar>,
 	        <makevar>PATCH_SITES</makevar>,
 	        <makevar>MASTER_SITE_SUBDIR</makevar>,
 	        <makevar>PATCH_SITE_SUBDIR</makevar>,
 	        <makevar>DISTFILES</makevar> und
 	        <makevar>PATCHFILES</makevar> entsprechend der
 		folgenden Syntax:</para>
 
 	      <orderedlist>
 		<listitem>
 		  <para>Elemente mit <makevar>MASTER_SITES</makevar>,
 		    <makevar>PATCH_SITES</makevar>,
 		    <makevar>MASTER_SITE_SUBDIR</makevar> und
 		    <makevar>PATCH_SITE_SUBDIR</makevar> m&uuml;ssen
 		    mit einem Schr&auml;gstrich beendet werden (
 		    <literal>/</literal>). Falls Elemente zu
 		    irgendwelchen Gruppen geh&ouml;ren, muss
 		    <literal>:<replaceable>n</replaceable></literal>
 		    direkt nach dem Trenner <literal>/</literal>
 		    stehen. Der
 		    <literal>MASTER_SITES:n</literal>-Mechanismus
 		    verl&auml;sst sich auf das Vorhandensein des
 		    Trennzeichens <literal>/</literal>, um verwirrende
 		    Elemente zu vermeiden in denen
 		    <literal>:n</literal> ein zul&auml;ssiger
 		    Bestandteil des Elementes ist und das Auftreten
 		    von <literal>:n</literal> die Gruppe
 		    <literal>n</literal> anzeigt. Aus
 		    Kompatibilit&auml;tsgr&uuml;nden (da der
 		    <literal>/</literal>-Trenner sowohl in
 		    <makevar>MASTER_SITE_SUBDIR</makevar> als auch
 		    <makevar>PATCH_SITE_SUBDIR</makevar>-Elementen
 		    nicht erforderlich ist) wird, falls das auf das
 		    Anh&auml;ngsel folgende n&auml;chste Zeichen kein
 		    <literal>/</literal> ist, auch
 		    <literal>:n</literal> als g&uuml;ltiger Teil des
 		    Elementes behandelt anstatt als Gruppenzusatz,
 		    selbst wenn ein Element ein angeh&auml;ngtes
 		    <literal>:n</literal> aufweist. Beachten Sie
 		    sowohl <xref
 		    linkend="ports-master-sites-n-example-detailed-use-master-site-subdir">
 		    als auch <xref
 		    linkend="ports-master-sites-n-example-detailed-use-complete-example-master-sites">.</para>
 
 		  <example
 		    id="ports-master-sites-n-example-detailed-use-master-site-subdir">
 		    <title>Ausf&uuml;hrliches Beispiel von
 		      <literal>MASTER_SITES:n</literal> in
 		      <makevar>MASTER_SITE_SUBDIR</makevar></title>
 
 		    <programlisting>MASTER_SITE_SUBDIR=     old:n new/:NEW</programlisting>
 
 		    <itemizedlist>
 		      <listitem>
 			<para>Verzeichnisse innerhalb der Gruppe
 			  <literal>DEFAULT</literal> -&gt;
 			  old:n</para>
 		      </listitem>
 
 		      <listitem>
 			<para>Verzeichnisse innerhalb der Gruppe
 			  <literal>NEW</literal> -&gt; new</para>
 		      </listitem>
 		    </itemizedlist>
 		  </example>
 
 		  <example
 		    id="ports-master-sites-n-example-detailed-use-complete-example-master-sites">
 		    <title>Ausf&uuml;hrliches Beispiel von
 		      <literal>MASTER_SITES:n</literal> mit
 		      Komma-Operator, mehreren Dateien, mehreren
 		      Webseiten und mehreren
 	              Unterverzeichnissen</title>
 
 		    <programlisting>MASTER_SITES=   http://site1/%SUBDIR%/ http://site2/:DEFAULT \
 	http://site3/:group3 http://site4/:group4 \
 	http://site5/:group5 http://site6/:group6 \
 	http://site7/:DEFAULT,group6 \
 	http://site8/%SUBDIR%/:group6,group7 \
 	http://site9/:group8
 DISTFILES=      file1 file2:DEFAULT file3:group3 \
 	file4:group4,group5,group6 file5:grouping \
 	file6:group7
 MASTER_SITE_SUBDIR=     directory-trial:1 directory-n/:groupn \
 	    directory-one/:group6,DEFAULT \
 	    directory</programlisting>
 
 		    <para>Das vorstehende Beispiel f&uuml;hrt zu
 		      einem fein granulierten Herunterladen.
 		      Die Webseiten werden in der exakten Reihenfolge
 		      ihrer Nutzung aufgelistet.</para>
 
 		    <itemizedlist>
 		      <listitem>
 			<para><filename>file1</filename> wird
 			  heruntergeladen von</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><makevar>MASTER_SITE_OVERRIDE</makevar></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-trial:1/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-one/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site2/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site7/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><makevar>MASTER_SITE_BACKUP</makevar></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file2</filename> wird genauso
 			  heruntergeladen wie
 			  <filename>file1</filename>, da sie zur
 			  gleichen Gruppe geh&ouml;ren</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><makevar>MASTER_SITE_OVERRIDE</makevar></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-trial:1/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-one/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site2/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site7/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><makevar>MASTER_SITE_BACKUP</makevar></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file3</filename> wird
 			  heruntergeladen von</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><makevar>MASTER_SITE_OVERRIDE</makevar></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site3/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><makevar>MASTER_SITE_BACKUP</makevar></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file4</filename> wird
 			  heruntergeladen von</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><makevar>MASTER_SITE_OVERRIDE</makevar></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site4/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site5/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site6/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site7/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site8/directory-one/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><makevar>MASTER_SITE_BACKUP</makevar></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file5</filename> wird
 			  heruntergeladen von</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><makevar>MASTER_SITE_OVERRIDE</makevar></para>
 			  </listitem>
 
 			  <listitem>
 			    <para><makevar>MASTER_SITE_BACKUP</makevar></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file6</filename> wird
 			  heruntergeladen von</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><makevar>MASTER_SITE_OVERRIDE</makevar></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site8/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><makevar>MASTER_SITE_BACKUP</makevar></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 		    </itemizedlist>
 		  </example>
 		</listitem>
 	      </orderedlist>
 	    </listitem>
 
 	    <listitem>
 	      <para>Wie gruppiere ich eine der speziellen Variablen
 		aus <filename>bsd.sites.mk</filename>, d.h.
 	        <makevar>MASTER_SITE_SOURCEFORGE</makevar>?</para>
 
 	      <para>Lesen Sie <xref
 	       linkend="ports-master-sites-n-example-detailed-use-master-site-sourceforge">.</para>
 
 	      <example
 		id="ports-master-sites-n-example-detailed-use-master-site-sourceforge">
 		<title>Ausf&uuml;hrliches Beispiel von
 		  <literal>MASTER_SITES:n</literal> mit
 		  <makevar>MASTER_SITE_SOURCEFORGE</makevar></title>
 
 		<programlisting>MASTER_SITES=   http://site1/ ${MASTER_SITE_SOURCEFORGE:S/$/:sourceforge,TEST/}
 DISTFILES=      something.tar.gz:sourceforge</programlisting>
 	      </example>
 
 	      <para><filename>something.tar.gz</filename> wird von
 		allen Webseiten innerhalb von
 		<makevar>MASTER_SITE_SOURCEFORGE</makevar>
 	        heruntergeladen.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Wie nutze ich dies mit
 		<makevar>PATCH*</makevar>-Variablen.</para>
 
 	      <para>In allen Beispielen wurden
 		<makevar>MASTER*</makevar>-Variablen genutzt,
 		aber sie funktionieren exakt genauso mit
 		<makevar>PATCH*</makevar>-Variablen, wie Sie an
 	        <xref
 		linkend="ports-master-sites-n-example-detailed-use-patch-sites">.
 	        sehen k&ouml;nnen.</para>
 
 	      <example
 		id="ports-master-sites-n-example-detailed-use-patch-sites">
 		<title>Vereinfachte Nutzung von
 		  <literal>MASTER_SITES:n</literal> mit
 		  <makevar>PATCH_SITES</makevar>.</title>
 
 		<programlisting>PATCH_SITES=    http://site1/ http://site2/:test
 PATCHFILES=     patch1:test</programlisting>
 	      </example>
 	    </listitem>
 	  </orderedlist>
 	</sect3>
 
 	<sect3>
 	  <title>Was &auml;ndert sich f&uuml;r die Ports?
 	    Was &auml;ndert sich nicht?</title>
 
 	  <orderedlist numeration="lowerroman">
 	    <listitem>
 	      <para>Alle bestehenden Ports bleiben gleich. Der Code
 		f&uuml;r <literal>MASTER_SITES:n</literal> wird nur
 		aktiviert, falls es Elemente mit angeh&auml;ngtem
 	        <literal>:<replaceable>n</replaceable></literal>
 	        entsprechend den zuvor erw&auml;hnten Syntax-Regeln
 		wie in <xref
 		linkend="porting-master-sites-n-group-semantics">
 		gezeigt gibt.</para>
 	    </listitem>
 
 	    <listitem
 	      id="porting-master-sites-n-what-changes-in-port-targets">
 	      <para>Das Target des Port bleibt gleich:
 		<maketarget>checksum</maketarget>,
 	        <maketarget>makesum</maketarget>,
 		<maketarget>patch</maketarget>,
 	        <maketarget>configure</maketarget>,
 		<maketarget>build</maketarget> etc.
 	        Mit der offensichtlichen Ausnahme von
 		<maketarget>do-fetch</maketarget>,
 	        <maketarget>fetch-list</maketarget>,
 		<maketarget>master-sites</maketarget>
 	        und <maketarget>patch-sites</maketarget>.</para>
 
 	      <itemizedlist>
 		<listitem>
 		  <para><maketarget>do-fetch</maketarget>: nutzt die
 		    neue Gruppierung <makevar>DISTFILES</makevar> und
 		    <makevar>PATCHFILES</makevar> mit ihren darauf
 		    zutreffenden Gruppenelementen in
 		    <makevar>MASTER_SITES</makevar> und
 		    <makevar>PATCH_SITES</makevar> welche zutreffende
 		    Gruppenelemente sowohl in
 		    <makevar>MASTER_SITE_SUBDIR</makevar> als auch
 		    <makevar>PATCH_SITE_SUBDIR</makevar> aufweisen.
 		    Sehen Sie hierzu <xref
 		    linkend="ports-master-sites-n-example-detailed-use-complete-example-master-sites">.</para>
 		</listitem>
 
 		<listitem>
 		  <para><maketarget>fetch-list</maketarget>: arbeitet
 		    wie das alte <maketarget>fetch-list</maketarget>
 		    mit der Ausnahme, dass es nur wie
 		    <maketarget>do-fetch</maketarget>
 		    gruppiert.</para>
 		</listitem>
 
 		<listitem>
 		  <para><maketarget>master-sites</maketarget>
 		    und <maketarget>patch-sites</maketarget>:
 		    (inkompatibel zu &auml;lteren Versionen) geben
 		    nur die Elemente der Gruppe
 		    <literal>DEFAULT</literal> zur&uuml;ck.
 		    Beziehungsweise sie f&uuml;hren genau genommen
 		    die Targets von
 		    <maketarget>master-sites-default</maketarget> und
 		    <maketarget>patch-sites-default</maketarget>
 		    aus.</para>
 
 		  <para>Weiterhin ist der Gebrauch des Target entweder
 		    von <maketarget>master-sites-all</maketarget> oder
 		    <maketarget>patch-sites-all</maketarget> der
 		    direkten &Uuml;berpr&uuml;fung von
 		    <maketarget>MASTER_SITES</maketarget> oder
 		    <maketarget>PATCH_SITES</maketarget> vorzuziehen.
 		    Zudem ist nicht garantiert, dass das direkte
 		    &Uuml;berpr&uuml;fen in zuk&uuml;nftigen Versionen
 		    funktionieren wird. Sehen Sie <xref
 		    linkend="porting-master-sites-n-new-port-targets-master-sites-all">
 		    f&uuml;r weitere Informationen zu diesen neuen
 		    Port-Targets.</para>
 		</listitem>
 	      </itemizedlist>
 	    </listitem>
 
 	    <listitem>
 	      <para>Neue Port-Targets</para>
 
 	      <orderedlist>
 		<listitem>
 		  <para>Es gibt
 		    <maketarget>master-sites-<replaceable>n</replaceable></maketarget>
 		    und
 		    <maketarget>patch-sites-<replaceable>n</replaceable></maketarget>-Targets,
 		    welche die Elemente der jeweiligen Gruppe
 		    <replaceable>n</replaceable> innerhalb von
 		    <makevar>MASTER_SITES</makevar> und
 		    <makevar>PATCH_SITES</makevar> auflisten.
 		    Beispielweise werden sowohl
 		    <maketarget>master-sites-DEFAULT</maketarget> als
 		    auch <maketarget>patch-sites-DEFAULT</maketarget>
 		    die Elemente der Gruppe
 		    <literal>DEFAULT</literal>,
 		    <maketarget>master-sites-test</maketarget> und
 		    <maketarget>patch-sites-test</maketarget> der
 		    Gruppe <literal>test</literal> usw.
 		    zur&uuml;ckgeben.</para>
 		</listitem>
 
 		<listitem
 		  id="porting-master-sites-n-new-port-targets-master-sites-all">
 		  <para>Es gibt das neue Target
 		    <maketarget>master-sites-all</maketarget> und
 		    <maketarget>patch-sites-all</maketarget>,
 		    welche die Arbeit der alten Targets
 		    <maketarget>master-sites</maketarget> und
 		    <maketarget>patch-sites</maketarget>
 		    &uuml;bernehmen. Sie geben die Elemente aller
 		    Gruppen zur&uuml;ck,als w&uuml;rden sie zur
 		    gleichen Gruppe geh&ouml;ren - mit dem Vorbehalt,
 		    dass sie so viele
 		    <makevar>MASTER_SITE_BACKUP</makevar> und
 		    <makevar>MASTER_SITE_OVERRIDE</makevar> auflisten
 		    wie Gruppen mittels
 		    <makevar>DISTFILES</makevar> oder
 		    <makevar>PATCHFILES</makevar> definiert sind.
 		    Das gleiche gilt entsprechend f&uuml;r
 		    <maketarget>master-sites-all</maketarget> und
 		    <maketarget>patch-sites-all</maketarget>.</para>
 		</listitem>
 	      </orderedlist>
 	    </listitem>
 	  </orderedlist>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title><makevar>DIST_SUBDIR</makevar></title>
 
 	<para>Verhindern Sie, dass Ihr Port das Verzeichnis
 	  <filename>/usr/ports/distfiles</filename> in Unordnung
 	  bringt. Falls Ihr Port eine ganze Reihe von Dateien
 	  herunterladen muss oder eine Datei enth&auml;lt,
 	  die einen Namen hat, der m&ouml;glicherweise mit
 	  anderen Ports in Konflikt stehen k&ouml;nnte
 	  (d.h.<filename>Makefile</filename>), dann setzen Sie die
 	  Variable <makevar>DIST_SUBDIR</makevar> auf den Namen des
 	  Ports (<literal>${PORTNAME}</literal> oder
 	  <literal>${PKGNAMEPREFIX}${PORTNAME}</literal>
 	  sollte hervorragend funktionieren). Dies wird
 	  <makevar>DISTDIR</makevar> von der Vorgabe
 	  <filename>/usr/ports/distfiles</filename> auf
 	  <filename>/usr/ports/distfiles/<makevar>DIST_SUBDIR</makevar>
 	  </filename> &auml;ndern und stellt tats&auml;chlich alle
 	  f&uuml;r Ihren Port ben&ouml;tigten Dateien in dieses
 	  Unterverzeichnis.</para>
 
 	<para>Es wird zus&auml;tzlich nach dem Unterverzeichnis mit
 	  dem gleichen Namen auf der Sicherung der Hauptseite auf
 	  <filename>ftp.FreeBSD.org</filename> suchen (das
 	  ausdr&uuml;ckliche Setzen von <makevar>DISTDIR</makevar>
 	  in Ihrem <makevar>Makefile</makevar> wird dies nicht
 	  gew&auml;hrleisten, also nutzen Sie bitte
 	  <makevar>DIST_SUBDIR</makevar>).</para>
 
 	<note>
 	  <para>Dies hat keine Auswirkungen auf die Variable
 	    <makevar>MASTER_SITES</makevar>, die Sie in Ihrem
 	    <filename>Makefile</filename> definieren.</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><makevar>ALWAYS_KEEP_DISTFILES</makevar></title>
 
 	<para>Falls Ihr Port bin&auml;re Distfiles benutzt und eine
 	  Lizenz aufweist, die verlangt, dass das der Quelltext in
 	  Form bin&auml;rer Pakete verteilt werden muss, z.B. GPL,
 	  dann wird <makevar>ALWAYS_KEEP_DISTFILES</makevar> den
 	  &os; Build Cluster anweisen eine Kopie der Dateien in
 	  <makevar>DISTFILES</makevar> vorzuhalten. Nutzer dieser
 	  Ports ben&ouml;tigen generell diese Dateien nicht, daher
 	  ist es ein gutes Konzept, nur dann die Distfiles zu
 	  <makevar>DISTFILES</makevar> hinzuzuf&uuml;gen, wenn
 	  <makevar>PACKAGE_BUILDING</makevar> definiert ist.</para>
 
 	<example
 	  id="ports-master-sites-n-example-always-keep-distfiles">
 	  <title>Nutzung von
 	    <makevar>ALWAYS_KEEP_DISTFILES</makevar>.</title>
 
 	  <programlisting>.if defined(PACKAGE_BUILDING)
 DISTFILES+=             <replaceable>foo.tar.gz</replaceable>
 ALWAYS_KEEP_DISTFILES=  yes
 .endif</programlisting>
 	</example>
 
 	<para>Wenn Sie zus&auml;tzliche Dateien zu
 	  <makevar>DISTFILES</makevar> hinzuf&uuml;gen,
 	  dann beachten Sie bitte, dass Sie diese auch in
 	  <filename>distinfo</filename> auff&uuml;hren.
 	  Zudem werden die zus&auml;tzlichen Dateien normalerweise
 	  ebenso in <makevar>WRKDIR</makevar> extrahiert,
 	  was f&uuml;r einige Ports zu unbeabsichtigten
 	  Seiteneffekten f&uuml;hren mag und spezielle
 	  Behandlung erfordert.</para>
       </sect2>
     </sect1>
 
     <sect1 id="makefile-maintainer">
       <title><makevar>MAINTAINER</makevar></title>
 
       <para>F&uuml;gen Sie hier Ihre E-Mailadresse ein. Bitte.
 	<!-- smiley --><emphasis>:-)</emphasis></para>
 
       <para>Beachten Sie bitte, dass nur eine einzelne E-Mailadresse
 	ohne Kommentar in der Variable <makevar>MAINTAINER</makevar>
 	zul&auml;ssig ist. Das Format sollte
 	<literal>user@hostname.domain</literal> sein.
 	Bitte f&uuml;gen Sie keinen beschreibenden Text wie z.B. Ihren
 	wirklichen Namen ein, dies verwirrt lediglich
 	<filename>bsd.port.mk</filename>.</para>
 
       <para>Der Maintainer ist daf&uuml;r verantwortlich, dass der
 	Port aktuell gehalten wird und er sorgt daf&uuml;r, dass der
 	Port korrekt arbeitet. F&uuml;r eine detaillierte Beschreibung
 	der Verantwortlichkeiten eines Maintainers beachten Sie bitte
 	den Abschnitt <ulink
 	url="&url.articles.contributing-ports;/maintain-port.html">
 	Die Herausforderung f&uuml;r einen
 	Port-Maintainer</ulink>.</para>
 
       <para>&Auml;nderungen am Port werden dem Maintainer zur
 	Begutachtung und Zustimmung vorgelegt, bevor sie committed
 	werden. Falls der Maintainer einem Aktualisierungs-Wunsch
 	nicht binnen 2 Wochen (ausgenommen wichtige &ouml;ffentliche
 	Feiertage) zustimmt, dann wird dies als Maintainer-Timeout
 	betrachtet und eine Aktualisierung kann ohne
 	ausdr&uuml;ckliche Zustimmung des Maintainers erfolgen.
 	Falls der Maintainer nicht binnen 3 Monaten zustimmt, wird er
 	als abwesend ohne Grund betrachtet und kann als Maintainer
 	des fraglichen Ports durch eine andere Person ersetzt werden.
 	Ausgenommen davon ist alles, was durch das &a.portmgr; oder
 	das &a.security-officer; betreut wird. Es d&uuml;rfen niemals
 	committs ohne vorherige Zustimmung an solchen Ports
 	vorgenommen werden!</para>
 
       <para>Wir behalten uns das Recht vor, die Einreichungen eines
 	Maintainers ohne ausdr&uuml;ckliche Zustimmung zu &auml;ndern,
 	falls wir der Auffassung sind, dass dadurch die Einhaltung von
 	Richtlinien und stilistischen Vorgaben f&uuml;r die
 	Ports-Sammlung besser erf&uuml;llt wird. Zudem k&ouml;nnen
 	gr&ouml;&szlig;ere &Auml;nderungen an der Infrastruktur der
 	Ports zu &Auml;nderungen an einem bestimmten Port ohne
 	Zustimmung des Maintainers f&uuml;hren.
 	Diese &Auml;nderungen beeinflussen niemals die
 	Funktionalit&auml;t eines Ports.</para>
 
       <para>Das &a.portmgr; beh&auml;lt sich das Recht vor, die
 	Maintainerschaft jedem aus irgendeinem Grund zu entziehen oder
 	ausser Kraft zu setzen, und das Security Officer Team
 	&a.security-officer; beh&auml;lt sich das Recht vor, jede
 	Maintainerschaft aus Sicherheitsgr&uuml;nden aufzuheben oder
 	ausser Kraft zu setzen.</para>
     </sect1>
 
     <sect1 id="makefile-comment">
       <title><makevar>COMMENT</makevar></title>
 
       <para>Dies ist eine einzeilige Beschreibung des Ports.
 	<emphasis>Bitte</emphasis> f&uuml;gen Sie nicht den Paketnamen
 	(oder die Version der Software) in den Kommentar ein.
 	Der Kommentar soll mit einem Gro&szlig;buchstaben beginnen
 	und mit einem Punkt enden. Hier ist ein Beispiel:</para>
 
       <programlisting>COMMENT=       A cat chasing a mouse all over the screen</programlisting>
 
       <para>Die COMMENT-Variable soll unmittelbar nach der
 	MAINTAINER-Variable im <filename>Makefile</filename>
 	stehen.</para>
 
       <para>Bitte versuchen Sie die COMMENT-Zeile auf weniger als 70
 	Zeichen zu begrenzen, da sie den Nutzern als einzeilige
 	Zusammenfassung des Ports angezeigt wird.</para>
     </sect1>
 
     <sect1 id="makefile-depend">
       <title>Abh&auml;ngigkeiten (dependencies)</title>
 
       <para>Viele Ports h&auml;ngen von anderen Ports ab.
 	Es gibt sieben Variablen, welche Sie benutzen k&ouml;nnen,
 	um sicherzustellen, dass alle ben&ouml;tigten Teile auf dem
 	Rechner des Nutzers sind. Zus&auml;tzlich gibt es einige
 	vordefinierte Variablen f&uuml;r Abh&auml;ngigkeiten in
 	h&auml;ufigen F&auml;llen und einige, welche das Verhalten
 	der Abh&auml;ngigkeiten bestimmen.</para>
 
       <sect2>
 	<title><makevar>LIB_DEPENDS</makevar></title>
 
 	<para>Diese Variable spezifiziert die Shared-Libraries,
 	  von denen der Port abh&auml;ngt. Es ist eine Liste von
 	  <replaceable>lib</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>-Tupeln
 	  wobei <replaceable>lib</replaceable> den Name der gemeinsam
 	  genutzten Bibliothek, <replaceable>dir</replaceable> das
 	  Verzeichnis, in welchem sie zu finden ist, falls nicht
 	  verf&uuml;gbar, und <replaceable>target</replaceable> das
 	  Target in diesem Verzeichnis angeben. Zum Beispiel wird
 
 	  <programlisting>LIB_DEPENDS=   jpeg.9:${PORTSDIR}/graphics/jpeg</programlisting>
 
 	  auf eine jpeg-Bibliothek mit der Hauptversionsnummer 9
 	  pr&uuml;fen, in das
 	  <filename>graphics/jpeg</filename>-Unterverzeichnis Ihrer
 	  Ports-Sammlung wechseln, es bauen und installieren, falls
 	  es nicht gefunden wird.
 	  Der <replaceable>target</replaceable>-Teil kann weggelassen
 	  werden, falls er identisch mit
 	  <makevar>DEPENDS_TARGET</makevar> ist (Vorgabe hierf&uuml;r
 	  ist <literal>install</literal>).</para>
 
 	<note>
 	  <para>Der <replaceable>lib</replaceable>-Teil ist ein
 	    regul&auml;rer Ausdruck, welcher die Ausgabe von
 	    <command>ldconfig -r</command> ausgewertet. Werte wie
 	    <literal>intl.[5-7]</literal> und <literal>intl</literal>
 	    sind zul&auml;ssig. Das erste Muster,
 	    <literal>intl.[5-7]</literal>, stimmt &uuml;berein mit:
 	    <literal>intl.5</literal>, <literal>intl.6</literal> oder
 	    <literal>intl.7</literal>. Das zweite Muster,
 	    <literal>intl</literal>, stimmt &uuml;berein mit jeder
 	    Version der <literal>intl</literal>-Bibliothek.</para>
 	</note>
 
 	<para>Die Abh&auml;ngigkeit wird zwei Mal &uuml;berpr&uuml;ft,
 	  einmal innerhalb des <maketarget>extract</maketarget>-Target
 	  und dann innerhalb des
 	  <maketarget>install</maketarget>-Target.
 	  Zudem wird der Name der Abh&auml;ngigkeit in das Paket
 	  eingef&uuml;gt, damit &man.pkg.add.1; es automatisch
 	  installiert, falls es nicht auf dem Rechner des Nutzers
 	  ist.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>RUN_DEPENDS</makevar></title>
 
 	<para>Diese Variable legt Bin&auml;rdateien oder Dateien,
 	  von denen der Port abh&auml;ngt, f&uuml;r die Laufzeit fest.
 	  Es ist eine Liste von
 	  <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>-Tupeln,
 	  wobei <replaceable>path</replaceable> der Name der
 	  Bin&auml;rdatei oder Datei, <replaceable>dir</replaceable>
 	  das Verzeichnis, in welchem sie gefunden werden kann, falls
 	  nicht vorhanden, und <replaceable>target</replaceable> das
 	  Target in diesem Verzeichnis angeben.
 	  Falls <replaceable>path</replaceable> mit einem Slash
 	  (<literal>/</literal>) beginnt, wird es als Datei behandelt
 	  und deren Vorhandensein wird mit <command>test -e</command>;
 	  &uuml;berpr&uuml;ft. Andernfalls wird angenommen, dass es
 	  eine Bin&auml;rdatei ist und <command>which -s</command>
 	  wird benutzt, um zu &uuml;berpr&uuml;fen, ob das Programm im
 	  Pfad vorhanden ist.</para>
 
 	<para>Zum Beispiel wird</para>
 
 	<programlisting>RUN_DEPENDS=   ${LOCALBASE}/etc/innd:${PORTSDIR}/news/inn \
 	   wish8.0:${PORTSDIR}/x11-toolkits/tk80</programlisting>
 
 	<para>&uuml;berpr&uuml;fen, ob die Datei oder das Verzeichnis
 	  <filename>/usr/local/etc/innd</filename> existiert und es
 	  erstellen und installieren aus dem
 	  <filename>news/inn</filename>-Unterverzeichnis der
 	  Ports-Sammlung, falls es nicht gefunden wird. Es wird zudem
 	  &uuml;berpr&uuml;ft, ob die Bin&auml;rdatei namens
 	  <command>wish8.0</command> im Suchpfad vorhanden ist und
 	  danach zum Unterverzeichnis
 	  <filename>x11-toolkits/tk80</filename> in Ihrer
 	  Ports-Sammlung wechseln, es bauen und installieren,
 	  falls es nicht gefunden wird.</para>
 
 	<note>
 	  <para>In diesem Fall ist <command>innd</command> eine
 	    Bin&auml;rdatei. Falls sich eine Bin&auml;rdatei an
 	    einem ungew&ouml;hnlichen Platz befindet, der nicht
 	    im Suchpfad ist, dann sollten Sie die volle Pfadangabe
 	    verwenden.</para>
 	</note>
 
 	<note>
 	  <para>Der offizielle Suchpfad <envar>PATH</envar>,
 	    welcher im Ports Cluster benutzt wird, ist</para>
 
 	  <programlisting>/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:/usr/X11R6/bin</programlisting>
 	</note>
 
 	<para>Die Abh&auml;ngigkeit wird innerhalb des
 	  <maketarget>install</maketarget>-Target
 	  &uuml;berpr&uuml;ft. Zudem wird der Name der
 	  Abh&auml;ngigkeit in das Paket &uuml;bernommen,
 	  damit &man.pkg.add.1; es automatisch installieren wird,
 	  falls es auf dem System des Nutzers nicht vorhanden ist.
 	  Der <replaceable>target</replaceable>-Teil kann
 	  weggelassen werden, wenn er der gleiche ist wie in der
 	  Variable <makevar>DEPENDS_TARGET</makevar>.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>BUILD_DEPENDS</makevar></title>
 
 	<para>Diese Variable legt Bin&auml;rdateien oder Dateien fest,
 	  die dieser Port zur Erstellung ben&ouml;tigt. Wie
 	  <makevar>RUN_DEPENDS</makevar> ist es eine Liste von
 	  <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>-Tupeln.
 	  Zum Beispiel wird
 
 	  <programlisting> BUILD_DEPENDS=
 	  unzip:${PORTSDIR}/archivers/unzip</programlisting>
 
 	  &uuml;berpr&uuml;fen, ob eine Bin&auml;rdatei
 	  <command>unzip</command> vorhanden ist und in das
 	  Unterverzeichnis <filename>archivers/unzip</filename>
 	  Ihrer Ports-Sammlung wechseln und sie erstellen und
 	  installieren, falls sie nicht gefunden wird.</para>
 
 	<note>
 	  <para><quote>Erstellen</quote> bedeutet hier alles von der
 	    Extraktion bis zur Kompilierung. Die Abh&auml;ngigkeit
 	    wird im <maketarget>extract</maketarget>-Target
 	    &uuml;berpr&uuml;ft.
 	    Der <replaceable>target</replaceable>-Teil kann
 	    weggelassen werden, falls er identisch mit der Variable
 	    <makevar>DEPENDS_TARGET</makevar> ist.</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><makevar>FETCH_DEPENDS</makevar></title>
 
 	<para>Diese Variable legt eine Bin&auml;rdatei oder Datei
 	  fest, welche der Port ben&ouml;tigt, um heruntergeladen
 	  werden zu k&ouml;nnen. Wie die vorherigen beiden Variablen
 	  ist er eine Liste von
 	  <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>-Tupeln.
 	  Zum Beispiel wird
 
 	  <programlisting> FETCH_DEPENDS=
 	  ncftp2:${PORTSDIR}/net/ncftp2</programlisting>
 
 	  &uuml;berpr&uuml;fen, ob eine Bin&auml;rdatei namens
 	  <command>ncftp2</command> vorhanden ist, in das
 	  Unterverzeichnis <filename>net/ncftp2</filename> Ihrer
 	  Ports-Sammlung wechseln, sie erstellen und installieren,
 	  falls sie nicht gefunden wird.</para>
 
 	<para>Die Abh&auml;ngigkeit wird innerhalb des
 	  <maketarget>fetch</maketarget>-Target &uuml;berpr&uuml;ft.
 	  Der <replaceable>target</replaceable>-Teil kann weggelassen
 	  werden, falls er identisch mit der Variable
 	  <makevar>DEPENDS_TARGET</makevar> ist.</para>
       </sect2>
 
       <sect2>
 	<title><makevar>EXTRACT_DEPENDS</makevar></title>
 
 	<para>Diese Variable spezifiziert eine Bin&auml;rdatei oder
 	  eine Datei, welche dieser Port f&uuml;r die Extraktion
 	  ben&ouml;tigt. Wie die vorherigen Variablen ist er eine
 	  Liste von
 	  <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>-Tupeln.
 	  Zum Beispiel wird
 
 	  <programlisting>EXTRACT_DEPENDS=
 	  unzip:${PORTSDIR}/archivers/unzip</programlisting>
 
 	  &uuml;berpr&uuml;fen, ob eine Bin&auml;rdatei namens
 	  <command>unzip</command> vorhanden ist, in das
 	  Unterverzeichnis <filename>archivers/unzip</filename>
 	  Ihrer Ports-Sammlung wechseln, sie erstellen und
 	  installieren, falls sie nicht gefunden wird.</para>
 
 	<para>Die Abh&auml;ngigkeit wird innerhalb des
 	  <maketarget>extract</maketarget>-Target &uuml;berpr&uuml;ft.
 	  Der <replaceable>target</replaceable>-Teil kann weggelassen
 	  werden, falls er identisch mit der Variable
 	  <makevar>DEPENDS_TARGET</makevar> ist.</para>
 
 	<note>
 	  <para>Nutzen Sie diese Variable nur, wenn die Extraktion
 	    nicht funktioniert (die Vorgabe nimmt
 	    <command>gzip</command> an) und nicht mit
 	    <makevar>USE_ZIP</makevar> oder
 	    <makevar>USE_BZIP2</makevar> wie in <xref
 	    linkend="use-vars"> beschrieben zum Laufen gebracht
 	    werden kann.</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><makevar>PATCH_DEPENDS</makevar></title>
 
 	<para>Diese Variable legt eine Bin&auml;rdatei oder eine
 	  Datei fest, welche dieser Port zum Patchen ben&ouml;tigt.
 	  Wie die vorhergehenden Variablen ist diese eine Liste von
 	  <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>-Tupeln.
 	  Zum Beispiel wird
 
 	  <programlisting> PATCH_DEPENDS=
 	  ${NONEXISTENT}:${PORTSDIR}/java/jfc:extract
 	  </programlisting>
 
 	  in das Unterverzeichnis <filename>java/jfc</filename> Ihrer
 	  Ports-Sammlung wechseln, um es zu entpacken.</para>
 
 	<para>Die Abh&auml;ngigkeit wird innerhalb des
 	  <maketarget>patch</maketarget>-Target &uuml;berpr&uuml;ft.
 	  Der <replaceable>target</replaceable>-Teil kann entfallen,
 	  falls er identisch mit der Variable
 	  <makevar>DEPENDS_TARGET</makevar> ist.</para>
       </sect2>
 
       <sect2 id="use-vars">
 	<title><makevar>USE_<replaceable>*</replaceable></makevar>
 	  </title>
 
 	<para>Es gibt eine Reihe von Variablen, um gebr&auml;uchliche
 	  Abh&auml;ngigkeiten einzukapseln, die viele Ports aufweisen.
 	  Obwohl Ihre Verwendung optional ist, k&ouml;nnen sie helfen
 	  die &Uuml;bersichtlichkeit des <filename>Makefile</filename>
 	  eines Ports zu erh&ouml;hen. Jede von ihnen ist im Stil von
 	  <makevar>USE_<replaceable>*</replaceable></makevar>.
 	  Der Gebrauch dieser Variablen ist beschr&auml;nkt auf das
 	  <filename>Makefile</filename> eines Ports und
 	  <filename>ports/Mk/bsd.*.mk</filename>. Es ist nicht
 	  entworfen worden, um durch den Nutzer setzbare Optionen
 	  einzukapseln; benutzen Sie
 	  <makevar>WITH_<replaceable>*</replaceable></makevar> und
 	  <makevar>WITHOUT_<replaceable>*</replaceable></makevar>
 	  f&uuml;r diese Zwecke.</para>
 
 	<note>
 	  <para>Es ist <emphasis>immer</emphasis> falsch, irgendeine
 	    <makevar>USE_<replaceable>*</replaceable></makevar>-Variable
 	    in der <filename>/etc/make.conf</filename> zu setzen.
 	    Zum Beispiel w&uuml;rde das Setzen von
 
 	    <programlisting>USE_GCC=3.2</programlisting>
 
 	    eine Abh&auml;ngigkeit f&uuml;r GCC32 f&uuml;r jeden Port
 	    einschliesslich GCC32 selbst hinzuf&uuml;gen!</para>
 	</note>
 
 	<table frame="none">
 	  <title>Die
 	    <makevar>USE_<replaceable>*</replaceable></makevar>-Varibalen
 	    </title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 		<entry>Bedeutung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_BZIP2</makevar></entry>
 		<entry>Der Tarball dieses Ports wird mit
 		  <command>bzip2</command> komprimiert.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_ZIP</makevar></entry>
 		<entry>Der Tarball des Ports wird mit
 		  <command>zip</command> komprimiert.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_BISON</makevar></entry>
 		<entry>Der Port benutzt <command>bison</command>
 		  f&uuml;r die Erstellung.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_CDRTOOLS</makevar></entry>
 		<entry>Der Port erfordert
 		  <application>cdrecord</application> entweder von
 		  <filename role="package">sysutils/cdrtools
 		  </filename> oder <filename
 		  role="package">sysutils/cdrtools-cjk</filename>,
 		  abh&auml;ngig davon, was der Nutzer vorgibt.
 		</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_GCC</makevar></entry>
 		<entry>Dieser Port ben&ouml;tigt eine bestimmte
 		  Version von <command>gcc</command> zur Erstellung.
 		  Die genaue Version kann festgelegt werden mit
 		  Werten wie <literal>3.2</literal>.
 		  Mit <literal>3.2+</literal> kann die mindestens
 		  erforderliche Version spezifiziert werden.
 		  Der <command>gcc</command> aus
 		  dem Basissystem wird genutzt, wenn er die
 		  erforderliche Version erf&uuml;llt, andernfalls wird
 		  eine geeignete Version des <command>gcc</command>
 		  aus den Ports kompiliert und die Variablen
 		  <makevar>CC</makevar> und <makevar>CXX</makevar>
 		  werden angepasst.</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Variablen zugeh&ouml;rig zu
 	  <application>gmake</application> und dem
 	  <filename>configure</filename>-Skript werden in
 	  <xref linkend="building"> beschrieben, w&auml;hrenddessen
 	  <application>autoconf</application>,
 	  <application>automake</application> und
 	  <application>libtool</application> in
 	  <xref linkend="using-autotools"> beschrieben sind.
 	  <application>Perl</application>-spezifische Variablen
 	  werden in <xref linkend="using-perl"> behandelt.
 	  X11-Variablen sind aufgelistet in
 	  <xref linkend="using-x11">. <xref linkend="using-gnome">
 	  behandelt GNOME-bezogene Variablen und <xref
 	  linkend="using-kde"> KDE-bezogene Variablen.
 	  <xref linkend="using-java"> dokumentiert Java-Variablen,
 	  w&auml;hrend <xref linkend="using-php">Informationen zu
 	  <application>Apache</application>,
 	  <application>PHP</application> und PEAR-Modulen
 	  enth&auml;lt.
 	  <application>Python</application> wird in
 	  <xref linkend="using-python"> und
 	  <application>Ruby</application> in
 	  <xref linkend="using-ruby"> er&ouml;rtert.
 	  <xref linkend="using-sdl"> stellt Variablen f&uuml;r
 	  <application>SDL</application>-Programme zur Verf&uuml;gung
 	  und <xref linkend="using-xfce"> enth&auml;lt schliesslich
 	  Variablen f&uuml;r <application>Xfce</application>.</para>
       </sect2>
 
       <sect2>
 	<title>Minimale Version einer Abh&auml;ngigkeit</title>
 
 	<para>Eine minimale Version einer Abh&auml;ngigkeit kann in
 	  jeder <makevar>*_DEPENDS</makevar>-Variable festgelegt
 	  werden mit Ausnahme von <makevar>LIB_DEPENDS</makevar>
 	  durch Anwendung folgender Syntax:</para>
 
 	<programlisting>p5-Spiffy>=0.26:${PORTSDIR}/devel/p5-Spiffy</programlisting>
 
 	<para>Das erste Feld enth&auml;lt einen abh&auml;ngigen
 	  Paketnamen, welcher einem Eintrag in der Paketdatenbank
 	  entsprechen muss und einen Vergleich mit einer
 	  Paketversion. Die Abh&auml;ngigkeit wird erf&uuml;llt,
 	  wenn p5-Spiffy-0.26 oder eine neuere Version
 	  auf dem System installiert ist.</para>
       </sect2>
 
       <sect2>
 	<title>Anmerkungen zu Abh&auml;ngigkeiten</title>
 
 	<para>Wie vorstehend beschrieben ist das Vorgabe-Target
 	  <maketarget>DEPENDS_TARGET</maketarget>, wenn eine
 	  Abh&auml;ngigkeit ben&ouml;tigt wird.
 	  Die Vorgabe hierf&uuml;r ist <literal>install</literal>.
 	  Dies ist eine Nutzer-Variable; sie wird niemals im
 	  <filename>Makefile</filename> eines Ports definiert.
 	  Falls Ihr Port einen besonderen Weg ben&ouml;tigt,
 	  um mit einer Abh&auml;ngigkeit umzugehen, dann benutzen
 	  Sie bitte den <literal>:target</literal>-Teil der
 	  <makevar>*_DEPENDS</makevar>-Variablen, anstatt
 	  <makevar>DEPENDS_TARGET</makevar> zu &auml;ndern.</para>
 
 	<para>Falls Sie <command>make clean</command> schreiben,
 	  werden dessen Abh&auml;ngigkeiten auch ges&auml;ubert.
 	  Falls Sie dies nicht wollen, definieren Sie die Variable
 	  <makevar>NOCLEANDEPENDS</makevar> in Ihrer Umgebung.
 	  Dies kann besonders erstrebenswert sein, wenn der Port
 	  etwas in seiner Liste von Abh&auml;ngigkeiten hat,
 	  das sehr viel Zeit f&uuml;r einen rebuild ben&ouml;tigt
 	  wie KDE, GNOME oder Mozilla.</para>
 
 	<para>Um von einem anderen Port bedingungslos abh&auml;ngig
 	  zu sein, benutzen Sie bitte die Variable
 	  <makevar>${NONEXISTENT}</makevar> als erstes Feld von
 	  <makevar>BUILD_DEPENDS</makevar> oder
 	  <makevar>RUN_DEPENDS</makevar>. Benutzen Sie dies nur,
 	  wenn Sie den Quelltext eines anderen Port ben&ouml;tigen.
 	  Sie k&ouml;nnen auch oft Kompilierzeit sparen, wenn Sie das
 	  Target festlegen. Zum Beispiel wird
 
 	  <programlisting>BUILD_DEPENDS=   ${NONEXISTENT}:${PORTSDIR}/graphics/jpeg:extract</programlisting>
 
 	  immer zum <literal>jpeg</literal>-Port wechseln und ihn
 	  extrahieren.</para>
       </sect2>
 
       <sect2>
 	<title>Zirkul&auml;re Abh&auml;ngigkeiten sind fatal</title>
 
 	<important>
 	  <para>F&uuml;hren Sie niemals irgendwelche zirkul&auml;ren
 	    Abh&auml;ngigkeiten in der Ports-Sammlung ein!</para>
 	</important>
 
 	<para>Die Struktur f&uuml;r die Erstellung von Ports dulde
 	  keinerlei zirkul&auml;re Abh&auml;ngigkeiten. Falls Sie
 	  dennoch eine verwenden, wird es irgendjemanden irgendwo auf
 	  der Welt geben, dessen FreeBSD-Installation nahezu sofort
 	  zusammenbricht und vielen anderen wird es sehr schnell
 	  genauso ergehen.
 	  So etwas kann extrem schwer festzustellen sein.
 	  Falls Sie Zweifel haben vor einer &Auml;nderung,
 	  dann vergewissern Sie sich, dass Sie folgendes getan haben:
 	  <command>cd /usr/ports; make index</command>.
 	  Dieser Prozess kann auf alten Maschinen sehr langsam sein,
 	  aber Sie ersparen sich und einer Vielzahl von Menschen
 	  m&ouml;glicherweise eine Menge &Auml;rger.</para>
       </sect2>
     </sect1>
 
     <sect1 id="makefile-masterdir">
       <title><makevar>MASTERDIR</makevar></title>
 
       <para>Falls Ihr Port wegen einer Variable, die verschiedene
 	Werte annimmt  (z.B. Aufl&ouml;sung oder
 	Papiergr&ouml;&szlig;e), leicht unterschiedliche Versione
 	von Paketen erzeugen muss, dann legen Sie bitte ein
 	Unterverzeichnis pro Paket an, um es f&uuml;r den Nutzer
 	einfacher begreiflich zu machen, was zu machen ist.
 	Aber versuchen Sie dabei so viele Dateien wie m&ouml;glich
 	zwischen diesen Ports gemeinsam zu nutzen.
 	Normalerweise ben&ouml;tigen Sie nur ein sehr kurzes
 	<filename>Makefile</filename> in allen ausser einem
 	Unterverzeichnis, wenn Sie Variablen intelligent nutzen.
 	In diesem einzigen <filename>Makefile</filename> k&ouml;nnen
 	Sie <makevar>MASTERDIR</makevar> verwenden, um anzugeben,
 	wo der Rest der Dateien liegt. Benutzen Sie bitte auch eine
 	Variable f&uuml;r <link linkend="porting-pkgname">
 	<makevar>PKGNAMESUFFIX</makevar></link>, damit die Pakete
 	unterschiedliche Namen haben werden.</para>
 
       <para>Wir demonstrieren dies am Besten an einem Beispiel. Es ist
 	Teil von
 	<filename>japanese/xdvi300/Makefile</filename>;</para>
 
       <programlisting>PORTNAME=       xdvi
 PORTVERSION=    17
 PKGNAMEPREFIX=  ja-
 PKGNAMESUFFIX=  ${RESOLUTION}
  :
 # default
 RESOLUTION?=   300
 .if ${RESOLUTION} != 118 && ${RESOLUTION} != 240 && \
        ${RESOLUTION} != 300 && ${RESOLUTION} != 400
        @${ECHO_MSG} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\""
        @${ECHO_MSG} "Possible values are: 118, 240, 300 (default) and 400."
        @${FALSE}
 .endif</programlisting>
 
       <para><filename role="package">japanese/xdvi300</filename>
 	verf&uuml;gt ebenfalls &uuml;ber alle Patches, Paket-Dateien
 	usw. Wenn Sie <command>make</command> eintippen, wird der Port
 	die Standardvorgabe f&uuml;r die Aufl&ouml;sung nehmen (300)
 	und den Port ganz normal erstellen.</para>
 
       <para>Genauso wie f&uuml;r alle anderen Aufl&ouml;sungen ist
 	dies das <emphasis>vollst&auml;ndige</emphasis>
 	<filename>xdvi118/Makefile</filename>:</para>
 
       <programlisting>RESOLUTION=     118
 MASTERDIR=      ${.CURDIR}/../xdvi300
 
 .include "${MASTERDIR}/Makefile"</programlisting>
 
       <para>(<filename>xdvi240/Makefile</filename> und
 	<filename>xdvi400/Makefile</filename> sind &auml;hnlich).
 	Die <makevar>MASTERDIR</makevar>-Definition teilt dem
 	<filename>bsd.port.mk</filename> mit, dass die normalen
 	Unterverzeichnisse wie <makevar>FILESDIR</makevar> und
 	<makevar>SCRIPTDIR</makevar> unter
 	<filename>xdvi300</filename> gefunden werden k&ouml;nnen.
 	Die <literal>RESOLUTION=118</literal>-Zeile wird die
 	<literal>RESOLUTION=300</literal>-Zeile in
 	<filename>xdvi300/Makefile</filename> &uuml;berschreiben
 	und der Port wird mit einer Aufl&ouml;sung von 118
 	erstellt.</para>
     </sect1>
 
     <sect1 id="makefile-manpages">
       <title>Manualpages</title>
 
       <para>Die Variablen <makevar>MAN[1-9LN]</makevar>
 	werden automatisch jede Manualpage zur
 	<filename>pkg-plist</filename> hinzuf&uuml;gen
 	(dies bedeutet, dass Sie Manualpages
 	<emphasis>nicht</emphasis> in der
 	<filename>pkg-plist</filename> auflisten d&uuml;rfen,
 	lesen Sie bitte <link linkend="plist-sub">Erstellung
 	der PLIST</link> f&uuml;r weitere Details).
 	Sie veranlassen zudem den Installationsabschnitt
 	dazu, die Manualpages zu Komprimieren oder zu Dekomprimieren
 	abh&auml;ngig vom gesetzten Wert der Variable
 	<makevar>NOMANCOMPRESS</makevar> in
 	<filename>/etc/make.conf</filename>.</para>
 
       <para>Falls Ihr Port versucht verschiedene Namen f&uuml;r
 	Manualpages unter Zuhilfenahme von Symlinks oder Hardlinks
 	zu installieren, m&uuml;ssen Sie die Variable
 	<makevar>MLINKS</makevar> nutzen, um diese zu identifizieren.
 	Der von Ihrem Port installierte Link wird von
 	<filename>bsd.port.mk</filename> gel&ouml;scht und wieder
 	eingef&uuml;gt, um sicherzustellen, dass er auf die korrekte
 	Datei zeigt. Jede Manualpage, welche in
 	<makevar>MLINKS</makevar> aufgef&uuml;hrt ist, darf nicht in
 	der <filename>pkg-plist</filename> aufgenommen werden.</para>
 
       <para>Falls die Manualpages w&auml;hrend der Installation
 	komprimiert werden sollen, m&uuml;ssen Sie die Variable
 	<makevar>MANCOMPRESSED</makevar> setzen. Diese Variable kann
 	drei Werte annehmen, <literal>yes</literal>,
 	<literal>no</literal> und <literal>maybe</literal>.
 	<literal>yes</literal> bedeutet, dass Manualpages bereits
 	komprimiert installiert sind, bei <literal>no</literal> sind
 	sie es nicht und <literal>maybe</literal> bedeutet, dass die
 	Software bereits den Wert von <makevar>NOMANCOMPRESS</makevar>
 	beachtet, damit <filename>bsd.port.mk</filename> nichts
 	besonderes auszuf&uuml;hren hat.</para>
 
       <para><makevar>MANCOMPRESSED</makevar> wird automatisch auf
 	<literal>yes</literal> gesetzt, wenn
 	<makevar>USE_IMAKE</makevar> vorgegeben ist und gleichzeitig
 	<makevar>NO_INSTALL_MANPAGES</makevar> nicht. Im umgekehrten
 	Falle ist <makevar>MANCOMPRESSED</makevar> auf
 	<literal>no</literal> gesetzt.
 	Sie m&uuml;ssen es nicht explizit angeben, au&szlig;er die
 	Standardvorgabe ist f&uuml;r Ihren Port nicht passend.</para>
 
       <para>Wenn Ihr Port den man tree irgendwo anders als in der
 	Variable <makevar>MANPREFIX</makevar> verankert, k&ouml;nnen
 	Sie ihn mit <makevar>MANPREFIX</makevar> bestimmen.
 	Sollten zudem Manualpages nur in bestimmten Abschnitten an
 	einem nicht-standardkonformen Platz liegen, wie z.B. bestimmte
 	<literal>Perl</literal>-Modul-Ports,
 	dann k&ouml;nnen Sie mittels der Variable
 	<makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar>
 	(wobei <replaceable>sect</replaceable> ein Wert aus
 	<literal>1-9</literal>, <literal>L</literal> oder
 	<literal>N</literal> ist) individuelle Pfade zu den
 	Manualpages festlegen.</para>
 
       <para>Wenn Ihre Manualpages in sprachspezifische
 	Unterverzeichnisse installiert werden, dann bestimmen Sie
 	bitte den Namen der Sprache mit der Variable
 	<makevar>MANLANG</makevar>. Der Wert dieser Variable ist
 	mit <literal>""</literal> vorgegeben (das bedeutet nur
 	Englisch).</para>
 
       <para>Hier ist ein Beispiel, welches alles zusammenfasst.</para>
 
       <programlisting>MAN1=          foo.1
 MAN3=          bar.3
 MAN4=          baz.4
 MLINKS=        foo.1 alt-name.8
 MANLANG=       "" ja
 MAN3PREFIX=    ${PREFIX}/share/foobar
 MANCOMPRESSED= yes</programlisting>
 
       <para>Dies zeigt an, dass sechs Dateien von diesem Port
 	installiert werden;</para>
 
       <programlisting>${MANPREFIX}/man/man1/foo.1.gz
 ${MANPREFIX}/man/ja/man1/foo.1.gz
 ${PREFIX}/share/foobar/man/man3/bar.3.gz
 ${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
 ${MANPREFIX}/man/man4/baz.4.gz
 ${MANPREFIX}/man/ja/man4/baz.4.gz</programlisting>
 
       <para><filename>${MANPREFIX}/man/man8/alt-name.8.gz</filename>
 	kann zus&auml;tzlich von Ihrem Port installiert werden,
 	oder auch nicht. Unabh&auml;ngig davon wird ein Symlink
 	erstellt, welcher die Manualpages foo(1) und alt-name(8)
 	einbindet.</para>
 
       <para>Falls nur manche Manualpages &uuml;bersetzt sind,
 	k&ouml;nnen Sie einige dynamisch vom
 	<makevar>MANLANG</makevar>-Inhalt erzeugte Variablen
 	nutzen:</para>
 
       <programlisting>MANLANG=       "" de ja
 MAN1=          foo.1
 MAN1_EN=       bar.1
 MAN3_DE=       baz.3</programlisting>
 
       <para>Dies f&uuml;hrt zu folgender Liste von Dateien:</para>
 
       <programlisting>${MANPREFIX}/man/man1/foo.1.gz
 ${MANPREFIX}/man/de/man1/foo.1.gz
 ${MANPREFIX}/man/ja/man1/foo.1.gz
 ${MANPREFIX}/man/man1/bar.1.gz
 ${MANPREFIX}/man/de/man3/baz.3.gz</programlisting>
     </sect1>
 
     <sect1 id="makefile-info">
       <title>Info-Dateien</title>
 
       <para>Falls Ihr Paket GNU-Info-Dateien installiert, sollten
 	diese in der <makevar>INFO</makevar>-Variablen augelistet sein
 	(ohne das angeh&auml;ngte <literal>.info</literal>) mit einem
 	Eintrag f&uuml;r jedes Dokument. Von diesen Dateien wird
 	angenommen, dass sie nach
 	<filename><makevar>PREFIX</makevar>/<makevar>INFO_PATH</makevar></filename>
 	installiert werden. Sie k&ouml;nnen
 	<makevar>INFO_PATH</makevar> &auml;ndern, falls Ihr Paket
 	einen anderen Ort vorsieht. Jedoch wird dies nicht empfohlen.
 	Die Eintr&auml;ge enthalten nur den relativen Pfad zu
 	<filename><makevar>PREFIX</makevar>/<makevar>INFO_PATH</makevar></filename>.
 	Zum Beispiel installiert <filename
 	role="package">lang/gcc33</filename> Info-Dateien nach
 	<filename><makevar>PREFIX</makevar>/<makevar>INFO_PATH</makevar>/gcc33</filename>,
 	wobei <makevar>INFO</makevar> etwa so aussieht:
 
         <programlisting>INFO= gcc33/cpp gcc33/cppinternals gcc33/g77 ...</programlisting>
 
 	Entsprechende Installations-/Deinstalltions-Codes werden vor
 	der Paket-Registrierung automatisch der vorl&auml;ufigen
 	<filename>pkg-plist</filename> hinzugef&uuml;gt.</para>
     </sect1>
 
     <sect1 id="makefile-options">
       <title>Makefile-Optionen</title>
 
       <para>Einige gr&ouml;&szlig;ere Applikationen k&ouml;nnen mit
 	einer Reihe von Konfigurationen, die zus&auml;tzliche
 	Funktionalit&auml;ten hinzuf&uuml;gen, erstellt werden,
 	falls eine oder mehrere Bibliotheken oder Applikationen
 	verf&uuml;gbar sind. Dazu geh&ouml;ren die Auswahl von
 	nat&uuml;rlichen Sprachen, GUI versus Kommandozeilen-Versionen
 	oder die Auswahl aus mehreren Datenbank-Programmen.
 	Da nicht alle Nutzer diese Bibliotheken oder Applikationen
 	wollen, stellt das Ports-System hooks (Haken) zur
 	Verf&uuml;gung, damit der Autor des Ports bestimmen kann,
 	welche Konfiguration erstellt werden soll.</para>
 
       <sect2>
 	<title>KNOBS (Einstellungen)</title>
 
 	<sect3>
 	  <title><makevar>WITH_<replaceable>*</replaceable></makevar>
 	    und
 	    <makevar>WITHOUT_<replaceable>*</replaceable></makevar>
 	  </title>
 
 	  <para>Diese Variablen sind entworfen worden, um vom
 	    System-Administrator gesetzt zu werden. Es gibt viele,
 	    die in <filename>ports/Mk/bsd.*.mk</filename>
 	    standardisiert sind. Andere sind es nicht,
 	    was verwirrend sein kann. Falls Sie eine solche
 	    Konfigurationsvariable hinzuf&uuml;gen m&uuml;ssen,
 	    dann nehmen Sie bitte eine aus der folgenden Liste.</para>
 
 	  <note>
 	    <para>Sie sollten nicht annehmen, dass ein
 	      <makevar>WITH_<replaceable>*</replaceable></makevar>
 	      notwendigerweise eine korrespondierende <makevar>
 	      WITHOUT_<replaceable>*</replaceable></makevar>-Variable
 	      hat oder umgekehrt. Im Allgemeinen wird diese
 	      Vorgabe einfach unterstellt.</para>
 	  </note>
 
 	  <note>
 	    <para>Falls nicht anderweitig festgelegt, werden diese
 	      Variablen nur dahingehend &uuml;berpr&uuml;ft, ob sie
 	      gesetzt sind oder nicht&nbsp;&ndash;&nbsp;nicht darauf,
 	      ob sie auf bestimmte Werte wie <literal>YES</literal>
 	      oder <literal>NO</literal> gesetzt sind.</para>
 	  </note>
 
 	  <table frame="none">
 	    <title>Die
 	      <makevar>WITH_<replaceable>*</replaceable></makevar>
 	      und <makevar>
 	      WITHOUT_<replaceable>*</replaceable></makevar>-Variablen
 	    </title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>Variable</entry>
 
 		  <entry>Bedeutung</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><makevar>WITH_APACHE2</makevar></entry>
 
 		  <entry>Falls gesetzt, benutze
 		    <filename role="package">www/apache20</filename>
 		    anstelle der Vorgabe <filename
 		    role="package">www/apache13</filename>.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>WITH_BERKELEY_DB</makevar></entry>
 
 		  <entry>Definiere diese Variable, um die
 		    F&auml;higkeit zu erhalten, eine Variante
 		    der Berkeley Database wie z.B. <filename
 		    role="package">databases/db41</filename> zu
 		    nutzen. Eine verwandte Variable,
 		    <makevar>WITH_BDB_VER</makevar>, kann mit Werten
 		    wie 2, 3, 4, 41 oder 42 festgelegt werden.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>WITH_MYSQL</makevar></entry>
 
 		  <entry>Definiere diese Variable, um die
 		    F&auml;higkeit zu erhalten, eine Variante
 		    von MySQL zu nutzen wie z.B. <filename
 		    role="package">databases/mysql40-server</filename>.
 		    Eine verwandte Variable ist,
 		    <makevar>WANT_MYSQL_VER</makevar>, welche
 		    mit Werten wie 323, 40, 41, oder 50
 		     belegt werden kann.</entry>
 		</row>
 
 		<row id="knobs-without-nls">
 		  <entry><makevar>WITHOUT_NLS</makevar></entry>
 
 		  <entry>Falls gesetzt, bedeutet sie, dass eine
 		    Internationalisierung nicht ben&ouml;tigt wird,
 		    was Kompilierzeit sparen kann. Als Vorgabe
 		    wird Internationalisierung gebraucht.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>WITH_OPENSSL_BASE</makevar></entry>
 
 		  <entry>Nutze die Version von OpenSSL aus dem
 		    Basissystem.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>WITH_OPENSSL_PORT</makevar></entry>
 
 		  <entry>Nutze die Version von OpenSSL aus <filename
 		    role="package">security/openssl</filename> und
 		    &uuml;berschreibe die Version, welche original
 		    im Basissystem installiert wurde.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>WITH_POSTGRESQL</makevar></entry>
 
 		  <entry>Definiere diese Variable, um die
 		    F&auml;higkeit zu erhalten, eine Variante
 		    der Datenbank PostGreSQL wie <filename
 		    role="package">databases/postgresql72</filename>
 		    auszuw&auml;hlen.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>WITHOUT_X11</makevar></entry>
 
 		  <entry>Falls der Port mit oder ohne
 		    Unterst&uuml;tzung f&uuml;r X erstellt werden
 		    kann, dann sollte normalerweise mit
 		    X-Unterst&uuml;tzung erstellt werden.
 		    Falls die Variable gesetzt ist, soll die Version
 		    ohne X-Unterst&uuml;tzung erstellt werden.</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 	</sect3>
 
 	<sect3>
 	  <title>Benennung von Knobs (Einstellungen)</title>
 
 	  <para>Um die Anzahl der Knobs niedrig zu halten und zum
 	    Vorteil des Anwenders, wird empfohlen, dass Porter
 	    &auml;hnliche Namen f&uuml;r Knobs verwenden.
 	    Eine Liste der beliebtesten Knobs kann in der <ulink
 	    url="http://www.freebsd.org/cgi/cvsweb.cgi/ports/KNOBS?rev=HEAD&amp;content-type=text/x-cvsweb-markup">KNOBS-Datei</ulink>
 	    eingesehen werden.</para>
 
 	  <para>Knob-Namen sollten wiederspiegeln, was der Knob
 	    bedeutet und was er bewirkt. Wenn ein Port einen
 	    lib-Pr&auml;fix im <makevar>PORTNAME</makevar> hat,
 	    dann soll das lib-Pr&auml;fix im Knob-Namen
 	    entfallen.</para>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title><makevar>OPTIONS</makevar></title>
 
 	<sect3>
 	  <title>Hintergrund</title>
 
 	  <para>Die <makevar>OPTIONS</makevar>-Variable gibt dem
 	    Nutzer, der diesen Port installiert, einen Dialog mit
 	    ausw&auml;hlbaren Optionen und speichert diese in
 	    <filename>/var/db/ports/<replaceable>portname</replaceable>/options</filename>.
 	    Bei der n&auml;chsten Neuerstellung des Ports werden
 	    diese Einstellungen wieder verwandt.
 	    Sie werden sich niemals mehr an all die zwanzig
 	    <makevar>WITH_<replaceable>*</replaceable></makevar> und
 	    <makevar>WITHOUT_<replaceable>*</replaceable></makevar>-Optionen
 	    erinnern m&uuml;ssen, die Sie benutzt haben, um diesen
 	    Port zu erstellen!</para>
 
 	  <para>Wenn der Anwender <command>make config</command>
 	    benutzt (oder ein <command>make build</command> das
 	    erste Mal laufen l&auml;sst) wird das Framework auf
 	    <filename>/var/db/ports/<replaceable>portname</replaceable>/options</filename>
 	    die Einstellungen pr&uuml;fen. Falls die Datei nicht
 	    existiert, werden die Werte von
 	    <makevar>OPTIONS</makevar> genutzt, um eine Dialogbox
 	    zu erzeugen, in welcher die Optionen an- oder abgeschaltet
 	    werden k&ouml;nnen. Dann wird die
 	    <filename>options</filename>-Datei gespeichert und die
 	    ausgew&auml;hlten Variablen werden bei der Erstellung
 	    des Ports benutzt.</para>
 
 	  <para>Falls eine neue Version des Ports
 	    <makevar>OPTIONS</makevar> hinzuf&uuml;gt, wird der
 	    Dialog mit den gespeicherten Werten dem Nutzer
 	    angezeigt.</para>
 
 	  <para>Benutzen Sie <command>make showconfig</command>,
 	    um die gespeicherte Konfiguration zu betrachten.
 	    Benutzen Sie <command>make rmconfig</command>, um die
 	    gespeicherte Konfiguration zu L&ouml;schen.</para>
 	</sect3>
 
 	<sect3>
 	  <title>Syntax</title>
 
 	  <para>Die Syntax f&uuml;r die
 	    <makevar>OPTIONS</makevar>-Variable lautet:
 
 	    <programlisting>OPTIONS=    OPTION    "descriptive text" default ...</programlisting>
 
 	    Der Wert als Vorgabe ist entweder <literal>ON</literal>
 	    oder <literal>OFF</literal>. Wiederholungen dieser drei
 	    Felder sind erlaubt.</para>
 
 	  <para><makevar>OPTIONS</makevar>-Definitionen
 	    m&uuml;ssen vor der Einbindung von
 	    <filename>bsd.port.pre.mk</filename> erscheinen.
 	    Die <makevar>WITH_*</makevar> und
 	    <makevar>WITHOUT_*</makevar>-Variablen k&ouml;nnen
 	    nur nach der Einbindung von
 	    <filename>bsd.port.pre.mk</filename> getestet
 	    werden.</para>
 	</sect3>
 
 	<sect3>
 	  <title>Beispiel</title>
 
 	  <example id="ports-options-simple-use">
 	    <title>Einfache Anwendung von
 	      <makevar>OPTIONS</makevar></title>
 
 	    <para><programlisting>OPTIONS=      FOO "Enable option foo" On \
               BAR "Support feature bar" Off
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITHOUT_FOO)
 CONFIGURE_ARGS+=    --without-foo
 .else
 CONFIGURE_ARGS+=    --with-foo
 .endif
 
 .if defined(WITH_BAR)
 RUN_DEPENDS+=    bar:${PORTSDIR}/bar/bar
 .endif
 
 .include &lt;bsd.port.post.mk&gt;</programlisting></para>
 	  </example>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title>Automatische Aktivierung von Funktionen</title>
 
 	<para>Wenn Sie ein GNU-Konfigurationsskript benutzen,
 	  sollten Sie ein Auge darauf werfen, welche Funktionen
 	  durch die automatische Erkennung aktiviert werden.
 	  Schalten Sie Funktionen, die Sie nicht m&ouml;chten,
 	  ausdr&uuml;cklich durch Verwendung von
 	  <literal>--without-xxx</literal> oder
 	  <literal>--disable-xxx</literal> in der Variable
 	  <makevar>CONFIGURE_ARGS</makevar> einzeln ab.</para>
 
 	<example>
 	  <title>Falsche Behandlung einer Option</title>
 
 	  <programlisting>.if defined(WITH_FOO)
 LIB_DEPENDS+=        foo.0:${PORTSDIR}/devel/foo
 CONFIGURE_ARGS+=    --enable-foo
 .endif</programlisting>
 	</example>
 
 	<para>Stellen Sie sich vor im obigen Beispiel ist eine
 	  Bibliothek libfoo auf dem System installiert. Der Nutzer
 	  will nicht, dass diese Applikation libfoo benutzt, also
 	  hat er die Option auf "off" im
 	  <literal>make config</literal>-Dialog umgestellt.
 	  Aber das Konfigurationsskript der Applikation hat
 	  erkannt, dass die Bibliothek auf dem System vorhanden ist
 	  und f&uuml;gt ihre Funktionen in die Bin&auml;rdatei ein.
 	  Falls der Nutzer sich nun entschliesst libfoo von seinem
 	  System zu entfernen, dann wird das Ports-System nicht
 	  protestieren (es wurde keine Abh&auml;ngigkeit von libfoo
 	  eingetragen), aber die Applikation bricht ab.</para>
 
 	<example>
 	  <title>Korrekte Behandlung einer Option</title>
 
 	  <programlisting>.if defined(WITH_FOO)
 LIB_DEPENDS+=        foo.0:${PORTSDIR}/devel/foo
 CONFIGURE_ARGS+=    --enable-foo
 .else
 CONFIGURE_ARGS+=    --disable-foo
 .endif</programlisting>
 	</example>
 
 	<para>Im zweiten Beispiel wird die Bibliothek libfoo explizit
 	  abgeschaltet. Das Konfigurationsskript aktiviert die
 	  entsprechenden Funktionen nicht in der Applikation trotz
 	  der Anwesenheit der Bibliothek auf dem System.</para>
       </sect2>
     </sect1>
 
     <sect1 id="makefile-wrkdir">
       <title>Die Festlegung des Arbeitsverzeichnisses</title>
 
       <para>Jeder Port wird extrahiert in ein Arbeitsverzeichnis,
 	welches beschreibbar sein muss. Das Ports-System gibt als
 	Standard vor, dass die <makevar>DISTFILES</makevar> in
 	einem Verzeichnis namens <literal>${DISTNAME}</literal>
 	entpackt werden. Mit anderen Worten, wenn Sie:</para>
 
       <programlisting>PORTNAME=      foo
 PORTVERSION=   1.0</programlisting>
 
       <para>festgelegt haben, dann enthalten die Distributions-Dateien
 	des Ports ein Verzeichnis auf oberster Ebene,
 	<filename>foo-1.0</filename>, und der Rest der Dateien
 	befindet sich unter diesem Verzeichnis.</para>
 
       <para>Es gibt eine Reihe von Variablen, die Sie
 	&uuml;berschreiben k&ouml;nnen, falls dies nicht der Fall
 	sein sollte.</para>
 
       <sect2>
 	<title><makevar>WRKSRC</makevar></title>
 
 	<para>Diese Variable listet den Namen des Verzeichnisses,
 	  welches erstellt wird, wenn die Distfiles der Applikation
 	  extrahiert werden. Wenn unser vorheriges Beispiel in einem
 	  Verzeichnis namens <filename>foo</filename> (und nicht
 	  <filename>foo-1.0</filename>) extrahiert wurde,
 	  w&uuml;rden Sie schreiben:</para>
 
 	<programlisting>WRKSRC=      ${WRKDIR}/foo</programlisting>
 
 	<para>oder m&ouml;glicherweise</para>
 
 	<programlisting>WRKSRC=      ${WRKDIR}/${PORTNAME}
 	  </programlisting>
       </sect2>
 
       <sect2>
 	<title><makevar>NO_WRKSUBDIR</makevar></title>
 
 	<para>Wenn der Port &uuml;berhaupt nicht in einem
 	  Unterverzeichnis extrahiert wird, sollten Sie dies mit dem
 	  Setzen von <makevar>NO_WRKSUBDIR</makevar> anzeigen.</para>
 
 	<programlisting>NO_WRKSUBDIR= yes</programlisting>
       </sect2>
     </sect1>
 
     <sect1 id="conflicts">
       <title><makevar>CONFLICTS</makevar></title>
 
       <para>Falls Ihr Paket nicht mit anderen Paketen koexistieren
 	kann (wegen Dateikonflikten, Laufzeit-Inkompatibilit&auml;ten
 	usw.), f&uuml;hren Sie bitte die anderen Paketnamen in der
 	Variable <makevar>CONFLICTS</makevar> auf. Sie k&ouml;nnen
 	hier Shell-Globs wie <literal>*</literal> und
 	<literal>?</literal> verwenden. Paketnamen sollten in der
 	gleichen Weise aufgez&auml;hlt werden, wie sie in
 	<filename>/var/db/pkg</filename> auftauchen. Bitte stellen
 	Sie sicher, dass <makevar>CONFLICTS</makevar> nicht mit dem
 	Paket des Ports selbst &uuml;bereinstimmt, da ansonsten das
 	Erzwingen der Installation durch
 	<makevar>FORCE_PKG_REGISTER</makevar> nicht l&auml;nger
 	funktionieren wird.</para>
 
       <note>
 	<para><makevar>CONFLICTS</makevar> setzt automatisch die
 	  Variable <makevar>IGNORE</makevar>, welche
 	  ausf&uuml;hrlicher in <xref
 	  linkend="dads-noinstall">dokumentiert ist.</para>
       </note>
 
       <para>Beim Entfernen eines von mehreren in Konflikt stehenden
 	Ports ist es ratsam, die
 	<makevar>CONFLICTS</makevar>-Eintr&auml;ge in den anderen
 	Ports f&uuml;r einige Monate beizubehalten, um Nutzer zu
 	unterst&uuml;tzen, die ihre Ports nur sporadisch
 	aktualisieren.</para>
     </sect1>
 
     <sect1 id="install">
       <title>Installation von Dateien</title>
 
       <sect2 id="install-macros">
 	<title>INSTALL_* macros</title>
 
 	<para>Nutzen Sie die Makros in
 	  <filename>bsd.port.mk</filename>, um korrekte
 	  Modi und Eigent&uuml;mer von Dateien in Ihren
 	  <maketarget>*-install</maketarget>-Targets
 	  sicherzustellen.</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><makevar>INSTALL_PROGRAM</makevar> ist ein Befehl,
 	      um bin&auml;re Bin&auml;rdateien zu installieren.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>INSTALL_SCRIPT</makevar> ist ein Befehl,
 	      um ausf&uuml;hrbare Skripte zu installieren.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>INSTALL_KLD</makevar> ist ein Befehl, mit
 	      dem Kernelmodule installiert werden k&ouml;nnen. Einige
 	      Architekturen haben Probleme mit stripped-Modulen.
 	      Daher sollten Sie diesen Befehl anstelle von
 	      <makevar>INSTALL_PROGRAM</makevar> verwenden.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>INSTALL_DATA</makevar> ist ein Befehl,
 	      um gemeinsam nutzbare Daten zu installieren.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>INSTALL_MAN</makevar> ist ein Befehl,
 	      um Manualpages oder andere Dokumentation zu
 	      installieren (es wird nichts komprimiert).</para>
 	  </listitem>
 	</itemizedlist>
 
 	<para>Das sind grunds&auml;tzlich alle
 	  <command>install</command>-Befehle mit
 	  ihren passenden Flags.</para>
       </sect2>
 
       <sect2 id="install-strip">
 	<title>Zerlegen von Bin&auml;rdateien</title>
 
 	<para>Zerlegen Sie keine Bin&auml;rdateien manuell,
 	  wenn Sie es nicht m&uuml;ssen. Alle Binaries sollten
 	  gestripped werden; allerdings vermag das
 	  <maketarget>INSTALL_PROGRAM</maketarget>-Makro gleichzeitig
 	  eine Bin&auml;rdatei zu installieren und zu strippen
 	  (beachten Sie den n&auml;chsten Abschnitt).</para>
 
 	<para>Wenn Sie eine Datei strippen m&uuml;ssen, aber nicht das
 	  <makevar>INSTALL_PROGRAM</makevar>-Makro nutzen wollen, dann
 	  kann <makevar>${STRIP_CMD}</makevar> Ihr Programm strippen.
 	  Dies wird typischerweise innerhalb des
 	  <literal>post-install</literal>-Targets gemacht.
 	  Zum Beispiel:</para>
 
 	<programlisting>post-install:
     ${STRIP_CMD} ${PREFIX}/bin/xdl</programlisting>
 
 	<para>Nutzen Sie &man.file.1; f&uuml;r die installierte
 	  Applikation, um zu &uuml;berpr&uuml;fen, ob eine
 	  Bin&auml;rdatei gestripped ist oder nicht.
 	  Wenn es nicht meldet <literal>not stripped</literal>,
 	  dann ist es bereits gestripped. Zudem wird &man.strip.1;
 	  nicht ein bereits gestripptes Programm nochmals versuchen
 	  zu strippen, sondern wird stattdessen einfach sauber
 	  beenden.</para>
       </sect2>
 
       <sect2 id="install-copytree">
 	<title>Installation eines ganzen Verzeichnisbaums
 	  inklusive Dateien</title>
 
 	<para>Manchmal muss man eine gro&szlig;e Zahl von Dateien
 	  unter Erhalt ihrer hierarchischen Struktur installieren,
 	  d.h. Kopieraktionen &uuml;ber einen ganzen Verzeichnisbaum
 	  von <makevar>WRKSRC</makevar> zu einem Zielverzeichnis unter
 	  <makevar>PREFIX</makevar>.</para>
 
 	<para>F&uuml;r diesen Fall gibt es zwei Makros. Der Vorteil
 	  der Nutzung dieser Makros anstatt <command>cp</command> ist,
 	  dass sie korrekte Besitzer und Berechtigungen auf den
 	  Zieldateien garantieren.
 	  Das erste Makro, <makevar>COPYTREE_BIN</makevar>, wird alle
 	  installierten Dateien ausf&uuml;hrbar markieren und damit
 	  passend f&uuml;r die Installation in
 	  <filename><makevar>PREFIX</makevar>/bin</filename>
 	  vorbereiten. Das zweite Makro,
 	  <makevar>COPYTREE_SHARE</makevar>, setzt keine
 	  Ausf&uuml;hrungsberechtigungen auf Dateien und ist daher
 	  geeignet f&uuml;r die Installation von Dateien im Target von
 	  <filename><makevar>PREFIX</makevar>/share</filename>.</para>
 
 	<programlisting>post-install:
     ${MKDIR} ${EXAMPLESDIR}
     (cd ${WRKSRC}/examples/ && ${COPYTREE_SHARE} \* ${EXAMPLESDIR})</programlisting>
 
 	<para>Dieses Beispiel wird den Inhalt des
 	  <filename>examples</filename>-Verzeichnisses im Distfile
 	  des Drittanbieters in das Beispielverzeichnis Ihres Ports
 	  kopieren.</para>
 
 	<programlisting>post-install:
     ${MKDIR} ${DATADIR}/summer
     (cd ${WRKSRC}/temperatures/ && ${COPYTREE_SHARE} "June July August" ${DATADIR}/summer/)</programlisting>
 
 	<para>Und dieses Beispiel wird die Daten der Sommermonate in
 	  das <filename>summer</filename>-Unterverzeichnis eines
 	  <filename><makevar>DATADIR</makevar></filename>
 	  installieren.</para>
 
 	<para>Zus&auml;tzliche <command>find</command>-Argumente
 	  k&ouml;nnen mit dem dritten Argument an die
 	  <makevar>COPYTREE_*</makevar>-Makros &uuml;bergeben werden.
 	  Um zum Beispiel alle Dateien aus dem 1. Beispiel ohne die
 	  Makefiles zu installieren, kann man folgenden Befehl
 	  benutzen.</para>
 
 	<programlisting>post-install:
     ${MKDIR} ${EXAMPLESDIR}
     (cd ${WRKSRC}/examples/ && \
 	${COPYTREE_SHARE} \* ${EXAMPLESDIR} "! -name Makefile")</programlisting>
 
 	<para>Beachten Sie bitte, dass diese Makros die installierten
 	  Dateien nicht zur <filename>pkg-plist</filename>
 	  hinzuf&uuml;gen, Sie m&uuml;ssen sie immer noch selbst
 	  auflisten.</para>
       </sect2>
 
       <sect2 id="install-documentation">
 	<title>Installation zus&auml;tzlicher Dokumentation</title>
 
 	<para>Falls Ihre Software zus&auml;tzlich zu den &uuml;blichen
 	  Manualpages und Info-Seiten weitere Dokumentation hat und
 	  Sie diese f&uuml;r n&uuml;tzlich halten, dann installieren
 	  Sie sie unter
 	  <filename><makevar>PREFIX</makevar>/share/doc</filename>.
 	  Dies kann wie vorstehend im Target des
 	  <maketarget>post-install</maketarget> geschehen.</para>
 
 	<para>Legen Sie ein neues Verzeichnis f&uuml;r Ihren Port an.
 	  Das Verzeichnis sollte wiederspiegeln, was der Port ist.
 	  Das bedeutet normalerweise <makevar>PORTNAME</makevar>.
 	  Wie auch immer, wenn Sie meinen, der Nutzer m&ouml;chte
 	  verschiedene Versionen des Ports zur gleichen Zeit
 	  installiert haben, dann k&ouml;nnen Sie die gesamte Variable
 	  <makevar>PKGNAME</makevar> nutzen.</para>
 
 	<para>Machen Sie die Installation von der Variablen
 	  <makevar>NOPORTDOCS</makevar> abh&auml;ngig, damit die
 	  Nutzer sie in <filename>/etc/make.conf</filename> abschalten
 	  k&ouml;nnen:</para>
 
 	<programlisting>post-install:
 .if !defined(NOPORTDOCS)
     ${MKDIR} ${DOCSDIR}
     ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${DOCSDIR}
 .endif</programlisting>
 
 	<para>Hier einige praktische Variablen und wie sie
 	  standardm&auml;ssig bei Verwendung im
 	  <filename>Makefile</filename> expandiert werden:
 
 	<itemizedlist>
 	  <listitem>
 	    <para><makevar>DATADIR</makevar> wird expandiert zu
 	      <filename><makevar>PREFIX</makevar>/share/<makevar>PORTNAME</makevar></filename>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>DATADIR_REL</makevar> wird expandiert zu
 	      <filename>share/<makevar>PORTNAME</makevar></filename>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>DOCSDIR</makevar> wird expandiert zu
 	      <filename><makevar>PREFIX</makevar>/share/doc/<makevar>PORTNAME</makevar></filename>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>DOCSDIR_REL</makevar> wird expandiert zu
 	      <filename>share/doc/<makevar>PORTNAME</makevar></filename>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>EXAMPLESDIR</makevar> wird expandiert zu
 	      <filename><makevar>PREFIX</makevar>/share/examples/<makevar>PORTNAME</makevar></filename>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>EXAMPLESDIR_REL</makevar> wird expandiert zu
 	      <filename>share/examples/<makevar>PORTNAME</makevar></filename>.</para>
 	  </listitem>
 	</itemizedlist>
 
 	<note>
 	  <para><makevar>NOPORTDOCS</makevar> behandelt nur
 	    zus&auml;tzliche Dokumentation, die in
 	    <makevar>DOCSDIR</makevar> installiert ist.
 	    F&uuml;r normale Manualpages und Info-Seiten
 	    wird die Variable benutzt.
 	    Dinge, welche in <makevar>DATADIR</makevar>
 	    und <makevar>EXAMPLESDIR</makevar> installiert werden,
 	    legen die Variablen <makevar>NOPORTDATA</makevar> und
 	    <makevar>NOPORTEXAMPLES</makevar> fest.</para>
 	</note>
 
 	<para>Die Variablen werden nach <makevar>PLIST_SUB</makevar>
 	  exportiert. Ihre Werte erscheinen dort als Pfadnamen relativ
 	  zu <filename><makevar>PREFIX</makevar></filename>,
 	  falls m&ouml;glich. Das bedeutet, dass
 	  <filename>share/doc/<makevar>PORTNAME</makevar></filename>
 	  standardm&auml;ssig ersetzt wird durch
 	  <literal>%%DOCSDIR%%</literal> in der Packliste usw.
 	  (mehr zur Ersetzung durch die
 	  <filename>pkg-plist</filename> finden Sie
 	  <link linkend="plist-sub">hier</link>).</para>
 
 	<para>Alle installierten Dokumentationsdateien
 	  und&nbsp;&ndash;Verzeichnisse
 	  sollten in der <filename>pkg-plist</filename> dem
 	  <literal>%%PORTDOCS%%</literal>-Pr&auml;fix
 	  enthalten sein, zum Beispiel:</para>
 
 	<programlisting>%%PORTDOCS%%%%DOCSDIR%%/AUTHORS
 %%PORTDOCS%%%%DOCSDIR%%/CONTACT
 %%PORTDOCS%%@dirrm %%DOCSDIR%%</programlisting>
 
 	<para>Alternativ zur Auflistung der Dokumentationsdateien in
 	  der <filename>pkg-plist</filename> kann in einem Port auch
 	  die Variable <makevar>PORTDOCS</makevar> gesetzt werden
 	  f&uuml;r eine Liste von Dateien und Shell-Globs, um diese
 	  zur endg&uuml;ltigen Packliste hinzuzuf&uuml;gen. Die Namen
 	  werden relativ zur Variable <makevar>DOCSDIR</makevar> sein.
 	  Wenn Sie also einen Port haben, welcher
 	  <makevar>PORTDOCS</makevar> benutzt, und Sie haben eine vom
 	  Standard abweichenden Platz f&uuml;r seine Dokumentation,
 	  dann m&uuml;ssen Sie die Variable <makevar>DOCSDIR</makevar>
 	  entsprechend setzen. Wenn ein Verzeichnis in
 	  <makevar>PORTDOCS</makevar> aufgef&uuml;hrt ist, oder von
 	  einem Shell-Glob dieser Variable abgebildet wird, dann wird
 	  der komplette Verzeichnisbaum inklusive Dateien und
 	  Verzeichnissen in der endg&uuml;ltigen Packliste
 	  aufgenommen. Wenn die Variable <makevar>NOPORTDOCS</makevar>
 	  gesetzt ist, dann werden die Dateien und Verzeichnisse,
 	  die in <makevar>PORTDOCS</makevar> aufgelistet sind,
 	  nicht installiert und werden auch nicht zur Packliste des
 	  Ports hinzugef&uuml;gt. Wie oben gezeigt bleibt es dem Port
 	  selbst &uuml;berlassen, die Dokumentation in
 	  <makevar>PORTDOCS</makevar> zu installieren. Ein typisches
 	  Beispiel f&uuml;r den Gebrauch von
 	  <makevar>PORTDOCS</makevar> sieht wie folgt aus:</para>
 
 	<programlisting>PORTDOCS=       README.* ChangeLog docs/*</programlisting>
 
 	<note>
 	  <para>Die &Auml;quivalente zu <makevar>PORTDOCS</makevar>
 	    f&uuml;r unter <makevar>DATADIR</makevar> und
 	    <makevar>EXAMPLESDIR</makevar> installierte Dateien sind
 	    <makevar>PORTDATA</makevar> beziehungsweise
 	    <makevar>PORTEXAMPLES</makevar>.</para>
 
 	  <para>Sie k&ouml;nnen auch <filename>pkg-message</filename>
 	    benutzen, um Meldungen w&auml;hrend der Installation
 	    anzuzeigen. Lesen Sie <link
 	    linkend="porting-message">diesen Abschnitt &uuml;ber den
 	    Gebrauch von <filename>pkg-message</filename></link>
 	    f&uuml;r weitere Details.
 	    Die <filename>pkg-message</filename>-Datei muss nicht zur
 	    <filename>pkg-plist</filename> hinzugef&uuml;gt
 	    werden.</para>
 	</note>
       </sect2>
 
       <sect2 id="install-subdirs">
 	<title>Unterverzeichnisse mit PREFIX</title>
 
 	<para>Lassen Sie den Port die Dateien in die richtigen
 	  Unterverzeichnisse von <makevar>PREFIX</makevar> verteilen.
 	  Einige Ports werfen alles in einen Topf und legen es im
 	  Unterverzeichnis mit dem Namen des Ports ab, was falsch ist.
 	  Ausserdem legen viele Ports alles ausser Binaries,
 	  Header-Dateien und Manualpages in ein Unterverzeichnis
 	  von <filename>lib</filename>, was nat&uuml;rlich auch nicht
 	  der BSD-Philosophie entspricht und nicht gut funktioniert.
 	  Viele der Dateien sollten in eines der folgenden
 	  Verzeichnisse geschoben werden: <filename>etc</filename>
 	  (Konfigurationsdateien), <filename>libexec</filename>
 	  (intern gestartete Bin&auml;rdateien),
 	  <filename>sbin</filename> (Bin&auml;rdateien f&uuml;r
 	  Superuser/Manager), <filename>info</filename>
 	  (Dokumentation f&uuml;r Info-Browser) oder
 	  <filename>share</filename> (Architektur-unabh&auml;ngige
 	  Dateien). Lesen Sie hierzu &man.hier.7;; weitestgehend
 	  greifen die Regeln f&uuml;r <filename>/usr</filename> auch
 	  f&uuml;r <filename>/usr/local</filename>. Die Ausnahme sind
 	  Ports, welche mit <quote>news</quote> aus dem USENET
 	  arbeiten. In diesem Falle sollte
 	  <filename><makevar>PREFIX</makevar>/news</filename>
 	  als Zielort f&uuml;r die Dateien benutzt werden.</para>
       </sect2>
     </sect1>
   </chapter>
 
     <chapter id="special">
       <title>Besonderheiten</title>
 
       <para>Es gibt einige Dinge mehr, die zu beachten sind,
 	wenn man einen Port erstellt. Dieser Abschnitt
 	erkl&auml;rt die wichtigsten.</para>
 
       <sect1 id="porting-shlibs">
 	<title>Shared-Libraries</title>
 
 	<para>Wenn Ihr Port eine oder mehrere Shared-Libraries
 	  installiert, dann definieren Sie bitte eine
 	  <makevar>USE_LDCONFIG</makevar> make-Variable,
 	  die <filename>bsd.port.mk</filename> anweisen wird,
 	  <literal>&dollar;{LDCONFIG} -m</literal> auf das
 	  Verzeichnis, in das die neue Library installiert wird
 	  (normalerweise
 	  <filename><makevar>PREFIX</makevar>/lib</filename>),
 	  w&auml;hrend des
 	  <maketarget>post-install</maketarget>-Targets anzuwenden,
 	  um sie im Shared-Library-Cache zu registrieren.
 	  Diese Variable, wenn definiert, wird auch daf&uuml;r sorgen,
 	  dass ein entsprechendes
 	  <literal>@exec /sbin/ldconfig -m</literal> und
 	  <literal>@unexec /sbin/ldconfig -R</literal>-Paar zu Ihrer
 	  <filename>pkg-plist</filename>-Datei hinzugef&uuml;gt wird,
 	  sodass ein Benutzer, der das Paket installiert, die
 	  Bibliothek danach sofort benutzen kann und das System nach
 	  deren Deinstallation nicht glaubt, die Bibliothek w&auml;re
 	  noch da.</para>
 
 	<programlisting>USE_LDCONFIG= yes</programlisting>
 
 	<para>Wenn n&ouml;tig, k&ouml;nnen Sie das Standardverzeichnis
 	  au&szlig;er Kraft setzen, indem Sie den
 	  <makevar>USE_LDCONFIG</makevar> Wert auf eine Liste von
 	  Verzeichnissen setzen, in die Shared Libraries installiert
 	  werden sollen. Wenn Ihr Port z.B. diese Bibliotheken nach
 	  <filename><makevar>PREFIX</makevar>/lib/foo</filename> und
 	  <filename><makevar>PREFIX</makevar>/lib/bar</filename>
 	  installiert, k&ouml;nnten Sie folgendes in Ihrem
 	  <filename>Makefile</filename> benutzen:</para>
 
 	<programlisting>USE_LDCONFIG= ${PREFIX}/lib/foo ${PREFIX}/lib/bar</programlisting>
 
 	<para>Bitte &uuml;berpr&uuml;fen Sie dies genau. Oft ist das
 	  &uuml;berhaupt nicht n&ouml;tig oder kann durch
 	  <literal>-rpath</literal> oder das Setzen von
 	  <envar>LD_RUN_PATH</envar> w&auml;hrend des Linkens umgangen
 	  werden (s. <filename
 	  role="package">lang/moscow_ml</filename> f&uuml;r ein
 	  Beispiel), oder durch einen Shell-Wrapper, der
 	  <makevar>LD_LIBRARY_PATH</makevar> setzt, bevor er die
 	  Bin&auml;rdatei ausf&uuml;hrt, wie es <filename
 	  role="package">www/mozilla</filename> tut.</para>
 
 	<para>Wenn Sie 32-Bit Libraries auf 64-Bit Systemen
 	  installieren, benutzen Sie stattdessen
 	  <makevar>USE_LDCONFIG32</makevar>.</para>
 
 	<para>Versuchen Sie Shared-Library-Versionsnummern im
 	  <filename>libfoo.so.0</filename> Format zu halten.
 	  Unser Runtime-Linker k&uuml;mmert sich nur um die Major
 	  (erste) Nummer.</para>
 
 	<para>Wenn sich die Major-Library-Versionsnummer
 	  w&auml;hrend der Aktualisierung zu einer neuen
 	  Portversion erh&ouml;ht, sollte auch die
 	  <makevar>PORTREVISION</makevar> aller Ports, die die
 	  Shared-Library linken, erh&ouml;ht werden, damit diese
 	  mit der neuen Version der Bibliothek neu kompiliert
 	  werden.</para>
       </sect1>
 
       <sect1 id="porting-restrictions">
 	<title>Ports mit beschr&auml;nkter Verbreitung</title>
 
 	<para>Lizenzen variieren und manche geben Restriktionen vor,
 	  wie die Applikation gepackt werden oder ob sie
 	  gewinnorientiert verkauft werden kann, usw.</para>
 
 	<important>
 	  <para>Es liegt in Ihrer Verantwortung als Porter die
 	    Lizenzbestimmungen der Software zu lesen und
 	    sicherzustellen, dass das FreeBSD-Projekt nicht haftbar
 	    gemacht wird f&uuml;r Lizenzverletzungen durch
 	    Weiterverbreitung des Quelltextes oder kompilierter
 	    Binaries &uuml;ber FTP/HTTP oder CD-ROM. Im Zweifelsfall
 	    kontaktieren Sie bitte die &a.ports;.</para>
 	</important>
 
 	<para>In solchen Situationen k&ouml;nnen die in den folgenden
 	  Abschnitten beschriebenen Variablen gesetzt werden.</para>
 
 	<sect2>
 	  <title><makevar>NO_PACKAGE</makevar></title>
 
 	  <para>Diese Variable zeigt an, dass wir keine bin&auml;ren
 	    Pakete dieser Applikation erzeugen d&uuml;rfen - z.B. wenn
 	    die Lizenz die Weiterverteilung von bin&auml;ren Paketen
 	    oder Paketen verbietet, die aus ver&auml;ndertem Quelltext
 	    erzeugt wurden.</para>
 
 	  <para>Die <makevar>DISTFILES</makevar> des Ports d&uuml;rfen
 	    allerdings frei &uuml;ber FTP/HTTP Mirrors
 	    weiterverbreitet werden. Sie d&uuml;rfen auch auf CD-ROM
 	    (oder &auml;hnlichen Medien) weiterverbreitet werden - es
 	    sei denn, <makevar>NO_CDROM</makevar> ist ebenfalls
 	    gesetzt.</para>
 
 	  <para><makevar>NO_PACKAGE</makevar> sollte auch benutzt
 	    werden, wenn das bin&auml;re Paket nicht allgemein
 	    brauchbar ist und die Applikation immer aus dem Quelltext
 	    kompiliert werden sollte.
 	    Zum Beispiel, wenn die Applikation konfigurierte
 	    Informationen &uuml;ber den Rechner/Installationsort bei
 	    der Installation einkompiliert bekommt, setzen Sie
 	    <makevar>NO_PACKAGE</makevar>.</para>
 
 	  <para><makevar>NO_PACKAGE</makevar> sollte auf eine
 	    Zeichenkette gesetzt werden, die den Grund beschreibt,
 	    warum kein Paket erzeugt werden soll.</para>
 	</sect2>
 
 	<sect2>
 	  <title><makevar>NO_CDROM</makevar></title>
 
 	  <para>Diese Variable gibt an, dassobwohl wir bin&auml;re
 	    Pakete erzeugen d&uuml;rfen&nbsp;&ndash;&nbsp;wir weder
 	    diese Pakete noch die <makevar>DISTFILES</makevar> des
 	    Ports auf einer CD-ROM (oder &auml;hnlichen Medien)
 	    verkaufen d&uuml;rfen. Die <makevar>DISTFILES</makevar>
 	    des Ports d&uuml;rfen allerdings immer noch auf FTP/HTTP
 	    Mirrors.</para>
 
 	  <para>Wenn diese Variable und auch
 	    <makevar>NO_PACKAGE</makevar> gesetzt ist, dann werden
 	    nur die <makevar>DISTFILES</makevar> des Ports
 	    erh&auml;ltlich sein&nbsp;&ndash;&nbsp;und das nur
 	    mittels FTP/HTTP.</para>
 
 	  <para><makevar>NO_CDROM</makevar> sollte auf eine
 	    Zeichenkette gesetzt werden, die den Grund beschreibt,
 	    warum der Port nicht auf CD-ROM weiterverbreitet werden
 	    kann. Das sollte z.B. gemacht werden, wenn die Lizenz
 	    des Ports nur f&uuml;r
 	    <quote>nichtkommerzielle Zwecke</quote> gilt.</para>
 	</sect2>
 
 	<sect2>
 	  <title><makevar>NOFETCHFILES</makevar></title>
 
 	  <para>Dateien, die in der Variable
 	    <makevar>NOFETCHFILES</makevar> aufgelistet sind,
 	    sind von keiner der <makevar>MASTER_SITES</makevar>
 	    abrufbar. Ein Beispiel solch einer Datei ist eine selbige,
 	    welche vom Anbieter auf CD-ROM bereitgestellt wird.</para>
 
 	  <para>Werkzeuge, die das Vorhandensein dieser Dateien auf
 	    den <makevar>MASTER_SITES</makevar>
 	    &uuml;berpr&uuml;fen, sollten diese Dateien
 	    ignorieren und sie nicht melden.</para>
 	</sect2>
 
 	<sect2>
 	  <title><makevar>RESTRICTED</makevar></title>
 
 	  <para>Setzen Sie diese Variable, wenn die Lizenz der
 	    Applikation weder das Spiegeln der
 	    <makevar>DISTFILES</makevar> der Applikation noch
 	    das Weiterverbreiten von bin&auml;ren Paketen in
 	    jedweder Art erlaubt.</para>
 
 	  <para><makevar>NO_CDROM</makevar> oder
 	    <makevar>NO_PACKAGE</makevar> sollten nicht zusammen
 	    mit <makevar>RESTRICTED</makevar> gesetzt werden, weil
 	    letztere Variable die anderen beiden impliziert.</para>
 
 	  <para><makevar>RESTRICTED</makevar> sollte auf eine
 	    Zeichenkette gesetzt werden, die den Grund beschreibt,
 	    warum der Port nicht weiterverbreitet werden kann.
 	    Typischerweise besagt dies, dass der Port propriet&auml;re
 	    Software enth&auml;lt und der Benutzer die
 	    <makevar>DISTFILES</makevar> manuell herunterladen
 	    muss&nbsp;&ndash;&nbsp;m&ouml;glicherweise erst nachdem
 	    er sich f&uuml;r die Software registriert oder die
 	    Bedingungen eines Endbenutzer-Lizenzvertrags
 	    (<acronym>EULA</acronym>) akzeptiert hat.</para>
 	</sect2>
 
 	<sect2>
 	  <title><makevar>RESTRICTED_FILES</makevar></title>
 
 	  <para>Wenn <makevar>RESTRICTED</makevar> oder
 	    <makevar>NO_CDROM</makevar> gesetzt ist, ist diese
 	    Variable auf <literal>${DISTFILES}
 	    ${PATCHFILES}</literal> voreingestellt, sonst ist sie
 	    leer. Wenn nicht jede dieser Dateien beschr&auml;nkt ist,
 	    dann f&uuml;hren Sie die betroffenen Dateien in dieser
 	    Variable auf.</para>
 
 	  <para>Beachten Sie, dass der Porter f&uuml;r jede
 	    aufgef&uuml;hrte Distributionsdatei einen Eintrag zu
 	    <filename>/usr/ports/LEGAL</filename> hinzuf&uuml;gen
 	    sollte, der genau beschreibt, was die Beschr&auml;nkung
 	    mit sich bringt.</para>
 	</sect2>
       </sect1>
 
       <sect1 id="building">
 	<title>Build-Mechanismen</title>
 
 	<sect2 id="using-make">
 	  <title><command>make</command>, <command>gmake</command>
 	    und <command>imake</command></title>
 
 	  <para>Wenn Ihr Port <application>GNU make</application>
 	    benutzt, dann setzen Sie bitte
 	    <literal>USE_GMAKE=yes</literal>.</para>
 
 	  <table frame="none">
 	    <title>Port-Variablen im Zusammenhang mit gmake</title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>Variable</entry>
 
 		  <entry>Bedeutung</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><makevar>USE_GMAKE</makevar></entry>
 
 		  <entry>Der Port ben&ouml;tigt <command>gmake</command>
 		   f&uuml;r den Build.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>GMAKE</makevar></entry>
 
 		  <entry>Der ganze Pfad zu <command>gmake</command>,
 		    wenn es nicht im <envar>PATH</envar> ist.</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	  <para>Wenn Ihr Port eine X-Applikation ist, die
 	    <filename>Makefile</filename>-Dateien aus
 	    <filename>Imakefile</filename>-Dateien mit
 	    <application>imake</application> erzeugt, dann setzen Sie
 	    <literal>USE_IMAKE=yes</literal>. Das sorgt daf&uuml;r,
 	    dass die Konfigurationsphase automatisch ein
 	    <command>xmkmf -a</command> ausf&uuml;hrt.
 	    Wenn das Flag <option>-a</option> ein Problem f&uuml;r
 	    Ihren Port darstellt, setzen Sie
 	    <literal>XMKMF=xmkmf</literal>. Wenn der Port
 	    <application>imake</application> benutzt, aber das
 	    <maketarget>install.man</maketarget>-Target nicht versteht,
 	    dann sollte <literal>NO_INSTALL_MANPAGES=yes</literal>
 	    gesetzt werden.</para>
 
 	  <para>Wenn das <filename>Makefile</filename>
 	    im Quelltext Ihres Ports etwas anderes als
 	    <maketarget>all</maketarget> als Haupt-Build-Target
 	    hat, setzen Sie <makevar>ALL_TARGET</makevar>
 	    entsprechend. Das Gleiche gilt f&uuml;r
 	    <maketarget>install</maketarget> und
 	    <makevar>INSTALL_TARGET</makevar>.</para>
 	</sect2>
 
 	<sect2 id="using-configure">
 	  <title><command>configure</command> Skript</title>
 
 	  <para>Wenn Ihr Port ein <command>configure</command>-Skript
 	    benutzt, um <filename>Makefile</filename>-Dateien aus
 	    <filename>Makefile.in</filename>-Dateien zu erzeugen,
 	    setzen Sie <literal>GNU_CONFIGURE=yes</literal>.
 	    Wenn Sie dem <command>configure</command>-Skript
 	    zus&auml;tzliche Argumente &uuml;bergeben wollen (das
 	    Vorgabeargument ist <literal>--prefix=&dollar;{PREFIX}
 	    --infodir=&dollar;{PREFIX}/&dollar;{INFO_PATH}
 	    --mandir=&dollar;{MANPREFIX}/man
 	    &dollar;{CONFIGURE_TARGET}</literal>), setzen Sie diese
 	    zus&auml;tzlichen Argumente in
 	    <makevar>CONFIGURE_ARGS</makevar>.
 	    Zus&auml;tzliche Umgebungsvariablen k&ouml;nnen
 	    &uuml;berdie Variable <makevar>CONFIGURE_ENV</makevar>
 	    &uuml;bergeben werden.</para>
 
 	  <para>Wenn Ihr Paket GNU <command>configure</command>
 	    benutzt und die entstandene Bin&auml;rdatei hat einen
 	    <quote>komischen</quote> Namen wie
 	    <filename>i386-portbld-freebsd4.7-</filename><replaceable>appname</replaceable>,
 	    dann m&uuml;ssen Sie zus&auml;tzlich die
 	    <makevar>CONFIGURE_TARGET</makevar>-Variable setzen,
 	    um das Target so anzugeben, wie Skripten, die von neueren
 	    Versionen von <command>autoconf</command> erzeugt wurden,
 	    es erwarten. F&uuml;gen Sie das Folgende direkt nach der
 	    Zeile <literal>GNU_CONFIGURE=yes</literal> in Ihrem
 	    <filename>Makefile</filename> hinzu:</para>
 
 	  <para><literal>CONFIGURE_TARGET=--build=${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal></para>
 
 	  <table frame="none">
 	    <title>Variablen f&uuml;r Ports, die configure
 	      benutzen</title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>Variable</entry>
 
 		  <entry>Bedeutung</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><makevar>GNU_CONFIGURE</makevar></entry>
 
 		  <entry>Der Port benutzt ein
 		    <command>configure</command>-Skript, um das Bauen
 		    vorzubereiten.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>HAS_CONFIGURE</makevar></entry>
 
 		  <entry>Wie <makevar>GNU_CONFIGURE</makevar>, nur
 		    dass kein Standard-Konfigurations-Target zu
 		    <makevar>CONFIGURE_ARGS</makevar> hinzugef&uuml;gt
 		    wird.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>CONFIGURE_ARGS</makevar></entry>
 
 		  <entry>Zus&auml;tzliche Argumente f&uuml;r das
 		    <command>configure</command>-Skript.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>CONFIGURE_ENV</makevar></entry>
 
 		  <entry>Zus&auml;tzliche Umgebungsvariablen
 		    f&uuml;r die Abarbeitung des
 		    <command>configure</command>-Skriptes.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>CONFIGURE_TARGET</makevar></entry>
 
 		  <entry>Ersetzt das Standard-Konfigurations-Target.
 		    Vorgabewert ist
 		    <literal>&dollar;{MACHINE_ARCH}-portbld-freebsd&dollar;{OSREL}</literal>.</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 	</sect2>
 
 	<sect2 id="using-scons">
 	  <title>Benutzung von <command>scons</command></title>
 
 	  <para>Wenn Ihr Port <application>SCons</application>
 	    benutzt, definieren Sie
 	    <literal>USE_SCONS=yes</literal>.</para>
 
 	  <table frame="none">
 	    <title>Variablen f&uuml;r Ports, die
 	      <command>scons</command> benutzen</title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>Variable</entry>
 
 		  <entry>Bedeutung</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><makevar>SCONS_ARGS</makevar></entry>
 
 		  <entry>Port-spezifische SCons-Argumente, die der
 		    SCons-Umgebung &uuml;bergeben werden.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>SCONS_BUILDENV</makevar></entry>
 
 		  <entry>Variablen, die in der System-Umgebung
 		    gesetzt werden sollen.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>SCONS_ENV</makevar></entry>
 
 		  <entry>Variablen, die in der SCons-Umgebung
 		    gesetzt werden sollen.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>SCONS_TARGET</makevar></entry>
 
 		  <entry>Letztes Argument, das SCons &uuml;bergeben
 		    wird&nbsp;&ndash;&nbsp;&auml;hnlich
 		    <makevar>MAKE_TARGET</makevar>.</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	  <para>Um <filename>SConstruct</filename> im Quelltext alles,
 	    was SCons in <makevar>SCONS_ENV</makevar> &uuml;bergeben
 	    wird, respektieren zu lassen (das ist haupts&auml;chlich
 	    <makevar>CC/CXX/CFLAGS/CXXFLAGS</makevar>), patchen Sie
 	    <filename>SConstruct</filename>, sodass das Build
 	    <literal>Environment</literal> wie folgt konstruiert
 	    wird:</para>
 
 	  <programlisting>env = Environment(**ARGUMENTS)</programlisting>
 
 	  <para>Es kann dann mit <literal>env.Append</literal> und
 	    <literal>env.Replace</literal> modifiziert werden.</para>
 	</sect2>
       </sect1>
 
       <sect1 id="using-autotools">
 	<title>Benutzung von GNU autotools</title>
 
 	<sect2 id="using-autotools-introduction">
 	  <title>Einf&uuml;hrung</title>
 
 	  <para>Die verschiedenen GNU autotools stellen einen
 	    Abstraktionsmechanismus bereit f&uuml;r das Kompilieren
 	    von Software f&uuml;r eine Vielfalt von Betriebssystemen
 	    und Maschinenarchitekturen. Innerhalb der Ports-Sammlung
 	    kann ein einzelner Port diese Werkzeuge mit Hilfe eines
 	    einfachen Konstrukts benutzen:</para>
 
 	  <programlisting>USE_AUTOTOOLS= <replaceable>tool</replaceable>:<replaceable>version</replaceable>[:<replaceable>operation</replaceable>] ...</programlisting>
 
 	  <para>Als dies geschrieben wurde konnte
 	    <replaceable>tool</replaceable> eins von
 	    <literal>libtool</literal>, <literal>libltdl</literal>,
 	    <literal>autoconf</literal>,
 	    <literal>autoheader</literal>,
 	    <literal>automake</literal> oder
 	    <literal>aclocal</literal> sein.</para>
 
 	  <para><replaceable>version</replaceable> gibt die einzelne
 	    Werkzeug-Revision an, die benutzt werden soll (siehe
 	    <literal>devel/{automake,autoconf,libtool}[0-9]+</literal>
 	    f&uuml;r m&ouml;gliche Versionen).</para>
 
 	  <para><replaceable>operation</replaceable> ist eine
 	    optionale Angabe, die modifiziert, wie das Werkzeug
 	    benutzt wird.</para>
 
 	  <para>Es k&ouml;nnen auch mehrere Werkzeuge angegeben
 	    werden&nbsp;&ndash;&nbsp;entweder durch Angabe aller in
 	    einer einzigen Zeile oder durch Benutzung des
 	    <literal>+=</literal> Makefile-Konstrukts.</para>
 
 	  <para>Schliesslich gibt es das spezielle Tool, genannt
 	    <literal>autotools</literal>, das der Einfachheit dient
 	    indem es von alle verf&uuml;gbaren Versionen der Autotools
 	    abh&auml;ngt, was sinnvoll f&uuml;r Cross-Development ist.
 	    Dies kann auch erreicht werden, indem man den Port
 	    <literal>devel/autotools</literal> installiert.</para>
 	</sect2>
 
 	<sect2 id="using-libtool">
 	  <title><command>libtool</command></title>
 
 	  <para>Shared-Libraries, die das GNU Build-System benutzen,
 	    verwenden normalerweise
 	    <command>libtool</command>, um die Kompilierung und
 	    Installation solcher Bibliotheken anzupassen.
 	    Die &uuml;bliche Praxis ist, eine Kopie von
 	    <command>libtool</command>, die mit dem Quelltext
 	    geliefert wird, zu benutzen. Falls Sie ein externes
 	    <command>libtool</command> ben&ouml;tigen, k&ouml;nnen
 	    Sie die Version, die von der Ports-Sammlung bereitgestellt
 	    wird, benutzen:</para>
 
 	  <programlisting>USE_AUTOTOOLS= libtool:<replaceable>version</replaceable>[:env]</programlisting>
 
 	  <para>Ohne zus&auml;tzliche Angaben sagt
 	    <literal>libtool:<replaceable>version</replaceable>
 	    </literal> dem Build-System, dass es das
 	    Konfigurationsskript mit der auf dem System
 	    installierten Kopie von <command>libtool</command>
 	    patchen soll.
 	    Die Variable <makevar>GNU_CONFIGURE</makevar> ist
 	    impliziert. Au&szlig;erdem werden einige
 	    make&ndash;&nbsp;und shell-Variablen zur
 	    weiteren Benutzung durch den Port gesetzt.
 	    F&uuml;r Genaueres siehe
 	    <filename>bsd.autotools.mk</filename>.</para>
 
 	  <para>Mit der Angabe <literal>:env</literal> wird nur die
 	    Umgebung vorbereitet.</para>
 
 	  <para>Schlie&szlig;lich k&ouml;nnen optional
 	    <makevar>LIBTOOLFLAGS</makevar> und
 	    <makevar>LIBTOOLFILES</makevar> gesetzt werden, um die
 	    h&auml;ufigsten Argumente und durch
 	    <command>libtool</command> gepatchten Dateien au&szlig;er
 	    Kraft zu setzen. Die meisten Ports werden das aber nicht
 	    brauchen. F&uuml;r Weiteres siehe
 	    <filename>bsd.autotools.mk</filename>.</para>
 	</sect2>
 
 	<sect2 id="using-libltdl">
 	  <title><command>libltdl</command></title>
 
 	  <para>Einige Ports benutzen das
 	    <command>libltdl</command>-Bibliothekspaket,
 	    welches Teil der <command>libtool</command>-Suite ist.
 	    Der Gebrauch dieser Bibliothek macht nicht automatisch
 	    den Gebrauch von <command>libtool</command> selbst
 	    n&ouml;tig, deshalb wird ein separates Konstrukt zur
 	    Verf&uuml;gung gestellt.</para>
 
 	  <programlisting>USE_AUTOTOOLS= libltdl:<replaceable>version</replaceable></programlisting>
 
 	  <para>Im Moment sorgt dies nur f&uuml;r eine
 	    <makevar>LIB_DEPENDS</makevar>-Abh&auml;ngigkeit von dem
 	    entsprechenden <command>libltdl</command>-Port und wird
 	    zur Vereinfachung zur Verf&uuml;gung gestellt,
 	    um Abh&auml;ngigkeiten von den Autotools-Ports
 	    ausserhalb des <makevar>USE_AUTOTOOLS</makevar>-Systems
 	    zu eliminieren. Es gibt keine weiteren Angaben f&uuml;r
 	    dieses Werkzeug.</para>
 	</sect2>
 
 	<sect2 id="using-autoconf">
 	  <title><command>autoconf</command> und
 	    <command>autoheader</command></title>
 
 	  <para>Manche Ports enthalten kein Konfigurationsskript,
 	    sondern eine autoconf-Vorlage in der
 	    <filename>configure.ac</filename>-Datei.
 	    Sie k&ouml;nnen die folgenden Zuweisungen benutzen,
 	    um <command>autoconf</command> das Konfigurationsskript
 	    erzeugen zu lassen, und auch <command>autoheader</command>
 	    Header-Vorlagen zur Benutzung durch das
 	    Konfigurationsskript erzeugen zu lassen.</para>
 
 	  <programlisting>USE_AUTOTOOLS=    autoconf:<replaceable>version</replaceable>[:env]</programlisting>
 
 	  <para>und</para>
 
 	  <programlisting>USE_AUTOTOOLS=    autoheader:<replaceable>version</replaceable></programlisting>
 
 	  <para>welches auch die Benutzung von
 	    <literal>autoconf:<replaceable>version</replaceable>
 	    </literal> impliziert.</para>
 
 	  <para>&Auml;hnlich wie bei <command>libtool</command>,
 	    bereitet die Angabe des optionalen
 	    <literal>:env</literal> nur die Umgebung f&uuml;r weitere
 	    Benutzung vor. Ohne dieses wird der Port auch gepatched
 	    und erneut konfiguriert.</para>
 
 	  <para>Die zus&auml;tzlichen optionalen Variablen
 	    <makevar>AUTOCONF_ARGS</makevar> und
 	    <makevar>AUTOHEADER_ARGS</makevar> k&ouml;nnen durch das
 	    <filename>Makefile</filename> des Ports ausser Kraft
 	    gesetzt werden, wenn erforderlich. Wie bei den
 	    <command>libtool</command>-&Auml;quivalenten werden die
 	    meisten Ports dies aber nicht ben&ouml;tigen.</para>
 	</sect2>
 
 	<sect2 id="using-automake">
 	  <title><command>automake</command> und
 	    <command>aclocal</command></title>
 
 	  <para>Manche Pakete enthalten nur
 	    <filename>Makefile.am</filename>-Dateien. Diese
 	    m&uuml;ssen durch <command>automake</command> in
 	    <filename>Makefile.in</filename>-Dateien konvertiert
 	    und dann durch <command>configure</command>
 	    weiterbearbeitet werden, um schlie&szlig;lich ein
 	    <filename>Makefile</filename> zu erzeugen.</para>
 
 	  <para>&Auml;hnliches gilt f&uuml;r Pakete, die gelegentlich
 	    keine <filename>aclocal.m4</filename>-Dateien mitliefern,
 	    welche ebenfalls zum Erstellen der Software ben&ouml;tigt
 	    werden. Diese k&ouml;nnen durch <command>aclocal</command>
 	    erzeugt werden, welches <filename>configure.ac</filename>
 	    oder <filename>configure.in</filename> durchsucht.</para>
 
 	  <para><command>aclocal</command> hat eine &auml;hnliche
 	    Beziehung zu <command>automake</command> wie
 	    <command>autoheader</command> zu
 	    <command>autoconf</command>&nbsp;&ndash;&nbsp;beschrieben
 	    im vorherigen Abschnitt. <command>aclocal</command>
 	    impliziert die Benutzung von <command>automake</command>,
 	    also haben wir:</para>
 
 	  <programlisting>USE_AUTOTOOLS=    automake:<replaceable>version</replaceable>[:<replaceable>env</replaceable>]</programlisting>
 
 	  <para>und</para>
 
 	  <programlisting>USE_AUTOTOOLS=    aclocal:<replaceable>version</replaceable></programlisting>
 
 	  <para>was auch die Benutzung von <literal>
 	    automake:<replaceable>version</replaceable></literal>
 	    impliziert.</para>
 
 	  <para>&Auml;hnlich wie bei <command>libtool</command> und
 	    <command>autoconf</command>, bereitet die optionale Angabe
 	    <literal>:env</literal> nur die Umgebung zur weiteren
 	    Benutzung vor. Ohne sie wird der Port erneut
 	    konfiguriert.</para>
 
 	  <para>Wie schon <command>autoconf</command> und
 	    <command>autoheader</command>, hat sowohl
 	    <command>automake</command> als auch
 	    <command>aclocal</command> eine optionale
 	    Argument-Variable <makevar>AUTOMAKE_ARGS</makevar>
 	    bzw. <makevar>ACLOCAL_ARGS</makevar>, die durch das
 	    <filename>Makefile</filename> des Ports, falls n&ouml;tig,
 	    au&szlig;er Kraft gesetzt werden kann.</para>
 	</sect2>
       </sect1>
 
       <sect1 id="using-gettext">
 	<title>Benutzung von GNU <literal>gettext</literal></title>
 
 	<sect2>
 	  <title>Grundlegende Benutzung</title>
 
 	  <para>Wenn Ihr Port <literal>gettext</literal>
 	    ben&ouml;tigt, setzen Sie einfach
 	    <makevar>USE_GETTEXT</makevar> auf <literal>yes</literal>,
 	    und Ihr Port bekommt die Abh&auml;ngigkeit von <filename
 	    role="package">devel/gettext</filename>. Der Wert von
 	    <makevar>USE_GETTEXT</makevar> kann auch die
 	    ben&ouml;tigte Version der
 	    <literal>libintl</literal>-Bibliothek angeben, der
 	    grundlegenden Teil von
 	    <literal>gettext</literal>&nbsp;&ndash;&nbsp;jedoch
 	    wird von der Benutzung dieser Funktion
 	    <emphasis>dringend abgeraten</emphasis>:
 	    Ihr Port sollte einfach nur mit der aktuellen Version von
 	    <filename role="package">devel/gettext</filename>
 	    funktionieren.</para>
 
 	  <para>Ein ziemlich h&auml;ufiger Fall ist, dass ein Port
 	    <literal>gettext</literal> und
 	    <command>configure</command> benutzt. Normalerweise sollte
 	    GNU <command>configure</command>
 	    <literal>gettext</literal> automatisch finden k&ouml;nnen.
 	    Sollte das einmal nicht funktionieren, k&ouml;nnen
 	    Hinweise &uuml;ber den Ort von <literal>gettext</literal>
 	    in <envar>CPPFLAGS</envar> und <envar>LDFLAGS</envar> wie
 	    folgt &uuml;bergeben werden:</para>
 
 	  <programlisting>USE_GETTEXT=    yes
 CPPFLAGS+=      -I${LOCALBASE}/include
 LDFLAGS+=       -L${LOCALBASE}/lib
 
 GNU_CONFIGURE=  yes
 CONFIGURE_ENV=  CPPFLAGS="${CPPFLAGS}" \
 	        LDFLAGS="${LDFLAGS}"</programlisting>
 
 	  <para>Nat&uuml;rlich kann der Code kompakter sein,
 	    wenn es keine weiteren Flags gibt, die
 	    <command>configure</command> &uuml;bergeben werden
 	    m&uuml;ssen:</para>
 
 	  <programlisting>USE_GETTEXT=    yes
 GNU_CONFIGURE=  yes
 CONFIGURE_ENV=  CPPFLAGS="-I${LOCALBASE}/include" \
 	        LDFLAGS="-L${LOCALBASE}/lib"</programlisting>
 	</sect2>
 
 	<sect2>
 	  <title>Optionale Benutzung</title>
 
 	  <para>Manche Softwareprodukte erlauben die Deaktivierung
 	    von NLS - z.B. durch &Uuml;bergeben von
 	    <option>--disable-nls</option> an
 	    <command>configure</command>. In diesem Fall sollte Ihr
 	    Port <literal>gettext</literal> abh&auml;ngig vom Status
 	    von <link
 	    linkend="knobs-without-nls"><makevar>WITHOUT_NLS</makevar></link>
 	    benutzen. F&uuml;r Ports mit niedriger bis mittlerer
 	    Komplexit&auml;t k&ouml;nnen Sie sich auf das folgende
 	    Idiom verlassen:</para>
 
 	  <programlisting>GNU_CONFIGURE=          yes
 
 .if !defined(WITHOUT_NLS)
 USE_GETTEXT=            yes
 PLIST_SUB+=             NLS=""
 .else
 CONFIGURE_ARGS+=        --disable-nls
 PLIST_SUB+=             NLS="@comment "
 .endif</programlisting>
 
 	  <para>Der n&auml;chste Punkt auf Ihrer Todo-Liste ist
 	    daf&uuml;r zu sorgen, dass die Message-Catalog-Dateien
 	    nur bedingt in der Packliste aufgef&uuml;hrt werden. Der
 	    <filename>Makefile</filename>-Teil dieser Aufgabe ist
 	    schon durch obiges Idiom erledigt.
 	    Das wird im Abschnitt &uuml;ber <link
 	    linkend="plist-sub">Fortgeschrittene
 	    <filename>pkg-plist</filename>-Methoden</link>
 	    erkl&auml;rt.
 	    Kurz gesagt, jedes Vorkommen von
 	    <literal>%%NLS%%</literal> in
 	    <filename>pkg-plist</filename> wird durch
 	    <quote><literal>@comment&nbsp;</literal></quote>, wenn NLS
 	    abgeschaltet ist, oder durch eine leere Zeichenkette,
 	    wenn NLS aktiviert ist, ersetzt. Folglich werden die
 	    Zeilen, denen <literal>%%NLS%%</literal> vorangestellt
 	    ist, zu reinen Kommentaren in der endg&uuml;ltigen
 	    Packliste, wenn NLS abgeschaltet ist;
 	    andernfalls wird der Prefix einfach nur ausgelassen.
 	    Alles, was Sie jetzt noch machen m&uuml;ssen, ist
 	    <literal>%%NLS%%</literal> vor jedem Pfad zu einer
 	    Message-Catalog-Datei in <filename>pkg-plist</filename>
 	    einzuf&uuml;gen. Zum Beispiel:</para>
 
 	  <programlisting>%%NLS%%share/locale/fr/LC_MESSAGES/foobar.mo
 %%NLS%%share/locale/no/LC_MESSAGES/foobar.mo</programlisting>
 
 	  <para>In sehr komplexen F&auml;llen m&uuml;ssen Sie
 	    eventuell fortgeschrittenere Techniken als die hier
 	    vorgestellte benutzen - wie z.B. <link
 	    linkend="plist-dynamic">Dynamische
 	    Packlistenerzeugung</link>.</para>
 	</sect2>
 
 	<sect2>
 	  <title>Behandlung von Message-Catalog-Verzeichnissen</title>
 
 	  <para>Bei der Installation von Message-Catalog-Dateien
 	    gibt es einen Punkt zu beachten. Ihr Zielverzeichnis,
 	    das unter <filename>
 	    <makevar>LOCALBASE</makevar>/share/locale</filename>
 	    liegt, sollte nur selten von Ihrem Port erzeugt und
 	    gel&ouml;scht werden. Die Verzeichnisse f&uuml;r die
 	    gebr&auml;uchlichsten Sprachen sind in
 	    <filename>/etc/mtree/BSD.local.dist</filename>
 	    aufgelistet; das heisst, sie sind Teil des Systems.
 	    Die Verzeichnisse f&uuml;r viele andere Sprachen sind
 	    Teil des Ports <filename
 	    role="package">devel/gettext</filename>. Sie wollen
 	    vielleicht dessen <filename>pkg-plist</filename>
 	    zur Hand nehmen, um festzustellen, ob Ihr Port eine
 	    Message-Catalog-Datei f&uuml;r eine seltene Sprache
 	    installiert.</para>
 	</sect2>
       </sect1>
 
       <sect1 id="using-perl">
 	<title>Die Benutzung von <literal>perl</literal></title>
 
 	<para>Wenn <makevar>MASTER_SITES</makevar> auf
 	  <makevar>MASTER_SITE_PERL_CPAN</makevar> gesetzt ist,
 	  dann ist der bevorzugte Wert von
 	  <makevar>MASTER_SITE_SUBDIR</makevar> der Top-Level-Name
 	  der Hierarchie. Zum Beispiel ist der empfohlene Wert
 	  f&uuml;r
 	  <literal>p5-Module-Name</literal>-<literal>Module</literal>.
 	  Die Top-Level-Hierarchie kann unter <ulink
 	  url="http://cpan.org/modules/by-module/">cpan.org</ulink>
 	  angeschaut werden. Dies sorgt daf&uuml;r, dass der Port
 	  weiter funktioniert, wenn sich der Autor des Moduls
 	  &auml;ndert.</para>
 
 	<para>Die Ausnahme dieser Regel ist, dass das entsprechende
 	  Verzeichnis selber oder das Distfile in diesem Verzeichnis
 	  nicht existiert. In solchen F&auml;llen ist die Benutzung
 	  der Id des Autors als <makevar>MASTER_SITE_SUBDIR</makevar>
 	  erlaubt.</para>
 
 	<para>Jede der Einstellungen unten kann sowohl auf
 	  <literal>YES</literal> als auch auf eine
 	  Versionszeichenkette wie <literal>5.8.0+</literal> gesetzt
 	  werden. Wenn <literal>YES</literal> benutzt wird, bedeutet
 	  das, dass der Port mit jeder der unterst&uuml;tzten
 	  <application>Perl</application>-Versionen funktioniert.
 	  Falls ein Port nur mit einer bestimmten
 	  <application>Perl</application>-Version funktioniert, kann
 	  darauf mit einer Versionszeichenkette hingewiesen werden,
 	  die entweder eine Mindest- (z.B. <literal>5.7.3+</literal>),
 	  Maximal- (z.B. <literal>5.8.0-</literal>) oder
 	  Absolutversion (z.B. <literal>5.8.3</literal>)
 	  festlegt.</para>
 
 	<table frame="none">
 	  <title>Variablen f&uuml;r Ports, die <literal>perl</literal>
 	  benutzen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 	 	<entry>Variable</entry>
 	 	<entry>Bedeutung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_PERL5</makevar></entry>
 		<entry>Bedeutet, dass der Port <literal>perl 5</literal>
 		  zum Erstellen und zum Ausf&uuml;hren benutzt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_PERL5_BUILD</makevar></entry>
 		<entry>Bedeutet, dass der Port <literal>perl 5</literal>
 		  zum Erstellen benutzt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_PERL5_RUN</makevar></entry>
 		<entry>Bedeutet, dass der Port <literal>perl 5</literal>
 	      zur Laufzeit benutzt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL</makevar></entry>
 		<entry>Der gesamte Pfad zu
 		  <literal>perl 5</literal>&nbsp;&ndash;&nbsp;entweder
 		  im Basissystem oder nachinstalliert &uuml;ber einen
 		  Port&nbsp;&ndash;&nbsp;ohne die Versionsnummer. Benutzen
 		  Sie diese Variable, wenn Sie <quote>
 		  <literal>#!</literal></quote>-Zeilen in Skripten
 		  ersetzen m&uuml;ssen.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL_CONFIGURE</makevar></entry>
 		<entry>Perls MakeMaker f&uuml;r die Konfiguration
 		  benutzen. Dies impliziert
 		  <makevar>USE_PERL5</makevar>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL_MODBUILD</makevar></entry>
 		<entry>Module::Build f&uuml;r configure, build und install
 		  benutzen. Dies impliziert
 		  <makevar>PERL_CONFIGURE</makevar>.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Nur lesbare Variablen</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>PERL_VERSION</makevar></entry>
 		<entry>Die volle Version des installierten
 		  <literal>perl</literal> (z.B.
 		  <literal>5.00503</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL_VER</makevar></entry>
 		<entry>Die kurze Angabe der installierten
 		  <literal>perl</literal>-Version (z.B.
 		  <literal>5.005</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL_LEVEL</makevar></entry>
 		<entry>Die installierte <literal>perl</literal>-Version
 		  als ein Integer der Form <literal>MNNNPP</literal>
 		  (z.B. <literal>500503</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL_ARCH</makevar></entry>
 		<entry>Wo <literal>perl</literal> architektur
 		  abh&auml;ngige Bibliotheken ablegt. Vorgabe ist
 		  <literal>${ARCH}-freebsd</literal>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>PERL_PORT</makevar></entry>
 		<entry>Name des <literal>perl</literal>-Ports, der
 		  installiert ist (z.B. <literal>perl5</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>SITE_PERL</makevar></entry>
 		<entry>Verzeichnis, in das die Site-spezifischen
 		  <literal>perl</literal>-Pakete kommen. Dieser Wert
 		  wird zu PLIST_SUB hinzugef&uuml;gt.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<note>
 	  <para>Ports von Perl-Modulen, die keine offizielle
 	    Webseite haben, sollen in der WWW-Zeile ihrer
 	    <filename>pkg-descr</filename>-Datei auf
 	    <hostid>cpan.org</hostid> verlinken.
 	    Die bevorzugte URL-Form ist <literal>
 	    http://search.cpan.org/dist/Module-Name/</literal>
 	    (inklusive des Slash am Ende).</para>
 	</note>
       </sect1>
 
       <sect1 id="using-x11">
 	<title>Benutzung von X11</title>
 
 	<sect2 id="x11-variables">
 	  <title>X.Org-Komponenten</title>
 
 	  <para>Die X11-Implementierung, welche die Ports-Sammlung
 	    bereitstellt, ist X.Org. Wenn Ihre Applikation von
 	    X-Komponenten abh&auml;ngt, listen Sie die ben&ouml;tigten
 	    Komponenten in <makevar>USE_XORG</makevar> auf. Als dies
 	    geschrieben wurde, wurden die folgenden Komponenten
 	    bereitgestellt:</para>
 
 	  <para><literal>bigreqsproto compositeproto damageproto dmx
 	    dmxproto evieproto fixesproto fontcacheproto fontenc
 	    fontsproto fontutil glproto ice inputproto kbproto libfs
 	    oldx printproto randrproto recordproto renderproto
 	    resourceproto scrnsaverproto sm trapproto videoproto x11
 	    xau xaw xaw6 xaw7 xaw8 xbitmaps xcmiscproto xcomposite
 	    xcursor xdamage xdmcp xevie xext xextproto
 	    xf86bigfontproto xf86dgaproto xf86driproto xf86miscproto
 	    xf86rushproto xf86vidmodeproto xfixes xfont xfontcache xft
 	    xi xinerama xineramaproto xkbfile xkbui xmu xmuu
 	    xorg-server xp xpm xprintapputil xprintutil xpr oto
 	    xproxymngproto xrandr xrender xres xscrnsaver xt xtrans
 	    xtrap xtst xv xvmc xxf86dga xxf86misc
 	    xxf86vm</literal>.</para>
 
 	  <para>Die aktuelle Liste finden Sie immer in
 	    <filename>/usr/ports/Mk/bsd.xorg.mk</filename>.</para>
 
 	  <para>Das Mesa Projekt ist ein Versuch, eine freie OpenGL
 	    Implementierung bereitzustellen. Sie k&ouml;nnen eine
 	    Abh&auml;ngigkeit von verschiedenen Komponenten diese
 	    Projektes in der Variable <makevar>USE_GL</makevar>
 	    spezifizieren. ouml;gliche Optionen sind: <literal>glut,
 	    glu, glw, gl</literal> und <literal>linux</literal>.
 	    F&uuml;r R&uuml;ckw&auml;rtskompatibilit&auml; gilt der
 	    Wert <literal>yes</literal> als
 	    <literal>glu</literal>.</para>
 
 	  <example id="use-xorg-example">
 	    <title>Beispiel f&uuml;r USE_XORG</title>
 
 	    <programlisting>USE_XORG=   xrender xft xkbfile xt xaw
 USE_GL=     glu</programlisting>
 	  </example>
 
 	  <para>Viele Ports definieren <makevar>USE_XLIB</makevar>,
 	    was daf&uuml;r sorgt, dass der Port von allen (rund 50)
 	    Bibliotheken abh&auml;ngt. Diese Variable existiert, um
 	    uuml;ckw&auml;rtskompatibilit&auml;t sicherzustellen (sie
 	    stammt noch aus der Zeit vor dem modularem X.Org), und
 	    sollte bei neuen Ports nicht mehr benutzt werden.</para>
 
 	  <table frame="none">
 	    <title>Variablen f&uuml;r Ports, die X benutzen</title>
 
 	    <tgroup cols="2">
 	      <tbody>
 
 		<row>
 		  <entry><makevar>USE_XLIB</makevar></entry>
 		  <entry>Der Port benutzt die X-Bibliotheken. Soll
 		    nicht mehr verwendet werden - benutzen Sie
 		    stattdessen eine Liste von Komponenten in
 		    <makevar>USE_XORG</makevar>.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>USE_X_PREFIX</makevar></entry>
 		  <entry>Soll nicht mehr benutzt werden, ist jetzt
 		    &auml;quivalent zu <makevar>USE_XLIB</makevar> und
 		    kann einfach durch letzteres ersetzt
 		    werden.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>USE_IMAKE</makevar></entry>
 		  <entry>Der Port benutzt <command>imake</command>.
 		    Impliziert <makevar>USE_X_PREFIX</makevar>.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>XMKMF</makevar></entry>
 		  <entry>Ist auf den Pfad zu <command>xmkmf</command>
 		    gesetzt, wenn nicht in <envar>PATH</envar>. Vorgabe
 		    ist <literal>xmkmf -a</literal>.</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	  <table frame="none">
 	    <title>Variablen bei Abh&auml;ngigkeit von einzelnen
 	      Teilen von X11</title>
 
 	    <tgroup cols="2">
 	      <tbody>
 		<row>
 		  <entry><makevar>X_IMAKE_PORT</makevar></entry>
 		  <entry>Ein Port, der <command>imake</command> und einige
 		    andere Werkzeuge, die zum Erstellen von X11 benutzt
 		    werden, bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_LIBRARIES_PORT</makevar></entry>
 		  <entry>Ein Port, der die X11-Bibliotheken
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_CLIENTS_PORT</makevar></entry>
 		  <entry>Ein Port, der X11-Clients bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_SERVER_PORT</makevar></entry>
 		  <entry>Ein Port, der den X11-Server bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTSERVER_PORT</makevar></entry>
 		  <entry>Ein Port, der den Fontserver bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_PRINTSERVER_PORT</makevar></entry>
 		  <entry>Ein Port, der den Printserver bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_VFBSERVER_PORT</makevar></entry>
 		  <entry>Ein Port, der den virtuellen Framebuffer-Server
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_NESTSERVER_PORT</makevar></entry>
 		  <entry>Ein Port, der einen nested X-Server
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_ENCODINGS_PORT</makevar></entry>
 		  <entry>Ein Port, der Kodierungen f&uuml;r Schriftarten
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_MISC_PORT</makevar></entry>
 		  <entry>Ein Port, der verschiedene Bitmap-Schriftarten
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_100DPI_PORT</makevar></entry>
 		  <entry>Ein Port, der 100dpi Bitmap-Schriftarten
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_75DPI_PORT</makevar></entry>
 		  <entry>Ein Port, der 75dpi Bitmap-Schriftarten
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_CYRILLIC_PORT</makevar></entry>
 		  <entry>Ein Port, der kyrillische Bitmap-Schriftarten
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_TTF_PORT</makevar></entry>
 		  <entry>Ein Port, der &truetype;-Schriftarten
 		    bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_FONTS_TYPE1_PORT</makevar></entry>
 		  <entry>Ein Port, der Type1-Schriftarten bereitstellt.</entry>
 		</row>
 
 		<row>
 		  <entry><makevar>X_MANUALS_PORT</makevar></entry>
 		  <entry>Ein Port, der entwicklerorientierte Manualpages
 		    bereitstellt.</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	  <example id="using-x11-vars">
 	    <title>Benutzung von X11-bezogenen Variablen in einem
 	      Port</title>
 
 	    <programlisting># Port benutzt X11-Bibliotheken und h&auml;ngt
      vom Font-Server
 # sowie von kyrillischen Schriftarten ab.
 RUN_DEPENDS=   ${X11BASE}/bin/xfs:${X_FONTSERVER_PORT} \
 	       ${X11BASE}/lib/X11/fonts/cyrillic/crox1c.pcf.gz:${X_FONTS_CYRILLIC_PORT}
 
 USE_XLIB=      yes</programlisting>
 	  </example>
 	</sect2>
 
 	<sect2 id="x11-motif">
 	  <title>Ports, die Motif ben&ouml;tigen</title>
 
 	  <para>Wenn Ihr Port eine Motif-Bibliothek ben&ouml;tigt,
 	    definieren Sie <makevar>USE_MOTIF</makevar> im
 	    <filename>Makefile</filename>.
 	    Die Standard-Motif-Implementierung ist <filename
 	    role="package">x11-toolkits/open-motif</filename>.
 	    Benutzer k&ouml;nnen stattdessen <filename
 	    role="package">x11-toolkits/lesstif</filename> w&auml;hlen,
 	    indem Sie die <makevar>WANT_LESSTIF</makevar>-Variable
 	    setzen.</para>
 
 	  <para>Die Variable <makevar>MOTIFLIB</makevar> wird von
 	    <filename>bsd.port.mk</filename> auf die entsprechende
 	    Motif-Bibliothek gesetzt. Bitte patchen Sie den Quelltext
 	    Ihres Ports, sodass er &uuml;berall
 	    <literal>&dollar;{MOTIFLIB}</literal> benutzt, wo die
 	    Motif-Bibliothek im Original <filename>Makefile</filename>
 	    oder <filename>Imakefile</filename> referenziert
 	    wird.</para>
 
 	  <para>Es gibt zwei verbreitete F&auml;lle:</para>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para>Wenn sich der Port in seinem
 		<filename>Makefile</filename> oder
 		<filename>Imakefile</filename> auf die
 		Motif-Bibliothek als <literal>-lXm</literal> bezieht,
 		ersetzen Sie das einfach durch
 		<literal>&dollar;{MOTIFLIB}</literal>.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>Wenn der Port in seinem
 		<filename>Imakefile</filename>
 		<literal>XmClientLibs</literal> benutzt, ersetzen Sie
 		das durch <literal>&dollar;{MOTIFLIB}
 		&dollar;{XTOOLLIB} &dollar;{XLIB}</literal>.</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>Anmerkung: <makevar>MOTIFLIB</makevar> expandiert
 	    (normalerweise) zu <literal>-L/usr/X11R6/lib
 	    -lXm</literal> oder <literal>/usr/X11R6/lib/libXm.a
 	    </literal> - d.h. Sie m&uuml;ssen kein
 	    <literal>-L</literal> oder <literal>-l</literal> davor
 	    einf&uuml;gen.</para>
 	</sect2>
 
 	<sect2>
 	  <title>X11 Schriftarten</title>
 
 	  <para>Wenn Ihr Port Schriftarten f&uuml;r das
 	    X-Window-System installiert, legen Sie diese nach
 	    <filename>
 	    <makevar>X11BASE</makevar>/lib/X11/fonts/local</filename>.</para>
 	</sect2>
 
 	<sect2>
 	  <title>Erzeugen eines k&uuml;nstlichen
 	    <envar>DISPLAY</envar> durch Xvfb</title>
 
 	  <para>Manche Applikationen ben&ouml;tigen ein
 	    funktionierendes X11-Display, damit die Kompilierung
 	    funktioniert. Das stellt f&uuml;r den FreeBSD
 	    Package-Building-Cluster, der ohne Display l&auml;uft,
 	    ein Problem dar. Wenn der folgende kanonische Hack
 	    benutzt wird, startet der Package-Building-Cluster den
 	    virtuellen Framebuffer-X-Server, und ein funktionierendes
 	    <envar>DISPLAY</envar> wird dem Build
 	    &uuml;bergeben.</para>
 
 	  <programlisting>USE_DISPLAY=  yes</programlisting>
 	</sect2>
 
 	<sect2 id="desktop-entries">
 	  <title>Desktop-Eintr&auml;ge</title>
 
 	  <para>Desktop-Eintr&auml;ge (<ulink
 	    url="http://standards.freedesktop.org/desktop-entry-spec/latest/">Freedesktop
 	    Standard</ulink>) k&ouml;nnen in Ihrem Port einfach
 	    &uuml;ber die <makevar>DESKTOP_ENTRIES</makevar>-Variable
 	    erzeugt werden. Diese Eintr&auml;ge erscheinen dann im
 	    Applikationsmen&uuml; von standardkonformen
 	    Desktop-Umgebungen wie GNOME oder KDE. Die
 	    <filename>.desktop</filename>-Datei wird dann
 	    automatisch erzeugt, installiert und der
 	    <filename>pkg-plist</filename> hinzugef&uuml;gt.
 	    Die Syntax ist:</para>
 
 	  <programlisting>DESKTOP_ENTRIES=  "NAME" "COMMENT" "ICON" "COMMAND" "CATEGORY" StartupNotify</programlisting>
 
 	  <para>Die Liste der m&ouml;glichen Kategorien ist auf der
 	    <ulink
 	    url="http://standards.freedesktop.org/menu-spec/latest/apa.html">Freedesktop
 	    Webseite</ulink> abrufbar.
 	    <makevar>StartupNotify</makevar> zeigt an, ob die
 	    Applikation den Status in Umgebungen, die
 	    Startup-Notifications kennen, l&ouml;schen wird.</para>
 
 	  <para>Beispiel:</para>
 
 	  <programlisting>DESKTOP_ENTRIES=  "ToME" "Roguelike game based on JRR Tolkien's work" \
 	          "${DATADIR}/xtra/graf/tome-128.png" \
 	          "tome -v -g" "Application;Game;RolePlaying" \
 	          false</programlisting>
 	</sect2>
     </sect1>
 
     <sect1 id="using-gnome">
       <title>Benutzung von GNOME</title>
 
       <para>Das FreeBSD/GNOME-Projekt benutzt seine eigene
 	Gruppe von Variablen, um zu definieren, welche
 	GNOME-Komponenten ein bestimmter Port benutzt. Eine
 	<ulink url="http://www.FreeBSD.org/gnome/docs/porting.html">
 	umfassende Liste dieser Variablen</ulink> existiert innerhalb
 	der Webseite des FreeBSD/GNOME-Projektes.</para>
     </sect1>
 
     <sect1 id="using-kde">
       <title>Benutzung von KDE</title>
 
       <sect2 id="kde-variables">
 	<title>Variablen-Definitionen</title>
 
 	<table frame="none">
 	  <title>Variablen f&uuml;r Ports, die KDE benutzen</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_KDELIBS_VER</makevar></entry>
 		<entry>Der Port benutzt KDE-Bibliotheken. Die Variable
 		  spezifiziert die Major Version von KDE, die benutzt
 		  werden soll, und impliziert
 		  <makevar>USE_QT_VER</makevar> der entsprechenden
 		  Version. Der einzig m&ouml;gliche Wert ist
 		  <literal>3</literal>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_KDEBASE_VER</makevar></entry>
 		<entry>Der Port benutzt die KDE-Base. Die Variable
 		  spezifiziert die Major Version von KDE, die benutzt
 		  werden soll, und impliziert
 		  <makevar>USE_QT_VER</makevar> der entsprechenden
 		  Version. Der einzig m&ouml;gliche Wert ist
 		  <literal>3</literal>.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 id="kde-qt">
 	<title>Ports, die Qt ben&ouml;tigen</title>
 
 	<table frame="none">
 	  <title>Variablen f&uuml;r Ports, die Qt
 	    ben&ouml;tigen</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_QT_VER</makevar></entry>
 		<entry>Der Port benutzt das Qt-Toolkit. M&ouml;gliche
 		  Werte sind <literal>3</literal> und
 		  <literal>4</literal>; diese spezifizieren die Major
 		  Version von Qt, die benutzt werden soll.
 		  Entsprechende Parameter werden an das
 		  <command>configure</command>-Skript und
 		  <command>make</command> &uuml;bergeben.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>QT_PREFIX</makevar></entry>
 		<entry>Enth&auml;lt den Pfad, wohin Qt installiert ist
 		  (nur lesbare Variable).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>MOC</makevar></entry>
 		<entry>Enth&auml;lt den Pfad von <command>moc</command>
 		  (nur lesbare Variable). Voreingestellt entsprechend des
 		  <makevar>USE_QT_VER</makevar>-Werts.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>QTCPPFLAGS</makevar></entry>
 		<entry>Zus&auml;tzliche Compiler-Flags, die &uuml;ber
 		  <makevar>CONFIGURE_ENV</makevar> an das Qt-Toolkit
 		    &uuml;bergeben werden. Voreingestellt entsprechend des
 		   <makevar>USE_QT_VER</makevar>-Wertes.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>QTCFGLIBS</makevar></entry>
 		<entry>Zus&auml;tzliche Bibliotheken, die &uuml;ber
 		<makevar>CONFIGURE_ENV</makevar> f&uuml;r das Qt-Toolkit
 		  gelinkt werden sollen. Voreingestellt entsprechend des
 		  <makevar>USE_QT_VER</makevar>-Wertes.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>QTNONSTANDARD</makevar></entry>
 		<entry>&Auml;nderungen von
 		  <makevar>CONFIGURE_ENV</makevar>,
 		  <makevar>CONFIGURE_ARGS</makevar> und
 		  <makevar>MAKE_ENV</makevar> sollen unterdr&uuml;ckt
 		  werden.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<table frame="none">
 	  <title>Zus&auml;tzliche Variablen f&uuml;r Ports,
 	    die Qt 4.xi benutzen</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><makevar>QT_COMPONENTS</makevar></entry>
 		<entry>Spezifiziert Tool&ndash;&nbsp;und
 		  Bibliothek-Abh&auml;ngigkeiten f&uuml;r Qt4.
 		  Siehe unten f&uuml;r Details.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>UIC</makevar></entry>
 		<entry>Enth&auml;lt den Pfad von <command>uic</command>
 		  (nur lesbare Variable). Voreingestellt entsprechend des
 		  <makevar>USE_QT_VER</makevar>-Wertes.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>QMAKE</makevar></entry>
 		<entry>Enth&auml;lt den Pfad von <command>qmake</command>
 		  (nur lesbare Variable). Voreingestellt entsprechend des
 		  <makevar>USE_QT_VER</makevar>-Wertes.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>QMAKESPEC</makevar></entry>
 		<entry>Enth&auml;lt den Pfad der Konfigurationsdatei
 		  f&uuml;r <command>qmake</command>
 		  (nur lesbare Variable). Voreingestellt entsprechend des
 		  <makevar>USE_QT_VER</makevar>-Wertes.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Wenn <makevar>USE_QT_VER</makevar> gesetzt ist,
 	  werden dem <command>configure</command>-Skript einige
 	  n&uuml;tzliche Einstellungen &uuml;bergeben:</para>
 
 	<programlisting>CONFIGURE_ARGS+= --with-qt-includes=${QT_PREFIX}/include \
 	         --with-qt-libraries=${QT_PREFIX}/lib \
 	         --with-extra-libs=${LOCALBASE}/lib \
 	         --with-extra-includes=${LOCALBASE}/include
 CONFIGURE_ENV+=  MOC="${MOC}" CPPFLAGS="${CPPFLAGS} ${QTCPPFLAGS}" LIBS="${QTCFGLIBS}" \
 	         QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"</programlisting>
 
 	<para>Wenn <makevar>USE_QT_VER</makevar> auf
 	  <literal>4</literal> gesetzt ist, werden auch die folgenden
 	  Einstellungen &uuml;bergeben:</para>
 
 	<programlisting>CONFIGURE_ENV+= UIC="${UIC}" QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}"
 MAKE_ENV+=      QMAKESPEC="${QMAKESPEC}"</programlisting>
       </sect2>
       <sect2 id="qt4-components">
 	<title>Komponentenauswahl (nur bei Qt 4.x)</title>
 
 	<para>Wenn <makevar>USE_QT_VER</makevar> auf 4 gesetzt ist,
 	   k&ouml;nnen individuelle Qt4-Tool- und
 	   Bibliotheksabh&auml;ngigkeiten in der Variable
 	   <makevar>QT_COMPONENTS</makevar> angegeben werden.  An jede
 	   Komponente kann <literal>_build</literal> oder
 	   <literal>_run</literal> als Suffix angeh&auml;ngt werden,
 	   was eine Abh&auml;ngigkeit zur Build- bzw. Laufzeit angibt.
 	   Ohne Suffix gilt die Abh&auml;ngigkeit sowohl zur Build-
 	   als auch zur Laufzeit.  Bibliothekskomponenten sollten
 	   normalerweise ohne Suffix angegeben werden,
 	   Tool-Komponenten mit <literal>_build</literal> und
 	   Plugin-Komponenten mit <literal>_run</literal>.  Die
 	   gebr&auml;uchlichsten Komponenten werden im Folgenden
 	   angegeben (alle verf&uuml;gbaren Komponenten sind in
 	   <makevar>_QT_COMPONENTS_ALL</makevar> in
 	   <filename>/usr/ports/Mk/bsd.qt.mk</filename>
 	   aufgelistet):</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare Qt4-Bibliothekskomponenten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>corelib</literal></entry>
 		<entry>Kern-Bibliothek (kann weggelassen
 		  werden&ndash;&nbsp;es sei denn, der Port benutzt nichts
 		  au&szlig;er <literal>corelib</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>gui</literal></entry>
 		<entry>Graphische
 		  Benutzeroberfl&auml;chen-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>network</literal></entry>
 		<entry>Netzwerk-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>opengl</literal></entry>
 		<entry>OpenGL-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>qt3support</literal></entry>
 		<entry>Qt3-Kompatibilit&auml;ts-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>qtestlib</literal></entry>
 		<entry>Modultest-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>script</literal></entry>
 		<entry>Skript-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>sql</literal></entry>
 		<entry>SQL-Bibliothek</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>xml</literal></entry>
 		<entry>XML-Bibliothek</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Sie k&ouml;nnen herausfinden, welche Bibliotheken die
 	  Applikation ben&ouml;tigt, indem Sie nach erfolgreicher
 	  Kompilierung <command>ldd</command> auf die
 	  Hauptbin&auml;rdatei anwenden.</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare Qt4-Tool-Komponenten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>moc</literal></entry>
 		<entry>meta object compiler (wird zum Build fast
 		  jeder Qt-Applikation ben&ouml;tigt)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>qmake</literal></entry>
 		<entry>Makefile-Generator / Build-Werkzeug</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>rcc</literal></entry>
 		<entry>Resource-Compiler (wird ben&ouml;tigt, falls
 		  die Applikation <filename>*.rc</filename> oder
 		  <filename>*.qrc</filename> Dateien
 		  enth&auml;lt)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>uic</literal></entry>
 		<entry>User-Interface-Compiler (wird ben&ouml;tigt,
 		  falls die Applikation von Qt-Designer erzeugte
 		  <filename>*.ui</filename> Dateien enth&auml;lt -
 		  gilt f&uuml;r praktisch jede Qt-Applikation mit
 		  einer GUI)</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare Qt4-Plugin-Komponenten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>iconengines</literal></entry>
 		<entry>SVG-Icon-Engine Plugin (wenn die Applikation
 		  SVG-Icons mitliefert)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>imageformats</literal></entry>
 		<entry>Bildformatplugins f&uuml;r GIF, JPEG, MNG und
 		  SVG (wenn die Applikation Bilddateien
 		  mitliefert)</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example id="qt4-components-example">
 	  <title>Qt4-Komponenten ausw&auml;hlen</title>
 
 	  <para>In diesem Beispiel benutzt die portierte Applikation
 	    die Qt4 GUI-Bibliothek, die Qt4-Core-Bibliothek, alle
 	    Qt4-Codeerzeugungstools und Qt4's Makefile Generator. Da
 	    die GUI-Bibliothek eine Abh&auml;ngigkeit von der
 	    Core-Bibliothek impliziert, muss corelib nicht angegeben
 	    werden. Die Qt4-Codeerzeugungstools moc, uic und rcc,
 	    sowie der Makefile Generator qmake werden nur f&uuml;r den
 	    Build ben&ouml;tigt, deshalb bekommen die den Suffix
 	    <literal>_build</literal>:</para>
 
 	  <programlisting>USE_QT_VER=    4
 QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="qt-additional">
 	<title>Zus&auml;tzliche Besonderheiten</title>
 
 	<para>Wenn die Applikation keine
 	  <filename>configure</filename> Datei, sondern eine
 	  <filename>.pro</filename> Datei hat, k&ouml;nnen Sie das
 	  Folgende benutzen:</para>
 
 	<programlisting>HAS_CONFIGURE=    yes
 
 do-configure:
 	@cd ${WRKSRC} && ${SETENV} ${CONFIGURE_ENV} \
 	        ${QMAKE} -unix PREFIX=${PREFIX} texmaker.pro</programlisting>
 
 	<para>Beachten Sie die &Auml;hnlichkeit mit der
 	  <command>qmake</command>-Zeile im mitgelieferten
 	  <filename>BUILD.sh</filename>-Skript. Die
 	  &Uuml;bergabe von  <makevar>CONFIGURE_ENV</makevar>
 	  stellt sicher, dass <command>qmake</command> die
 	  <makevar>QMAKESPEC</makevar>-Variable &uuml;bergeben
 	  bekommt, ohne die es nicht funktioniert.
 	  <command>qmake</command> erzeugt Standard-Makefiles,
 	  sodass es nicht n&ouml;tig ist ein eigenes neues
 	  <maketarget>build</maketarget>-Target zu schreiben.</para>
 
 	<para>Qt-Applikationen sind oft so geschrieben, dass sie
 	  plattform&uuml;bergreifend sind, und oft ist X11/Unix
 	  nicht die Plattform, auf der sie entwickelt werden.
 	  Das sorgt oft f&uuml;r bestimmte fehlende
 	  Kleinigkeiten wie z.B.:</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><emphasis>Fehlende zus&auml;tzliche
 	      Include-Pfade.</emphasis>
 	      Viele Applikationen kommen mit System-Tray-Icon
 	      Support&ndash;&nbsp;unterlassen es aber Includes
 	      oder Bibliotheken in den X11 Verzeichnissen zu suchen.
 	      Sie k&ouml;nnen <command>qmake</command> &uuml;ber die
 	      Kommandozeile sagen, es soll Verzeichnisse zu den
 	      Include- und Bibliotheks-Suchpfaden
 	      hinzuf&uuml;gen - z.B.:</para>
 
 	    <programlisting>${QMAKE} -unix PREFIX=${PREFIX} INCLUDEPATH+=${X11BASE}/include \
     LIBS+=-L${X11BASE}/lib sillyapp.pro</programlisting>
 	  </listitem>
 
 	  <listitem>
 	    <para><emphasis>Falsche Installations-Pfade.</emphasis>
 	      Manchmal werden Daten wie Icons oder .desktop-Dateien
 	      per Vorgabe in Verzeichnisse installiert, die nicht von
 	      XDG-kompatiblen Applikationen durchsucht werden.
 	      <filename role="package">editors/texmaker</filename>
 	      ist hierf&uuml;r ein Beispiel&ndash;&nbsp;siehe
 	      <filename>patch-texmaker.pro</filename> im
 	      <filename>files</filename>-Verzeichnis dieses Ports
 	      als eine Vorlage, die zeigt, wie man dies direkt in der
 	      Qmake Projektdatei l&ouml;st.</para>
 	  </listitem>
 	</itemizedlist>
       </sect2>
     </sect1>
 
     <sect1 id="using-java">
       <title>Benutzung von Java</title>
 
       <sect2 id="java-variables">
 	<title>Variablen-Definitionen</title>
 
 	<para>Wenn Ihr Port ein Java&trade; Development Kit (JDK)
 	  ben&ouml;tigt, entweder zum Bauen, zur Laufzeit oder
 	  sogar, um das Distfile auszupacken, dann sollten Sie
 	  <makevar>USE_JAVA</makevar> setzen.</para>
 
 	<para>Es gibt mehrere JDKs in der
 	  Ports-Sammlung&ndash;&nbsp;von verschiedenen Anbietern
 	  und in verschiedenen Versionen.
 	  Wenn Ihr Port eine bestimmte dieser Versionen
 	  ben&ouml;tigt, k&ouml;nnen Sie definieren welche.
 	  Die aktuelle Version ist <filename
 	  role="package">java/jdk15</filename>.</para>
 
 	<table frame="none">
 	  <title>Variablen, die von Ports, die Java benutzen, gesetzt
 	  werden m&uuml;ssen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 		<entry>Bedeutung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_JAVA</makevar></entry>
 		<entry>Sollte definiert sein, damit die &uuml;brigen
 		  Variablen irgendeinen Effekt haben.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_VERSION</makevar></entry>
 		<entry>Durch Leerzeichen getrennte Liste von geeigneten
 		  Java-Versionen f&uuml;r den Port. Ein optionales
 		  <literal>"+"</literal> erm&ouml;glicht die Angabe eines
 		  Bereiches von Versionen (m&ouml;gliche Werte:
 		  <literal>1.1[+] 1.2[+] 1.3[+] 1.4[+]</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_OS</makevar></entry>
 		<entry>Durch Leerzeichen getrennte Liste von geeigneten
 		  JDK-Port-Betriebssystemen f&uuml;r den Port. (erlaubte
 		  Werte: <literal>native linux</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_VENDOR</makevar></entry>
 		<entry>Durch Leerzeichen getrennte Liste von geeigneten
 		  JDK-Port-Anbietern f&uuml;r den Port. (erlaubte Werte:
 		  <literal>freebsd bsdjava sun ibm
 		  blackdown</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_BUILD</makevar></entry>
 		<entry>Bedeutet, falls gesetzt, dass der ausgew&auml;hlte
 		  JDK-Port zu den Build-Abh&auml;ngigkeiten des Ports
 		  hinzugef&uuml;gt werden soll.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_RUN</makevar></entry>
 		<entry>Bedeutet, falls gesetzt, dass der ausgew&auml;hlte
 		  JDK-Port zu den Laufzeit-Abh&auml;ngigkeiten des Ports
 		  hinzugef&uuml;gt werden soll.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_EXTRACT</makevar></entry>
 		<entry>Bedeutet, falls gesetzt, dass der ausgew&auml;hlte
 		  JDK-Port zu den Extract-Abh&auml;ngigkeiten des Ports
 		  hinzugef&uuml;gt werden soll.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_JIKES</makevar></entry>
 		<entry>Legt fest, ob der Port den <command>jikes</command>
 		  Bytecode-Compiler zum Kompilieren benutzen soll. Wenn
 		  kein Wert f&uuml;r diese Variable gesetzt ist, wird der
 		  Port <command>jikes</command> f&uuml;r die Kompilierung
 		  benutzen&ndash;&nbsp;falls vorhanden. Sie k&ouml;nnen
 		  die Benutzung von <command>jikes</command> auch
 		  ausdr&uuml;cklich verbieten oder erzwingen (durch
 		  Setzen auf <literal>'no'</literal> oder
 		  <literal>'yes'</literal>). Im letzteren Fall wird
 		  <filename role="package">devel/jikes</filename> zu den
 		  Build-Abh&auml;ngigkeiten des Ports hinzugef&uuml;gt.
 		  In jedem Fall wird, wenn <command>jikes</command>
 		  tats&auml;chlich statt <command>javac</command> zur
 		  Kompilierung benutzt wird, die Variable
 		  <makevar>HAVE_JIKES</makevar> von
 		  <filename>bsd.java.mk</filename> definiert.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Das Folgende ist eine Liste aller Variablen, die ein
 	  Port bekommt, nachdem er <makevar>USE_JAVA</makevar>
 	  gesetzt hat:</para>
 
 	<table frame="none">
 	  <title>Bereitgestellte Variablen f&uuml;r Ports,
 	    die Java benutzen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 		<entry>Wert</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>JAVA_PORT</makevar></entry>
 		<entry>Der Name des JDK-Ports (z.B.
 		  <literal>'java/jdk14'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_VERSION</makevar></entry>
 		<entry>Die volle Version des JDK Ports (z.B.
 		  <literal>'1.4.2'</literal>). Wenn Sie nur die ersten
 		  beiden Stellen dieser Versionsnummer ben&ouml;tigen,
 		  benutzen Sie <makevar>
 		  ${JAVA_PORT_VERSION:C/^([0-9])\.([0-9])(.*)$/\1.\2/}</makevar>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_OS</makevar></entry>
 		<entry>Das vom JDK-Port benutzte Betriebssystem (z.B.
 		  <literal>'linux'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_VENDOR</makevar></entry>
 		<entry>Der Anbieter des JDK-Ports (z.B.
 		  <literal>'sun'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_OS_DESCRIPTION</makevar></entry>
 		<entry>Beschreibung des vom JDK-Port benutzten
 		  Betriebssystems (z.B.
 		  <literal>'Linux'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_PORT_VENDOR_DESCRIPTION</makevar></entry>
 		<entry>Beschreibung des Anbieters des JDK-Ports (z.B.
 		  <literal>'FreeBSD Foundation'</literal>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_HOME</makevar></entry>
 		<entry>Pfad zum Installationsverzeichnis des JDK (z.B.
 		  <filename>'/usr/local/jdk1.3.1'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVAC</makevar></entry>
 		<entry>Pfad zum Java-Compiler, der benutzt werden soll
 		  (z.B. <filename>
 		  '/usr/local/jdk1.1.8/bin/javac'</filename> oder
 		  <filename>'/usr/local/bin/jikes'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAR</makevar></entry>
 		<entry>Pfad zum <command>jar</command>-Werkzeug, das
 		  benutzt werden soll (z.B. <filename>
 		  '/usr/local/jdk1.2.2/bin/jar'</filename> oder
 		  <filename>'/usr/local/bin/fastjar'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>APPLETVIEWER</makevar></entry>
 		<entry>Pfad zum <command>appletviewer</command>-Werkzeug
 		(z.B. <filename>
 		'/usr/local/linux-jdk1.2.2/bin/appletviewer'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA</makevar></entry>
 		<entry>Pfad zur <command>java</command> Bin&auml;rdatei.
 		  Benutzen Sie dies, um Java-Programme auszuf&uuml;hren
 		  (z.B. <filename>
 		  '/usr/local/jdk1.3.1/bin/java'</filename>).</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVADOC</makevar></entry>
 		<entry>Pfad zum
 		  <command>javadoc</command>-Werkzeug.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVAH</makevar></entry>
 		<entry>Pfad zum <command>javah</command>-Programm.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVAP</makevar></entry>
 		<entry>Pfad zum <command>javap</command>-Programm.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_KEYTOOL</makevar></entry>
 		<entry>Pfad zum <command>keytool</command>-Werkzeug.
 		  Diese Variable ist nur verf&uuml;gbar, wenn das JDK Java
 		  1.2 oder h&ouml;her ist.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_N2A</makevar></entry>
 		<entry>Pfad zum
 		  <command>native2ascii</command>-Werkzeug.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_POLICYTOOL</makevar></entry>
 		<entry>Pfad zum <command>policytool</command> Programm.
 		  Diese Variable ist nur verf&uuml;gbar, wenn das JDK
 		  Java 1.2 oder h&ouml;her ist.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_SERIALVER</makevar></entry>
 		<entry>Pfad zum
 		  <command>serialver</command>-Werkzeug.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>RMIC</makevar></entry>
 		<entry>Pfad zum RMI Stub/Skeleton-Generator,
 		  <command>rmic</command>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>RMIREGISTRY</makevar></entry>
 		<entry>Pfad zum RMI Registry-Werkzeug,
 		  <command>rmiregistry</command>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>RMID</makevar></entry>
 		<entry>Pfad zum RMI Daemon <command>rmid</command>.
 		  Diese Variable ist nur verf&uuml;gbar, wenn das JDK
 		  Java 1.2 oder h&ouml;her unterst&uuml;tzt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVA_CLASSES</makevar></entry>
 		<entry>Pfad zum Archiv, das die JDK-Klassendateien
 		  enth&auml;lt. F&uuml;r das JDK 1.2 oder sp&auml;ter
 		  ist dies
 		  <filename>${JAVA_HOME}/jre/lib/rt.jar</filename>.
 		  Fr&uuml;here JDKs benutzten <filename>
 		  ${JAVA_HOME}/lib/classes.zip</filename>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>HAVE_JIKES</makevar></entry>
 		<entry>Ist dann gesetzt, wenn <command>jikes</command>
 		  vom Port benutzt wird (s. <makevar>USE_JIKES</makevar>
 		  oben).</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Sie k&ouml;nnen das <literal>java-debug</literal>
 	  make-Target benutzen, um Information zum Debuggen
 	  Ihres Ports zu erhalten. Es wird die Werte vieler
 	  der obenangegebenen Variablen anzeigen.</para>
 
 	<para>Zus&auml;tzlich sind die folgenden Konstanten
 	  definiert, damit alle Java-Ports auf eine konsistente
 	  Art installiert werden k&ouml;nnen:</para>
 
 	<table frame="none">
 	  <title>Konstanten, die f&uuml;r Ports, welche Java benutzen,
 	    definiert sind</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Konstante</entry>
 		<entry>Wert</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>JAVASHAREDIR</makevar></entry>
 		<entry>Das Basis-Verzeichnis f&uuml;r alles, was mit Java
 		  zusammenh&auml;ngt. Standardm&auml;&szlig;ig
 		  <filename>${PREFIX}/share/java</filename>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVAJARDIR</makevar></entry>
 		<entry>Das Verzeichnis, wohin JAR-Dateien installiert
 		  werden sollen. Standardm&auml;&szlig;ig
 		  <filename>${JAVASHAREDIR}/classes</filename>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>JAVALIBDIR</makevar></entry>
 		<entry>Das Verzeichnis, in dem JAR-Dateien, die von
 		  anderen Ports installiert wurden, liegen.
 		  Standardm&auml;&szlig;ig <filename>
 		  ${LOCALBASE}/share/java/classes</filename>.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Die entsprechenden Eintr&auml;ge sind sowohl in
 	  <makevar>PLIST_SUB</makevar> (dokumentiert in
 	  <xref linkend="plist-sub">) als auch in
 	  <makevar>SUB_LIST</makevar> definiert.</para>
       </sect2>
 
       <sect2 id="java-building-with-ant">
 	<title>Kompilieren mit Ant</title>
 
 	<para>Wenn der Port mit Apache Ant kompiliert werden soll,
 	  muss er <makevar>USE_ANT</makevar> setzen. Ant wird dann
 	  als das sub-make-Kommando betrachtet. Wenn kein
 	  <literal>do-build</literal>-Target vom Port definiert ist,
 	  wird eine Standardvorgabe benutzt, die einfach Ant
 	  entsprechend <makevar>MAKE_ENV</makevar>,
 	  <makevar>MAKE_ARGS</makevar> und
 	  <makevar>ALL_TARGETS</makevar> aufruft. Das &auml;hnelt dem
 	  <makevar>USE_GMAKE</makevar>-Mechanismus, der in <xref
 	  linkend="building"> dokumentiert ist.</para>
 
 	<para>Wenn <command>jikes</command> anstelle von
 	  <command>javac</command> benutzt wird (siehe
 	  <makevar>USE_JIKES</makevar> in <xref
 	  linkend="java-variables">), dann wird Ant es automatisch
 	  benutzen, um den Port zu kompilieren.</para>
       </sect2>
 
       <sect2 id="java-best-practices">
 	<title>Optimales Verfahren</title>
 
 	<para>Wenn Sie eine Java-Bibliothek portieren, sollte Ihr Port
 	  die JAR-Datei(en) in <filename>${JAVAJARDIR}</filename>
 	  installieren, und alles andere unter
 	  <filename>${JAVASHAREDIR}/${PORTNAME}</filename>
 	  (ausgenommen die Dokumentation - siehe unten). Um die
 	  Gr&ouml;&szlig;e der Packlistendatei zu reduzieren,
 	  k&ouml;nnen die JAR-Datei(en) direkt im
 	  <filename>Makefile</filename> angegeben werden. Benutzen
 	  Sie einfach die folgende Anweisung (wobei
 	  <filename>myport.jar</filename> der Name der JAR-Datei ist,
 	  die als Teil des Ports installiert wird):</para>
 
 	<programlisting>PLIST_FILES+= %%JAVAJARDIR%%/myport.jar</programlisting>
 
 	<para>Beim Portieren einer Java-Applikation installiert der
 	  Port normalerweise alles unter einem einzigen Verzeichnis
 	  (inklusive seiner JAR-Abh&auml;ngigkeiten). Die Benutzung
 	  von <filename>${JAVASHAREDIR}/${PORTNAME}</filename>
 	  wird in dieser Beziehung dringend empfohlen. Es liegt
 	  im Entscheidungsbereich des Portierenden, ob der Port
 	  die zus&auml;tzlichen JAR-Abh&auml;ngigkeiten unter
 	  diesem Verzeichnis installieren oder direkt die schon
 	  installierten (aus <filename>${JAVAJARDIR}</filename>)
 	  benutzen soll.</para>
 
 	<para>Unabh&auml;ngig von der Art Ihres Ports (Bibliothek
 	  oder Applikation), sollte die zus&auml;tzliche Dokumentation
 	  an die <link
 	  linkend="install-documentation">gleiche Stelle</link>
 	  installiert werden wie bei jedem anderen Port auch.
 	  Das JavaDoc-Werkzeug ist daf&uuml;r bekannt einen
 	  unterschiedlichen Satz von Dateien abh&auml;ngig von der
 	  Version des benutzten JDKs zu erstellen. F&uuml;r Ports,
 	  die nicht die Benutzung eines bestimmten JDKs vorgeben,
 	  ist es deshalb eine komplexe Aufgabe die Packliste
 	  (<filename>pkg-plist</filename>) festzulegen. Dies ist
 	  ein Grund, warum dringend angeraten wird, das
 	  <makevar>PORTDOCS</makevar>-Makro zu benutzen.
 	  Au&szlig;erdem, selbst wenn Sie den Satz von Dateien,
 	  den <command>javadoc</command> erzeugen wird,
 	  voraussagen k&ouml;nnen, die Gr&ouml;&szlig;e der
 	  resultierenden <filename>pkg-plist</filename>
 	  bef&uuml;rwortet die Benutzung von
 	  <makevar>PORTDOCS</makevar>.</para>
 
 	<para>Der Vorgabewert f&uuml;r <makevar>DATADIR</makevar> ist
 	  <filename>${PREFIX}/share/${PORTNAME}</filename>. Es ist
 	  eine gute Idee, <makevar>DATADIR</makevar> f&uuml;r
 	  Java-Ports stattdessen auf
 	  <filename>${JAVASHAREDIR}/${PORTNAME}</filename> zu setzen.
 	  In der Tat wird <makevar>DATADIR</makevar> automatisch zu
 	  <makevar>PLIST_SUB</makevar> (dokumentiert in <xref
 	  linkend="plist-sub">) hinzugef&uuml;gt, d.h. Sie k&ouml;nnen
 	  <literal>%%DATADIR%%</literal> direkt in
 	  <filename>pkg-plist</filename> benutzen.</para>
 
 	<para>Zu der Frage, ob Java-Ports aus dem Quelltext gebaut
 	  werden, oder direkt bereitgestellte bin&auml;re
 	  Distributionen benutzt werden sollten, gab es, als dies
 	  geschrieben wurde, keine definierte Richtlinie. Allerdings
 	  ermutigen Mitglieder des <ulink
 	  url="http://www.freebsd.org/java/">&os;
 	  Java-Projekts</ulink> Porter dazu, Ihre Ports aus dem
 	  Quelltext kompilieren zu lassen, wann immer dies kein
 	  Problem darstellt.</para>
 
 	<para>Alle Eigenschaften, die in diesem Abschnitt
 	  pr&auml;sentiert wurden sind in
 	  <filename>bsd.java.mk</filename> implementiert.
 	  Sollten Sie jemals der Meinung sein, dass Ihr Port
 	  ausgefeiltere Java-Unterst&uuml;tzung ben&ouml;tigt,
 	  schauen Sie bitte erst in das <ulink
 	  url="http://www.freebsd.org/cgi/cvsweb.cgi/ports/Mk/bsd.java.mk">
 	  bsd.java.mk CVS Log</ulink>, weil es normalerweise immer
 	  etwas Zeit braucht bis die neuesten Eigenschaften
 	  dokumentiert sind. Wenn Sie glauben, dass der fehlende
 	  Support auch f&uuml;r viele andere Java Ports n&uuml;tzlich
 	  sein k&ouml;nnte, wenden Sie sich bitte an die
 	  &a.java;.</para>
 
 	<para>Obwohl es eine <literal>java</literal>-Kategorie
 	  f&uuml;r Fehlerberichte gibt, bezieht sich diese auf die
 	  JDK-Portierungsbem&uuml;hungen des &os; Java-Projektes.
 	  Deshalb sollten Sie Ihren Java-Port in der
 	  <literal>ports</literal>-Kategorie einreichen wie bei
 	  jeden anderen Port auch - es sei denn, die Angelegenheit,
 	  die Sie zu kl&auml;ren versuchen, steht in Zusammenhang
 	  entweder mit einer JDK-Implementierung oder
 	  <filename>bsd.java.mk</filename>.</para>
 
 	<para>Gleicherma&szlig;en gibt es eine definierte Richtlinie
 	  f&uuml;r die <makevar>CATEGORIES</makevar> eines Java-Ports,
 	  die in <xref linkend="makefile-categories"> erkl&auml;rt
 	  wird.</para>
       </sect2>
     </sect1>
 
     <sect1 id="using-php">
       <title>Webanwendungen, Apache und PHP</title>
 
       <sect2 id="using-apache">
 	<title>Apache</title>
 
 	<table frame="none">
 	  <title>Variablen f&uuml;r Ports, die Apache
 	    verwenden</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_APACHE</makevar></entry>
 		<entry>Der Port ben&ouml;tigt Apache. M&ouml;gliche Werte:
 		  <literal>yes</literal> (beliebige Version),
 		  <literal>1.3</literal>, <literal>2.0</literal>,
 		  <literal>2.2</literal>, <literal>2.0+</literal>,
 		  etc.&nbsp;&ndash;&nbsp;Standard ist Version
 		  <literal>1.3</literal>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WITH_APACHE2</makevar></entry>
 		<entry>Der Port ben&ouml;tigt Apache 2.0. Ist diese
 		  Variable nicht gesetzt, so ben&ouml;tigt der Port
 		  Apache 1.3. Diese Variable ist veraltet und sollte
 		  nicht mehr verwendet werden.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>APXS</makevar></entry>
 		<entry>Vollst&auml;ndiger Pfad zu der
 		  <command>apxs</command> Bin&auml;rdatei. Die Variable
 		  kann neu gesetzt werden.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>HTTPD</makevar></entry>
 		<entry>Vollst&auml;ndiger Pfad zu der
 		  <command>httpd</command> Bin&auml;rdatei.
 		  Die Variable kann neu gesetzt werden.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>APACHE_VERSION</makevar></entry>
 		<entry>Beinhaltet die Versionsnummer des aktuell
 		  installierten Apache (nur lesbare Variable).
 		  Diese Variable ist nach Einbinden der Datei
 		  <filename>bsd.port.pre.mk</filename>
 		  verf&uuml;gbar. M&ouml;gliche Werte:
 		  <literal>13</literal>, <literal>20</literal>,
 		  <literal>22</literal>.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>APACHEMODDIR</makevar></entry>
 		<entry>Verzeichnis der Apache-Module. Diese Variable wird
 		  automatisch in pkg-plist ersetzt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>APACHEINCLUDEDIR</makevar></entry>
 		<entry>Verzeichnis der Apache Header-Dateien. Diese
 		  Variable wird automatisch in pkg-plist ersetzt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>APACHEETCDIR</makevar></entry>
 		<entry> Verzeichnis der Apache-Konfigurationsdateien.
 		  Diese Variable wird automatisch in pkg-plist
 		  ersetzt.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<table frame="none">
 	  <title>N&uuml;tzliche Variablen f&uuml;r Ports von
 	    Apache-Modulen</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><makevar>MODULENAME</makevar></entry>
 		<entry>Name des Moduls. Standardwert ist
 		  <makevar>PORTNAME</makevar>. Beispiel:
 		  <literal>mod_hello</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>SHORTMODNAME</makevar></entry>
 		<entry>Der gek&uuml;rzte Name des Moduls.
 		  Standardm&auml;&szlig;ig
 		  wird der Wert von <makevar>MODULENAME</makevar>
 		  &uuml;bernommen.
 		  Beispiel: <literal>hello</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>AP_FAST_BUILD</makevar></entry>
 		<entry>Verwende <command>apxs</command> zum Kompilieren
 		  und Installieren des Moduls.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>AP_GENPLIST</makevar></entry>
 		<entry>Eine <filename>pkg-plist</filename> wird
 		  automatisch erzeugt.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>AP_INC</makevar></entry>
 		<entry>Verzeichnis f&uuml;r zus&auml;tzliche
 		  Header-Dateien, die beim Kompilieren mitverwendet
 		  werden.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>AP_LIB</makevar></entry>
 		<entry>Verzeichnis f&uuml;r zus&auml;tzliche
 		  Bibliothek-Dateien, welche beim Kompilieren
 		  mitverwendet werden.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>AP_EXTRAS</makevar></entry>
 		<entry>Zus&auml;tzliche Flags f&uuml;r
 		  <command>apxs</command>.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 id="web-apps">
 	<title>Webanwendungen</title>
 
 	<para>Webanwendungen sollten nach <filename>
 	  <makevar>PREFIX</makevar>/www/<replaceable>programmname
 	  </replaceable></filename> installiert werden.
 	  Der Einfachheit halber ist dieser Pfad sowohl im
 	  <filename>Makefile</filename> als auch in
 	  <filename>pkg-plist</filename> als
 	  <makevar>WWWDIR</makevar> verf&uuml;gbar. Der relative
 	  Pfad <makevar>PREFIX</makevar> ist hingegen im
 	  <filename>Makefile</filename> durch die Variable
 	  <makevar>WWWDIR_REL</makevar> festgelegt.</para>
 
 	<para>Der Benutzername und die Benutzergruppe,
 	  mit deren Rechte Webanwendungen laufen, sind in
 	  <makevar>WWWOWN</makevar> und <makevar>WWWGRP</makevar>
 	  festgelegt. Standardwert ist bei beiden
 	  <literal>www</literal>. Falls ein Port mit anderen
 	  Rechten gestartet werden soll, so sollte die Anweisung
 	  <literal>WWWOWN?= myuser</literal> verwendet werden. Dies
 	  vereinfacht dem Benutzer eine Anpassung dieser Werte.</para>
 
 	<para>Falls die Webanwendung nicht explizit Apache
 	  ben&ouml;tigt, so sollte dieser auch nicht als
 	  Abh&auml;ngigkeit des Ports aufgef&uuml;hrt werden.
 	  Dadurch bleibt es dem Benutzer &uuml;berlassen
 	  Apache oder einen anderen Webserver zu verwenden.</para>
       </sect2>
 
       <sect2 id="php-variables">
 	<title>PHP</title>
 
 	<table frame="none">
 	  <title>Variablen f&uuml;r Ports, die PHP verwenden</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_PHP</makevar></entry>
 		<entry>Der Port ben&ouml;tigt PHP. Der Wert
 		  <literal>yes</literal> bewirkt eine Abh&auml;ngigkeit
 		  des Ports von PHP. Es kann auch eine Liste der
 		  ben&ouml;tigten PHP-Erweiterungen angegeben
 		  werden. Beispiel:
 		  <literal>pcre xml gettext</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>DEFAULT_PHP_VER</makevar></entry>
 		<entry>Legt die Version von PHP fest, die
 		  standardm&auml;&szlig;ig installiert wird, falls noch
 		  kein PHP vorhanden ist. Standardwert ist
 		  <literal>4</literal>. M&ouml;gliche Werte sind:
 		  <literal>4</literal>,<literal>5</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>IGNORE_WITH_PHP</makevar></entry>
 		<entry>Der Port funktioniert nicht mit der angegebenen
 		  Version von PHP. M&ouml;gliche Werte:
 		  <literal>4</literal>, <literal>5</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_PHPIZE</makevar></entry>
 		<entry>Der Port wird als PHP-Erweiterung gebaut.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_PHPEXT</makevar></entry>
 		<entry>Der Port wird wie eine PHP-Erweiterung
 		  behandelt&nbsp;&ndash;&nbsp;Installation und
 		  Eintragung in die PHP-Registry f&uuml;r
 		  Erweiterungen.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_PHP_BUILD</makevar></entry>
 		<entry>Setzt PHP als build-Anh&auml;ngigkeit.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WANT_PHP_CLI</makevar></entry>
 		<entry>Ben&ouml;tigt die Kommandozeilen-Version von
 		  PHP.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WANT_PHP_CGI</makevar></entry>
 		<entry>Ben&ouml;tigt die CGI-Version von PHP.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WANT_PHP_MOD</makevar></entry>
 		<entry>Ben&ouml;tigt das Apache-Modul von PHP.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WANT_PHP_SCR</makevar></entry>
 		<entry>Ben&ouml;tigt die Kommandozeilen- oder die
 		  CGI-Version von PHP.</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WANT_PHP_WEB</makevar></entry>
 		<entry>Ben&ouml;tigt das Apache-Modul oder die CGI-Version
 		   von PHP.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2>
 	<title>PEAR Module</title>
 
 	<para>Das Portieren von PEAR-Modulen ist sehr einfach.</para>
 
 	<para>Mit Hilfe der Variablen <makevar>FILES</makevar>,
 	  <makevar>TESTS</makevar>, <makevar>DATA</makevar>,
 	  <makevar>SQLS</makevar>, <makevar>SCRIPTFILES</makevar>,
 	  <makevar>DOCS</makevar> und <makevar>EXAMPLES</makevar>
 	  k&ouml;nnen die zu installierenden Dateien angegeben werden.
 	  Alle aufgef&uuml;hrten Dateien werden automatisch in die
 	  jeweiligen Verzeichnisse installiert und der Datei
 	  <filename>pkg-plist</filename> hinzugef&uuml;gt.</para>
 
 	<para>Die Datei <filename>
 	  &dollar;{PORTSDIR}/devel/pear/bsd.pear.mk</filename>
 	  muss am Ende des <filename>Makefile</filename>s
 	  eingebunden werden.</para>
 
 	<example id="pear-makefile">
 	  <title>Beispiel eines Makefiles f&uuml;r eine PEAR
 	    Klasse</title>
 
 	  <programlisting>PORTNAME=       Date
 PORTVERSION=    1.4.3
 CATEGORIES=     devel www pear
 
 MAINTAINER=     example@domain.com
 COMMENT=        PEAR Date and Time Zone Classes
 
 BUILD_DEPENDS=  ${PEARDIR}/PEAR.php:${PORTSDIR}/devel/pear-PEAR
 RUN_DEPENDS=    ${BUILD_DEPENDS}
 
 FILES=          Date.php Date/Calc.php Date/Human.php Date/Span.php     \
 	        Date/TimeZone.php
 TESTS=          test_calc.php test_date_methods_span.php testunit.php   \
 	        testunit_date.php testunit_date_span.php wknotest.txt   \
 	        bug674.php bug727_1.php bug727_2.php bug727_3.php       \
 	        bug727_4.php bug967.php weeksinmonth_4_monday.txt       \
 	        weeksinmonth_4_sunday.txt weeksinmonth_rdm_monday.txt   \
 	        weeksinmonth_rdm_sunday.txt
 DOCS=           TODO
 _DOCSDIR=       .
 
 .include &lt;bsd.port.pre.mk&gt;
 .include "&dollar;{PORTSDIR}/devel/pear/bsd.pear.mk"
 .include &lt;bsd.port.post.mk&gt;</programlisting>
 
 	</example>
       </sect2>
     </sect1>
 
     <sect1 id="using-python">
       <title>Python benutzen</title>
 
       <para>Die Ports unterst&uuml;tzen parallele Installationen
 	mehrerer Python-Versionen. Ports sollten sicherstellen,
 	dass der richtige <command>python</command>-Interpreter
 	verwendet wird&nbsp;&ndash;&nbsp;entsprechend der durch den
 	Benutzer definierbaren Variable
 	<makevar>PYTHON_VERSION</makevar>. H&auml;ufig bedeutet
 	dies, dass der Pfad zum <command>python</command>-Interpreter
 	durch den Wert der Variablen <makevar>PYTHON_CMD</makevar>
 	ersetzt werden muss.</para>
 
       <para>Ports, die Dateien unter
 	<makevar>PYTHON_SITELIBDIR</makevar> installieren, sollten
 	<literal>pyXY-</literal> als Pr&auml;fix des Paketnamens
 	haben, sodass in deren Paketname die zugeh&ouml;rige
 	Python Version aufgef&uuml;hrt wird.</para>
 
       <programlisting>PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX}</programlisting>
 
       <table frame="none">
 	<title>N&uuml;tzliche Variablen f&uuml;r Ports,
 	  die Python verwenden</title>
 
 	<tgroup cols="2">
 	  <tbody>
 	    <row>
 	      <entry><makevar>USE_PYTHON</makevar></entry>
 	      <entry>Der Port ben&ouml;tigt Python. Die minimal
 		ben&ouml;tigte Version kann durch Werte wie
 		<literal>2.3+</literal> angegeben werden.
 		Bereiche von Versionsnummern k&ouml;nnen durch Angabe der
 		minimalen und maximalen Versionsnummer, getrennt durch
 		einen Gedankenstrich, festgelegt werden, z.B.:
 		<literal>2.1-2.3</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>USE_PYDISTUTILS</makevar></entry>
 	      <entry>Verwende Python-distutils zum Konfigurieren,
 		Kompilieren und Installieren. Dies ist erforderlich,
 		falls der Port eine <filename>setup.py</filename>-Datei
 		beinhaltet. Dadurch werden die
 		<maketarget>do-build</maketarget> und
 		<maketarget>do-install</maketarget>-Ziele und eventuell
 		auch das <maketarget>do-configure</maketarget>-Ziel
 		&uuml;bergangen, falls <makevar>GNU_CONFIGURE</makevar>
 		nicht definiert ist.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYTHON_PKGNAMEPREFIX</makevar></entry>
 	      <entry>Wird als <makevar>PKGNAMEPREFIX</makevar> verwendet,
 		um Pakete f&uuml;r unterschiedliche Python-Versionen zu
 		trennen. Beispiel: <literal>py24-</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYTHON_SITELIBDIR</makevar></entry>
 	      <entry>Verzeichnis des site-Pakete Baums, der das
 		Installationsverzeichnis von Python (&uuml;blicherweise
 		<makevar>LOCALBASE</makevar>) beinhaltet. Die
 		<makevar>PYTHON_SITELIBDIR</makevar>-Variable kann
 		sehr n&uuml;tzlich bei der Installation von
 		Python-Modulen sein.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYTHONPREFIX_SITELIBDIR</makevar></entry>
 	      <entry>Die pr&auml;fix-freie Variante von
 		<makevar>PYTHON_SITELIBDIR</makevar>. Benutzen Sie immer
 		<literal>%%PYTHON_SITELIBDIR%%</literal> in
 		<filename>pkg-plist</filename>, wenn m&ouml;glich. Der
 		Standardwert von <literal>%%PYTHON_SITELIBDIR%%</literal>
 		ist <literal>
 		lib/python%%PYTHON_VERSION%%/site-packages
 	    </literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYTHON_CMD</makevar></entry>
 	      <entry>Kommandozeilen-Interpreter f&uuml;r Python mit
 		Versionsnummer.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYNUMERIC</makevar></entry>
 	      <entry>Liste der Abh&auml;ngigkeiten f&uuml;r numerische
 		Erweiterungen.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYNUMPY</makevar></entry>
 	      <entry>Liste der Abh&auml;ngigkeiten f&uuml;r die neue
 		numerische Erweiterung numpy.
 		(<makevar>PYNUMERIC</makevar> ist vom Anbieter als
 		veraltet deklariert)</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PYXML</makevar></entry>
 	      <entry>Liste der Abh&auml;ngigkeiten f&uuml;r
 		XML-Erweiterungen (wird ab Python 2.0 nicht mehr
 		ben&ouml;tigt, da im Basispaket enthalten).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>USE_TWISTED</makevar></entry>
 	      <entry>Setzt die Abh&auml;ngigkeit des Ports von
 		twistedCore. Die Liste der erforderlichen Komponenten
 		kann als Wert spezifiziert werden. Beispiel:
 		<literal>web lore pair flow</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>USE_ZOPE</makevar></entry>
 	      <entry>Setzt Zope, eine Plattform f&uuml;r Webanwendungen,
 		als Abh&auml;ngigkeit des Ports. Setzt die
 		Versionsabh&auml;ngigkeit von Python auf 2.3. Setzt
 		<makevar>ZOPEBASEDIR</makevar> auf das Verzeichnis,
 		in welches Zope installiert wurde.</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>Eine vollst&auml;ndige Liste aller verf&uuml;gbaren
 	Variablen ist in <filename>/usr/ports/Mk/bsd.python.mk
 	</filename> zu finden.</para>
     </sect1>
 
     <sect1 id="using-emacs">
       <title>Emacs benutzen</title>
 
       <para>Dieser Abschnitt muss noch geschrieben werden.</para>
     </sect1>
 
     <sect1 id="using-ruby">
       <title>Ruby benutzen</title>
 
       <table frame="none">
 	<title>N&uuml;tzliche Variablen f&uuml;r Ports,
 	  die Ruby verwenden</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Variable</entry>
 	      <entry>Description</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><makevar>USE_RUBY</makevar></entry>
 	      <entry>Der Port ben&ouml;tigt Ruby.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>USE_RUBY_EXTCONF</makevar></entry>
 	      <entry>Der Port verwendet <filename>extconf.rb</filename>
 		f&uuml;r die Konfiguration.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>USE_RUBY_SETUP</makevar></entry>
 	      <entry>Der Port verwendet <filename>setup.rb</filename>
 		f&uuml;r die Konfiguration.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>RUBY_SETUP</makevar></entry>
 	      <entry>Legt den alternativen Namen von
 		<filename>setup.rb</filename> fest. &Uuml;blich ist der
 		Wert <filename>install.rb</filename>.</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>Die folgende Tabelle listet ausgew&auml;hlte Variablen
 	auf, die Portautoren &uuml;ber die Port-Infrastruktur zur
 	Verf&uuml;gung stehen. Diese Variablen sollten f&uuml;r die
 	Installation von Dateien in die entsprechenden Verzeichnisse
 	verwendet werden. Sie sollten in
 	<filename>pkg-plist</filename> so h&auml;ufig wie m&ouml;glich
 	verwendet und in einem Port nicht neu definiert werden.</para>
 
       <table frame="none">
 	<title>Ausgew&auml;hlte read-only-Variablen f&uuml;r Ports,
 	  die Ruby verwenden</title>
 
 	<tgroup cols="3">
 	  <thead>
 	    <row>
 	      <entry>Variable</entry>
 	      <entry>Beschreibung</entry>
 	      <entry>Beispiel</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><makevar>RUBY_PKGNAMEPREFIX</makevar></entry>
 	      <entry>Wird als <makevar>PKGNAMEPREFIX</makevar> verwendet,
 	        um Pakete f&uuml;r verschiedene Versionen von Ruby zu
 	        unterscheiden.</entry>
 	      <entry><literal>ruby18-</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>RUBY_VERSION</makevar></entry>
 	      <entry>Vollst&auml;ndige Version von Ruby in der Form
 	        <literal>x.y.z</literal>.</entry>
 	      <entry><literal>1.8.2</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>RUBY_SITELIBDIR</makevar></entry>
 	      <entry>Installationsverzeichnis der von der
 	        Rechnerarchitektur unabh&auml;ngigen
 	        Bibliotheken.</entry>
 	      <entry><literal>/usr/local/lib/ruby/site_ruby/1.8</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>RUBY_SITEARCHLIBDIR</makevar></entry>
 	      <entry>Installationsverzeichnis der von der Rechnerarchitektur
 	        abh&auml;ngigen Bibliotheken.</entry>
 	      <entry><literal>/usr/local/lib/ruby/site_ruby/1.8/amd64-freebsd6</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>RUBY_MODDOCDIR</makevar></entry>
 	      <entry>Installationsverzeichnis f&uuml;r die Dokumentation
 	        der Module.</entry>
 	      <entry><literal>/usr/local/share/doc/ruby18/patsy</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>RUBY_MODEXAMPLESDIR</makevar></entry>
 	      <entry>Installationsverzeichnis f&uuml;r die Beispiele der
 	        Module.</entry>
 	      <entry><literal>/usr/local/share/examples/ruby18/patsy</literal></entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>Eine vollst&auml;ndige Liste der verf&uuml;gbarenVariablen
 	kann in <filename>/usr/ports/Mk/bsd.ruby.mk</filename>
 	eingesehen werden.</para>
     </sect1>
 
     <sect1 id="using-sdl">
       <title>SDL verwenden</title>
 
       <para>Die Variable <makevar>USE_SDL</makevar> wird f&uuml;r die
 	automatische Konfiguration der Abh&auml;ngigkeiten f&uuml;r Ports
 	benutzt, die auf SDL basierende Bibliotheken wie
 	<filename role="package">devel/sdl12</filename> und
 	<filename role="package">x11-toolkits/sdl_gui</filename>
 	verwenden.</para>
 
       <para>Die folgenden SDL-Bibliotheken sind derzeit
 	bekannt:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>sdl: <filename
 	    role="package">devel/sdl12</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>gfx: <filename
 	    role="package">graphics/sdl_gfx</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>gui: <filename
 	    role="package">x11-toolkits/sdl_gui</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>image: <filename
 	    role="package">graphics/sdl_image</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>ldbad: <filename
 	    role="package">devel/sdl_ldbad</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>mixer: <filename
 	    role="package">audio/sdl_mixer</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>mm: <filename
 	    role="package">devel/sdlmm</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>net: <filename
 	    role="package">net/sdl_net</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>sound: <filename
 	    role="package">audio/sdl_sound</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>ttf: <filename
 	    role="package">graphics/sdl_ttf</filename></para>
 	</listitem>
       </itemizedlist>
 
       <para>Falls ein Port z.B. von
 	<filename role="package">net/sdl_net</filename> und
 	<filename role="package">audio/sdl_mixer</filename>
 	abh&auml;ngt, so w&auml;re die Syntax:</para>
 
       <programlisting>USE_SDL=        net mixer</programlisting>
 
       <para>Die Abh&auml;ngigkeit von
 	<filename role="package">devel/sdl12</filename>, die durch
 	<filename role="package">net/sdl_net</filename> und
 	<filename role="package">audio/sdl_mixer</filename> entsteht,
 	wird automatisch zum Port hinzugef&uuml;gt.</para>
 
       <para>Falls <makevar>USE_SDL</makevar> im Port verwendet wird,
 	so wird automatisch:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>die Abh&auml;ngigkeit von
 	    <application>sdl12-config</application> zu
 	    <makevar>BUILD_DEPENDS</makevar> hinzugef&uuml;gt</para>
 	</listitem>
 
 	<listitem>
 	  <para>die Variable <makevar>SDL_CONFIG</makevar> zu
 	    <makevar>CONFIGURE_ENV</makevar> hinzugef&uuml;gt</para>
 	</listitem>
 
 	<listitem>
 	  <para>die Abh&auml;ngigkeit der ausgew&auml;hlten
 	    Bibliotheken zu <makevar>LIB_DEPENDS</makevar>
 	    hinzugef&uuml;gt</para>
 	</listitem>
       </itemizedlist>
 
       <para>Um zu &uuml;berpr&uuml;fen, ob die SDL-Bibliotheken
 	verf&uuml;gbar sind, kann die Variable
 	<makevar>WANT_SDL</makevar> verwendet werden:</para>
 
       <programlisting>WANT_SDL=yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if ${HAVE_SDL:Mmixer}!=""
 USE_SDL+=   mixer
 .endif
 
 .include &lt;bsd.port.post.mk&gt;</programlisting>
 
     </sect1>
 
     <sect1 id="using-wx">
       <title><application>wxWidgets</application> verwenden</title>
 
       <para>Dieser Abschnitt beschreibt den Status der
 	<application>wxWidgets</application>-Bibliotheken in den Ports
 	und deren Einbindung in das Ports-System.</para>
 
       <sect2 id="wx-introduction">
 	<title>Einf&uuml;hrung</title>
 
 	<para>Es gibt viele Probleme bei der gleichzeitigen Verwendung
 	  unterschiedlicher Versionen von
 	  <application>wxWidgets</application>-Bibliotheken (Dateien
 	  unterschiedlicher
 	  <application>wxWidgets</application>-Versionen haben
 	  denselben Dateinamen). In den Ports wurde das Problem
 	  dadurch gel&ouml;st, dass jede Version unter einem eigenen
 	  Namen installiert wird, der die Versionsnummer als Suffix
 	  beinhaltet.</para>
 
 	<para>Der offensichtliche Nachteil dabei ist, dass jede
 	  Anwendung so ver&auml;ndert werden muss, dass sie die
 	  erwartete Version vorfindet.  Die meisten solcher
 	  Anwendungen benutzen das
 	  <command>wx-config</command>-Skript, um die ben&ouml;tigten
 	  Compiler- und Linkerflags zu erhalten. Dieses Skript hat
 	  f&uuml;r jede verf&uuml;gbare Version einen anderen Namen.
 	  Die meisten Anwendungen beachten eine Umgebungsvariable oder
 	  ein Argument beim <command>configure</command>-Skript, um
 	  das gew&uuml;nschte <command>wx-config</command>-Skript
 	  festzulegen. Ansonsten m&uuml;ssen sie gepatcht
 	  werden.</para>
       </sect2>
 
       <sect2 id="wx-version">
 	<title>Auswahl der Version</title>
 
 	<para>Um festzulegen, welche Version der
 	  <application>wxWidgets</application> verwendet werden soll,
 	  gibt es zwei Variablen (falls nur eine der beiden definiert
 	  wird, so wird die andere auf einen Standardwert
 	  gesetzt):</para>
 
 	<table id="wx-ver-sel-table" frame="none">
 	  <title>Variablen, um die
 	    <application>wxWidgets</application>-Version festzulegen</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 		<entry>Beschreibung</entry>
 		<entry>Standardwert</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_WX</makevar></entry>
 		<entry>Liste der Versionen, die der Port verwenden
 		  kann</entry>
 		<entry>Alle verf&uuml;gbaren Versionen</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_WX_NOT</makevar></entry>
 		<entry>Liste der Versionen, die der Port nicht verwenden
 		  kann</entry>
 		<entry>Nichts</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Es folgt eine Liste an m&ouml;glichen
 	  <application>wxWidgets</application>-Versionen und deren
 	  zugeh&ouml;riger Port:</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare
 	    <application>wxWidgets</application>-Versionen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Version</entry>
 		<entry>Port</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>2.4</literal></entry>
 		<entry><filename
 		  role="package">x11-toolkits/wxgtk24</filename></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>2.6</literal></entry>
 		<entry><filename
 		  role="package">x11-toolkits/wxgtk26</filename></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>2.8</literal></entry>
 		<entry><filename
 		  role="package">x11-toolkits/wxgtk28</filename></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
         <note>
 	  <para>Ab Version <literal>2.5</literal> werden auch Versionen in
 	    Unicode unterst&uuml;tzt und &uuml;ber einen Unterport
 	    mit dem Suffix <literal>-unicode</literal> installiert.
 	    Dies kann aber auch &uuml;ber Variablen gehandhabt
 	    werden (siehe <xref linkend="wx-unicode">).</para>
 	</note>
 
 	<para>Die Variablen in <xref linkend="wx-ver-sel-table">
 	  k&ouml;nnen auf einen oder mehrere (durch Leerzeichen
 	  getrennt) der folgenden Werte gesetzt werden:</para>
 
 	<table frame="none">
 	  <title>Spezifikationen der
 	    <application>wxWidgets</application>-Versionen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Beschreibung</entry>
 		<entry>Beispiel</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>Einzelne Version</entry>
 		<entry><literal>2.4</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>Aufsteigende Versionsnummern</entry>
 		<entry><literal>2.4+</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>Absteigende Versionsnummern</entry>
 		<entry><literal>2.6-</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>Versionsinterval (muss aufsteigend sein)</entry>
 		<entry><literal>2.4-2.6</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Desweiteren gibt es Variablen, &uuml;ber die eine
 	  bevorzugte Version festgelegt werden kann. Die Versionen
 	  k&ouml;nnen als Liste angegeben werden, wobei die
 	  Reihenfolge der Priorisierung entspricht.</para>
 
 	<table frame="none">
 	  <title>Variablen zur Festlegung der bevorzugten
 	    <application>wxWidgets</application>-Version</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Bestimmt f&uuml;r</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>WANT_WX_VER</makevar></entry>
 		<entry>den Port</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WITH_WX_VER</makevar></entry>
 		<entry>den Benutzer</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 id="wx-components">
 	<title>Komponentenauswahl</title>
 
 	<para>Desweiteren gibt es Anwendungen, die nicht direkt
 	  <application>wxWidgets</application>-Bibliotheken sind, aber
 	  trotzdem mit diesen zusammenh&auml;ngen. Diese Anwendungen
 	  k&ouml;nnen &uuml;ber die Variable
 	  <makevar>WX_COMPS</makevar> festgelegt werden. Die folgenden
 	  Komponenten sind verf&uuml;gbar:</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare
 	    <application>wxWidgets</application>-Komponenten</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 		<entry>Versionsbeschr&auml;nkungen</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>wx</literal></entry>
 		<entry>Hauptbibliothek</entry>
 		<entry><literal>Nichts</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>contrib</literal></entry>
 		<entry>Beigesteuerte Bibliothek</entry>
 		<entry><literal>Nichts</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>python</literal></entry>
 		<entry><application>wxPython</application>
 		  (<application>Python</application>-Bindungen)</entry>
 		<entry><literal>2.4-2.6</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>mozilla</literal></entry>
 		<entry><application>wxMozilla</application></entry>
 		<entry><literal>2.4</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>svg</literal></entry>
 		<entry><application>wxSVG</application></entry>
 		<entry><literal>2.6</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Der Typ der Abh&auml;ngigkeit kann f&uuml;r jede
 	  Komponente durch hinzuf&uuml;gen eines Suffix (durch
 	  Strichpunkt getrennt) festgelegt werden. Falls der Typ nicht
 	  angegeben wird, wird ein Standardwert verwendet (siehe <xref
 	  linkend="wx-def-dep-types">).  Die folgenden Typen sind
 	  verf&uuml;gbar:</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare Typen von
 	    <application>wxWidgets</application>-Abh&auml;ngigkeiten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>build</literal></entry>
 		<entry>Komponente wird zum Bau
 		  ben&ouml;tigt&nbsp;&ndash;&nbsp;&auml;quivalent zu
 		  <makevar>BUILD_DEPENDS</makevar></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>run</literal></entry>
 		<entry>Komponente wird zum Ausf&uuml;hren
 		  ben&ouml;tigt&nbsp;&ndash;&nbsp;&auml;quivalent zu
 		  <makevar>RUN_DEPENDS</makevar></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>lib</literal></entry>
 		<entry>Komponente wird zum Bau und Ausf&uuml;hren
 		  ben&ouml;tigt&nbsp;&ndash;&nbsp;&auml;quivalent zu
 		  <makevar>LIB_DEPENDS</makevar>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Die Standardwerte f&uuml;r die einzelnen Komponenten
 	  sind in der folgenden Tabelle aufgef&uuml;hrt:</para>
 
 	<table id="wx-def-dep-types" frame="none">
 	  <title>Standardtypen der
 	    <application>wxWidgets</application>-Abh&auml;ngigkeiten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Komponente</entry>
 		<entry>Typ der Abh&auml;ngigkeit</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>wx</literal></entry>
 		<entry><literal>lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>contrib</literal></entry>
 		<entry><literal>lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>python</literal></entry>
 		<entry><literal>run</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>mozilla</literal></entry>
 		<entry><literal>lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>svg</literal></entry>
 		<entry><literal>lib</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example id="wx-components-example">
 	  <title>Auswahl von
 	    <application>wxWidgets</application>-Komponenten</title>
 
 	  <para>Der folgende Ausschnitt entspricht einem Port, der
 	    die <application>wxWidgets</application>-Version
 	    <literal>2.4</literal> und die zugeh&ouml;rigen
 	    Bibliotheken verwendet.</para>
 
 	  <programlisting>USE_WX=       2.4
 WX_COMPS=     wx contrib</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="wx-unicode">
 	<title>Unicode</title>
 
 	<para>Die <application>wxWidgets</application>-Bibliotheken
 	  unterst&uuml;tzen Unicode seit der Version
 	  <literal>2.5</literal>. In den Ports sind beide Versionen
 	  verf&uuml;gbar und k&ouml;nnen &uuml;ber die folgenden
 	  Variablen ausgew&auml;hlt werden:</para>
 
 	<table id="wx-unicode-var-table" frame="none">
 	  <title>Variablen, um Unicode in den
 	    <application>wxWidgets</application>-Versionen
 	    auszuw&auml;hlen</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 		<entry>Beschreibung</entry>
 		<entry>Bestimmt f&uuml;r</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>WX_UNICODE</makevar></entry>
 		<entry>Der Port funktioniert
 		  <emphasis>ausschlie&szlig;lich</emphasis> mit der
 		  Unicode-Version</entry>
 		<entry>den Port</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WANT_UNICODE</makevar></entry>
 		<entry>Der Port funktioniert in beiden
 		  Versionen&nbsp;&ndash;&nbsp;bevorzugt wird jedoch
 		  Unicode</entry>
 		<entry>den Port</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WITH_UNICODE</makevar></entry>
 		<entry>Der Port verwendet die Unicode-Version</entry>
 		<entry>den Benutzer</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WITHOUT_UNICODE</makevar></entry>
 		<entry>Der Port verwendet, falls unterst&uuml;tzt, die
 		  normale Version (falls <makevar>WX_UNICODE</makevar>
 		  nicht definiert ist)</entry>
 		<entry>den Benutzer</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<warning>
 	  <para>Die Variable <makevar>WX_UNICODE</makevar> darf
 	    nicht bei Ports benutzt werden, die sowohl die Version mit
 	    als auch ohne Unterst&uuml;tzung f&uuml;r Unicode
 	    verwenden k&ouml;nnen. Falls der Port
 	    standardm&auml;&szlig;ig Unterst&uuml;tzung f&uuml;r
 	    Unicode bieten soll, verwenden Sie
 	    <makevar>WANT_UNICODE</makevar> stattdessen.</para>
 	</warning>
       </sect2>
 
       <sect2 id="wx-version-detection">
 	<title>Feststellen der installierten Version</title>
 
 	<para>Um eine bereits installierte Version zu finden, muss
 	  <makevar>WANT_WX</makevar> definiert werden. Falls diese
 	  Variable nicht auf eine bestimmte Versionsnummer gesetzt
 	  wird, werden die Komponenten einen Suffix mit der
 	  Versionsnummer tragen. Die Variable
 	  <makevar>HAVE_WX</makevar> wird gesetzt, falls eine
 	  installierte Version vorgefunden wurde.</para>
 
 	<example id="wx-ver-det-example">
 	  <title>Installierte
 	    <application>wxWidgets</application>-Versionen
 	    und&nbsp;&ndash;Komponenten feststellen</title>
 
 	  <para>Der folgende Ausschnitt kann in einem Port verwendet
 	    werden, der <application>wxWidgets</application>
 	    verwendet, falls es installiert ist, oder falls eine
 	    Option daf&uuml;r ausgew&auml;hlt wurde.</para>
 
 	  <programlisting>WANT_WX=        yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_WX) || ${HAVE_WX:Mwx-2.4} != ""
 USE_WX=         2.4
 CONFIGURE_ARGS+=--enable-wx
 .endif</programlisting>
 
 	  <para>Der folgende Ausschnitt kann verwendet werden, um
 	    die Unterst&uuml;tzung f&uuml;r
 	    <application>wxPython</application> zus&auml;tzlich zu der
 	    von <application>wxWidgets</application> zu aktivieren
 	    (beide in Version <literal>2.6</literal>), wenn das
 	    installiert ist, oder die Option ausgew&auml;hlt
 	    wurde.</para>
 
 	  <programlisting>USE_WX=         2.6
 WX_COMPS=       wx
 WANT_WX=        2.6
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_WXPYTHON) || ${HAVE_WX:Mpython} != ""
 WX_COMPS+=      python
 CONFIGURE_ARGS+=--enable-wxpython
 .endif</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="wx-defined-variables">
 	<title>Vordefinierte Variablen</title>
 
 	<para>Die folgenden Variablen sind in den Ports
 	  verf&uuml;gbar (nachdem sie entsprechend <xref
 	  linkend="wx-ver-sel-table"> definiert wurden).</para>
 
 	<table frame="none">
 	  <title>Vordefinierte Variablen f&uuml;r Ports, die
 	    <application>wxWidgets</application> verwenden</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>WX_CONFIG</makevar></entry>
 		<entry>Pfad zum <application>wxWidgets</application>
 		  <command>wx-config</command>-Skript (mit
 		  unterschiedlichem Namen)</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WXRC_CMD</makevar></entry>
 		<entry>Pfad zum <application>wxWidgets</application>
 		  <command>wxrc</command>-Programm (mit
 		  unterschiedlichem Namen)</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WX_VERSION</makevar></entry>
 		<entry>Version der <application>wxWidgets</application>, die
 		  verwendet werden soll (z.B. <literal>2.6</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WX_UNICODE</makevar></entry>
 		<entry>Falls Unterst&uuml;tzung f&uuml;r Unicode nicht
 		  explizit definiert, jedoch verwendet wird, dann wird die
 		  Unterst&uuml;tzung automatisch aktiviert.</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 id="wx-premk">
 	<title>Verarbeitung in
 	  <filename>bsd.port.pre.mk</filename></title>
 
 	<para>Falls die Variablen gleich nach dem Importieren von
 	  <filename>bsd.port.pre.mk</filename> benutzt werden sollen,
 	  so muss die Variable <makevar>WX_PREMK</makevar> definiert
 	  werden.</para>
 
 	<important>
 	  <para>Falls <makevar>WX_PREMK</makevar> definiert ist, so
 	    werden Version, Abh&auml;ngigkeiten, Komponenten und
 	    vordefinierte Variablen nicht ge&auml;ndert, wenn die
 	    Variablen des <application>wxWidgets</application>-Ports
 	    <emphasis>nach</emphasis> dem Einbinden von
 	    <filename>bsd.port.pre.mk</filename> ge&auml;ndert
 	    werden.</para>
 	</important>
 
 	<example id="wx-premk-example">
 	  <title>Verwendung von
 	    <application>wxWidgets</application>-Variablen
 	    in Kommandos</title>
 
 	  <para>Der folgende Ausschnitt zeigt die Verwendung von
 	    <makevar>WX_PREMK</makevar> durch Ausf&uuml;hren des
 	    <command>wx-config</command>-Skriptes, um die
 	    vollst&auml;ndige Version als Zeichenkette zu erhalten,
 	    diese dann einer Variablen zuzuweisen und die Variable
 	    anschlie&szlig;end einem Programm zu
 	    &uuml;bergeben.</para>
 
 	  <programlisting>USE_WX=         2.4
 WX_PREMK=       yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if exists(${WX_CONFIG})
 VER_STR!=       ${WX_CONFIG} --release
 
 PLIST_SUB+=     VERSION="${VER_STR}"
 .endif</programlisting>
 	</example>
 
 	<note>
 	  <para>Die <application>wxWidgets</application>-Variablen
 	    k&ouml;nnen problemlos in Kommandos benutzt werden, falls
 	    diese in Targets ohne gesetztes
 	    <makevar>WX_PREMK</makevar> verwendet werden.</para>
 	</note>
       </sect2>
 
       <sect2 id="wx-additional-config-args">
 	<title>Weitere <command>configure</command>-Argumente</title>
 
 	<para>Einige GNU <command>configure</command>-Skripte
 	  k&ouml;nnen <application>wxWidgets</application> nicht
 	  auffinden, falls nur die Umgebungsvariable
 	  <literal>WX_CONFIG</literal> gesetzt ist, sondern
 	  ben&ouml;tigen zus&auml;tzliche Argumente. Daf&uuml;r kann
 	  die Variable <makevar>WX_CONF_ARGS</makevar> benutzt
 	  werden.</para>
 
 	<table frame="none">
 	  <title>Zul&auml;ssige Werte f&uuml;r
 	    <makevar>WX_CONF_ARGS</makevar></title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>M&ouml;glicher Wert</entry>
 		<entry>Resultierendes Argument</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>absolute</literal></entry>
 		<entry><literal>--with-wx-config=${WX_CONFIG}</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>relative</literal></entry>
 		<entry><literal>--with-wx=${X11BASE}
 		  --with-wx-config=${WX_CONFIG:T}</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
     </sect1>
 
     <sect1 id="using-lua">
       <title>Verwendung von <application>Lua</application></title>
 
       <para>Dieser Abschnitt beschreibt den Status der
 	<application>Lua</application>-Bibliotheken in den Ports
 	und deren Einbindung in das Ports System.</para>
 
       <sect2 id="lua-introduction">
 	<title>Einf&uuml;hrung</title>
 
 	<para>Es gibt viele Probleme bei der gleichzeitigen
 	  Verwendung unterschiedlicher Versionen von
 	  <application>Lua</application>-Bibliotheken (Dateien
 	  unterschiedlicher Versionen haben denselben Dateinamen). In
 	  den Ports wurde das Problem gel&ouml;st, indem jede Version
 	  unter einem eigenen Namen mit der Versionsnummer als Suffix
 	  installiert wird.</para>
 
 	<para>Der offensichtliche Nachteil dabei ist, dass jede
 	  Anwendung so ver&auml;ndert werden muss, dass sie die
 	  erwartete Version vorfindet. Dies kann jedoch durch
 	  zus&auml;tzliche Flags f&uuml;r Compiler und Linker
 	  gel&ouml;st werden.</para>
       </sect2>
 
       <sect2 id="lua-version">
 	<title>Auswahl der Version</title>
 
 	<para>Um festzulegen, welche Version von
 	  <application>Lua</application> verwendet werden soll, gibt
 	  es zwei Variablen (falls nur eine der beiden definiert ist,
 	  so wird die andere auf einen Standardwert gesetzt):</para>
 
 	<table id="lua-ver-sel-table" frame="none">
 	  <title>Variablen, um die
 	    <application>Lua</application>-Version festzulegen</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 		<entry>Beschreibung</entry>
 		<entry>Standardwert</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>USE_LUA</makevar></entry>
 		<entry>Liste der Versionen, welche der Port verwenden
 		  kann</entry>
 		<entry>Alle verf&uuml;gbaren Versionen</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>USE_LUA_NOT</makevar></entry>
 		<entry>Liste der Versionen, die der Port nicht verwenden
 		  kann</entry>
 		<entry>Nichts</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Es folgt eine Liste an m&ouml;glichen
 	  <application>Lua</application>-Versionen und deren
 	  zugeh&ouml;riger Port:</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare
 	    <application>Lua</application>-Versionen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Version</entry>
 		<entry>Port</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>4.0</literal></entry>
 		<entry><filename
 		  role="package">lang/lua4</filename></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>5.0</literal></entry>
 		<entry><filename
 		  role="package">lang/lua50</filename></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>5.1</literal></entry>
 		<entry><filename
 		  role="package">lang/lua</filename></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Die Variablen in <xref linkend="lua-ver-sel-table">
 	  k&ouml;nnen auf einen oder mehrere (durch Leerzeichen
 	  getrennt) der folgenden Werte gesetzt werden:</para>
 
 	<table frame="none">
 	  <title>Spezifikationen der
 	    <application>Lua</application>-Versionen</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Beschreibung</entry>
 		<entry>Beispiel</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>Spezielle Version</entry>
 		<entry><literal>4.0</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>Aufsteigende Versionen</entry>
 		<entry><literal>5.0+</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>Absteigende Versionen</entry>
 		<entry><literal>5.0-</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>Versionenintervall (muss aufsteigend sein)</entry>
 		<entry><literal>5.0-5.1</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Desweiteren gibt es Variablen, &uuml;ber die eine
 	  bevorzugte Version festgelegt werden kann. Die Versionen
 	  k&ouml;nnen als Liste angegeben werden, wobei die
 	  Reihenfolge der Priorisierung entspricht.</para>
 
 	<table frame="none">
 	  <title>Variablen zur Festlegung der bevorzugten
 	    <application>Lua</application>-Version</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Bestimmt f&uuml;r</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>WANT_LUA_VER</makevar></entry>
 		<entry>den Port</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>WITH_LUA_VER</makevar></entry>
 		<entry>den Benutzer</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example id="lua-version-example">
 	  <title>Auswahl der
 	    <application>Lua</application>-Version</title>
 
 	  <para>Der folgende Ausschnitt entspricht einem Port, der
 	    <application>Lua</application> in den Versionen
 	    <literal>5.0</literal> oder <literal>5.1</literal>
 	    verwenden kann und standardm&auml;&szlig;ig
 	    <literal>5.0</literal> verwendet.  Diese Einstellung kann
 	    durch die benutzerdefinierte Variable
 	    <makevar>WITH_LUA_VER</makevar> &uuml;berschrieben
 	    werden.</para>
 
 	  <programlisting>USE_LUA=      5.0-5.1
 WANT_LUA_VER= 5.0</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="lua-components">
 	<title>Komponentenauswahl</title>
 
 	<para>Desweiteren gibt es Anwendungen, die nicht direkt
 	  <application>Lua</application>-Bibliotheken sind, aber
 	  trotzdem mit diesen zusammenh&auml;ngen. Diese Anwendungen
 	  k&ouml;nnen &uuml;ber die Variable
 	  <makevar>LUA_COMPS</makevar> festgelegt werden.  Die
 	  folgenden Komponenten sind verf&uuml;gbar:</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare
 	    <application>Lua</application>-Komponenten</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 		<entry>Versionseinschr&auml;nkungen</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>lua</literal></entry>
 		<entry>Hauptbibliothek</entry>
 		<entry>Keine</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>tolua</literal></entry>
 		<entry>Bibliothek f&uuml;r die Unterst&uuml;tzung von C/C++-Code</entry>
 		<entry><literal>4.0-5.0</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>ruby</literal></entry>
 		<entry>Ruby-Bindungen</entry>
 		<entry><literal>4.0-5.0</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<note>
 	  <para>Es gibt weitere Komponenten, die jedoch Module
 	    f&uuml;r den Interpreter sind und nicht von Anwendungen
 	    benutzt werden (nur von anderen Modulen).</para>
 	</note>
 
 	<para>Der Typ der Abh&auml;ngigkeit kann f&uuml;r jede
 	  Komponente durch Hinzuf&uuml;gen eines Suffix (durch
 	  Strichpunkt getrennt) festgelegt werden. Falls der Typ nicht
 	  angegeben wird, wird ein Standardwert verwendet (siehe <xref
 	  linkend="lua-def-dep-types">).  Die folgenden Typen sind
 	  verf&uuml;gbar:</para>
 
 	<table frame="none">
 	  <title>Verf&uuml;gbare Typen von
 	    <application>Lua</application>-Abh&auml;ngigkeiten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>build</literal></entry>
 		<entry>Komponente wird zum Bau
 		  ben&ouml;tigt&nbsp;&ndash;&nbsp;&auml;quivalent zu
 		  <makevar>BUILD_DEPENDS</makevar></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>run</literal></entry>
 		<entry>Komponente wird zum Ausf&uuml;hren
 		  ben&ouml;tigt&nbsp;&ndash;&nbsp;&auml;quivalent zu
 		  <makevar>RUN_DEPENDS</makevar></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>lib</literal></entry>
 		<entry>Komponente wird zum Bau und zum Ausf&uuml;hren
 		  ben&ouml;tigt&nbsp;&ndash;&nbsp;&auml;quivalent zu
 		  <makevar>LIB_DEPENDS</makevar></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>Die Standardwerte f&uuml;r die einzelnen Komponenten
 	  sind in der folgenden Tabelle aufgef&uuml;hrt:</para>
 
 	<table id="lua-def-dep-types" frame="none">
 	  <title>Standardtypen f&uuml;r
 	    <application>Lua</application>-Abh&auml;ngigkeiten</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Komponente</entry>
 		<entry>Typ der Abh&auml;ngigkeit</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>lua</literal></entry>
 		<entry><literal>lib</literal> f&uuml;r
 		  <literal>4.0-5.0</literal> (shared) und
 		  <literal>build</literal> f&uuml;r <literal>5.1</literal>
 		  (static)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>tolua</literal></entry>
 		<entry><literal>build</literal> (static)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>ruby</literal></entry>
 		<entry><literal>lib</literal> (shared)</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example id="lua-components-example">
 	  <title>Auswahl von
 	    <application>Lua</application>-Komponenten</title>
 
 	  <para>Der folgende Ausschnitt entspricht einem Port,
 	    welcher die <application>Lua</application>-Version
 	    <literal>4.0</literal> und die zugeh&ouml;rigen
 	    <application>Ruby</application>-Bindungen
 	    verwendet.</para>
 
 	  <programlisting>USE_LUA=      4.0
 LUA_COMPS=    lua ruby</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="lua-version-detection">
 	<title>Feststellen der installierten Version</title>
 
 	<para>Um eine bereits installierte Version zu finden, muss
 	  <makevar>WANT_LUA</makevar> definiert werden. Falls diese
 	  Variable nicht auf eine bestimmte Versionsnummer gesetzt
 	  wird, werden die Komponenten einen Suffix mit der
 	  Versionsnummer tragen. Die Variable
 	  <makevar>HAVE_LUA</makevar> wird gesetzt, falls eine
 	  installierte Version vorgefunden wurde.</para>
 
 	<example id="lua-ver-det-example">
 	  <title>Installierte
 	    <application>Lua</application>-Versionen
 	    und&ndash;&nbsp;Komponenten feststellen</title>
 
 	  <para>Der folgende Ausschnitt kann in einem Port verwendet
 	    werden, der <application>Lua</application> benutzt, falls
 	    es installiert ist oder eine Option daf&uuml;r
 	    ausgew&auml;hlt wurde.</para>
 
 	  <programlisting>WANT_LUA=       yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_LUA5) || ${HAVE_LUA:Mlua-5.[01]} != ""
 USE_LUA=        5.0-5.1
 CONFIGURE_ARGS+=--enable-lua5
 .endif</programlisting>
 
 	  <para>Der folgende Ausschnitt kann verwendet werden, um
 	    die Unterst&uuml;tzung f&uuml;r
 	    <application>tolua</application> zus&auml;tzlich zu der
 	    von <application>Lua</application> zu aktivieren (beide in
 	    Version 4.0), wenn dies installiert ist oder die Option
 	    ausgew&auml;hlt wurde.</para>
 
 	  <programlisting>USE_LUA=        4.0
 LUA_COMPS=      lua
 WANT_LUA=       4.0
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_TOLUA) || ${HAVE_LUA:Mtolua} != ""
 LUA_COMPS+=     tolua
 CONFIGURE_ARGS+=--enable-tolua
 .endif</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="lua-defined-variables">
 	<title>Vordefinierte Variablen</title>
 
 	<para>Die folgenden Variablen sind in den Ports
 	  verf&uuml;gbar (nachdem sie entsprechend <xref
 	  linkend="lua-ver-sel-table"> definiert wurden).</para>
 
 	<table frame="none">
 	  <title>Vordefinierte Variablen f&uuml;r Ports, die
 	    <application>Lua</application> verwenden</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Name</entry>
 		<entry>Beschreibung</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><makevar>LUA_VER</makevar></entry>
 		<entry>Die <application>Lua</application>-Version, die
 		  verwendet wird (z.B. <literal>5.1</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_VER_SH</makevar></entry>
 		<entry>Die Hauptversion f&uuml;r
 		  shared-<application>Lua</application>-Bibliotheken (z.B.
 		  <literal>1</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_VER_STR</makevar></entry>
 		<entry>Die <application>Lua</application>-Version ohne die
 		  Punkte (z.B. <literal>51</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_PREFIX</makevar></entry>
 		<entry>Der Pr&auml;fix, unter dem
 		  <application>Lua</application> (und Komponenten)
 		  installiert ist</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_SUBDIR</makevar></entry>
 		<entry>Das Verzeichnis unter
 		  <filename>${PREFIX}/bin</filename>,
 		  <filename>${PREFIX}/share</filename> und
 		  <filename>${PREFIX}/lib</filename>, in welchem
 		  <application>Lua</application> installiert ist</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_INCDIR</makevar></entry>
 		<entry>Das Verzeichnis, in dem
 		  <application>Lua</application>- und
 		  <application>tolua</application>-Header-Dateien
 		  installiert sind</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_LIBDIR</makevar></entry>
 		<entry>Das Verzeichnis, in dem
 		  <application>Lua</application>&ndash;&nbsp;und
 		  <application>tolua</application>-Bibliotheken
 		  installiert sind</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_MODLIBDIR</makevar></entry>
 		<entry>Das Verzeichnis, in dem
 		  <application>Lua</application> Modul-Bibliotheken
 		  (<filename>.so</filename>) installiert sind</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_MODSHAREDIR</makevar></entry>
 		<entry>Das Verzeichnis, in dem
 		  <application>Lua</application>-Module
 		  (<filename>.lua</filename>) installiert sind</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_PKGNAMEPREFIX</makevar></entry>
 		<entry>Der Paketnamen-Pr&auml;fix, der von
 		  <application>Lua</application>-Modulen verwendet
 	          wird</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUA_CMD</makevar></entry>
 		<entry>Das Verzeichnis, in dem der
 		  <application>Lua</application>-Interpreter liegt</entry>
 	      </row>
 
 	      <row>
 		<entry><makevar>LUAC_CMD</makevar></entry>
 		<entry>Das Verzeichnis, in dem der
 		  <application>Lua</application>-Compiler liegt</entry>
 	      </row>
 	      <row>
 		<entry><makevar>TOLUA_CMD</makevar></entry>
 		<entry>Das Verzeichnis, in dem das
 		  <application>tolua</application>-Programm liegt</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example id="lua-variables-example">
 	  <title>Einem Port mitteilen, in welchem Verzeichnis
 	    <application>Lua</application> liegt</title>
 
 	  <para>Der folgende Ausschnitt zeigt, wie einem Port,
 	    welcher ein configure-Skript verwendet, mitgeteilt werden
 	    kann, wo die <application>Lua</application>-Header-Dateien
 	    und Bibliotheken liegen.</para>
 
 	  <programlisting>
 USE_LUA=        4.0
 GNU_CONFIGURE=  yes
 CONFIGURE_ENV=  CPPFLAGS="-I${LUA_INCDIR}" LDFLAGS="-L${LUA_LIBDIR}"</programlisting>
 	</example>
       </sect2>
 
       <sect2 id="lua-premk">
 	<title>Verarbeitung in
 	  <filename>bsd.port.pre.mk</filename></title>
 
 	<para>Falls die Variablen gleich nach dem Einbinden von
 	  <filename>bsd.port.pre.mk</filename> benutzt werden sollen,
 	  so muss die Variable <makevar>LUA_PREMK</makevar> definiert
 	  werden.</para>
 
 	<important>
 	  <para>Falls <makevar>LUA_PREMK</makevar> definiert ist, so
 	    werden Version, Abh&auml;ngigkeiten, Komponenten und
 	    vordefinierte Variablen nicht ge&auml;ndert, wenn die
 	    Variablen des <application>Lua</application>-Ports
 	    <emphasis>nach</emphasis> dem Einbinden von
 	    <filename>bsd.port.pre.mk</filename> ge&auml;ndert
 	    werden.</para>
 	</important>
 
 	<example id="lua-premk-example">
 	  <title>Verwendung von
 	    <application>Lua</application>-Variablen in
 	    Kommandos</title>
 
 	  <para>Der folgende Ausschnitt zeigt die Verwendung von
 	    <makevar>LUA_PREMK</makevar> durch Ausf&uuml;hren des
 	    <application>Lua</application>-Interpreters, um die
 	    vollst&auml;ndige Version als Zeichenkette zu erhalten,
 	    diese dann einer Variablen zuzuweisen und die Variable
 	    schlie&szlig;lich einem Programm zu &uuml;bergeben.</para>
 
 	  <programlisting>USE_LUA=        5.0
 LUA_PREMK=      yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if exists(${LUA_CMD})
 VER_STR!=       ${LUA_CMD} -v
 
 CFLAGS+=        -DLUA_VERSION_STRING="${VER_STR}"
 .endif</programlisting>
 	</example>
 
 	<note>
 	  <para>Die <application>Lua</application>-Variablen
 	    k&ouml;nnen problemlos in Befehlen benutzt werden, falls
 	    diese in Targets ohne gesetztes
 	    <makevar>LUA_PREMK</makevar> verwendet werden.</para>
 	</note>
       </sect2>
     </sect1>
 
     <sect1 id="using-xfce">
       <title>Xfce verwenden</title>
 
       <para>Die <makevar>USE_XFCE</makevar>-Variable wird f&uuml;r
 	die automatische Konfiguration der Abh&auml;ngigkeiten
 	eingesetzt, welche die Xfce-Basisbibliotheken oder Anwendungen
 	wie <filename
 	role="package">x11-toolkits/libxfce4gui</filename> und
 	<filename role="package">x11-wm/xfce4-panel</filename>
 	verwenden.</para>
 
       <para>Die folgenden Xfce-Bibliotheken und -Anwendungen werden
 	derzeit unterst&uuml;tzt:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>libexo: <filename
 	    role="package">x11/libexo</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>libgui: <filename
 	    role="package">x11-toolkits/libxfce4gui</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>libutil: <filename
 	    role="package">x11/libxfce4util</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>libmcs: <filename
 	    role="package">x11/libxfce4mcs</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>mcsmanager: <filename
 	    role="package">sysutils/xfce4-mcs-manager</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>panel: <filename
 	    role="package">x11-wm/xfce4-panel</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>thunar: <filename
 	    role="package">x11-fm/thunar</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>wm: <filename
 	    role="package">x11-wm/xfce4-wm</filename></para>
 	</listitem>
 
 	<listitem>
 	  <para>xfdev: <filename
 	    role="package">dev/xfce4-dev-tools</filename></para>
 	</listitem>
       </itemizedlist>
 
       <para>Die folgenden zus&auml;tzlichen Parameter werden
 	unterst&uuml;tzt:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>configenv: Benutzen Sie dies, wenn Ihr Port eine
 	    speziell angepasste
 	    <makevar>CONFIGURE_ENV</makevar>-Variable ben&ouml;tigt,
 	    um seine erforderlichen Bibliotheken zu finden.
 	    <programlisting>-I&dollar;{LOCALBASE}/include
 	    -L&dollar;{LOCALBASE}/lib</programlisting> wird CPPFLAGS
 	    hinzugef&uuml;gt und ergibt
 	    <makevar>CONFIGURE_ENV</makevar>.</para>
 	</listitem>
       </itemizedlist>
 
       <para>Wenn also ein Port von <filename
 	role="package">sysutils/xfce4-mcs-manager</filename>
 	abh&auml;ngt und die speziellen CPPFLAGS in seiner
 	configure-Umgebung verlangt, dann w&uuml;rde die Syntax wie
 	folgt aussehen:</para>
 
       <programlisting>USE_XFCE=        mcsmanager configenv</programlisting>
     </sect1>
 
     <sect1 id="rc-scripts">
       <title>Starten und Anhalten von Diensten (rc Skripten)</title>
 
       <para><filename>rc.d</filename>-Skripten werden zum Starten
 	von Diensten w&auml;hrend des Systemstarts verwendet und um
 	den Administratoren einen Standardweg zum Anhalten und Starten
 	von Diensten zu bieten. Ports halten sich an dieses
 	systemweite <filename>rc.d</filename>-Framework.  Details zu
 	deren Benutzung k&ouml;nnen im <ulink
 	url="&url.books.handbook;/configtuning-rcd.html">rc.d Kapitel
 	des Handbuchs</ulink> nachgelesen werden. Ausf&uuml;hrliche
 	Beschreibungen der verf&uuml;gbaren Befehle stehen in
 	&man.rc.8; und &man.rc.subr.8;.  Desweiteren gibt es <ulink
 	url="&url.articles.rc-scripting.en;">einen Artikel</ulink> zu
 	praktischen Aspekten bez&uuml;glich
 	<filename>rc.d</filename>-Skripten.</para>
 
       <para>Ein oder mehrere rc-Skripten k&ouml;nnen installiert
 	werden mittels:</para>
 
       <programlisting>USE_RC_SUBR=    doormand</programlisting>
 
       <para>Skripten m&uuml;ssen im Unterverzeichnis
 	<filename>files</filename> abgelegt und jeder Skript-Datei
 	muss ein <literal>.in</literal>-Suffix hinzugef&uuml;gt
 	werden.  Der einzige Unterschied zu einem
 	<filename>rc.d</filename>-Skript aus dem Basissystem ist, dass
 	die Zeile <literal>.&nbsp;/etc/rc.subr</literal> in
 	<literal>.&nbsp;%%RC_SUBR%%</literal> umbenannt werden muss,
 	da &auml;ltere Versionen von &os; die Datei
 	<filename>/etc/rc.subr</filename> nicht besitzen.
 	Standarderweiterungen wie <makevar>SUB_LIST</makevar> werden
 	ebenfalls unterst&uuml;tzt. Die Verwendung von
 	<literal>%%PREFIX%%</literal>,
 	<literal>%%LOCALBASE%%</literal> und
 	<literal>%%X11BASE%%</literal> wird dringend empfohlen.
 	N&auml;heres zu <makevar>SUB_LIST</makevar> kann im <link
 	linkend="using-sub-files">zugeh&ouml;rigen Kapitel</link>
 	nachgelesen werden.</para>
 
       <para>F&uuml;r &os;-Versionen, die &auml;lter als 6.1-RELEASE
 	sind, ist die Integration mittels &man.rcorder.8;
 	m&ouml;glich, indem <makevar>USE_RCORDER</makevar> anstatt
 	<makevar>USE_RC_SUBR</makevar> verwendet wird. Die Verwendung
 	dieser Methode wird aber nicht mehr empfohlen.</para>
 
       <para>Seit &os;&nbsp;6.1-RELEASE sind lokale
 	<filename>rc.d</filename>-Skripten (inklusive der durch Ports
 	installierten) im allgemeinen &man.rcorder.8; des
 	Basissystems.</para>
 
       <para>Beispiel eines einfachen
 	<filename>rc.d</filename>-Skripts:</para>
 
       <programlisting>#!/bin/sh
 
 # PROVIDE: doormand
 # REQUIRE: LOGIN
 #
 # Add the following lines to /etc/rc.conf.local or /etc/rc.conf
 # to enable this service:
 #
 # doormand_enable (bool):    Set to NO by default.
 #                Set it to YES to enable doormand.
 # doormand_config (path):    Set to %%PREFIX%%/etc/doormand/doormand.cf
 #                by default.
 #
 
 . %%RC_SUBR%%
 
 name="doormand"
 rcvar=${name}_enable
 
 command=%%PREFIX%%/sbin/${name}
 pidfile=/var/run/${name}.pid
 
 load_rc_config $name
 
 : ${doormand_enable="NO"}
 : ${doormand_config="%%PREFIX%%/etc/doormand/doormand.cf"}
 
 command_args="-p $pidfile -f $doormand_config"
 
 run_rc_command "$1"</programlisting>
 
       <para>F&uuml;r die Wertzuweisung von Variablen sollte
 	&quot;=&quot; anstatt &quot;:=&quot; verwendet werden, da bei
 	Ersterem nur auf einen Standardwert gesetzt wird, wenn die
 	Variable vorher noch nicht gesetzt war, und bei Letzterem
 	dieser gesetzt wird, auch wenn der Wert vorher Null gewesen
 	ist. Ein Benutzer kann durchaus einen Ausdruck wie
 	<programlisting>doormand_flags=""</programlisting> in seiner
 	<filename>rc.conf.local</filename>-Datei stehen haben, und
 	eine Variablenzuweisung mittels &quot;:=&quot; w&uuml;rde in
 	diesem Fall die Benutzerdefinition &uuml;berschreiben.</para>
 
       <para>Der Suffix des rc-Skriptes wird durch
 	<makevar>RC_SUBR_SUFFIX</makevar> f&uuml;r die weitere
 	Verwendung im <filename>Makefile</filename> des Ports
 	bereitgestellt. Aktuelle Versionen von &os; f&uuml;gen keinen
 	Suffix den Skriptnamen hinzu im Gegensatz zu &auml;ltere
 	Versionen, die dies mit dem Suffix <filename>.sh</filename>
 	taten.</para>
 
       <note>
 	<para>Es sollten keine weiteren Skripten mit der
 	  <filename>.sh</filename>-Endung hinzugef&uuml;gt werden.
 	  Irgendwann wird es ein Massenumbenennen aller Skripten im
 	  Repository geben, die immer noch diese Endung haben.</para>
       </note>
 
       <sect2>
 	<title>Anhalten und Deinstallieren von Diensten</title>
 
 	<para>Es ist m&ouml;glich, dass ein Dienst w&auml;hrend der
 	  Deinstallation automatisch angehalten wird. Es wird
 	  empfohlen dieses Verhalten nur zu implementieren, wenn es
 	  unbedingt erforderlich ist zuerst den Dienst anzuhalten und
 	  dann die Dateien zu entfernen. Normalerweise sollte es dem
 	  Administrator &uuml;berlassen werden, ob ein Dienst durch
 	  Deinstallieren angehalten werden soll. Dies betrifft auch
 	  den Vorgang des Aktualisierens.</para>
 
 	<para>Der Datei <filename>pkg-plist</filename> sollte eine
 	  Zeile wie folgt zugef&uuml;gt werden:</para>
 
 	<programlisting>@stopdaemon doormand</programlisting>
 
 	<para>Das Argument muss dabei mit dem Inhalt der
 	  <makevar>USE_RC_SUBR</makevar>-Variablen
 	  &uuml;bereinstimmen.</para>
       </sect2>
     </sect1>
   </chapter>
 
   <chapter id="plist">
     <title>Fortgeschrittene
       <filename>pkg-plist</filename>-Methoden</title>
 
     <sect1 id="plist-sub">
       <title>&Auml;nderungen an <filename>pkg-plist</filename> mit
 	Hilfe von make-Variablen</title>
 
       <para>Einige Ports, insbesondere die
 	<literal>p5-</literal>-Ports, m&uuml;ssen, abh&auml;ngig von
 	ihren Konfigurationsoptionen (oder im Falle der p5-Ports von
 	der <literal>perl</literal>-Version), die
 	<filename>pkg-plist</filename> ver&auml;ndern. Um dies zu
 	vereinfachen, werden f&uuml;r jeden Eintrag in
 	<filename>pkg-plist</filename> die Variablen
 	<literal>%%OSREL%%</literal>, <literal>%%PERL_VER%%</literal>
 	und <literal>%%PERL_VERSION%%</literal> durch die jeweiligen
 	Werte ersetzt. Der Wert von <literal>%%OSREL%%</literal> ist
 	die Revisionsnummer des Betriebssystems (z.B.
 	<literal>4.9</literal>). <literal>%%PERL_VERSION%%</literal>
 	gibt die vollst&auml;ndige Versionsnummer von
 	<command>perl</command> (z.B. <literal>5.00502</literal>) und
 	<literal>%%PERL_VER%%</literal> die Versionsnummer ohne
 	Patchlevel (z.B. <literal>5.005</literal>) an. Weitere, die
 	Dokumentationsdateien des Ports betreffende
 	<literal>%%<replaceable>VARS</replaceable>%%</literal>, werden
 	im <link linkend="install-documentation">entsprechenden
 	Abschnitt</link> erl&auml;utert.</para>
 
       <para>Falls Sie weitere Ersetzungen von Variablen
 	durchf&uuml;hren m&uuml;ssen, k&ouml;nnen Sie in der Variable
 	<makevar>PLIST_SUB</makevar> eine Liste von
 	<literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>-Paaren
 	angeben, wobei in der <filename>pkg-plist</filename>
 	<literal>%%<replaceable>VAR</replaceable>%%</literal> durch
 	<replaceable>VALUE</replaceable> ersetzt wird.</para>
 
       <para>Wenn Sie z.B. einen Port haben, der viele Dateien in ein
 	versionsspezifisches Unterverzeichnis installiert, dann
 	k&ouml;nnen Sie etwas wie</para>
 
       <programlisting>OCTAVE_VERSION= 2.0.13
 PLIST_SUB=      OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
 
       <para>in das <filename>Makefile</filename> schreiben und
 	<literal>%%OCTAVE_VERSION%%</literal> verwenden,
 	unabh&auml;ngig davon, wo die Variable in
 	<filename>pkg-plist</filename> verwendet wird. In diesem Fall
 	m&uuml;ssen Sie bei einem Upgrade des Ports nicht dutzende
 	(oder manchmal sogar hunderte) Zeilen in
 	<filename>pkg-plist</filename> anpassen.</para>
 
       <para>Diese Ersetzung (ebenso wie das Hinzuf&uuml;gen weiterer
 	<link linkend="makefile-manpages">Manualpages</link>) wird
 	zwischen den <maketarget>pre-install</maketarget>- und
 	<maketarget>do-install</maketarget>-Targets ausgef&uuml;hrt,
 	indem aus <filename><makevar>PLIST</makevar></filename>
 	gelesen und in
 	<filename><makevar>TMPPLIST</makevar></filename> geschrieben
 	wird (Standard:
 	<filename><makevar>WRKDIR</makevar>/.PLIST.mktmp</filename>).
 	Falls Ihr Port also
 	<filename><makevar>PLIST</makevar></filename> w&auml;hrend dem
 	Erstellen generiert, so sollte dies vor oder in
 	<maketarget>pre-install</maketarget> geschehen. Muss Ihr Port
 	die resultierende Datei ver&auml;ndern, so sollte dies in
 	<maketarget>post-install</maketarget> mit der Ausgabedatei
 	<filename><makevar>TMPPLIST</makevar></filename>
 	erfolgen.</para>
 
       <para>Eine weitere M&ouml;glichkeit, die Paketliste eines
 	Ports zu ver&auml;ndern, besteht darin die Variablen
 	<makevar>PLIST_FILES</makevar> und
 	<makevar>PLIST_DIRS</makevar> zu setzen.  Der Wert jeder der
 	beiden Variablen stellt eine Liste von Pfadnamen dar, die
 	zusammen mit dem Inhalt von
 	<filename><makevar>PLIST</makevar></filename> in
 	<filename><makevar>TMPPLIST</makevar></filename> geschrieben
 	wird. Dabei unterliegen die Namen in
 	<makevar>PLIST_FILES</makevar> und
 	<makevar>PLIST_DIRS</makevar> der weiter oben beschriebenen
 	Substitution von
 	<literal>%%<replaceable>VAR</replaceable>%%</literal>.  Die
 	Namen aus <makevar>PLIST_FILES</makevar> werden ansonsten
 	unver&auml;ndert in die endg&uuml;ltige Paketliste
 	&uuml;bernommen, w&auml;hrend den Namen aus
 	<makevar>PLIST_DIRS</makevar> noch der Wert von
 	<literal>@dirrm</literal> vorangestellt wird.  Damit die
 	Verwendung von <makevar>PLIST_FILES</makevar> und
 	<makevar>PLIST_DIRS</makevar> &uuml;berhaupt m&ouml;glich
 	ist, m&uuml;ssen diese gesetzt werden, bevor
 	<filename><makevar>TMPPLIST</makevar></filename> geschrieben
 	wird&nbsp;&ndash;&nbsp;z.B. in
 	<maketarget>pre-install</maketarget> oder vorher.</para>
     </sect1>
 
     <sect1 id="plist-cleaning">
       <title>Leere Verzeichnisse</title>
 
       <sect2 id="plist-dir-cleaning">
 	<title>Aufr&auml;umen leerer Verzeichnisse</title>
 
 	<para>Bitte sorgen Sie daf&uuml;r, dass ihre Ports bei der
 	  Deinstallation leere Verzeichnisse l&ouml;schen. Dazu wird
 	  f&uuml;r jedes Verzeichnis, das der Port erzeugt hat, eine
 	  <literal>@dirrm</literal>-Zeile angegeben. Um ein
 	  Verzeichnis zu l&ouml;schen m&uuml;ssen Sie zuerst dessen
 	  Unterverzeichnisse entfernen.</para>
 
 	<programlisting> :
 lib/X11/oneko/pixmaps/cat.xpm
 lib/X11/oneko/sounds/cat.au
  :
 @dirrm lib/X11/oneko/pixmaps
 @dirrm lib/X11/oneko/sounds
 @dirrm lib/X11/oneko</programlisting>
 
 	<para>Es kann allerdings auch vorkommen, dass
 	  <literal>@dirrm</literal> Fehler ausgibt, da andere Ports
 	  ein Verzeichnis ebenfalls nutzen.  Deshalb k&ouml;nnen Sie
 	  <literal>@dirrmtry</literal> verwenden, um nur Verzeichnisse
 	  zu l&ouml;schen, die wirklich leer sind, und damit
 	  Warnhinweise vermeiden.</para>
 
 	<programlisting>@dirrmtry share/doc/gimp</programlisting>
 
 	<para>Dadurch wird es weder eine Fehlermeldung geben noch
 	  wird &man.pkg.delete.1; abnormal beendet werden - auch dann
 	  nicht, wenn
 	  <filename><makevar>${PREFIX}</makevar>/share/doc/gimp</filename>
 	  nicht leer ist, da andere Ports hier ebenfalls Dateien
 	  installiert haben.</para>
       </sect2>
 
       <sect2 id="plist-dir-empty">
 	<title>Erstellen leerer Verzeichnisse</title>
 
 	<para>Um leere Verzeichnisse w&auml;hrend der Installation
 	  eines Ports zu erstellen, bedarf es etwas Aufmerksamkeit.
 	  Diese Verzeichnisse werden nicht erstellt, wenn das Paket
 	  installiert wird, da Pakete nur die Dateien speichern und
 	  &man.pkg.add.1; nur die Verzeichnisse erstellt, die
 	  daf&uuml;r ben&ouml;tigt werden.  Um sicher zu gehen, dass
 	  das leere Verzeichnis erstellt wird, wenn ein Paket
 	  installiert wird, muss die folgende Zeile in
 	  <filename>pkg-plist</filename> &uuml;ber der entsprechenden
 	  <literal>@dirrm</literal> Zeile eingetragen werden:</para>
 
 	<programlisting>@exec mkdir -p %D/share/foo/templates</programlisting>
       </sect2>
     </sect1>
 
     <sect1 id="plist-config">
       <title>Konfigurationsdateien</title>
 
       <para>Sollte Ihr Port Konfigurationsdateien in
 	<filename><makevar>PREFIX</makevar>/etc</filename>
 	ben&ouml;tigen, so sollten Sie diese
 	<emphasis>nicht</emphasis> einfach installieren und in
 	<filename>pkg-plist</filename> auflisten. Dies w&uuml;rde
 	&man.pkg.delete.1; veranlassen, diese Dateien zu l&ouml;schen,
 	selbst wenn wenn sie vom Benutzer editiert wurden.</para>
 
       <para>Stattdessen sollten Beispieldateien mit einem
 	entsprechenden Suffix (beispielsweise
 	<filename><replaceable>filename</replaceable>.sample</filename>)
 	versehen werden. Ist die Konfigurationsdatei nicht vorhanden,
 	so sollte die Beispieldatei an deren Platz kopiert werden. Bei
 	der Deinstallation sollte die Konfigurationsdatei
 	gel&ouml;scht werden, aber nur, wenn sie nicht vom Benutzer
 	ver&auml;ndert wurde. Das alles muss sowohl im
 	<filename>Makefile</filename> des Ports als auch in der
 	<filename>pkg-plist</filename> (f&uuml;r die Installation aus
 	einem Paket) sichergestellt werden.</para>
 
       <para>Beispiel aus einem <filename>Makefile</filename>:</para>
 
       <programlisting>post-install:
     @if [ ! -f ${PREFIX}/etc/orbit.conf ]; then \
 	${CP} -p ${PREFIX}/etc/orbit.conf.sample ${PREFIX}/etc/orbit.conf ; \
     fi</programlisting>
 
       <para>Beispiel aus einer <filename>pkg-plist</filename>:</para>
 
       <programlisting>@unexec if cmp -s %D/etc/orbit.conf.sample %D/etc/orbit.conf; then rm -f %D/etc/orbit.conf; fi
 etc/orbit.conf.sample
 @exec if [ ! -f %D/etc/orbit.conf ] ; then cp -p %D/%F %B/orbit.conf; fi</programlisting>
 
       <para>Wahlweise k&ouml;nnen Sie auch eine <link
 	linkend="porting-message">Nachricht</link> ausgegeben lassen,
 	in der Sie den Nutzer auffordern, die Datei an die richtige
 	Stelle zu kopieren und zu bearbeiten, bevor das Programm
 	ausgef&uuml;hrt werden kann.</para>
     </sect1>
 
     <sect1 id="plist-dynamic">
       <title>Dynamische oder statische Paketliste</title>
 
       <para>Eine <emphasis>statische Paketliste</emphasis> ist eine
 	Paketliste, die in der Ports-Sammlung, entweder in Form der
 	<filename>pkg-plist</filename> (mit oder ohne der Ersetzung
 	von Variablen) oder durch <makevar>PLIST_FILES</makevar> und
 	<makevar>PLIST_DIRS</makevar> im <filename>Makefile</filename>
 	eingebettet, verf&uuml;gbar ist. Selbst wenn der Inhalt durch
 	ein Werkzeug oder ein Target im Makefile automatisch erzeugt
 	wird, <emphasis>bevor</emphasis> die Datei von einem Committer
 	in die Ports-Sammlung aufgenommen wird, so ist dies immer noch
 	eine statische Liste, da es m&ouml;glich ist den Dateiinhalt
 	zu betrachten ohne ein Distfile Herunterladen oder Kompilieren
 	zu m&uuml;ssen.</para>
 
       <para>Eine <emphasis>dynamische Paketliste</emphasis> ist eine
 	Paketliste, die beim Kompilieren des Ports erstellt wird,
 	abh&auml;ngig davon, welche Dateien und Verzeichnisse
 	installiert werden. Es ist nicht m&ouml;glich diese Liste zu
 	betrachten, bevor der Quelltext heruntergeladen und kompiliert
 	oder nachdem ein <literal>make clean</literal> ausgef&uuml;hrt
 	wurde.</para>
 
       <para>Der Einsatz dynamischer Paketlisten ist zwar nicht
 	untersagt, aber Sie sollten, wann immer das m&ouml;glich ist,
 	statische Paketlisten verwenden, da die Nutzer dann
 	&man.grep.1; auf alle verf&uuml;gbaren Ports anwenden
 	k&ouml;nnen, um z.B. herauszufinden, von welchem eine
 	bestimmte Datei installiert wurde. Dynamische Paketlisten
 	sollten f&uuml;r komplexe Ports verwendet werden, bei denen
 	sich die Liste abh&auml;ngig von den gew&auml;hlten Funktionen
 	sehr stark &auml;ndern kann (wodurch die Pflege von statischen
 	Listen unm&ouml;glich wird), oder Ports, welche die Paketliste
 	abh&auml;ngig von den Versionen verwendeter
 	Abh&auml;ngigkeiten ver&auml;ndern (z.B. Ports, die Ihre
 	Dokumentation mit <application>Javadoc</application>
 	erzeugen).</para>
 
       <para>Maintainer, die dynamische Paketlisten bevorzugen,
 	werden dazu aufgefordert, neue Targets zu Ihren Ports
 	hinzuzuf&uuml;gen, welche die
 	<filename>pkg-plist</filename>-Datei erzeugen, sodass Benutzer
 	den Inhalt &uuml;berpr&uuml;fen k&ouml;nnen.</para>
     </sect1>
 
     <sect1 id="plist-autoplist">
       <title>Automatisiertes Erstellen von Paketlisten</title>
 
       <para>Als Erstes sollten Sie sich vergewissern, dass der Port
 	bis auf <filename>pkg-plist</filename> vollst&auml;ndig
 	ist.</para>
 
       <para>Als N&auml;chstes erstellen Sie einen tempor&auml;ren
 	Verzeichnisbaum, in welchem Ihr Port installiert werden kann,
 	und installieren Sie alle Abh&auml;ngigkeiten.</para>
 
       <screen>&prompt.root; <userinput>mkdir /var/tmp/$(make -V PORTNAME)</userinput>
 &prompt.root; <userinput>mtree -U -f $(make -V MTREE_FILE) -d -e -p /var/tmp/$(make -V PORTNAME)</userinput>
 &prompt.root; <userinput>make depends PREFIX=/var/tmp/$(make -V PORTNAME)</userinput></screen>
 
       <para>Speichern Sie die Verzeichnisstruktur in einer neuen
 	Datei.</para>
 
       <screen>&prompt.root; <userinput>(cd /var/tmp/$(make -V PORTNAME) && find -d * -type d) | sort &gt; OLD-DIRS</userinput></screen>
 
       <para>Erstellen Sie eine leere
 	<filename>pkg-plist</filename>-Datei:</para>
 
       <screen>&prompt.root; <userinput>:&gt;pkg-plist</userinput></screen>
 
       <para>Wenn Ihr Port auf <makevar>PREFIX</makevar> achtet (was
 	er machen sollte), so kann der Port nun installiert und die
 	Paketliste erstellt werden.</para>
 
       <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/$(make -V PORTNAME)</userinput>
 &prompt.root; <userinput>(cd /var/tmp/$(make -V PORTNAME) && find -d * \! -type d) | sort &gt; pkg-plist</userinput></screen>
 
       <para>Sie m&uuml;ssen auch alle neu erstellten Verzeichnisse in
 	die Paketliste aufnehmen.</para>
 
       <screen>&prompt.root; <userinput>(cd /var/tmp/$(make -V PORTNAME) && find -d * -type d) | sort | comm -13 OLD-DIRS - | sort -r | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</userinput></screen>
 
       <para>Zu guter Letzt muss die Paketliste noch manuell
 	aufger&auml;umt werden - es funktioniert eben nicht
 	<emphasis>alles</emphasis> automatisch. Manualpages sollten im
 	<filename>Makefile</filename> des Ports unter
 	<makevar>MAN<replaceable>n</replaceable></makevar>
 	aufgef&uuml;hrt sein und nicht in der Paketliste.
 	Konfigurationsdateien des Benutzers sollten entfernt oder als
 	<filename><replaceable>filename</replaceable>.sample</filename>
 	installiert werden. Die <filename>info/dir</filename>-Datei
 	sollte nicht aufgef&uuml;hrt sein und die zugeh&ouml;rigen
 	<filename>install-info</filename>-Zeilen sollten
 	hinzugef&uuml;gt werden, wie im <link
 	linkend="makefile-info">info files</link>-Abschnitt
 	beschrieben. Alle Bibliotheken, die der Port installiert,
 	sollten aufgelistet werden, wie es im <link
 	linkend="porting-shlibs">Shared Libraries</link>-Abschnitt
 	festgelegt ist.</para>
 
       <para>Alternativ dazu k&ouml;nnen Sie das
 	<command>plist</command>-Skript in
 	<filename>/usr/ports/Tools/scripts/</filename> verwenden, um
 	die Paketliste automatisch zu erstellen. Der erste Schritt ist
 	derselbe wie oben: Nehmen Sie die ersten drei Zeilen, also
 	<command>mkdir</command>, <command>mtree</command> und
 	<command>make depends</command>. Installieren und bauen Sie
 	dann den Port:</para>
 
       <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/$(make -V PORTNAME)</userinput></screen>
 
       <para>Und lassen Sie <command>plist</command> die
 	<filename>pkg-plist</filename>-Datei erstellen:</para>
 
       <screen>&prompt.root; <userinput>/usr/ports/Tools/scripts/plist -Md -m $(make -V MTREE_FILE) /var/tmp/$(make -V PORTNAME) &gt; pkg-plist</userinput></screen>
 
       <para>Die Paketliste muss immer noch von Hand aufger&auml;umt
 	werden, wie es oben erkl&auml;rt wurde.</para>
     </sect1>
   </chapter>
 
   <chapter id="pkg-files">
     <title>Die <filename>pkg-<replaceable>*</replaceable></filename>
       Dateien</title>
 
     <para>Es gibt noch einige Tricks mit
       <filename>pkg-<replaceable>*</replaceable></filename>, die wir
       noch nicht erw&auml;hnt haben, die aber oft sehr praktisch
       sind.</para>
 
     <sect1 id="porting-message">
       <title><filename>pkg-message</filename></title>
 
       <para>Wenn Sie dem Anwender bei der Installation weitere
 	Informationen anzeigen wollen, so k&ouml;nnen Sie diese
 	Nachricht in <filename>pkg-message</filename> speichern.
 	Diese Vorgehensweise ist oft n&uuml;tzlich, um
 	zus&auml;tzliche Schritte anzuzeigen, die nach &man.pkg.add.1;
 	durchgef&uuml;hrt werden m&uuml;ssen. Dadurch k&ouml;nnen Sie
 	auch Lizenzinformationen darstellen.</para>
 
       <para>Wollen Sie nur ein paar Zeilen &uuml;ber die
 	Einstellungen zum Erstellen des Ports oder Warnungen ausgeben,
 	benutzen Sie <makevar>ECHO_MSG</makevar>.
 	<filename>pkg-message</filename> ist nur f&uuml;r Schritte
 	nach der Installation vorgesehen. Sie sollten den Unterschied
 	zwischen <makevar>ECHO_MSG</makevar> und
 	<makevar>ECHO_CMD</makevar> beachten: Ersteres wird benutzt,
 	um Informationen auf dem Bildschirm auszugeben, w&auml;hrend
 	Letzteres f&uuml;r Kommando-Pipelining bestimmt ist.</para>
 
       <para>Ein gutes Beispiel f&uuml;r die Benutzung der beiden
 	Befehle ist in <filename>shells/bash2/Makefile</filename> zu
 	finden:</para>
 
       <programlisting>update-etc-shells:
     @${ECHO_MSG} "updating /etc/shells"
     @${CP} /etc/shells /etc/shells.bak
     @( ${GREP} -v ${PREFIX}/bin/bash /etc/shells.bak; \
 	${ECHO_CMD} ${PREFIX}/bin/bash) &gt;/etc/shells
     @${RM} /etc/shells.bak</programlisting>
 
       <note>
 	<para>Die <filename>pkg-message</filename> wird nicht zur
 	  <filename>pkg-plist</filename> hinzugef&uuml;gt. Sie wird
 	  auch nicht automatisch angezeigt, falls ein Anwender den
 	  Port installiert. Sie m&uuml;ssen also die Ausgabe selbst im
 	  <maketarget>post-install</maketarget>-Ziel des Make-Vorgangs
 	  veranlassen.</para>
       </note>
     </sect1>
 
     <sect1 id="pkg-install">
       <title><filename>pkg-install</filename></title>
 
       <para>Sollte es n&ouml;tig sein, dass Ihr Port bei der
 	Installation des Bin&auml;rpakets mit &man.pkg.add.1; Befehle
 	ausf&uuml;hrt, k&ouml;nnen Sie das Skript
 	<filename>pkg-install</filename> benutzen. Dieses Skript wird
 	automatisch dem Paket hinzugef&uuml;gt und zweimal von
 	&man.pkg.add.1; ausgef&uuml;hrt: Zuerst als
 	<literal>&dollar;{SH} pkg-install &dollar;{PKGNAME}
 	PRE-INSTALL</literal> und beim zweiten Mal als
 	<literal>&dollar;{SH} pkg-install &dollar;{PKGNAME}
 	POST-INSTALL</literal>. <literal>&dollar;2</literal> kann also
 	getestet werden, um festzustellen, in welchem Modus das Skript
 	ausgef&uuml;hrt wird. Die Umgebungsvariable
 	<envar>PKG_PREFIX</envar> wird auf das Verzeichnis gesetzt, in
 	welches das Paket installiert wird. Siehe &man.pkg.add.1;
 	f&uuml;r weiterf&uuml;hrende Informationen.</para>
 
       <note>
 	<para>Das Skript wird nicht automatisch ausgef&uuml;hrt,
 	  wenn Sie den Port mit <command>make install</command>
 	  installieren. Wenn Sie es ausf&uuml;hren lassen wollen, dann
 	  m&uuml;ssen Sie es im Makefile aufrufen:
 	  <literal>PKG_PREFIX=&dollar;{PREFIX} &dollar;{SH}
 	  &dollar;{PKGINSTALL} &dollar;{PKGNAME}
 	  PRE-INSTALL.</literal></para>
       </note>
     </sect1>
 
     <sect1 id="pkg-deinstall">
       <title><filename>pkg-deinstall</filename></title>
 
       <para>Dieses Skript wird ausgef&uuml;hrt, wenn ein Paket
 	deinstalliert wird.</para>
 
       <para>Es wird zweimal von &man.pkg.delete.1; aufgerufen. Das
 	erste Mal als <literal>&dollar;{SH} pkg-deinstall
 	&dollar;{PKGNAME} DEINSTALL</literal> und dann als
 	<literal>&dollar;{SH} pkg-deinstall &dollar;{PKGNAME}
 	POST-DEINSTALL.</literal></para>
     </sect1>
 
     <sect1 id="pkg-req">
       <title><filename>pkg-req</filename></title>
 
       <para>Muss Ihr Port entscheiden, ob er installiert werden
 	soll oder nicht, k&ouml;nnen Sie ein
 	<filename>pkg-req</filename>-<quote>Bedingungsskript</quote>
 	verwenden. Dieses wird automatisch bei der Installation/
 	Deinstallation aufgerufen, um zu entscheiden, ob die
 	Installation/ Deinstallation fortgesetzt werden soll.</para>
 
       <para>Das Skript wird w&auml;hrend der Installation von
 	&man.pkg.add.1; als <literal>pkg-req &dollar;{PKGNAME}
 	INSTALL</literal> aufgerufen. Bei der Deinstallation wird es
 	von &man.pkg.delete.1; als <literal>pkg-req &dollar;{PKGNAME}
 	DEINSTALL</literal> ausgef&uuml;hrt.</para>
     </sect1>
 
     <sect1 id="pkg-names">
       <title id="porting-pkgfiles">&Auml;ndern der Namen der
       <filename>pkg-<replaceable>*</replaceable></filename>
       Dateien</title>
 
 <!-- Hier muss noch mal &uuml;berarbeitet werden -->
 
     <para>Alle Namen der
       <filename>pkg-<replaceable>*</replaceable></filename> Dateien
       werden durch Variablen festgelegt. Sie k&ouml;nnen sie bei
       Bedarf also im <filename>Makefile</filename> des Ports
       &auml;ndern. Das ist besonders n&uuml;tzlich, wenn Sie die
       gleichen <filename>pkg-<replaceable>*</replaceable></filename>
       Dateien in mehreren Ports nutzen oder in eine der oben genannten
       Dateien schreiben wollen. Schreiben Sie niemals au&szlig;erhalb
       des Unterverzeichnisses <makevar>WRKDIR</makevar>
       <filename>pkg-*</filename>, eine Erkl&auml;rung hierzu finden
       Sie in <link linkend="porting-wrkdir"> Schreiben ausserhalb von
       <makevar>WRKDIR</makevar></link>.</para>
 
       <para>Hier ist eine Liste von Variablennamen und ihren
 	Standardwerten (<makevar>PKGDIR</makevar> ist
 	standardm&auml;&szlig;ig
 	<makevar>&dollar;{MASTERDIR}</makevar>).</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Variable</entry>
 	      <entry>Standardwert</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><makevar>DESCR</makevar></entry>
 	      <entry><literal>${PKGDIR}/pkg-descr</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PLIST</makevar></entry>
 	      <entry><literal>${PKGDIR}/pkg-plist</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PKGINSTALL</makevar></entry>
 	      <entry><literal>${PKGDIR}/pkg-install</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PKGDEINSTALL</makevar></entry>
 	      <entry><literal>${PKGDIR}/pkg-deinstall</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PKGREQ</makevar></entry>
 	      <entry><literal>${PKGDIR}/pkg-req</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PKGMESSAGE</makevar></entry>
 	      <entry><literal>${PKGDIR}/pkg-message</literal></entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para>Bitte benutzen Sie diese Variablen anstatt
 	<makevar>PKG_ARGS</makevar> zu &auml;ndern. Wenn Sie
 	<makevar>PKG_ARGS</makevar> modifizieren, werden diese Dateien
 	bei der Installation des Ports nicht korrekt in
 	<filename>/var/db/pkg</filename> installiert.</para>
     </sect1>
 
     <sect1 id="using-sub-files">
       <title>Nutzung von <makevar>SUB_FILES</makevar> und
 	<makevar>SUB_LIST</makevar></title>
 
       <para>Die Variablen <makevar>SUB_FILES</makevar> und
 	<makevar>SUB_LIST</makevar> sind n&uuml;tzlich, um dynamische
 	Werte in Port-Dateien zu verwenden, wie beispielsweise der
 	Installations-<makevar>PREFIX</makevar> in
 	<filename>pkg-message</filename>.</para>
 
       <para>Die Variable <makevar>SUB_FILES</makevar> enth&auml;lt
 	eine Liste von Dateien, die automatisch ver&auml;ndert werden.
 	Jede <replaceable>Datei</replaceable> in
 	<makevar>SUB_FILES</makevar> muss ein entsprechendes Pendant
 	<replaceable>datei.in</replaceable> im Verzeichnis
 	<makevar>FILESDIR</makevar> haben. Die modifizierte Version
 	wird in <makevar>WRKDIR</makevar> angelegt. Dateien, die als
 	Werte von <makevar>USE_RC_SUBR</makevar> (oder veraltet in
 	<makevar>USE_RCORDER</makevar>) gespeichert werden, werden
 	automatisch zu <makevar>SUB_FILES</makevar> hinzugef&uuml;gt.
 	F&uuml;r die Dateien <filename>pkg-message</filename>,
 	<filename>pkg-install</filename>,
 	<filename>pkg-deinstall</filename> und
 	<filename>pkg-req</filename> werden die jeweiligen
 	Makefile-Variablen selbstt&auml;tig auf die ge&auml;nderte
 	Version der Datei gesetzt.</para>
 
       <para>Die Variable <makevar>SUB_LIST</makevar> ist eine Liste
 	von <literal>VAR=WERT</literal>-Paaren. Jedes Paar
 	<literal>%%VAR%%</literal> in den Dateien von
 	<makevar>SUB_FILES</makevar> wird mit <literal>WERT</literal>
 	ersetzt.  Einige gebr&auml;uchliche Paare werden automatisch
 	definiert: <makevar>PREFIX</makevar>,
 	<makevar>LOCALBASE</makevar>, <makevar>X11BASE</makevar>,
 	<makevar>DATADIR</makevar>, <makevar>DOCSDIR</makevar>,
 	<makevar>EXAMPLESDIR</makevar>. Jede Zeile, die mit
 	<literal>@comment</literal> beginnt, wird nach der
 	Variablen-Ersetzung aus der neu erstellten Datei
 	gel&ouml;scht.</para>
 
       <para>Im folgenden Beispiel wird <literal>%%ARCH%%</literal>
 	mit der Systemarchitektur in <filename>pkg-message</filename>
 	ersetzt:</para>
 
       <programlisting>SUB_FILES=     pkg-message
 SUB_LIST=      ARCH=${ARCH}</programlisting>
 
       <para>Beachten Sie bitte, dass in diesem Beispiel die Datei
 	<filename>pkg-message.in</filename> im Verzeichnis
 	<makevar>FILESDIR</makevar> vorhanden sein muss.</para>
 
       <para>Hier ein Beispiel f&uuml;r eine gute
 	<filename>pkg-message.in</filename>:</para>
 
       <programlisting>Now it is time to configure this package.
 Copy %%PREFIX%%/share/examples/putsy/%%ARCH%%.conf into your home directory
 as .putsy.conf and edit it.</programlisting>
     </sect1>
   </chapter>
 
   <chapter id="testing">
     <title>Ihren Port testen</title>
 
     <sect1 id="make-describe">
       <title><command>make describe</command> ausf&uuml;hren</title>
 
       <para>Einige der &os;-Werkzeuge zur Pflege von Ports, wie zum
 	Beispiel &man.portupgrade.1;, verwenden eine Datenbank names
 	<filename>/usr/ports/INDEX</filename>, welche Eigenschaften,
 	wie z.B. Port-Abh&auml;ngigkeiten, verfolgt.
 	<filename>INDEX</filename> wird vom Makefile der h&ouml;chsten
 	Ebene, <filename>ports/Makefile</filename>, mittels
 	<command>make index</command> erstellt, welches in das
 	Unterverzeichnis jedes Ports wechselt und dort <command>make
 	describe</command> ausf&uuml;hrt. Wenn also <command>make
 	describe</command> bei einem Port fehlschl&auml;gt, kann
 	<filename>INDEX</filename> nicht generiert werden und schnell
 	werden viele Leute dar&uuml;ber unzufrieden sein.</para>
 
       <note>
 	<para>Es ist wichtig diese Datei erzeugen zu k&ouml;nnen,
 	  unabh&auml;ngig davon, welche Optionen in
 	  <filename>make.conf</filename> vorhanden sind. Bitte
 	  vermeiden Sie es daher beispielsweise
 	  <literal>.error</literal>-Anweisungen zu benutzen, wenn zum
 	  Beispiel eine Abh&auml;ngigkeit nicht erf&uuml;llt wird
 	  (Lesen Sie dazu bitte <xref
 	  linkend="dads-dot-error">).</para>
       </note>
 
       <para>Wenn <command>make describe</command> eine Zeichenkette
 	anstatt einer Fehlermeldung erzeugt, sind Sie wahrscheinlich
 	auf der sicheren Seite. Vergleichen Sie die erzeugte
 	Zeichenkette mit <filename>bsd.port.mk</filename>, um mehr
 	&uuml;ber deren Bedeutung zu erfahren.</para>
 
       <para>Beachten Sie bitte au&szlig;erdem, dass die Benutzung
 	einer aktuellen Version von <command>portlint</command> (wie
 	im n&auml;chsten Abschnitt beschrieben) automatisch
 	<command>make describe</command> startet.</para>
     </sect1>
 
     <sect1 id="testing-portlint">
       <title>Portlint</title>
 
       <para>Bitte &uuml;berpr&uuml;fen Sie Ihre Arbeit stets mit
 	<link
 	linkend="porting-portlint"><command>portlint</command></link>,
 	bevor Sie diese einreichen oder committen.
 	<command>portlint</command> warnt Sie bei h&auml;ufigen
 	Fehlern, sowohl funktionaler als auch stilistischer Natur.
 	F&uuml;r einen neuen (oder repokopierten) Port ist
 	<command>portlint -A</command> die gr&uuml;ndlichste Variante;
 	f&uuml;r einen bereits existierenden Port ist
 	<command>portlint -C</command> ausreichend.</para>
 
       <para>Da <command>portlint</command> heuristische Methoden zur
 	Fehlersuche benutzt, kann es vorkommen, dass Warnungen
 	f&uuml;r Fehler erzeugt werden, die keine sind. Gelegentlich
 	kann etwas, das als Problem angezeigt wird, aufgrund von
 	Einschr&auml;nkungen im Port-System nicht anders gel&ouml;st
 	werden. Wenn es Zweifel gibt, fragen Sie am besten auf
 	&a.ports; nach.</para>
     </sect1>
 
     <sect1 id="testing-porttools">
       <title>Port Tools</title>
 
       <para>Das Programm <filename
 	role="package">ports-mgmt/porttools</filename> ist Teil der
 	Ports-Sammlung.</para>
 
       <para><command>port</command> ist das Front-End-Skript, das
 	Ihnen dabei behilflich sein kann Ihre Arbeit als Tester zu
 	vereinfachen. Um einen neuen Port zu testen oder einen bereits
 	bestehenden Port zu aktualisieren, k&ouml;nnen Sie
 	<command>port test</command> verwenden, damit die Tests,
 	inklusive der <link
 	linkend="testing-portlint"><command>portlint</command></link>-&Uuml;berpr&uuml;fung,
 	durchgef&uuml;hrt werden. Dieser Befehl sp&uuml;rt ausserdem
 	alle nicht in <filename>pkg-plist</filename> enthaltenen
 	Dateien auf und gibt eine Liste dieser aus.  Hier ein
 	Beispiel:</para>
 
       <screen>&prompt.root; <userinput>port test /usr/ports/net/csup</userinput></screen>
     </sect1>
 
 
     <sect1 id="porting-prefix">
       <title><makevar>PREFIX</makevar> und
 	<makevar>DESTDIR</makevar></title>
 
       <para><makevar>PREFIX</makevar> bestimmt, an welche Stelle der
 	Port installiert werden soll. In der Regel ist
 	dies<filename>/usr/local</filename> oder
 	<filename>/opt</filename>. Benutzer k&ouml;nnen
 	<makevar>PREFIX</makevar> setzen, wie sie wollen. Ihr Port
 	muss sich an diese Variable halten.</para>
 
       <para><makevar>DESTDIR</makevar>, wenn es vom Benutzer gesetzt
 	wird, bestimmt die alternative Umgebung (in der Regel eine
 	Jail oder ein installiertes System, welches an anderer Stelle
 	als <filename>/</filename> eingeh&auml;ngt ist).
 	Ein Port wird unter
 	<makevar>DESTDIR</makevar>/<makevar>PREFIX</makevar>
 	installiert und registriert sich in der Paket-Datenbank unter
 	<makevar>DESTDIR</makevar>/var/db/pkg.
 	Da <makevar>DESTDIR</makevar> mittels eines
 	&man.chroot.8;-Aufrufs vom Ports-System automatisch gesetzt
 	wird, brauchen Sie keine &Auml;nderungen oder besondere Pflege
 	f&uuml;r <makevar>DESTDIR</makevar>-konforme Ports.</para>
 
       <para>Der Wert von <makevar>PREFIX</makevar> wird auf
 	<makevar>LOCALBASE</makevar> gesetzt (Standard ist
 	<filename>/usr/local</filename>).
 	Falls <makevar>USE_X_PREFIX</makevar> oder
 	<makevar>USE_IMAKE</makevar> gesetzt ist,
 	wird <makevar>PREFIX</makevar> <makevar>X11BASE</makevar>
 	entsprechen (aus
 	Kompatiblit&auml;tsgr&uuml;nden standardm&auml;&szlig;ig
 	<makevar>LOCALBASE</makevar>, das in Zukunft aber
 	komplett verschwinden wird).
 	Falls <makevar>USE_LINUX_PREFIX</makevar> gesetzt ist, wird
 	<makevar>PREFIX</makevar> <makevar>LINUXBASE</makevar>
 	annehmen (Standard ist
 	<filename>/compat/linux</filename>).</para>
 
       <para>Die Vermeidung der hart kodierten Angaben von
 	<filename>/usr/local</filename> oder
 	<filename>/usr/X11R6</filename> im Quelltext wird den Port
 	viel flexibler machen und erleichtert es die Anforderungen
 	anderer Einsatzorte zu erf&uuml;llen. F&uuml;r X-Ports, die
 	<command>imake</command> benutzen, geschieht dies automatisch;
 	andernfalls kann dies erreicht werden, indem alle Angaben von
 	<filename>/usr/local</filename> (oder
 	<filename>/usr/X11R6</filename> f&uuml;r X-Ports, die nicht
 	imake benutzen) in den verschiedenen
 	<filename>Makefile</filename>s im Port ersetzt werden, um
 	<makevar>${PREFIX}</makevar> zu lesen, da diese Variable
 	automatisch an jede Stufe des Build- und Install-Prozesses
 	&uuml;bergeben wird.</para>
 
       <para>Vergewissern Sie sich bitte, dass Ihre Anwendung nichts
 	unter <filename>/usr/local</filename> an Stelle von
 	<makevar>PREFIX</makevar> installiert. Um dies festzustellen,
 	k&ouml;nnen Sie folgendes machen:</para>
 
       <screen>&prompt.root; <userinput>make clean; make package PREFIX=/var/tmp/$(make -V PORTNAME)</userinput></screen>
 
       <para>Wenn etwas au&szlig;erhalb von <makevar>PREFIX</makevar>
 	installiert wird, so gibt der Prozess der Paketerstellung eine
 	Meldung aus, dass es die Dateien nicht finden kann.</para>
 
       <para>Dies pr&uuml;ft nicht das Vorhandensein eines internen
 	Verweises oder die richtige Verwendung von
 	<makevar>LOCALBASE</makevar> f&uuml;r Verweise auf Dateien
 	anderer Ports. Das Testen der Installation in
 	<filename>/var/tmp/$(make -V PORTNAME)</filename> w&uuml;rde
 	dies erledigen.</para>
 
       <para>Bitte verzichten Sie auf das Setzen von
 	<makevar>USE_X_PREFIX</makevar>, es sei denn, Ihr Port
 	ben&ouml;tigt dies wirklich (das hei&szlig;t, er muss auf
 	Dateien in <makevar>X11BASE</makevar> verweisen).</para>
 
       <para>Die Variable <makevar>PREFIX</makevar> kann in Ihrem
 	<filename>Makefile</filename> oder der Umgebung des Benutzers
 	neu gesetzt werden. Allerdings wird f&uuml;r einzelne Ports
 	dringend davon abgeraten diese Variable in den
 	<filename>Makefile</filename>s direkt zu setzen.</para>
 
       <para>Verweisen Sie bitte au&szlig;erdem auf Programme/Dateien
 	von anderen Ports durch die oben erw&auml;hnten Variablen und
 	nicht mit den eindeutigen Pfadnamen. Wenn Ihr Port zum
 	Beispiel vom Makro <literal>PAGER</literal> erwartet, dass es
 	den vollst&auml;ndigen Pfadnamen von <command>less</command>
 	enth&auml;lt, benutzen Sie folgendes Compiler-Flag:
 
 	<programlisting>-DPAGER=\"&dollar;{LOCALBASE}/bin/less\"</programlisting>
 
 	anstatt <literal>-DPAGER=\"/usr/local/bin/less\"</literal>.
 	Somit ist die Wahrscheinlichkeit h&ouml;her, dass es auch
 	funktioniert, wenn der Administrator den ganzen
 	<filename>/usr/local</filename>-Baum an eine andere Stelle
 	verschoben hat.</para>
     </sect1>
 
     <sect1 id="testing-tinderbox">
       <title>Die Tinderbox</title>
 
       <para>Wenn Sie ein begeisterter Ports-Entwickler sind
 	m&ouml;chten Sie vielleicht einen Blick auf die
 	<application>Tinderbox</application> werfen. Es ist ein
 	leistungsstarkes System zur Erstellung und zum Testen von
 	Ports, welches auf Skripten basiert, die auf <link
 	linkend="build-cluster">Pointyhat</link> verwendet werden. Sie
 	k&ouml;nnen <application>Tinderbox</application> installieren,
 	indem Sie den Port <filename
 	role="package">ports-mgmt/tinderbox</filename> benutzen.
 	Bitte lesen Sie die mitgelieferte Dokumentation
 	gr&uuml;ndlich, da die Konfiguration nicht einfach ist.</para>
 
 
       <para>Um N&auml;heres dar&uuml;ber zu erfahren, besuchen Sie
 	bitte die <ulink
 	url="http://tinderbox.marcuscom.com/">Tinderbox
 	Homepage</ulink>.</para>
     </sect1>
   </chapter>
 
   <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&auml;tzlich den Vorteil, dass Sie
       so auch alle Abh&auml;ngigkeiten des Ports aktuell
       halten.</para>
 
     <para>Der n&auml;chste Schritt besteht darin festzustellen, ob
       bereits eine Aktualisierung des Ports darauf wartet committet zu
       werden. Um das sicherzustellen haben Sie folgende
       M&ouml;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&auml;hlen Sie dazu
       <literal>Ports</literal> im Drop-Down-Men&uuml; und geben Sie
       den Namen des Ports ein.</para>
 
     <para>Allerdings wird manchmal vergessen den Namen des Ports
       eindeutig im Feld f&uuml;r die Zusammenfassung anzugeben. In
       diesem Fall k&ouml;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&ouml;nnen Sie die <ulink
       url="http://portsmon.FreeBSD.org/portoverview.py">&Uuml;bersicht
       eines Ports</ulink> verwenden.</para>
 
     <para>Wenn es keine wartenden PRs gibt, ist der n&auml;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&auml;tsproblemen der neuen Version). Sie
       wollen sicher nicht die Arbeit des Maintainers doppelt machen.
       Beachten Sie bitte, dass f&uuml;r Ports ohne Maintainer
       <literal>ports@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&uuml;hren Sie die &Auml;nderungen
       durch und speichern Sie die Ausgabe des rekursiven
       <command>diff</command> des neuen und alten Portverzeichnisses
       (wenn Ihr ver&auml;ndertes Portverzeichnis z.B.
       <filename>superedit</filename> und das Original
       <filename>superedit.bak</filename> hei&szlig;t, dann speichern
       Sie bitte die Ergebnisse von <command>diff -ruN superedit.bak
       superedit</command>). Sowohl vereinheitlichendes als auch
       kontextabh&auml;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&auml;uchliche
       Weg <command>diff</command> dazu zu bewegen korrekt damit
       umzugehen, neue Dateien anzulegen und alte zu l&ouml;schen.
       Bevor Sie das diff einsenden &uuml;berpr&uuml;fen Sie bitte die
       Ausgabe, um sicherzugehen, dass die &Auml;nderungen sinnvoll
       sind. Um g&auml;ngige Operationen mit Korrekturdateien zu
       vereinfachen, k&ouml;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&auml;gung sich als
       Maintainer zu melden. &os; hat mehr als 2000 Ports ohne
       Maintainer und in diesem Bereich werden immer zus&auml;tzliche
       Freiwillige ben&ouml;tigt (F&uuml;r eine ausf&uuml;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&uuml;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&auml;hnen Sie alle hinzugef&uuml;gten oder
       gel&ouml;schten Dateien in der Nachricht, da diese beim Commit
       ausdr&uuml;cklich an &man.cvs.1; &uuml;bergeben werden
       m&uuml;ssen. Wenn das diff gr&ouml;&szlig;er ist als 20 Kilobyte
       komprimieren und uuencoden Sie es bitte. Ansonsten k&ouml;nnen
       Sie es in den PR einf&uuml;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 &uuml;ber
       Problemberichte lesen. Dieser enth&auml;lt sehr viel mehr
       Informationen dar&uuml;ber, wie man n&uuml;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&uuml;hren. Sonst werden ahnungslose
 	Nutzer von &man.pkg.add.1; &uuml;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>Nun, da Sie all das geschafft haben, werden Sie in <xref
       linkend="keeping-up"> nachlesen k&ouml;nnen, wie Sie den Port
       aktuell halten.</para>
   </chapter>
 
   <chapter id="security">
     <title>Sicherheit der Ports</title>
 
     <sect1 id="security-intro">
       <title>Warum Sicherheit so wichtig ist</title>
 
       <para>Es finden sich immer wieder Fehler in Software. Die
 	gef&auml;hrlichsten davon sind wohl jene, die
 	Sicherheitsl&uuml;cken &ouml;ffnen. Technisch gesehen
 	m&uuml;ssen diese L&uuml;cken geschlossen werden, indem die
 	Fehler, die Sie verursacht haben, beseitigt werden. Aber die
 	Vorgehensweisen, wie mit blo&szlig;en Fehlern und
 	Sicherheitsl&uuml;cken umgegangen wird, sind sehr
 	unterschiedlich.</para>
 
       <para>Ein typischer kleiner Fehler betrifft nur Nutzer, die
 	eine bestimmte Kombination von Optionen aktiviert haben, die
 	den Fehler ausl&ouml;st. Der Entwickler wird letztendlich
 	einen Patch herausgeben, gefolgt von einer neuen Version des
 	Programms, die den Fehler nicht mehr
 	enth&auml;lt&nbsp;&ndash;&nbsp;jedoch wird die Mehrheit der
 	Nutzer nicht sofort aktualisieren, da sie von diesem Fehler
 	nicht betroffen sind. Ein kritischer Fehler, der zu
 	Datenverlust f&uuml;hren kann, stellt ein schwerwiegendes
 	Problem dar. Dennoch sind sich umsichtige Nutzer bewusst, dass
 	Datenverlust verschiedene Ursachen&nbsp;&ndash;&nbsp;neben
 	Softwarefehlern&nbsp;&ndash;&nbsp;haben kann, und machen
 	deshalb Sicherungskopien wichtiger Daten. Zumal ein
 	kritischer Fehler sehr schnell entdeckt wird.</para>
 
       <para>Bei einer Sicherheitsl&uuml;cke ist dies ganz anders.
 	Erstens wird sie vielleicht jahrelang nicht entdeckt, da dies
 	oftmals keine Fehlfunktion im Programm verursacht. Zweitens
 	kann eine b&ouml;swillige Person unerlaubten Zugriff auf ein
 	unsicheres System erlangen, um empfindliche Daten zu
 	ver&auml;ndern oder zu zerst&ouml;ren; im schlimmsten Fall
 	findet der Nutzer nicht einmal die Ursache des Schadens.
 	Drittens hilft der Zugriff auf ein unsicheres System dem
 	Angreifer oft in ein anderes System einzudringen, welches
 	ansonsten nicht gef&auml;hrdet w&auml;re. Deshalb reicht es
 	nicht aus eine Sicherheitsl&uuml;cke nur zu schlie&szlig;en:
 	Die Zielgruppe sollte m&ouml;glichst genau und umfassend
 	dar&uuml;ber informiert werden, damit sie die Gefahr
 	einsch&auml;tzen und passende Ma&szlig;nahmen ergreifen
 	k&ouml;nnen.</para>
     </sect1>
 
     <sect1 id="security-fix">
       <title>Sicherheitsl&uuml;cken schliessen</title>
 
       <para>Bei Ports und Paketen kann eine Sicherheitsl&uuml;cke im
 	urspr&uuml;nglichen Programm oder in den Port-Dateien
 	verursacht werden. Im ersten Fall wird der urspr&uuml;ngliche
 	Entwickler den Fehler wahrscheinlich umgehend korrigieren oder
 	eine neue Version herausgeben und Sie m&uuml;ssen den Port nur
 	aktualisieren und die Korrekturen des Autors beachten. Falls
 	sich die Korrektur aus irgendeinem Grund verz&ouml;gert,
 	sollten Sie <link linkend="dads-noinstall">den Port als
 	<makevar>FORBIDDEN</makevar> markieren</link> oder selbst den
 	Fehler f&uuml;r den Port korrigieren. Falls die
 	Sicherheitsl&uuml;cke im Port verursacht wird, sollten Sie ihn
 	sobald wie m&ouml;glich berichtigen. In jedem Fall sollte
 	<link linkend="port-upgrading">die Standardvorgehensweise zum
 	Einreichen von &Auml;nderungen</link> beachtet
 	werden&nbsp;&ndash;&nbsp;es sei denn, Sie haben das Recht
 	diese direkt in den Ports-Baum zu committen.</para>
 
       <important>
 	<para>Ports-Committer zu sein ist nicht genug, um
 	  &Auml;nderungen an einem beliebigen Port zu committen. Bitte
 	  denken Sie daran, dass Ports &uuml;blicherweise Maintainer
 	  haben, die Sie respektieren sollten.</para>
       </important>
 
       <para>Bitte stellen Sie sicher, dass die Revision des Ports
 	erh&ouml;ht wird, sobald die Sicherheitsl&uuml;cke geschlossen
 	wurde. Dadurch sehen die Nutzer, die installierte Pakete
 	regelm&auml;&szlig;ig aktualisieren, dass es an der Zeit ist
 	eine Aktualisierung durchzuf&uuml;hren. Au&szlig;erdem wird
 	ein neues Paket gebaut, &uuml;ber FTP&ndash;&nbsp;und
 	WWW-Spiegel verteilt und die unsichere Version damit
 	verdr&auml;ngt. <makevar>PORTREVISION</makevar> sollte
 	erh&ouml;ht werden&nbsp;&ndash;&nbsp;es sei denn,
 	<makevar>PORTREVISION</makevar> hat sich im Laufe der
 	Korrektur des Fehlers ge&auml;ndert. Das hei&szlig;t, Sie
 	sollten <makevar>PORTREVISION</makevar> erh&ouml;hen, wenn Sie
 	eine Korrektur hinzugef&uuml;gt haben. Sie sollten diese aber
 	nicht erh&ouml;hen, wenn Sie den Port auf die neueste Version
 	des Programms gebracht haben und <makevar>PORTREVISION
 	</makevar> somit schon ver&auml;ndert wurde. Bitte beachten
 	Sie den <link linkend="makefile-naming-revepoch">betreffenden
 	Abschnitt</link> f&uuml;r weitere Informationen.</para>
     </sect1>
 
     <sect1 id="security-notify">
       <title>Die Community informiert halten</title>
 
       <sect2 id="security-notify-vuxml-db">
 	<title>Die VuXML-Datenbank</title>
 
 	<para>Ein sehr wichtiger und dringender Schritt, den man
 	  unternehmen muss, sobald eine Sicherheitsl&uuml;cke entdeckt
 	  wurde, ist die Gemeinschaft der Anwender des Ports &uuml;ber
 	  die Gefahr zu informieren. Diese Benachrichtigung hat zwei
 	  Gr&uuml;nde. Erstens wird es sinnvoll sein, wenn die Gefahr
 	  wirklich so gro&szlig; ist, sofort Abhilfe zu schaffen,
 	  indem man z.B. den betreffenden Netzwerkdienst beendet oder
 	  den Port komplett deinstalliert, bis die L&uuml;cke
 	  geschlossen wurde. Und Zweitens pflegen viele Nutzer
 	  installierte Pakete nur gelegentlich zu aktualisieren. Sie
 	  werden aus der Mitteilung erfahren, dass Sie das Paket,
 	  sobald eine Korrektur verf&uuml;gbar ist, sofort
 	  aktualisieren <emphasis>m&uuml;ssen</emphasis>.</para>
 
 	<para>Angesichts der riesigen Zahl an Ports kann nicht
 	  f&uuml;r jeden Vorfall ein Sicherheitshinweis erstellt
 	  werden, ohne durch die Flut an Nachrichten die
 	  Aufmerksamkeit der Empf&auml;nger zu verlieren, im Laufe der
 	  Zeit kommt es so zu ernsten Problemen. Deshalb werden
 	  Sicherheitsl&uuml;cken von Ports in <ulink
 	  url="http://vuxml.freebsd.org/">der FreeBSD
 	  VuXML-Datenbank</ulink> aufgezeichnet. Das Team der
 	  Sicherheitsverantwortlichen beobachtet diese wegen
 	  Angelegenheiten, die Ihr Eingreifen erfordern.</para>
 
 	<para>Wenn Sie Committerrechte haben, k&ouml;nnen Sie die
 	  VuXML-Datenbank selbst aktualisieren. Auf diese Weise helfen
 	  Sie den Sicherheitsverantwortlichen und liefern die
 	  kritischen Informationen fr&uuml;hzeitig an die Community.
 	  Aber auch wenn Sie kein Committer sind und glauben, Sie
 	  haben eine au&szlig;ergew&ouml;hnlich schwerwiegende
 	  L&uuml;cke gefunden&nbsp;&ndash;&nbsp;egal
 	  welche&nbsp;&ndash;&nbsp;z&ouml;gern Sie bitte nicht die
 	  Sicherheitsverantwortlichen zu kontaktieren, wie es in den
 	  <ulink url="http://www.freebsd.org/security/#how"> FreeBSD
 	  Sicherheitsinformationen</ulink> beschrieben wird.</para>
 
 	<para>In Ordnung, Sie haben sich also f&uuml;r den
 	  schwierigen Weg entschieden. Wie vielleicht aus dem Titel
 	  hervorgeht, ist die VuXMl-Datenbank haupts&auml;chlich ein
 	  XML-Dokument. Die Quelldatei <filename>vuln.xml</filename>
 	  k&ouml;nnen Sie im Port <filename
 	  role="package">security/vuxml</filename> finden. Deshalb
 	  wird der komplette Pfadname <filename>
 	  <envar>PORTSDIR</envar>/security/vuxml/vuln.xml</filename>
 	  lauten.  Jedes Mal, wenn Sie eine Sicherheitsl&uuml;cke in
 	  einem Port entdecken, f&uuml;gen Sie bitte einen Eintrag
 	  daf&uuml;r in diese Datei ein. Solange Sie nicht mit VuXML
 	  vertraut sind, ist es das Beste, was Sie machen k&ouml;nnen,
 	  einen vorhandenen Eintrag, der zu Ihrem Fall passt, zu
 	  kopieren und als Vorlage zu verwenden.</para>
       </sect2>
 
       <sect2 id="security-notify-vuxml-intro">
 	<title>Eine kurze Einf&uuml;hrung in VuXML</title>
 
 	<para>Das komplette XML ist komplex und w&uuml;rde den
 	  Rahmen dieses Buches sprengen. Allerdings ben&ouml;tigen Sie
 	  f&uuml;r einen grundlegenden Einblick in die Struktur eines
 	  VuXML-Eintrags nur eine Vorstellung der Tags. XML-Tags
 	  bestehen aus Namen, die in spitzen Klammern eingeschlossen
 	  sind. Zu jedem &ouml;ffnenden &lt;Tag&gt; muss ein passendes
 	  &lt;/Tag&gt; existieren. Tags k&ouml;nnen geschachtelt
 	  werden. Wenn sie geschachtelt werden m&uuml;ssen die inneren
 	  Tags vor den &Auml;u&szlig;eren geschlossen werden. Es gibt
 	  eine Hierarchie von Tags&nbsp;&ndash;&nbsp;das hei&szlig;t
 	  komplexere Regeln zur Schachtelung. Klingt so &auml;hnlich
 	  wie HTML, oder? Der gr&ouml;&szlig;te Unterschied ist: XML
 	  ist erweiterbar
 	  (e<emphasis>X</emphasis>tensible)&nbsp;&ndash;&nbsp;das
 	  hei&szlig;t es basiert darauf ma&szlig;geschneiderte Tags zu
 	  definieren. Aufgrund seiner wesentlichen Struktur bringt
 	  XML ansonsten formlose Daten in eine bestimmte Form. VuXML
 	  ist speziell darauf zugeschnitten Beschreibungen von
 	  Sicherheitsl&uuml;cken zu verwalten.</para>
 
 	<para>Lassen Sie uns nun einen realistischen VuXML-Eintrag
 	  betrachten:</para>
 
 	<programlisting>&lt;vuln vid="f4bc80f4-da62-11d8-90ea-0004ac98a7b9"&gt; <co id="co-vx-vid">
   &lt;topic&gt;Several vulnerabilities found in Foo&lt;/topic&gt; <co id="co-vx-top">
   &lt;affects&gt;
     &lt;package&gt;
       &lt;name&gt;foo&lt;/name&gt; <co id="co-vx-nam">
       &lt;name&gt;foo-devel&lt;/name&gt;
       &lt;name&gt;ja-foo&lt;/name&gt;
       &lt;range&gt;&lt;ge&gt;1.6&lt;/ge&gt;&lt;lt&gt;1.9&lt;/lt&gt;&lt;/range&gt; <co id="co-vx-rng">
       &lt;range&gt;&lt;ge&gt;2.*&lt;/ge&gt;&lt;lt&gt;2.4_1&lt;/lt&gt;&lt;/range&gt;
       &lt;range&gt;&lt;eq&gt;3.0b1&lt;/eq&gt;&lt;/range&gt;
     &lt;/package&gt;
     &lt;package&gt;
       &lt;name&gt;openfoo&lt;/name&gt; <co id="co-vx-nm2">
       &lt;range&gt;&lt;lt&gt;1.10_7&lt;/lt&gt;&lt;/range&gt; <co id="co-vx-epo">
       &lt;range&gt;&lt;ge&gt;1.2,1&lt;/ge&gt;&lt;lt&gt;1.3_1,1&lt;/lt&gt;&lt;/range&gt;
     &lt;/package&gt;
   &lt;/affects&gt;
   &lt;description&gt;
     &lt;body xmlns="http://www.w3.org/1999/xhtml"&gt;
       &lt;p&gt;J. Random Hacker reports:&lt;/p&gt; <co id="co-vx-bdy">
       &lt;blockquote
         cite="http://j.r.hacker.com/advisories/1"&gt;
         &lt;p&gt;Several issues in the Foo software may be exploited
           via carefully crafted QUUX requests.  These requests will
           permit the injection of Bar code, mumble theft, and the
           readability of the Foo administrator account.&lt;/p&gt;
       &lt;/blockquote&gt;
     &lt;/body&gt;
   &lt;/description&gt;
   &lt;references&gt; <co id="co-vx-ref">
     &lt;freebsdsa&gt;SA-10:75.foo&lt;/freebsdsa&gt; <co id="co-vx-fsa">
     &lt;freebsdpr&gt;ports/987654&lt;/freebsdpr&gt; <co id="co-vx-fpr">
     &lt;cvename&gt;CAN-2010-0201&lt;/cvename&gt; <co id="co-vx-cve">
     &lt;cvename&gt;CAN-2010-0466&lt;/cvename&gt;
     &lt;bid&gt;96298&lt;/bid&gt; <co id="co-vx-bid">
     &lt;certsa&gt;CA-2010-99&lt;/certsa&gt; <co id="co-vx-cts">
     &lt;certvu&gt;740169&lt;/certvu&gt; <co id="co-vx-ctv">
     &lt;uscertsa&gt;SA10-99A&lt;/uscertsa&gt; <co id="co-vx-ucs">
     &lt;uscertta&gt;SA10-99A&lt;/uscertta&gt; <co id="co-vx-uct">
     &lt;mlist msgid="201075606@hacker.com"&gt;http://marc.theaimsgroup.com/?l=bugtraq&amp;amp;m=203886607825605&lt;/mlist&gt; <co id="co-vx-mls">
     &lt;url&gt;http://j.r.hacker.com/advisories/1&lt;/url&gt; <co id="co-vx-url">
   &lt;/references&gt;
   &lt;dates&gt;
     &lt;discovery&gt;2010-05-25&lt;/discovery&gt; <co id="co-vx-dsc">
     &lt;entry&gt;2010-07-13&lt;/entry&gt; <co id="co-vx-ent">
     &lt;modified&gt;2010-09-17&lt;/entry&gt; <co id="co-vx-mod">
   &lt;/dates&gt;
 &lt;/vuln&gt;</programlisting>
 
 	<para>Die Namen der Tags sollten selbsterkl&auml;rend sein
 	  &nbsp;&ndash;&nbsp;also werfen wir einen genaueren Blick auf
 	  die Felder, die Sie selbst ausf&uuml;llen
 	  m&uuml;ssen:</para>
 
 	<calloutlist>
 	  <callout arearefs="co-vx-vid">
 	    <para>Dies ist die h&ouml;chste Tag-Ebene eines
 	      VuXML-Eintrags. Es ist ein vorgeschriebenes Attribut
 	      <literal>vid</literal>, welches eine allgemein
 	      einzigartige Kennung (universally unique identifier,
 	      UUID) in Anf&uuml;hrungszeichen f&uuml;r diesen
 	      Eintrag festlegt.  Sie sollten eine UUID f&uuml;r
 	      jeden neuen VuXML-Eintrag erzeugen (und vergessen Sie
 	      nicht die UUID der Vorlage zu ersetzen, es sei denn,
 	      Sie schreiben den Eintrag von Grund auf selbst). Sie
 	      k&ouml;nnen &man.uuidgen.1; verwenden, um eine VuXML
 	      UUID zu erzeugen. Wahlweise k&ouml;nnen Sie, wenn Sie
 	      FreeBSD 4.x verwenden, den Port <filename
 	      role="package">devel/p5-Data-UUID </filename>
 	      verwenden und folgenden Befehl aufrufen:</para>
 
 	    <programlisting>perl -MData::UUID -le 'print lc new Data::UUID-&gt;create_str'</programlisting>
 	  </callout>
 
 	  <callout arearefs="co-vx-top">
 	    <para>Dies ist eine einzeilige Beschreibung des
 	      gefundenen Fehlers.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-nam">
 	    <para>Hier werden die Namen betroffener Pakete
 	      aufgef&uuml;hrt. Es k&ouml;nnen mehrere Namen
 	      angegeben werden, da mehrere Pakete von einem einzigen
 	      Master-Port oder Software-Produkt abh&auml;ngen
 	      k&ouml;nnen. Das schlie&szlig;t Stable&ndash;&nbsp;und
 	      Developement-Zweige, lokalisierte Versionen und
 	      Slave-Ports ein, die verschiedene
 	      Auswahlm&ouml;glichkeiten wichtiger
 	      Kompilierungszeit-Optionen bieten.</para>
 
 	    <important>
 	      <para>Es liegt in Ihrer Verantwortung all diese
 		betroffenen Pakete zu finden, wenn Sie den
 		VuXML-Eintrag schreiben.Behalten Sie im
 		Hinterkopf, dass <literal>make search
 		name=foo</literal> Ihr Freund ist. Die wichtigsten
 		Punkte, auf die Sie achten sollten, sind die
 		folgenden:</para>
 
 	      <itemizedlist>
 		<listitem>
 		  <para>die <filename>foo-devel</filename>
 		    Variante eines <filename>foo</filename>
 		    Ports;</para>
 		</listitem>
 
 		<listitem>
 		  <para>andere Varianten mit einem Suffix wie
 		    <literal> -a4</literal> (f&uuml;r
 		    Druck-betreffende Pakete),
 		    <literal>-without-gui</literal> (f&uuml;r Pakete
 		    mit deaktivierter X-Unterst&uuml;tzung) oder
 		    &auml;hnliche</para>
 		</listitem>
 
 		<listitem>
 		  <para><literal>jp-</literal>,
 		    <literal>ru-</literal>, <literal>zh-</literal>
 		    und andere, eventuell lokalisierte, Varianten in
 		    den entsprechenden L&auml;nderkategorien der
 		    Ports-Sammlung</para>
 		</listitem>
 	      </itemizedlist>
 	    </important>
 	  </callout>
 
 	  <callout arearefs="co-vx-rng">
 	    <para>Betroffene Versionen der Pakete werden hier als
 	      ein Bereich oder mehrere durch eine Kombination aus
 	      <literal>&lt;lt&gt;</literal>, <literal>&lt;le&gt;
 	      </literal>, <literal>&lt;eq&gt;</literal>, <literal>
 	      &lt;ge&gt;</literal>, und
 	      <literal>&lt;gt&gt;</literal>-Elementen ausgegeben.
 	      Die angegebenen Bereiche sollten sich nicht
 	      &uuml;berschneiden.</para>
 
 	    <para>In einer Bereichsangabe steht
 	      <literal>*</literal> (Asterisk) f&uuml;r die kleinste
 	      Versionsnummer. Insbesondere ist
 	      <literal>2.*</literal> kleiner als
 	      <literal>2.a</literal>. Deshalb kann ein Stern benutzt
 	      werden, um auf alle m&ouml;glichen <literal>Alpha
 	      </literal>-, <literal>Beta</literal>&ndash;&nbsp;und
 	      <literal>RC </literal>-Versionen zuzutreffen. Zum
 	      Beispiel passt
 	      <literal>&lt;ge&gt;2.*&lt;/ge&gt;&lt;lt&gt;3.*
 	      &lt;/lt&gt;</literal> auf alle Versionen der Form
 	      <literal>2.x</literal>, w&auml;hrend
 	      <literal>&lt;ge&gt;
 	      2.0&lt;/ge&gt;&lt;lt&gt;3.0&lt;/lt&gt;</literal> das
 	      nicht erf&uuml;llt, da es nicht auf <literal>2.r3
 	      </literal> passt, auf <literal>3.b</literal> aber
 	      schon.</para>
 
 	    <para>Das obige Beispiel legt fest, dass Versionen von
 	      <literal>1.6</literal> bis <literal>1.9</literal>
 	      betroffen sind&nbsp;&ndash;&nbsp;au&szlig;erdem
 	      Versionen <literal>2.x </literal> vor
 	      <literal>2.4_1</literal> und Version
 	      <literal>3.0b1</literal>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-nm2">
 	    <para>Mehrere zusammenh&auml;ngende Gruppen von
 	      Paketen (im wesentlichen Ports) k&ouml;nnen im
 	      Abschnitt <literal> &lt;affected&gt;</literal>
 	      aufgef&uuml;hrt werden. Das kann man benutzen, wenn
 	      sich Programme (sagen wir FooBar, FreeBar und OpenBar)
 	      denselben Quelltext als Grundlage haben und sich noch
 	      dessen Fehler und Sicherheitsl&uuml;cken teilen.
 	      Beachten Sie den Unterschied zum Anf&uuml;hren
 	      mehrerer Namen innerhalb eines &lt;package&gt;
 	      Abschnittes.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-epo">
 	    <para>Die Versionsbereiche sollten, wenn m&ouml;glich,
 	      sowohl <makevar>PORTEPOCH</makevar> als auch <makevar>
 	      PORTREVISION</makevar> erlauben. Bitte denken Sie
 	      daran, dass gem&auml;&szlig; der Vergleichsregeln eine
 	      Version mit einer <makevar>PORTEPOCH</makevar>, die
 	      nicht Null ist, gr&ouml;&szlig;er ist als jede Version
 	      ohne <makevar>PORTEPOCH</makevar>. Das hei&szlig;t,
 	      <literal> 3.0,1</literal> ist gr&ouml;&szlig;er als
 	      <literal>3.1 </literal> oder sogar
 	      <literal>8.9</literal>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-bdy">
 	    <para>Das ist die Zusammenfassung des Problems. In
 	      diesem Feld wird XHTML verwendet. Zumindest
 	      umschlie&szlig;ende <literal>&lt;p&gt;</literal> und
 	      <literal>&lt;/p&gt;</literal> sollten auftauchen.
 	      Komplexere Tags sind zwar m&ouml;glich, aber sollten
 	      nur um der Genauigkeit und Klarheit willen verwendet
 	      werden: Bitte verwenden Sie hier kein
 	      Eye-Candy.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-ref">
 	    <para>Dieser Abschnitt enth&auml;lt Verweise auf
 	      relevante Dokumente. Es wird empfohlen so viele
 	      Referenzen wie n&ouml;tig aufzuf&uuml;hren.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-fsa">
 	    <para>Das ist ein <ulink
 	      url="http://www.freebsd.org/security/#adv">FreeBSD
 	      Sicherheitshinweis</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-fpr">
 	    <para>Das ist ein <ulink
 	      url="http://www.freebsd.org/support.html#gnats">
 	      FreeBSD Problembericht</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-cve">
 	    <para>Das ist eine <ulink
 	      url="http://www.cve.mitre.org/">Mitre CVE</ulink>
 	      Kennung.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-bid">
 	    <para>Das ist eine <ulink
 	      url="http://www.securityfocus.com/bid">SecurityFocus
 	      Fehler-Kennung</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-cts">
 	    <para>Das ist ein Sicherheitshinweis von <ulink
 	      url="http://www.cert.org/">US-CERT</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-ctv">
 	    <para>Das ist eine Mitteilung &uuml;ber eine
 	      Schwachstelle von <ulink
 	      url="http://www.cert.org/">US-CERT</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-ucs">
 	    <para>Das ist ein Cyber-Sicherheitsalarm von <ulink
 	      url="http://www.cert.org/">US-CERT</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-uct">
 	    <para>Das ist ein technischer Cyber-Sicherheitsalarm
 	      von <ulink
 	      url="http://www.cert.org/">US-CERT</ulink>.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-mls">
 	    <para>Das ist eine URL zu einem archivierten Posting
 	      auf einer Mailingliste. Das Attribut
 	      <literal>msgid</literal> ist optional und gibt die
 	      Nachrichtenkennung des Postings an.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-url">
 	    <para>Das ist eine gew&ouml;hnliche URL. Sie sollte
 	      nur verwendet werden, wenn keine der anderen
 	      Referenzkategorien verf&uuml;gbar ist.</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-dsc">
 	    <para>Das ist das Datum, an dem die
 	      Sicherheitsl&uuml;cke bekannt wurde
 	      (<replaceable>JJJJ-MM-TT</replaceable>).</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-ent">
 	    <para>Das ist das Datum, an dem der Eintrag
 	      hinzugef&uuml;gt wurde
 	      (<replaceable>JJJJ-MM-TT</replaceable>).</para>
 	  </callout>
 
 	  <callout arearefs="co-vx-mod">
 	    <para>Das ist das Datum, an dem zuletzt irgendeine
 	      Information des Eintrags ver&auml;ndert wurde
 	      (<replaceable>JJJJ-MM-TT</replaceable>). Neue
 	      Eintr&auml;ge d&uuml;rfen dieses Feld nicht enthalten.
 	      Es sollte beim Editieren eines existierenden Eintrags
 	      eingef&uuml;gt werden.</para>
 	  </callout>
 	</calloutlist>
       </sect2>
 
       <sect2 id="security-notify-vuxml-testing">
 	<title>Ihre &Auml;nderungen an der VuXML-Datenbank
 	  testen</title>
 
 	<para>Nehmen wir an, Sie haben gerade einen Eintrag
 	  f&uuml;r eine Sicherheitsl&uuml;cke in dem Paket
 	  <literal>clamav</literal> geschrieben oder
 	  ausgef&uuml;llt, die in der Version
 	  <literal>0.65_7</literal> korrigiert wurde.</para>
 
 	<para>Als Voraussetzung sollten Sie eine neue Version der
 	  Ports <filename
 	  role="package">ports-mgmt/portaudit</filename> und
 	  <filename
 	  role="package">ports-mgmt/portaudit-db</filename>
 	  installieren.</para>
 
 	<para>Zuerst &uuml;berpr&uuml;fen Sie bitte, ob bereits
 	  ein Eintrag f&uuml;r diese Schwachstelle existiert. Wenn
 	  es einen solchen Eintrag gibt, sollte er auf die vorige
 	  Version <literal>0.65_6</literal> zutreffen:</para>
 
 	<screen>&prompt.user; <userinput>packaudit</userinput>
 &prompt.user; <userinput>portaudit clamav-0.65_6</userinput></screen>
 
 	<note>
 	  <para>Um <command>packaudit</command> auszuf&uuml;hren,
 	    m&uuml;ssen Sie die Berechtigung haben
 	    <filename><makevar>DATABASEDIR</makevar></filename> zu
 	    schreiben&nbsp;&ndash;&nbsp;&uuml;blicherweise ist das
 	    <filename>/var/db/portaudit</filename>.</para>
 	</note>
 
 	<para>Wenn keine vorhandenen Eintr&auml;ge gefunden werden
 	  haben Sie gr&uuml;nes Licht einen neuen Eintrag f&uuml;r
 	  diese Sicherheitsl&uuml;cke anzulegen. Sie k&ouml;nnen nun
 	  eine neue UUID erzeugen (wir nehmen an, diese lautet
 	  <literal>74a9541d-5d6c-11d8-80e3-0020ed76ef5a</literal>)
 	  und einen neuen Eintrag in der VuXML-Datenbank anlegen.
 	  Bitte &uuml;berpr&uuml;fen Sie danach die Syntax mit
 	  folgendem Befehl:</para>
 
 	<screen>&prompt.user; <userinput>cd ${PORTSDIR}/security/vuxml && make validate</userinput></screen>
 
 	<note>
 	  <para>Sie werden zumindest eines der folgenden Pakete
 	    ben&ouml;tigen: <filename
 	    role="package">textproc/libxml2</filename>, <filename
 	    role="package">textproc/jade</filename>.</para>
 	</note>
 
 	<para>Jetzt bauen Sie bitte die
 	  <command>portaudit</command>-Datenbank aus der VuXML-Datei
 	  neu:</para>
 
 	<screen>&prompt.user; <userinput>packaudit</userinput></screen>
 
 	<para>Um sicherzustellen, dass der Abschnitt
 	  <literal>&lt;affected&gt;</literal> Ihres Eintrags die
 	  richtigen Pakete betrifft, verwenden Sie bitte den
 	  folgenden Befehl:</para>
 
 	<screen>&prompt.user; <userinput>portaudit -f /usr/ports/INDEX -r 74a9541d-5d6c-11d8-80e3-0020ed76ef5a</userinput></screen>
 
 	<note>
 	  <para>Bitte lesen Sie in &man.portaudit.1; nach, um ein
 	    besseres Verst&auml;ndnis der Befehlssyntax zu
 	    entwickeln.</para>
 	</note>
 
 	<para>Bitte stellen Sie sicher, dass Ihr Eintrag keine
 	  falschen Treffer in der Ausgabe erzeugt.</para>
 
 	<para>Jetzt &uuml;berpr&uuml;fen Sie bitte, dass Ihr
 	  Eintrag die richtigen Versionen des Pakets angibt:</para>
 
 	<screen>&prompt.user; <userinput>portaudit clamav-0.65_6 clamav-0.65_7</userinput>
 Affected package: clamav-0.65_6 (matched by clamav&lt;0.65_7)
 Type of problem: clamav remote denial-of-service.
 Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-0020ed76ef5a.html&gt;
 
 1 problem(s) found.</screen>
 
 	<para>Offensichtlich sollte die erste Version ausgegeben
 	  werden&nbsp;&ndash;&nbsp;die zweite jedoch nicht.</para>
 
 	<para>Abschlie&szlig;end &uuml;berpr&uuml;fen Sie bitte,
 	  ob die Webseite, die aus der VuXML-Datenbank erzeugt wird,
 	  wie erwartet aussieht:</para>
 
 	<screen>&prompt.user; <userinput>mkdir -p ~/public_html/portaudit</userinput>
 &prompt.user; <userinput>packaudit</userinput>
 &prompt.user; <userinput>lynx ~/public_html/portaudit/74a9541d-5d6c-11d8-80e3-0020ed76ef5a.html</userinput></screen>
       </sect2>
     </sect1>
   </chapter>
 
   <chapter id="porting-dads">
     <title>Was man machen respektive vermeiden sollte</title>
 
     <sect1 id="dads-intro">
       <title>Einf&uuml;hrung</title>
 
       <para>Hier ist eine Liste von gebr&auml;uchlichen Dos and
 	Don'ts (Dinge, die man machen oder vermeiden sollte), welchen
 	Sie w&auml;hrend des Portierungsprozesses begegnen werden.
 	Sie sollten Ihren Port anhand dieser Liste
 	&uuml;berpr&uuml;fen. Sie k&ouml;nnen auch Ports in der <ulink
 	url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">PR
 	Datenbank</ulink>, welche andere Menschen eingereicht haben,
 	kontrollieren. Senden Sie bitte Kommentare zu Ports, die Sie
 	verifizieren wie unter <ulink
 	url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">Bug
 	Reports and General Commentary</ulink> beschrieben. Der
 	Abgleich von Ports aus der PR-Datenbank hilft uns diese
 	schneller zu committen, und zeigt auch, dass Sie wissen, worum
 	es geht.</para>
     </sect1>
 
     <sect1 id="porting-wrkdir">
       <title><makevar>WRKDIR</makevar></title>
 
       <para>Schreiben Sie in keine Dateien au&szlig;erhalb von
 	<makevar>WRKDIR</makevar>. <makevar>WRKDIR</makevar> ist der
 	einzige Ort, welcher w&auml;hrend des Erstellen des Ports
 	garantiert beschreibbar ist (siehe <ulink
 	url="&url.books.handbook;/ports-using.html#PORTS-CD"> Ports
 	Installieren von CDROM</ulink> f&uuml;r ein Beispiel, um Ports
 	in einem schreibgesch&uuml;tzen Zweig zu erstellen). Wenn Sie
 	eine der <filename>pkg-<replaceable>*</replaceable></filename>
 	Dateien modifizieren m&uuml;ssen, sollten Sie <link
 	linkend="porting-pkgfiles">eine Variable erneut
 	definieren</link>, anstatt die Datei zu
 	&uuml;berschreiben.</para>
     </sect1>
 
     <sect1 id="porting-wrkdirprefix">
       <title><makevar>WRKDIRPREFIX</makevar></title>
 
       <para>Vergewissern Sie sich, dass Ihr Port
 	<makevar>WRKDIRPREFIX</makevar> beachtet. Die meisten Ports
 	sollten sich dar&uuml;ber keine Sorgen machen. Beachten Sie
 	bitte, falls auf <makevar>WRKDIR</makevar> eines anderen Ports
 	verwiesen wird, dass die korrekte Position
 	<filename><makevar>WRKDIRPREFIX</makevar><makevar>PORTSDIR</makevar>/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>,
 	und nicht etwa
 	<filename><makevar>PORTSDIR</makevar>/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>,
 	<filename><makevar>.CURDIR</makevar>/../../<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
 	oder &auml;hnliches ist.</para>
 
       <para>Falls Sie <makevar>WRKDIR</makevar> selbst definieren,
 	sollten Sie sicherstellen, dass Sie
 	<literal>&dollar;{WRKDIRPREFIX}&dollar;{.CURDIR}</literal> am
 	Anfang anf&uuml;gen.</para>
     </sect1>
 
     <sect1 id="porting-versions">
       <title>Unterschiedliche Betriebssysteme und
 	Betriebssystemversionen</title>
 
       <para>Sie k&ouml;nnen auf Quelltext treffen, welcher
 	Modifizierungen oder bedingtes Kompilieren, abh&auml;ngig
 	davon, unter welcher Unix-Version er l&auml;uft,
 	ben&ouml;tigt.  Falls Sie &Auml;nderungen an solch einem
 	Quelltext vornehmen m&uuml;ssen, stellen Sie bitte sicher,
 	dass Sie Ihre &Auml;nderungen so allgemein wie m&ouml;glich
 	halten, damit wir den Quelltext auf &auml;ltere
 	FreeBSD-Systeme portieren und zur Quer-Portierung auf andere
 	BSD-Systeme, wie etwa 4.4BSD von CSRG, BSD/386, 386BSD, NetBSD
 	und OpenBSD verwenden k&ouml;nnen.</para>
 
       <para>Der bevorzugte Weg, um 4.3BSD/Reno (1990) und neuere
 	Versionen des BSD-Quelltextes zu unterscheiden, ist das
 	<literal>BSD</literal>-Makro zu nutzen, welches in <ulink
 	url="http://cvsweb.freebsd.org/src/sys/sys/param.h">sys/param.h</ulink>
 	definiert ist. Hoffentlich ist diese Datei schon
 	enthalten&nbsp;&ndash;&nbsp;falls nicht, so f&uuml;gen Sie
 	folgenden Quelltext:</para>
 
       <programlisting>#if (defined(__unix__) || defined(unix)) &amp;&amp; !defined(USG)
 #include &lt;sys/param.h&gt;
 #endif</programlisting>
 
       <para>an der richtigen Stelle in der <filename>.c</filename>
 	Datei hinzu. Wir glauben, dass jedes System, welches diese
 	beiden Symbole definiert, die Datei
 	<filename>sys/param.h</filename> besitzt. Wenn Sie auf
 	Systeme sto&szlig;en, wo dies nicht so ist, w&uuml;rden wir
 	gerne davon erfahren. Bitte senden Sie eine E-Mail an
 	&a.ports;.</para>
 
       <para>Eine andere M&ouml;glichkeit zur Unterscheidung ist der
 	GNU Autoconf-Stil:</para>
 
       <programlisting>#ifdef HAVE_SYS_PARAM_H
 #include &lt;sys/param.h&gt;
 #endif</programlisting>
 
       <para>Vergessen Sie nicht
 	<literal>-DHAVE_SYS_PARAM_H</literal> zu den
 	<makevar>CFLAGS</makevar> im <filename>Makefile</filename>
 	hinzuzuf&uuml;gen, falls Sie diese Methode benutzen
 	sollten.</para>
 
       <para>Sobald Sie <filename>sys/param.h</filename>
 	hinzugef&uuml;gt haben, k&ouml;nnen Sie mit Hilfe von</para>
 
       <programlisting>#if (defined(BSD) &amp;&amp; (BSD &gt;= 199103))</programlisting>
 
       <para>unterscheiden, ob der Quelltext auf einer 4.3 Net2
 	Code-Basis oder neuer (z.B. FreeBSD 1.x, 4.3/Reno, NetBSD 0.9,
 	386BSD, BSD/386 1.1 und niedriger) kompiliert werden
 	wird.</para>
 
       <para>Benutzen Sie:</para>
 
       <programlisting>#if (defined(BSD) &amp;&amp; (BSD &gt;= 199306))</programlisting>
 
       <para>um zu differenzieren, ob der Quelltext auf der Basis von
 	4.4 Code oder neuer (z.B. FreeBSD 2.x, 4.4, NetBSD 1.0,
 	BSD/386 2.0 oder h&ouml;her) kompiliert werden wird.</para>
 
       <para>Der Wert des <literal>BSD</literal>-Makros ist
 	<literal>199506</literal> f&uuml;r die 4.4BSD-Lite2 Codebasis.
 	Beachten Sie bitte, dass dies hier nur der Information wegen
 	angegeben ist. Das Makro sollte nicht dazu benutzt werden, um
 	zwischen Versionen von FreeBSD, welche auf 4.4-Lite basieren,
 	und Versionen, welche &Auml;nderungen von 4.4-Lite2
 	&uuml;bernommen haben, zu unterscheiden. Das
 	<literal>__FreeBSD__</literal> Makro sollte stattdessen
 	verwandt werden.</para>
 
       <para>Sparsam sollte eingesetzt werden:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para><literal>__FreeBSD__</literal> ist in allen Versionen
 	    von FreeBSD definiert. Benutzen Sie dieses Makro, falls
 	    die &Auml;nderung(en), die Sie machen,
 	    <emphasis>nur</emphasis> FreeBSD betrifft.
 	    Portierungsfallen, wie der Gebrauch von
 	    <literal>sys_errlist[]</literal> gegen&uuml;ber
 	    <function>strerror()</function> sind Berkeley-Eigenheiten,
 	    keine FreeBSD &Auml;nderungen.</para>
 	</listitem>
 
 	<listitem>
 	  <para>In FreeBSD 2.x, ist <literal>__FreeBSD__</literal>
 	    auf <literal>2</literal> definiert. In &auml;lteren
 	    Versionen, ist es <literal>1</literal>. Alle sp&auml;teren
 	    Versionen erh&ouml;hen es, damit es mit der
 	    Haupt-Versionsnummer &uuml;bereinstimmt.</para>
 	</listitem>
 
 	<listitem>
 	  <para>Falls Sie zwischen einem FreeBSD 1.x und einem
 	    FreeBSD 2.x (oder h&ouml;her) System unterscheiden
 	    m&uuml;ssen, ist es normalerweise richtig, die
 	    <literal>BSD</literal>-Makros (wie oben beschrieben) zu
 	    benutzen. Gibt es tats&auml;chlich eine
 	    FreeBSD-spezifische &Auml;nderung (wie z.B. spezielle
 	    Optionen von Shared-Libraries f&uuml;r
 	    <command>ld</command>), ist es nicht zu beanstanden
 	    <literal>__FreeBSD__</literal> und <literal>#if
 	    __FreeBSD__ &gt; 1</literal> zu nutzen, um FreeBSD 2.x und
 	    sp&auml;tere Systeme zu erkennen. Falls Sie eine
 	    h&ouml;here Genauigkeit ben&ouml;tigen, um FreeBSD Systeme
 	    seit 2.0-RELEASE zu erkennen, k&ouml;nnen Sie folgendes
 	    nutzen:</para>
 
 	  <programlisting>#if __FreeBSD__ &gt;= 2
 #include &lt;osreldate.h&gt;
 #    if __FreeBSD_version &gt;= 199504
 	 /* 2.0.5+ release specific code here */
 #    endif
 #endif</programlisting>
 	</listitem>
       </itemizedlist>
 
       <para>In den Tausenden von Ports, die bis jetzt erstellt
 	wurden, gab es nur ein oder zwei F&auml;lle, in denen
 	<literal>__FreeBSD__</literal> h&auml;tte benutzt werden
 	sollen.  Nur weil ein fr&uuml;herer Port es an der falschen
 	Stelle benutzt hatte, bedeutet das nicht, dass Sie dies auch
 	machen sollten.</para>
     </sect1>
 
     <sect1 id="freebsd-versions">
       <title>__FreeBSD_version Werte</title>
 
       <para>Hier ist eine praktische Liste von
 	<literal>__FreeBSD_version</literal>-Werten wie in <ulink
 	url="http://cvsweb.freebsd.org/src/sys/sys/param.h">sys/param.h</ulink>
 	definiert:</para>
 
       <table frame="none">
 	<title>__FreeBSD_version-Werte</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Release</entry>
 	      <entry><literal>__FreeBSD_version</literal></entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>2.0-RELEASE</entry>
 	      <entry>119411</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.1-CURRENT</entry>
 	      <entry>199501, 199503</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.0.5-RELEASE</entry>
 	      <entry>199504</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-CURRENT vor 2.1</entry>
 	      <entry>199508</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.1.0-RELEASE</entry>
 	      <entry>199511</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-CURRENT vor 2.1.5</entry>
 	      <entry>199512</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.1.5-RELEASE</entry>
 	      <entry>199607</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-CURRENT vor 2.1.6</entry>
 	      <entry>199608</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.1.6-RELEASE</entry>
 	      <entry>199612</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.1.7-RELEASE</entry>
 	      <entry>199612</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-RELEASE</entry>
 	      <entry>220000</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2.1-RELEASE</entry>
 	      <entry>220000 (keine &Auml;nderung)</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach 2.2.1-RELEASE</entry>
 	      <entry>220000 (keine &Auml;nderung)</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach texinfo-3.9</entry>
 	      <entry>221001</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach top</entry>
 	      <entry>221002</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2.2-RELEASE</entry>
 	      <entry>222000</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach 2.2.2-RELEASE</entry>
 	      <entry>222001</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2.5-RELEASE</entry>
 	      <entry>225000</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach 2.2.5-RELEASE</entry>
 	      <entry>225001</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach der Aufnahme von ldconfig -R</entry>
 	      <entry>225002</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2.6-RELEASE</entry>
 	      <entry>226000</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2.7-RELEASE</entry>
 	      <entry>227000</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach 2.2.7-RELEASE</entry>
 	      <entry>227001</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach &man.semctl.2; &Auml;nderung</entry>
 	      <entry>227002</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2.8-RELEASE</entry>
 	      <entry>228000</entry>
 	    </row>
 
 	    <row>
 	      <entry>2.2-STABLE nach 2.2.8-RELEASE</entry>
 	      <entry>228001</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-CURRENT vor &man.mount.2; &Auml;nderung</entry>
 	      <entry>300000</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-CURRENT nach &man.mount.2; &Auml;nderung</entry>
 	      <entry>300001</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-CURRENT nach &man.semctl.2; &Auml;nderung</entry>
 	      <entry>300002</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-CURRENT nach ioctl arg &Auml;nderungen</entry>
 	      <entry>300003</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-CURRENT nach ELF-Konvertierung</entry>
 	      <entry>300004</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-RELEASE</entry>
 	      <entry>300005</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-CURRENT nach 3.0-RELEASE</entry>
 	      <entry>300006</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.0-STABLE nach 3/4 Zweig</entry>
 	      <entry>300007</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.1-RELEASE</entry>
 	      <entry>310000</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.1-STABLE nach 3.1-RELEASE</entry>
 	      <entry>310001</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.1-STABLE nach &Auml;nderung der C++
 		Konstruktor/Destruktor-Reihenfolge</entry>
 	      <entry>310002</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.2-RELEASE</entry>
 	      <entry>320000</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.2-STABLE</entry>
 	      <entry>320001</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.2-STABLE nach bin&auml;r-inkompatibler IPFW und
 		Socket-&Auml;nderungen</entry>
 	      <entry>320002</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.3-RELEASE</entry>
 	      <entry>330000</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.3-STABLE</entry>
 	      <entry>330001</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.3-STABLE nach Hinzuf&uuml;gen von &man.mkstemp.3;
 		zur libc</entry>
 	      <entry>330002</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.4-RELEASE</entry>
 	      <entry>340000</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.4-STABLE</entry>
 	      <entry>340001</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.5-RELEASE</entry>
 	      <entry>350000</entry>
 	    </row>
 
 	    <row>
 	      <entry>3.5-STABLE</entry>
 	      <entry>350001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach 3.4 Zweig</entry>
 	      <entry>400000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach der &Auml;nderung im Verhalten des
 		dynamischen Linkers.</entry>
 	      <entry>400001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach &Auml;nderung der C++
 		Konstruktor/Destruktor Reihenfolge.</entry>
 	      <entry>400002</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach funktionierendem &man.dladdr.3;.</entry>
 	      <entry>400003</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach der __deregister_frame_info
 		Fehlerbehebung f&uuml;r den dynamischen Linker (auch
 		4.0-CURRENT nach EGCS 1.1.2 Integration).</entry>
 	      <entry>400004</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach &man.suser.9; API &Auml;nderung
 		(auch 4.0-CURRENT nach newbus).</entry>
 	      <entry>400005</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach &Auml;nderung der
 	 	cdevsw-Registrierung.</entry>
 	      <entry>400006</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach Hinzuf&uuml;gen von so_cred
 		f&uuml;r Zugangsberechtigungen auf Socket-Ebene.</entry>
 	      <entry>400007</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach Hinzuf&uuml;gen eines poll
 		Syscall-Wrappers zur libc_r.</entry>
 	      <entry>400008</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach der &Auml;nderung des Kernel
 		<literal>dev_t</literal>-Typs zum <literal>struct
 		specinfo</literal>-Zeiger.</entry>
 	      <entry>400009</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach dem Beseitigen eines Fehlers in
 		&man.jail.2;.</entry>
 	      <entry>400010</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach der <literal>sigset_t</literal>
 	  	Datentyp &Auml;nderung.</entry>
 	      <entry>400011</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach dem Wechsel zum GCC
 	 	2.95.2-Compiler.</entry>
 	      <entry>400012</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach Hinzuf&uuml;gen der erweiterbaren
 		Linux Mode ioctl-Routinen.</entry>
 	      <entry>400013</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach dem OpenSSL-Import.</entry>
 	      <entry>400014</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach der C++ ABI &Auml;nderung in GCC
 		2.95.2 von -fvtable-thunks zu -fno-vtable-thunks als
 		Standard.</entry>
 	      <entry>400015</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-CURRENT nach OpenSSH-Import.</entry>
 	      <entry>400016</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-RELEASE</entry>
 	      <entry>400017</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-STABLE nach 4.0-RELEASE</entry>
 	      <entry>400018</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-STABLE nach der Einf&uuml;hrung von
 		verz&ouml;gerten Pr&uuml;fsummen.</entry>
 	      <entry>400019</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-STABLE nach dem Einpflegen des
 	  	libxpg4-Quelltextes in die libc.</entry>
 	      <entry>400020</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.0-STABLE nach der Aktualisierung von Binutils auf
 		2.10.0, &Auml;nderungen der bin&auml;ren ELF-Markierungen,
 		Aufnahme von tcsh ins Basissystem.</entry>
 	      <entry>400021</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.1-RELEASE</entry>
 	      <entry>410000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.1-STABLE nach 4.1-RELEASE</entry>
 	      <entry>410001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.1-STABLE nachdem &man.setproctitle.3; von der
 	 	libutil in die libc verschoben wurde.</entry>
 	      <entry>410002</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.1.1-RELEASE</entry>
 	      <entry>411000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.1.1-STABLE nach 4.1.1-RELEASE</entry>
 	      <entry>411001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.2-RELEASE</entry>
 	      <entry>420000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.2-STABLE nach Kombinaion von libgcc.a und
 		libgcc_r.a und zugeh&ouml;rigen &Auml;nderungen der
 		GCC-Bindungen.</entry>
 	      <entry>420001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.3-RELEASE</entry>
 	      <entry>430000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.3-STABLE nach der Einf&uuml;hrung von
 		wint_t.</entry>
 	      <entry>430001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.3-STABLE nach dem Einpflegen der PCI
 		Stromstatus-API.</entry>
 	      <entry>430002</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.4-RELEASE</entry>
 	      <entry>440000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.4-STABLE nach der Einf&uuml;hrung von
 		d_thread_t.</entry>
 	      <entry>440001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.4-STABLE nach den &Auml;nderungen der
 		mount-Struktur (betrifft Dateisystem-Kernelmodule).
 	    </entry>
 	      <entry>440002</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.4-STABLE nachdem die Userland-Komponenten von
 		smbfs importiert worden sind.</entry>
 	      <entry>440003</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.5-RELEASE</entry>
 	      <entry>450000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.5-STABLE nach der Umbenennung von Elementen der
 		USB-Struktur.</entry>
 	      <entry>450001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.5-STABLE nachdem die
 		<literal>sendmail_enable</literal> &man.rc.conf.5;
 		Variable ge&auml;ndert worden ist, um den Wert
 		<literal>NONE</literal> zu akzeptieren.  </entry>
 	      <entry>450004</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.5-STABLE nachdem XFree86 4 als Standard zum Bauen
 		der Pakete benutzt wird.</entry>
 	      <entry>450005</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.5-STABLE nach dem Reparieren des Empfangsfilters,
 		welcher anf&auml;llig f&uuml;r einfache DoS-Attacken
 		war.</entry>
 	      <entry>450006</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.6-RELEASE</entry>
 	      <entry>460000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.6-STABLE &man.sendfile.2; repariert, um mit der
 		Dokumentation &uuml;bereinzustimmen, und nicht mehr die
 		Anzahl der gesendeten Header mit der Anzahl der Daten,
 		welche aus der Datei geschickt werden, gegenzurechnen.</entry>
 	      <entry>460001</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.6.2-RELEASE</entry>
 	      <entry>460002</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.6-STABLE</entry>
 	      <entry>460100</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.6-STABLE nach dem Einflie&szlig;en von `sed -i' aus
 	 	CURRENT.</entry>
 	      <entry>460101</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.6-STABLE nach dem Einflie&szlig;en von vielen
 		neuen pkg_install-Funktionen aus HEAD (HEAD = die
 		aktuellste und letzte Version des
 		Quellverzeichnisbaumes).</entry>
 	      <entry>460102</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.7-RELEASE</entry>
 	      <entry>470000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.7-STABLE</entry>
 	      <entry>470100</entry>
 	    </row>
 
 	    <row>
 	      <entry>Beginn von generierten __std{in,out,err}p
 		Referenzen statt  __sF. Dies &auml;ndert std{in,out,err}
 		von einem Ausdruck w&auml;hrend des Kompilierens zu einem
 		Laufzeitausdruck.</entry>
 	      <entry>470101</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.7-STABLE nach dem Einfliessen von
 		mbuf-&Auml;nderungen, um m_aux mbufs mit denen von m_tag
 		zu ersetzen</entry>
 	      <entry>470102</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.7-STABLE erh&auml;lt OpenSSL 0.9.7</entry>
 	      <entry>470103</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.8-RELEASE</entry>
 	      <entry>480000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.8-STABLE</entry>
 	      <entry>480100</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.8-STABLE nachdem &man.realpath.3; Thread-sicher
 		gemacht wurde.</entry>
 	      <entry>480101</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.8-STABLE &Auml;nderung der 3ware-API in twe.</entry>
 	      <entry>480102</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.9-RELEASE</entry>
 	      <entry>490000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.9-STABLE</entry>
 	      <entry>490100</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.9-STABLE nachdem e_sid zu der Struktur
 		kinfo_eproc hinzugef&uuml;gt wurde.</entry>
 	      <entry>490101</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.9-STABLE nach dem Einfliessen der
 		libmap-Funktionalit&auml;t f&uuml;r rtld.</entry>
 	      <entry>490102</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.10-RELEASE</entry>
 	      <entry>491000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.10-STABLE</entry>
 	      <entry>491100</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.10-STABLE nach dem Einfliessen von Revision
 		20040629 der Paket-Werkzeuge aus CURRENT.</entry>
 	      <entry>491101</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.10-STABLE nach der Fehlerbehebung in der VM, um
 		das Freigeben von fiktiven Speicherseiten korrekt zu
 		handhaben.</entry>
 	      <entry>491102</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.11-RELEASE</entry>
 	      <entry>492000</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.11-STABLE</entry>
 	      <entry>492100</entry>
 	    </row>
 
 	    <row>
 	      <entry>4.11-STABLE nach dem Hinzuf&uuml;gen von
 		libdata/ldconfig Verzeichnissen zu den
 		mtree-Dateien.</entry>
 	      <entry>492101</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT</entry>
 	      <entry>500000</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach Hinzuf&uuml;gen von
 		zus&auml;tzlichen Feldern in den ELF-Headern und
 		&Auml;ndern der Methode zur ELF-Markierung von
 		Bin&auml;rdateien.</entry>
 	      <entry>500001</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach kld-Metadaten
 		&Auml;nderungen.</entry>
 	      <entry>500002</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach buf/bio &Auml;nderungen.</entry>
 	      <entry>500003</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach binutils Aktualisierung.</entry>
 	      <entry>500004</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Einfliessen des libxpg4
 		Quelltextes in die libc und der Einf&uuml;hrung der
 		TASKQ-Schnittstelle.</entry>
 	      <entry>500005</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Hinzuf&uuml;gen der
 	 	AGP-Schnittstellen.</entry>
 	      <entry>500006</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Aktualisierung von Perl auf
 		Version 5.6.0.</entry>
 	      <entry>500007</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Aktualisierung des
 		KAME-Quelltextes zu den 2000/07-Quellen.</entry>
 	      <entry>500008</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach ether_ifattach() und
 		ether_ifdetach() &Auml;nderungen.</entry>
 	      <entry>500009</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die mtree-Standards zur&uuml;ck
 		zur urspr&uuml;nglichen Variante ge&auml;ndert wurden; -L
 		hinzugef&uuml;gt, um Symlinks zu folgen.</entry>
 	      <entry>500010</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die kqueue-API ge&auml;ndert
 		worden ist.</entry>
 	      <entry>500011</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem &man.setproctitle.3; von
 		libutil nach libc verschoben worden ist.</entry>
 	      <entry>500012</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem ersten SMPng-Commit.</entry>
 	      <entry>500013</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem &lt;sys/select.h&gt; nach
 		&lt;sys/selinfo.h&gt; verschoben worden ist.</entry>
 	      <entry>500014</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Kombinieren von libgcc.a und
 		libgcc_r.a und damit verbundene &Auml;nderungen an
 		GCC-Bindungen.</entry>
 	      <entry>500015</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der &Auml;nderung das
 		Zusammenbinden von libc und libc_r zu erlauben, womit die
 		-pthread Option veraltet ist.</entry>
 	      <entry>500016</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Umschalten von struct ucred zu
 		struct xucred, um die vom Kernel exportierte API f&uuml;r
 		mount u.a.zu stabilisieren.</entry>
 	      <entry>500017</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Hinzuf&uuml;gen der CPUTYPE
 		make Variable zum Kontrollieren von CPU-spezifischen
 		Optimierungen.</entry>
 	      <entry>500018</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Verschieben von
 		machine/ioctl_fd.h nach sys/fdcio.h</entry>
 	      <entry>500019</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Umbenennung der
 		locale-Namen.</entry>
 	      <entry>500020</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Bzip2-Import. Kennzeichnet
 		auch, dass S/Key entfernt wurde.</entry>
 	      <entry>500021</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach SSE Unterst&uuml;tzung.</entry>
 	      <entry>500022</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach KSE-Meilenstein 2.</entry>
 	      <entry>500023</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach d_thread_t, und nachdem UUCP in
 		die Ports verschoben worden ist.</entry>
 	      <entry>500024</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach &Auml;nderungen in der ABI bei der
 		Weitergabe von Deskriptoren und Berechtigungen auf 64 Bit
 		Plattformen.</entry>
 	      <entry>500025</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem XFree86 4 als Standard zum
 		Erstellen der Pakete benutzt wird und die neue libc
 		strnstr()-Funktion hinzugef&uuml;gt wurde.</entry>
 	      <entry>500026</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die neue libc
 		strcasestr()-Funktion hinzugef&uuml;gt wurde.</entry>
 	      <entry>500027</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die Userland-Komponenten von
 		smbfs importiert wurden.</entry>
 	      <entry>500028</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die neuen C99-Ganzzahlen mit
 		spezifischer Breite hinzugef&uuml;gt wurden.</entry>
 	      <entry>(Nicht hochgez&auml;hlt.)</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem eine &Auml;nderung im
 		R&uuml;ckgabewert von &man.sendfile.2; gemacht
 		wurde.</entry>
 	      <entry>500029</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Einf&uuml;hrung des Types
 		<literal>fflags_t</literal>, welches die passende
 		Gr&ouml;&szlig;e f&uuml;r Dateiflags hat.</entry>
 	      <entry>500030</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Umbenennung der USB
 	 	elements-Struktur.</entry>
 	      <entry>500031</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Einf&uuml;hrung von Perl
 		5.6.1.</entry>
 	      <entry>500032</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die
 		<literal>sendmail_enable</literal> &man.rc.conf.5;
 		Variable ge&auml;ndert worden ist, um den Wert
 		<literal>NONE</literal> zu akzeptieren.</entry>
 	      <entry>500033</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem mtx_init() einen dritten
 		Parameter entgegen nimmt.</entry>
 	      <entry>500034</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT mit GCC 3.1.</entry>
 	      <entry>500035</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT ohne Perl in /usr/src</entry>
 	      <entry>500036</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Hinzuf&uuml;gen von
 		&man.dlfunc.3;</entry>
 	      <entry>500037</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem die Typen von einigen Elementen
 		der sockbuf-Struktur ge&auml;ndert wurden und nachdem die
 		Struktur neu geordnet wurde.</entry>
 	      <entry>500038</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem GCC 3.2.1 Import. Und auch
 		nachdem die Header nicht mehr _BSD_FOO_T_ sondern
 		_FOO_T_DECLARED benutzen. Dieser Wert kann auch als
 		konservative Sch&auml;tzung f&uuml;r den Beginn der
 		Unterst&uuml;tzung des &man.bzip2.1; Pakets verwendet
 		werden.</entry>
 	      <entry>500039</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem verschiedene &Auml;nderungen an
 		Plattenfunktionen gemacht wurden, um die Anh&auml;ngigkeit
 		von Interna der disklabel-Struktur zu entfernen.</entry>
 	      <entry>500040</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Hinzuf&uuml;gen von
 		&man.getopt.long.3; zur libc.</entry>
 	      <entry>500041</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der Aktualisierung von Binutils
 		auf 2.13, bei denen die FreeBSD-Emulation, vec und das
 		Ausgabeformat ge&auml;ndert wurden.</entry>
 	      <entry>500042</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Hinzuf&uuml;gen schwacher
 		pthread_XXX Stubs zur libc, womit libXThrStub.so veraltet
 		ist. 5.0-RELEASE.</entry>
 	      <entry>500043</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach dem Erstellen des
 		RELENG_5_0-Zweiges</entry>
 	      <entry>500100</entry>
 	    </row>
 
 	    <row>
 	      <entry>&lt;sys/dkstat.h&gt; ist leer und sollte nicht
 	  	inkludiert werden.</entry>
 	      <entry>500101</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der &Auml;nderung in der
 	 	d_mmap_t-Schnittstelle.</entry>
 	      <entry>500102</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem taskqueue_swi ge&auml;dert
 	  	wurde, um ohne Giant zu arbeiten, und taskqueue_swi_giant
 	  	hinzugef&uuml;gt wurde, um Giant zu verwenden.</entry>
 	      <entry>500103</entry>
 	    </row>
 
 	    <row>
 	      <entry>cdevsw_add() und cdevsw_remove() gibt es nicht
 		l&auml;nger. Auftauchen der
 		MAJOR_AUTO-Allokationsm&ouml;glichkeit.</entry>
 	      <entry>500104</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der neuen
 	 	cdevsw-Initialisierungsmethode.</entry>
 	      <entry>500105</entry>
 	    </row>
 
 	    <row>
 	      <entry>devstat_add_entry() wurde durch
 		devstat_new_entry() ersetzt.</entry>
 	      <entry>500106</entry>
 	    </row>
 
 	    <row>
 	      <entry>Devstat Schnittstellen&auml;nderung; siehe
 		sys/sys/param.h 1.149.</entry>
 	      <entry>500107</entry>
 	    </row>
 
 	    <row>
 	      <entry>Token-Ring Schnittstellen&auml;nderungen.</entry>
 	      <entry>500108</entry>
 	    </row>
 
 	    <row>
 	      <entry>Hinzuf&uuml;gen von vm_paddr_t.</entry>
 	      <entry>500109</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem &man.realpath.3;
 		Thread-sicher gemacht wurde.</entry>
 	      <entry>500110</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nachdem &man.usbhid.3; mit
 		NetBSD synchronisiert wurde.</entry>
 	      <entry>500111</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach der neuen NSS Implementierung
 		und Hinzuf&uuml;gen der POSIX.1 getpw*_r, getgr*_r
 		Funktionen.</entry>
 	      <entry>500112</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.0-CURRENT nach Entfernen des alten
 		rc-Systems.</entry>
 	      <entry>500113</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-RELEASE.</entry>
 	      <entry>501000</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nach dem Erstellen des RELENG_5_1
 	  	Zweiges.</entry>
 	      <entry>501100</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem die Semantik von
 		sigtimedwait(2) and sigwaitinfo(2) korrigiert
 		wurden.</entry>
 	      <entry>501101</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nach dem Hinzuf&uuml;gen der lockfunc und
 		lockfuncarg-Felder zu &man.bus.dma.tag.create.9;.</entry>
 	      <entry>501102</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nach der Integration des GCC 3.3.1-pre
 	  	20030711 Snapshots.</entry>
 	      <entry>501103</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT 3ware-API &Auml;nderungen in twe.</entry>
 	      <entry>501104</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT Unterst&uuml;tzung von dynamisch
 		gebundenen /bin und /sbin und Verschieben von Bibliotheken
 		nach /lib.</entry>
 	      <entry>501105</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem im Kernel Unterst&uuml;tzung
 		f&uuml;r Coda 6.x hinzugef&uuml;gt wurden.</entry>
 	      <entry>501106</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem die 16550 UART-Konstanten von
 		<filename>&lt;dev/sio/sioreg.h&gt;</filename> nach
 		<filename>&lt;dev/ic/ns16550.h&gt;</filename> verschoben
 		wurden. Und nachdem die libmap Funktionalit&auml;t
 		vorbehaltlos vom rtld unterst&uuml;tzt wurde.</entry>
 	      <entry>501107</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nach Aktualisierung der PFIL_HOOKS API.</entry>
 	      <entry>501108</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem kiconv(3) hinzugef&uuml;gt
 		wurde.</entry>
 	      <entry>501109</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem der standardm&auml;&szlig;ige
 		Ablauf von open und close in cdevsw ge&auml;ndert
 		wurde.</entry>
 	      <entry>501110</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem das Layout von cdevsw
 		ge&auml;ndert wurde.</entry>
 	      <entry>501111</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nach dem Hinzuf&uuml;gen von
 		Mehrfachvererbung in kobj.</entry>
 	      <entry>501112</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nach der if_xname &Auml;nderung in der
 	 	Struktur ifnet</entry>
 	      <entry>501113</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.1-CURRENT nachdem /bin und /sbin ge&auml;ndert
 		wurden, um sie dynamisch zu binden.</entry>
 	      <entry>501114</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-RELEASE</entry>
 	      <entry>502000</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2.1-RELEASE</entry>
 	      <entry>502010</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Erstellen des RELENG_5_2-Zweiges.</entry>
 	      <entry>502100</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem die
 		__cxa_atexit/__cxa_finalize Funktionen zur libc
 		hinzugef&uuml;gt wurden.</entry>
 	      <entry>502101</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem die Standard-Thread Bibliothek
 		von libc_r zu libpthread ge&auml;ndert wurde.</entry>
 	      <entry>502102</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Ger&auml;tetreiber API
 		Megapatch.</entry>
 	      <entry>502103</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem getopt_long_only()
 		hinzugef&uuml;gt wurde.</entry>
 	      <entry>502104</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem NULL f&uuml;r C in ((void *)0)
 		ge&auml;ndert wurde, was mehr Warnungen erzeugt.</entry>
 	      <entry>502105</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem pf beim Bauen und Installieren
 		mit eingebunden wird.</entry>
 	      <entry>502106</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem time_t auf der sparc64-Plattform
 		in einen 64-bit Wert ge&auml;ndert wurde.</entry>
 	      <entry>502107</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem sich die Unterst&uuml;tzung
 		f&uuml;r den Intel C/C++-Compiler in einigen Headern und
 		execve(2) ge&auml;ndert hat, um sich strikter an POSIX zu
 		halten.</entry>
 	      <entry>502108</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach der Einf&uuml;hrung der
 		bus_alloc_resource_any API</entry>
 	      <entry>502109</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Hinzuf&uuml;gen von UTF-8
 		locales</entry>
 	      <entry>502110</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Entfernen der getvfsent(3)
 		API</entry>
 	      <entry>502111</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Hinzuf&uuml;gen der .warning
 		Directive f&uuml;r make.</entry>
 	      <entry>502112</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem ttyioctl() zwingend erforderlich
 		f&uuml;r serielle Treiber gemacht wurde.</entry>
 	      <entry>502113</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Import des
 		ALTQ-Frameworks.</entry>
 	      <entry>502114</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem sema_timedwait(9) ge&auml;ndert
 		wurde, 0 bei Erfolg und einen von 0 verschiedenen
 		Fehlercode im Falle eines Fehlers
 		zur&uuml;ckzuliefern.</entry>
 	      <entry>502115</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem &Auml;ndern der Kernel
 		Struktur dev_t, in ein Zeiger auf die Struktur cdev *</entry>
 	      <entry>502116</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem &Auml;ndern der Kernelstruktur
 		udev_t in dev_t.</entry>
 	      <entry>502117</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem Unterst&uuml;tzung f&uuml;r
 		CLOCK_VIRTUAL und CLOCK_PROF zu clock_gettime(2) und
 		clock_getres(2) hinzugef&uuml;gt wurde.</entry>
 	      <entry>502118</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem die &Uuml;berpr&uuml;fung des
 		Klonens von Netzwerk-Schnittstellen ge&auml;ndert
 		wurde.</entry>
 	      <entry>502119</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Einfliessen von Revision
 		20040629 der Paket-Werkzeuge.</entry>
 	      <entry>502120</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem Bluetooth-Quelltext als nicht
 	 	i386-spezifisch markiert wurde.</entry>
 	      <entry>502121</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach der Einf&uuml;hrung des KDB
 		Debugger Frameworks, der Umwandlung des DDB in ein Backend
 		und der Einf&uuml;hrung des GDB-Backends.</entry>
 	      <entry>502122</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem VFS_ROOT ge&auml;ndert wurde,
 		eine Struktur thread als Argument zu aktzeptieren, wie
 		vflush. Die Struktur kinfo_proc enthält nun einen Zeiger
 		auf Benutzer Daten. Der Umstieg auf
 		<literal>xorg</literal> als standardm&auml;&szlig;ige X
 		Implementierung wurde auch zu dieser Zeit
 		durchgef&uuml;hrt.</entry>
 	      <entry>502123</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem die Art und Weise, wie rc.d-Skripte
 		von Ports und Altlasten gestartet werden, getrennt wurde.</entry>
 	      <entry>502124</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem die vorherige &Auml;nderung
 		r&uuml;ckg&auml;ngig gemacht wurde.</entry>
 	      <entry>502125</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach dem Entfernen von
 		kmem_alloc_pageable() und dem Import von GCC 3.4.2.</entry>
 	      <entry>502126</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nachdem die UMA Kernel API
 		ge&auml;ndert wurde, um Konstruktoren und
 		Initialisierungsmethoden zu erlauben
 		fehlzuschlagen.</entry>
 	      <entry>502127</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.2-CURRENT nach der &Auml;nderung in der vfs_mount
 		Signatur sowie allgemeines Ersetzen von PRISON_ROOT durch
 		SUSER_ALLOWJAIL in der suser(9) API.</entry>
 	      <entry>502128</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.3-BETA/RC vor der &Auml;nderung der pfil-API.</entry>
 	      <entry>503000</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.3-RELEASE</entry>
 	      <entry>503001</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.3-STABLE nach dem Erstellen des RELENG_5_3-Zweiges.</entry>
 	      <entry>503100</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.3-STABLE nach dem Hinzuf&uuml;gen von
 		F&uuml;lloptionen im Stile der libc zu
 		&man.strftime.3;.</entry>
 	      <entry>503101</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.3-STABLE nachdem OpenBSD's nc(1) von CURRENT
 		importiert wurde.</entry>
 	      <entry>503102</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-PRERELEASE nach dem Einfliessen der Reparaturen
 		aus CURRENT, in
 		<filename>&lt;src/include/stdbool.h&gt;</filename> und
 		<filename>&lt;src/sys/i386/include/_types.h&gt;</filename>,
 		um die GCC-Kompatibilit&auml;t des Intel C/C++-Compilers
 		zu benutzen.</entry>
 	      <entry>503103</entry>
 	   </row>
 
 	    <row>
 	      <entry>5.4-PRERELEASE nach dem Einfliessen der
 		&Auml;nderung aus CURRENT in ifi_epoch statt der lokalen
 		Zeit die Betriebszeit des Systems zu benutzen.</entry>
 	      <entry>503104</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-PRERELEASE nach dem Einfliessen der Reparaturen
 		von EOVERFLOW in vswprintf(3) aus CURRENT.</entry>
 	      <entry>503105</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-RELEASE.</entry>
 	      <entry>504000</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-STABLE nach dem Erstellen des
 		RELENG_5_4-Zweiges.</entry>
 	      <entry>504100</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-STABLE nach dem Vergr&ouml;&szlig;ern der
 		standardm&auml;&szlig;igen Stackgr&ouml;&szlig;e f&uuml;r
 		Threads.</entry>
 	      <entry>504101</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-STABLE nach dem Hinzuf&uuml;gen von sha256.</entry>
 	      <entry>504102</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-STABLE nach dem Einfliessen von if_bridge aus
 		CURRENT.</entry>
 	      <entry>504103</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-STABLE nach dem Einfliessen von bsdiff und
 		portsnap aus CURRENT.</entry>
 	      <entry>504104</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.4-STABLE nach dem Einfliessen der &Auml;nderung
 		von ldconfig_local_dirs aus CURRENT.</entry>
 	      <entry>504105</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.5-RELEASE.</entry>
 	      <entry>505000</entry>
 	    </row>
 
 	    <row>
 	      <entry>5.5-STABLE nach dem Erstellen des RELENG_5_5-Zweiges.</entry>
 	      <entry>505100</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT</entry>
 	      <entry>600000</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach der festen Aktivierung von
 		PFIL_HOOKS im Kernel.</entry>
 	      <entry>600001</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach der anf&auml;nglichen
 		Einf&uuml;hrung von ifi_epoch zur Struktur if_data. Wurde
 		nach ein paar Tagen wieder r&uuml;ckg&auml;ngig gemacht.
 		Benutzen Sie diesen Wert bitte nicht.</entry>
 	      <entry>600002</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem erneuten Hinzuf&uuml;gen des
 		Elements ifi_epoch zur Struktur if_data.</entry>
 	      <entry>600003</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Hinzuf&uuml;gen der Struktur
 		inpcb als Argument in der pfil API.</entry>
 	      <entry>600004</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Hinzuf&uuml;gen des "-d
 		DESTDIR" Schalters zu newsyslog.</entry>
 	      <entry>600005</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Hinzuf&uuml;gen von
 		F&uuml;lloptionen im Style der libc zu
 		&man.strftime.3;.</entry>
 	      <entry>600006</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Hinzuf&uuml;gen von 802.11
 		Framework Neuerungen.</entry>
 	      <entry>600007</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT &Auml;nderung an den VOP_*VOBJECT()
 		Funktionen und Einf&uuml;hrung des MNTK_MPSAFE Schalters
 		f&uuml;r Dateisysteme, welche ohne Giant arbeiten.</entry>
 	      <entry>600008</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Hinzuf&uuml;gen von cpufreq
 		Framework und Treibern.</entry>
 	      <entry>600009</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem OpenBSD's nc(1) importiert
 	   	wurde.</entry>
 	      <entry>600010</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem der Anschein von
 		<literal>matherr()</literal> Unterst&uuml;tzung in SVID2
 		entfernt wurde.</entry>
 	      <entry>600011</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Vergr&ouml;&szlig;ern der
 		standardm&auml;&szlig;igen Stackgr&ouml;&szlig;e f&uuml;r
 		Threads.</entry>
 	      <entry>600012</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Einfliessen der Reparaturen in
 		<filename>&lt;src/include/stdbool.h&gt;</filename> und
 		<filename>&lt;src/sys/i386/include/_types.h&gt;</filename>,
 		um die GCC-Kompatibilit&auml;t des Intel C/C++-Compilers
 		zu benutzen.</entry>
 	      <entry>600013</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem die &Uuml;berpr&uuml;fungen auf
 		EOVERFLOW in vswprintf(3) korrigiert wurden.</entry>
 	      <entry>600014</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Einfliessen der &Auml;nderung,
 		in ifi_epoch, statt der lokalen Zeit, die Betriebzeit des
 		Systems zu benutzen.</entry>
 	      <entry>600015</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem das Format von LC_CTYPE auf der
 		Festplatte ver&auml;ndert wurde.</entry>
 	      <entry>600016</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem das Format der NLS-Kataloge auf
 		der Festplatte ver&auml;ndert wurde.</entry>
 	      <entry>600017</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem das Format von LC_COLLATE auf
 		der Festplatte ver&auml;ndert wurde.</entry>
 	      <entry>600018</entry>
 	    </row>
 
 	    <row>
 	      <entry>Installation der acpica Include-Dateien in
 		/usr/include.</entry>
 	      <entry>600019</entry>
 	    </row>
 
 	    <row>
 	      <entry>Hinzuf&uuml;gen des MSG_NOSIGNAL Schalters zur
 		send(2) API.</entry>
 	      <entry>600020</entry>
 	    </row>
 
 	    <row>
 	      <entry>Hinzuf&uuml;gen von Feldern zu cdevsw</entry>
 	      <entry>600021</entry>
 	    </row>
 
 	    <row>
 	      <entry>gtar wurde aus dem Basissystem entfernt.</entry>
 	      <entry>600022</entry>
 	    </row>
 
 	    <row>
 	      <entry>Die Optionen LOCAL_CREDS, LOCAL_CONNWAIT f&uuml;r
 		Sockets wurde zu unix(4) hinzugef&uuml;gt.</entry>
 	      <entry>600023</entry>
 	    </row>
 
 	    <row>
 	      <entry>&man.hwpmc.4; und zugeh&ouml;rige Werkzeuge wurden
 		zu 6.0-CURRENT hinzugef&uuml;gt.</entry>
 	      <entry>600024</entry>
 	    </row>
 
 	    <row>
 	      <entry>Die Struktur icmphdr wurden zu 6.0-CURRENT
 		hinzugef&uuml;gt.</entry>
 	      <entry>600025</entry>
 	    </row>
 
 	    <row>
 	      <entry>pf Aktualisierung auf 3.7.</entry>
 	      <entry>600026</entry>
 	    </row>
 
 	    <row>
 	      <entry>Kernel libalias und ng_nat wurden
 		eingef&uuml;hrt.</entry>
 	      <entry>600027</entry>
 	    </row>
 
 	    <row>
 	      <entry>POSIX ttyname_r(3) wurde &uuml;ber unistd.h und
 		libc zur Verf&uuml;gung gestellt.</entry>
 	      <entry>600028</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem libpcap zu Version v0.9.1 alpha
 		096 aktualisiert wurde.</entry>
 	      <entry>600029</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Import von NetBSDs
 		if_bridge(4).</entry>
 	      <entry>600030</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nachdem die Struktur ifnet aus dem
 		Treiber softcs herausgel&ouml;st wurde.</entry>
 	      <entry>600031</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-CURRENT nach dem Import von libpcap
 		v0.9.1.</entry>
 	      <entry>600032</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nachdem die Versionen aller gemeinsam
 		genutzten Bibliotheken, welche seit RELENG_5 nicht
 		ge&auml;ndert wurden, erh&ouml;ht wurden.</entry>
 	      <entry>600033</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nachdem das Argument credential zu der
 		dev_clone-Ereignisbehandlung hinzugef&uuml;gt wurde.
 		6.0-RELEASE.</entry>
 	      <entry>600034</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nach dem Erstellen des
 		6.0-RELEASE-Zweiges.</entry>
 	      <entry>600100</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nach dem Aufnehmen von Skripten aus den
 		local_startup-Verzeichnissen in &man.rcorder.8; des
 		 Basissystems.</entry>
 	      <entry>600101</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nach dem Aktualisieren der ELF-Typen und
 		Konstanten.</entry>
 	      <entry>600102</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nach dem Einfliessen der pidfile(3)-API
 		aus CURRENT.</entry>
 	      <entry>600103</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nach dem Einfliessen der &Auml;nderung
 		von ldconfig_local_dirs aus CURRENT.</entry>
 	      <entry>600104</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.0-STABLE nach der NLS-Katalogunterst&uuml;tzung
 		von csh(1).</entry>
 	      <entry>600105</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-RELEASE</entry>
 	      <entry>601000</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-STABLE nach 6.1-RELEASE.</entry>
 	      <entry>601100</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-STABLE nach dem Import von csup.</entry>
 	      <entry>601101</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-STABLE nach der iwi(4)-Aktualisierung.</entry>
 	      <entry>601102</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-STABLE nach der Aktualisierung der
 		Namensaufl&ouml;sung zu BIND9 und Aufnahme der
 		ablaufinvarianten Versionen der netdb-Funktionen.</entry>
 	      <entry>601103</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-STABLE nachdem Unterst&uuml;tzung f&uuml;r DSO
 		(dynamic shared objects - gemeinsam genutzte, dynamische
 		Objekte) in OpenSSL aktiviert wurde.</entry>
 	      <entry>601104</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.1-STABLE nachdem 802.11 Reparaturen die API der
 		IEEE80211_IOC_STA_INFO ioctl ge&auml;ndert haben.</entry>
-	      <entry>601104</entry>
+	      <entry>601105</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-RELEASE</entry>
 	      <entry>602000</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach 6.2-RELEASE.</entry>
 	      <entry>602100</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Hinzuf&uuml;gen der Wi-Spy
 		Eigenart.</entry>
 	      <entry>602101</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nachdem pci_find_extcap() hinzugef&uuml;gt
 		wurde.</entry>
 	      <entry>602102</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen der dlsym
 		&Auml;nderung aus CURRENT, ein angefordertes Symbol sowohl
 		in der spezifizierten dso, als auch in den impliziten
 		Abh&auml;ngigkeiten nachzuschlagen.</entry>
 	      <entry>602103</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen von ng_deflate(4)
 		und ng_pred1(4) netgraph Knoten und neuen Kompressions-
 		und -Verschl&uuml;sselungmodi f&uuml;r den ng_ppp(4)
 		Knoten aus CURRENT.</entry>
 	      <entry>602104</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen der BSD lizensierten
 		Version von &man.gzip.1;, welche von NetBSD portiert wurde
 		aus CURRENT.</entry>
 	      <entry>602105</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen der PCI MSI und
 	 	MSI-X Unterst&uuml;tzung aus CURRENT.</entry>
 	      <entry>602106</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen von ncurses 5.6 und
 		Unterst&uuml;tzung f&uuml;r Multibyte-Zeichen aus
 		CURRENT.</entry>
 	      <entry>602107</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen des 'SG'
 		Peripherieger&auml;tes aus CURRENT in CAM, welches einen
 		Teil der SCSI SG passthrough Ger&auml;te API von Linux
 		enth&auml;lt.</entry>
 	      <entry>602108</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen von readline 5.2
 		Patchset 002 aus CURRENT.</entry>
 	      <entry>602109</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen von
 		pmap_invalidate_cache(), pmap_change_attr(),
 		pmap_mapbios(), pmap_mapdev_attr(), und pmap_unmapbios()
 		f&uuml;r amd64 und i386 aus CURRENT.</entry>
 	      <entry>602110</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen von BOP_BDFLUSH aus
 		CURRENT und dem daraus resultierendem Bruch mit dem
 		Dateisystemmodul KBI.</entry>
 	      <entry>602111</entry>
 	    </row>
 
 	    <row>
 	      <entry>6.2-STABLE nach dem Einpflegen von libutil(3) aus
 	        CURRENT.</entry>
 	      <entry>602112</entry>
 	    </row>
-
+	    <row>
+	      <entry>6.2-STABLE, nach der Trennung in "wide und
+		single byte ctype".  Neu kompilierte Bin&auml;rdateien,
+		die ctype.h referenzieren, erfordern m&ouml;glicherweise
+		ein neues Symbol, __mb_sb_limit, das auf &auml;lteren
+		Systemen nicht verf&uuml;gbar ist.</entry>
+	      <entry>602113</entry>
+	    </row>
+	    <row>
+	      <entry>6.2-STABLE, nachdem die ctype
+		ABI-Aufw&auml;rtskompatibilit&auml;t wiederhergestellt
+		wurde.</entry>
+	      <entry>602114</entry>
+            </row>
 	    <row>
 	      <entry>7.0-CURRENT.</entry>
 	      <entry>700000</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem die Versionen aller gemeinsam
 		genutzten Bibliothken, welche seit RELENG_5 nicht
 		ge&auml;ndert wurden, erh&ouml;ht wurden.</entry>
 	      <entry>700001</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem ein Berechtigungs-Argument zur
 		dev_clone-Ereignisroutine hinzugef&uuml;gt wurde.</entry>
 	      <entry>700002</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem memmem(3) zur libc
 		hinzugef&uuml;gt wurde.</entry>
 	      <entry>700003</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem die Argumente der
 		Kernelfunktion solisten(9) modifiziert wurden, um einen
 		Backlog-Parameter (Anzahl der maximalen wartenden
 		Verbindungen) zu akzeptieren.</entry>
 	      <entry>700004</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem IFP2ENADDR() ge&auml;ndert
 		wurde, einen Zeiger auf IF_LLADDR()
 		zur&uuml;ckzugeben.</entry>
 	      <entry>700005</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen des
 		<literal>if_addr</literal>-Elements zur Struktur
 		<literal>ifnet</literal> und dem Entfernen von
 		IFP2ENADDR().</entry>
 	      <entry>700006</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Aufnehmen von Skripten aus den
 		local_startup Verzeichnissen in &man.rcorder.8; des
 		Basissystems.</entry>
 	      <entry>700007</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Entfernen der MNT_NODEV
 		mount-Option.</entry>
 	      <entry>700008</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach ELF-64 Typen &Auml;nderungen und
 		Symbol Versionierung.</entry>
 	      <entry>700009</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach Hinzuf&uuml;gen der hostb und
 		vgapci Treiber, Hinzuf&uuml;gen von pci_find_extcap() und
 		&Auml;nderung der AGP Treiber die Apertur nicht
 		l&auml;nger abzubilden.</entry>
 	      <entry>700010</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem auf allen Plattformen
 		au&szlig;er Alpha tv_sec in time_t umgewandelt
 		wurde.</entry>
 	      <entry>700011</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach &Auml;nderung von
 		ldconfig_local_dirs.</entry>
 	      <entry>700012</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach &Auml;nderung in
 		<filename>/etc/rc.d/abi</filename> um
 		<filename>/compat/linux/etc/ld.so.cache</filename> als
 		Symlink in ein schreibgesch&uuml;tztes Dateisystem zu
 		unterst&uuml;tzen.</entry>
 	      <entry>700013</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach pts Import.</entry>
 	      <entry>700014</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach Einf&uuml;hrung von Version 2 der
 		&man.hwpmc.4;'s ABI.</entry>
 	      <entry>700015</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen von
 		&man.fcloseall.3; zur libc.</entry>
 	      <entry>700016</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Entfernen von ip6fw.</entry>
 	      <entry>700017</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Import von snd_emu10kx.</entry>
 	      <entry>700018</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Import von OpenSSL
 		0.9.8b.</entry>
 	      <entry>700019</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen der
 		bus_dma_get_tag-Funktion</entry>
 	      <entry>700020</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Import von libpcap 0.9.4 und
 		tcpdump 3.9.4.</entry>
 	      <entry>700021</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach der dlsym &Auml;nderung, ein
 		angefordertes Symbol sowohl in der spezifizierten dso, als
 		auch in den impliziten Abh&auml;ngigkeiten
 		nachzuschlagen.</entry>
 	      <entry>700022</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen neuer
 		Sound-IOCTLs.</entry>
 	      <entry>700023</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Import von OpenSSL
 		0.9.8d.</entry>
 	      <entry>700024</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen der
 		libelf.</entry>
 	      <entry>700025</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach gr&ouml;&szlig;eren
 		&Auml;nderungen an den Sound sysctls.</entry>
 	      <entry>700026</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen der
 		Wi-Spy-Eigenart.</entry>
 	      <entry>700027</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen von
 		sctp-Aufrufen zur libc.</entry>
 	      <entry>700028</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Ersetzen von GNU &man.gzip.1;
 		durch eine von NetBSD portierte Version, die unter
 		BSD-Lizenz steht.</entry>
 	      <entry>700029</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Entfernen der IPIP
 		Tunnelkapselung (VIFF_TUNNEL) aus dem IPv4
 		Multicast-Forwarding-Quelltext.</entry>
 	      <entry>700030</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach den Modifizierungen an
 		bus_setup_intr() (newbus).</entry>
 	      <entry>700031</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach der Aufnahme der Firmware f&uuml;r
 		ipw(4) und iwi(4).</entry>
 	      <entry>700032</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach Unterst&uuml;tzung f&uuml;r
 		Multibyte-Zeichen.</entry>
 	      <entry>700033</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach &Auml;nderungen, wie insmntque(),
 		getnewvnode() und vfs_hash_insert() arbeiten.</entry>
 	      <entry>700034</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach Hinzuf&uuml;gen eines
 		Benachrichtigungsmechanismus f&uuml;r CPU
 		Frequenz&auml;nderungen.</entry>
 	      <entry>700035</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Import des ZFS
 		Dateisystemes.</entry>
 	      <entry>700036</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Einpflegen des 'SG'
 		Peripherieger&auml;tes in CAM, welches einen Teil der SCSI
 		SG passthrough Ger&auml;te API von Linux
 		enth&auml;lt.</entry>
 	      <entry>700037</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem &man.getenv.3;, &man.putenv.3;,
 		&man.setenv.3; und &man.unsetenv.3; ge&auml;ndert wurden,
 		um POSIX konform zu sein.</entry>
 	      <entry>700038</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem die &Auml;nderungen von 700038
 		r&uuml;ckg&auml;ngig gemacht wurden.</entry>
 	      <entry>700039</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Hinzuf&uuml;gen von
 		&man.flopen.3; zur libutil.</entry>
 	      <entry>700040</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem Symbol Versionierung aktiviert
 		und die standardm&auml;&szlig;ige Thread-Bibliothek zu
 		libthr ge&auml;ndert wurde.</entry>
 	      <entry>700041</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach dem Import von GCC 4.2.0.</entry>
 	      <entry>700042</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem die Versionen aller
 		Shared-Libraries, welche seit RELENG_6 nicht ge&auml;ndert
 		wurden, erh&ouml;ht worden sind.</entry>
 	      <entry>700043</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem das Argument f&uuml;r
 		vn_open()/VOP_OPEN() vom Dateideskriptorindex zur Struktur
 		file * ge&auml;dert wurde.</entry>
 	      <entry>700044</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nachdem &man.pam.nologin.8;
 		ge&auml;dert wurde, eine Kontoverwaltungs-Funktion statt
 		einer Authentifizierungsfunktion f&uuml;r das
 		PAM-Framework zur Verf&uuml;gung zu stellen.</entry>
 	      <entry>700045</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT nach aktualisierter 802.11 wireless
 		Unterst&uuml;tzung.</entry>
 	      <entry>700046</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem
 		TCP-LRO-Schnittstellen-Ressourcen hinzugef&uuml;gt
 		wurden.</entry>
 	      <entry>700047</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem die RFC&nbsp;3678
 		API-Unterst&uuml;tzung zum IPv4-Stack hinzugef&uuml;gt
 		wurde. Veraltetes RFC&nbsp;1724-Verhalten
 		des IP_MULTICAST_IF ioctl wurde entfernt;
 		0.0.0.0/8 darf nicht l&auml;nger als Schnittstellen-Index
 		benutzt werden.  Stattdessen sollte die Struktur ipmreqn
 		verwendet werden.</entry>
 	      <entry>700048</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem pf von OpenBSD&nbsp;4.1
 		importiert wurde</entry>
 	      <entry>700049</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem die IPv6-Unterst&uuml;tzung
 		um FAST_IPSEC erweitert, KAME IPSEC entfernt und
 		FAST_IPSEC in IPSEC umbenannt wurde.</entry>
 	      <entry>(nicht ge&auml;ndert)</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem Aufrufe von
 		setenv/putenv/usw. von der traditionellen
 		BSD-Art und Weise nach POSIX konvertiert
 		wurden.</entry>
 	      <entry>700050</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem neue Systemaufrufe
 		(mmap/lseek/usw.) implementiert wurden.</entry>
 	      <entry>700051</entry>
 	    </row>
 
 	    <row>
 	      <entry>7.0-CURRENT, nachdem die I4B-Header nach
 		include/i4b verschoben wurden.</entry>
 	      <entry>700052</entry>
 	    </row>
 	    <row>
 	      <entry>7.0-CURRENT, nachdem die Unterst&uuml;tzung
 	        f&uuml;r PCI Dom&auml;nen hinzugef&uuml;gt
 		wurde.</entry>
 	      <entry>700053</entry>
 	    </row>
+	    <row>
+	      <entry>7.0-STABLE, nach der Trennung in "wide und
+		single byte ctype".</entry>
+	      <entry>700054</entry>
+	    </row>
+	    <row>
+	      <entry>7.0-STABLE, nachdem die
+		ABI-Abw&auml;rtskompatibilit&auml;t f&uuml;r die
+		FreeBSD 4/5/6-Versionen der PCIOCGETCONF-, PCIOCREAD-
+		sowie PCIOCWRITE IOCTLs hinzugef&uuml;gt wurde.  Damit
+		verbunden war, dass die ABI der PCIOCGETCONF IOCTL
+		erneut deaktiviert werden musste.</entry>
+	      <entry>700055</entry>
+	    </row>
 	    <row>
 	      <entry>8.0-CURRENT. Nach der Trennung in "wide und
 		single byte ctype".</entry>
 	      <entry>800000</entry>
             </row>
 	    <row>
 	      <entry>8.0-CURRENT, nachdem libpcap 0.9.8 und
 		tcpdump 3.9.8 importiert wurden.</entry>
 	      <entry>800001</entry>
 	    </row>
+	    <row>
+	      <entry>8.0-CURRENT, nachdem kthread_create() und
+		Konsorten in kproc_create() usw. umbenannt
+		wurden.</entry>
+              <entry>800002</entry>
+	    </row>
+	    <row>
+	      <entry>8.0-CURRENT, nachdem die
+		ABI-Abw&auml;rtskompatibilit&auml;t f&uuml;r die
+		FreeBSD 4/5/6-Versionen der PCIOCGETCONF-, PCIOCREAD-
+		sowie PCIOCWRITE IOCTLs hinzugef&uuml;gt wurde.  Damit
+		verbunden war, dass die ABI der PCIOCGETCONF IOCTL
+		erneut deaktiviert werden musste.</entry>
+	      <entry>800003</entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <note>
 	<para>Beachten Sie, dass 2.2-STABLE sich nach dem
 	  2.2.5-RELEASE manchmal als <quote>2.2.5-STABLE</quote>
 	  identifiziert. Das Muster war fr&uuml;her das Jahr gefolgt
 	  von dem Monat, aber wir haben uns entschieden, ab 2.2. einen
 	  geradlinigeren Ansatz mit major/minor-Nummern zu benutzen.
 	  Dies liegt daran, dass gleichzeitiges Entwickeln an mehreren
 	  Zweigen es unm&ouml;glich macht, die Versionen nur mit Hilfe
 	  des Datums des Releases zu unterteilen. Wenn Sie jetzt einen
 	  Port erstellen brauchen Sie sich nicht um alte -CURRENTs zu
 	  k&uuml;mmern; diese sind hier nur als Referenz
 	  augef&uuml;hrt.</para>
       </note>
     </sect1>
 
     <sect1 id="dads-after-port-mk">
       <title>Etwas hinter die
 	<filename>bsd.port.mk</filename>-Anweisung schreiben</title>
 
       <para>Schreiben Sie bitte nichts hinter die <literal>.include
 	&lt;bsd.port.mk&gt;</literal>-Zeile. Normalerweise kann dies
 	vermieden werden, indem Sie die Datei
 	<filename>bsd.port.pre.mk</filename> irgendwo in der Mitte
 	Ihres <filename>Makefile</filename>s und
 	<filename>bsd.port.post.mk</filename> am Ende
 	einf&uuml;gen.</para>
 
       <note>
 	<para>Sie d&uuml;rfen entweder nur das
 	  <filename>bsd.port.pre.mk</filename>/<filename>bsd.port.post.mk</filename>-Paar
 	  oder <filename>bsd.port.mk</filename> alleine
 	  hinzuf&uuml;gen; vermischen Sie diese Verwendungen
 	  nicht!</para>
       </note>
 
       <para><filename>bsd.port.pre.mk</filename> definiert nur
 	einige Variablen, welche in Tests im
 	<filename>Makefile</filename> benutzt werden k&ouml;nnen,
 	<filename>bsd.port.post.mk</filename> definiert den
 	Rest.</para>
 
       <para>Hier sind einige wichtige Variablen, welche in
 	<filename>bsd.port.pre.mk</filename> definiert sind (dies ist
 	keine vollst&auml;ndige Liste, lesen Sie bitte
 	<filename>bsd.port.mk</filename> f&uuml;r eine
 	vollst&auml;ndige Auflistung).</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Variable</entry>
 	      <entry>Beschreibung</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><makevar>ARCH</makevar></entry>
 	      <entry>Die Architektur, wie von <command>uname
 	        -m</command> zur&uuml;ckgegeben (z.B.
 	        <literal>i386</literal>)</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>OPSYS</makevar></entry>
 	      <entry>Der Typ des Betriebsystems, wie von <command>uname
 	        -s</command> zur&uuml;ckgegeben (z.B.
 	        <literal>FreeBSD</literal>)</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>OSREL</makevar></entry>
 	      <entry>Die Release Version des Betriebssystems (z.B.,
 	        <literal>2.1.5</literal> oder
 	        <literal>2.2.7</literal>)</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>OSVERSION</makevar></entry>
 	      <entry>Die numerische Version des Betriebssystems;
 	        gleichbedeutend mit <link
 	        linkend="freebsd-versions"><literal>__FreeBSD_version</literal></link>.</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PORTOBJFORMAT</makevar></entry>
 	      <entry>Das Objektformat des Systems
 	        (<literal>elf</literal> oder <literal>aout</literal>;
 	        beachten Sie, dass f&uuml;r <quote>moderne</quote>
 	        Versionen von FreeBSD <literal>aout</literal> veraltet
 	        ist).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>LOCALBASE</makevar></entry>
 	      <entry>Die Basis des <quote>local</quote>
 	        Verzeichnisbaumes (z.B.
 	        <literal>/usr/local/</literal>)</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>X11BASE</makevar></entry>
 	      <entry>Die Basis des <quote>X11</quote> Verzeichnisbaumes
 	        (z.B., <literal>/usr/X11R6</literal>)</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>PREFIX</makevar></entry>
 	      <entry>Wo der Port sich selbst installiert (siehe <link
 	        linkend="porting-prefix"> Mehr Informationen &uuml;ber
 	        <makevar>PREFIX</makevar></link>).</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <note>
 	<para>Falls Sie die Variablen <makevar>USE_IMAKE</makevar>,
 	  <makevar>USE_X_PREFIX</makevar>, oder
 	  <makevar>MASTERDIR</makevar> definieren m&uuml;ssen, sollten
 	  Sie dies vor dem Einf&uuml;gen von
 	  <filename>bsd.port.pre.mk</filename> machen.</para>
       </note>
 
       <para>Hier sind ein paar Beispiele von Dingen, die Sie hinter
 	die Anweisung <filename>bsd.port.pre.mk</filename> schreiben
 	k&ouml;nnen:</para>
 
       <programlisting># lang/perl5 muss nicht kompliliert werden, falls perl5 schon auf dem System ist
 .if ${OSVERSION} &gt; 300003
 BROKEN= perl ist im System
 .endif
 
 # nur eine Versionsnummer f&uuml;r die ELF Version der shlib
 .if ${PORTOBJFORMAT} == "elf"
 TCL_LIB_FILE=  ${TCL_LIB}.${SHLIB_MAJOR}
 .else
 TCL_LIB_FILE=  ${TCL_LIB}.${SHLIB_MAJOR}.${SHLIB_MINOR}
 .endif
 
 # die Software erstellt schon eine Verkn&uuml;pfung f&uuml; ELF, aber nicht f&uuml; a.out
 post-install:
 .if ${PORTOBJFORMAT} == "aout"
        ${LN} -sf liblinpack.so.1.0 ${PREFIX}/lib/liblinpack.so
 .endif</programlisting>
 
       <para>Sie haben sich daran erinnert Tabulator statt
 	Leerzeichen nach <literal>BROKEN=</literal> und
 	<literal>TCL_LIB_FILE=</literal> zu benutzen, oder?
 	<!-- smiley -->:-).</para>
     </sect1>
 
     <sect1 id="dads-sh-exec">
       <title>Benutzen Sie die <function>exec</function>-Anweisung in
 	Wrapper-Skripten</title>
 
       <para>Falls der Port ein Shellskript installiert, dessen Zweck
 	es ist ein anderes Programm zu starten, und falls das Starten
 	des Programmes die letzte Aktion des Skripts ist, sollten Sie
 	sicherstellen, dass Sie die Funktion <function>exec</function>
 	daf&uuml;r benutzen; zum Beispiel:</para>
 
       <programlisting>#!/bin/sh
 exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
 
       <para>Die Funktion <function>exec</function> ersetzt den
 	Shell-Prozess mit dem angegebenen Programm. Falls
 	<function>exec</function> ausgelassen wird, verbleibt der
 	Shell-Prozess im Speicher w&auml;hrend das Programm
 	ausgef&auml;hrt wird und verbraucht unn&ouml;tig
 	Systemressourcen.</para>
     </sect1>
 
     <sect1 id="dads-uid-and-gids">
       <title>UIDs und GIDs</title>
 
       <para>Die aktuellen Listen von reservierten UIDs und GIDs sind
 	in <filename>ports/UIDs</filename> und
 	<filename>ports/GIDs</filename> zu finden.</para>
 
       <para>Falls Ihr Port einen bestimmten Benutzer auf dem zu
 	installierendem System ben&ouml;tigt, lassen Sie das
 	<filename>pkg-install</filename>-Skript den Aufruf von
 	<command>pw</command> machen, um ihn automatisch anzulegen.
 	Schauen Sie sich f&uuml;r ein Beispiel <filename
 	role="package">net/cvsup-mirror</filename> an. Beachten Sie
 	bitte, dass wir von diesem Vorgehen stark abraten! Bitte
 	registrieren Sie Benutzer/Gruppen wie unten
 	beschrieben.</para>
 
       <para>Falls Ihr Port die gleichen Benutzer/Gruppen IDs
 	benutzen muss, egal ob als Bin&auml;r-Paket installiert oder
 	als Port kompiliert, m&uuml;ssen Sie eine nicht benutzte UID
 	zwischen 50 und 999 benutzen und entweder in
 	<filename>ports/UIDs</filename> (f&uuml;r Benutzer) oder in
 	<filename>ports/GIDs</filename> (f&uuml;r Gruppen)
 	registrieren.  F&uuml;r ein Beispiel schauen Sie sich bitte
 	<filename role="package">japanese/Wnn6</filename> an.</para>
 
       <para>Stellen Sie sicher, dass Sie keine UIDs verwenden,
 	welche schon vom System oder von einem anderen Port gebraucht
 	werden.</para>
 
       <para>Bitte f&uuml;gen Sie einen Patch f&uuml;r diese beiden
 	Datei hinzu, falls f&uuml;r Ihren Port ein neuer Benutzer oder
 	Gruppe angelegt werden muss.</para>
     </sect1>
 
     <sect1 id="dads-rational">
       <title>Aufgaben vern&uuml;nftig l&ouml;sen</title>
 
       <para>Das <filename>Makefile</filename> sollte die
 	n&ouml;tigen Schritte einfach und vern&uuml;nftig
 	durchf&uuml;hren. Wenn Sie ein einige Zeilen einsparen oder
 	die Lesbarkeit verbessern k&ouml;nnen, dann machen Sie dies
 	bitte. Beispiele sind: Ein make-Konstrukt
 	<literal>.if</literal> anstatt eines Shellkonstrukt
 	<literal>if</literal> zu verwenden, anstatt
 	<maketarget>do-extract</maketarget> neu zu definieren, dies
 	mit <makevar>EXTRACT*</makevar> machen, oder
 	<makevar>GNU_CONFIGURE</makevar> anstelle von
 	<literal>CONFIGURE_ARGS += --prefix=&dollar;{PREFIX}</literal>
 	zu verwenden.</para>
 
       <para>Falls Sie sich in einer Situation wiederfinden, in der
 	Sie viel Code neu schreiben m&uuml;ssen, um etwas zu testen,
 	sollten Sie zuerst <filename>bsd.port.mk</filename> erneut
 	konsultieren und nachpr&uuml;fen ob es nicht bereits eine
 	L&ouml;sung f&uuml;r Ihr Problem enth&auml;lt. Es ist zwar
 	schwer zu lesen, beinhaltet jedoch eine Menge kurzer
 	L&ouml;sungen f&uuml;r viele scheinbar schwierige
 	Probleme.</para>
     </sect1>
 
     <sect1 id="dads-cc">
       <title>Ber&uuml;cksichtigen Sie sowohl <makevar>CC</makevar> als
 	auch <makevar>CXX</makevar></title>
 
       <para>Der Port sollte sowohl die <makevar>CC</makevar>- wie
 	auch die <makevar>CXX</makevar>-Variable ber&uuml;cksichtigen.
 	Damit ist gemeint, dass der Port diese Variablen nicht ohne
 	R&uuml;cksicht auf eventuell schon gesetzte Werte einfach
 	&uuml;berschreiben sollte; stattdessen sollten neue Werte an
 	schon existierende angeh&auml;ngt werden. Dadurch k&ouml;nnen
 	Build-Optionen, die alle Ports betreffen, global definiert
 	werden.</para>
 
       <para>Falls der Port diese Variablen nicht
 	ber&uuml;cksichtigt, sollte <literal>NO_PACKAGE=ignores either
 	cc or cxx</literal> ins <filename>Makefile</filename>
 	eingef&uuml;gt werden.</para>
 
       <para>Im Folgenden wird ein Beispiel eines
 	<filename>Makefile</filename>s gezeigt, welches die beiden
 	Variablen <makevar>CC</makevar> und <makevar>CXX</makevar>
 	ber&uuml;cksichtigt. Beachten Sie das
 	<makevar>?=</makevar>:</para>
 
       <programlisting>CC?= gcc</programlisting>
       <programlisting>CXX?= g++</programlisting>
 
       <para>Nachfolgend ein Beispiel, welches weder
 	<makevar>CC</makevar> noch <makevar>CXX</makevar>
 	ber&uuml;cksichtigt:</para>
 
       <programlisting>CC= gcc</programlisting>
       <programlisting>CXX= g++</programlisting>
 
       <para>Die Variablen <makevar>CC</makevar> und
 	<makevar>CXX</makevar> k&ouml;nnen auf FreeBSD-Systemen in
 	<filename>/etc/make.conf</filename> definiert werden. Im
 	ersten Beispiel wird ein Wert nur dann gesetzt, falls dieser
 	vorher noch nicht gesetzt war, um so systemweite Definitionen
 	zu ber&uuml;cksichtigen. Im zweiten Beispiel werden die
 	Variablen ohne R&uuml;cksicht &uuml;berschrieben.</para>
     </sect1>
 
     <sect1 id="dads-cflags">
       <title>Ber&uuml;cksichtigen Sie
 	<makevar>CFLAGS</makevar></title>
 
       <para>Der Port sollte die Variable <makevar>CFLAGS</makevar>
 	ber&uuml;cksichtigen. Damit ist gemeint, dass der Port den
 	Wert dieser Variablen nicht absolut setzen und damit
 	existierende Werte &uuml;berschreiben sollte; stattdessen
 	sollte er weitere Werte der Variablen durch Anh&auml;ngen
 	hinzuf&uuml;gen. Dadurch k&ouml;nnen Build-Optionen, die alle
 	Ports betreffen, global definiert werden.</para>
 
       <para>Falls der Port diese Variablen nicht
 	ber&uuml;cksichtigt, sollte <literal>NO_PACKAGE=ignores
 	cflags</literal> ins <filename>Makefile</filename>
 	eingef&uuml;gt werden.</para>
 
       <para>Im Folgenden wird ein Beispiel eines
 	<filename>Makefile</filename>s gezeigt, welches die Variable
 	<makevar>CFLAGS</makevar> ber&uuml;cksichtigt. Beachten Sie
 	das <makevar>+=</makevar>:</para>
 
       <programlisting>CFLAGS+= -Wall -Werror</programlisting>
 
       <para>Nachfolgend finden Sie ein Beispiel, welches die
 	<makevar>CFLAGS</makevar>-Variable nicht
 	ber&uuml;cksichtigt:</para>
 
       <programlisting>CFLAGS= -Wall -Werror</programlisting>
 
       <para>Die Variable <makevar>CFLAGS</makevar> wird auf
 	FreeBSD-Systemen in <filename>/etc/make.conf</filename>
 	definiert. Im ersten Beispiel werden weitere Flags an die
 	Variable <makevar>CFLAGS</makevar> angeh&auml;ngt und somit
 	der bestehende Wert nicht gel&ouml;scht. Im zweiten Beispiel
 	wird die Variable ohne R&uuml;cksicht
 	&uuml;berschrieben.</para>
 
       <para>Sie sollten Optimierungsflags aus
 	<filename>Makefile</filename>s Dritter entfernen. Die
 	<makevar>CFLAGS</makevar> des Systems beinhalten systemweite
 	Optimierungsflags. Ein Beispiel eines unver&auml;nderten
 	<filename>Makefile</filename>s:</para>
 
       <programlisting>CFLAGS= -O3 -funroll-loops -DHAVE_SOUND</programlisting>
 
       <para>Werden nun systemweite Optimierungsflags verwendet so
 	w&uuml;rde das <filename>Makefile</filename> in etwa
 	folgenderma&szlig;en aussehen:</para>
 
       <programlisting>CFLAGS+= -DHAVE_SOUND</programlisting>
     </sect1>
 
     <sect1 id="dads-pthread">
       <title>Threading-Bibliotheken</title>
 
       <para>Die Threading-Bibliothek muss mit Hilfe eines speziellen
 	Linker-Flags <literal>-pthread</literal> in die
 	Bin&auml;rdateien unter &os; gebunden werden. Falls ein Port
 	auf ein direktes Verlinken gegen <literal>-lpthread</literal>
 	oder <literal>-lc_r</literal> besteht, passen Sie den Port
 	bitte so an, dass er die durch das Port-Framework
 	bereitgestellte Variable <makevar>PTHREAD_LIBS</makevar>
 	verwendet. Diese Variable hat &uuml;blicherweise den Wert
 	<literal>-pthread</literal>, kann aber auf einigen
 	Architekturen und &os;-Versionen abweichende Werte haben und
 	daher sollte nie <literal>-pthread</literal> direkt in Patches
 	geschrieben werden, sondern immer
 	<makevar>PTHREAD_LIBS</makevar>.</para>
 
       <note>
 	<para>Falls durch das Setzen von
 	  <makevar>PTHREAD_LIBS</makevar> der Bau des Ports mit der
 	  Fehlermeldung <literal>unrecognized option
 	  '-pthread'</literal> abbricht, kann die Verwendung des
 	  <command>gcc</command> als Linker durch setzen von
 	  <makevar>CONFIGURE_ENV</makevar> auf
 	  <literal>LD=${CC}</literal> helfen. Die Option
 	  <literal>-pthread</literal> wird nicht direkt von
 	  <command>ld</command> unterst&uuml;tzt.</para>
       </note>
     </sect1>
 
     <sect1 id="dads-freedback">
       <title>R&uuml;ckmeldungen</title>
 
       <para>Brauchbare &Auml;nderungen/Patches sollten an den
 	urspr&uuml;nglichen Autor/Maintainer der Software geschickt
 	werden, damit diese in der n&auml;chsten Version der Software
 	mit aufgenommen werden k&ouml;nnen.  Dadurch wird Ihre Aufgabe
 	f&uuml;r die n&auml;chste Version der Software deutlich
 	einfacher.</para>
     </sect1>
 
     <sect1 id="dads-readme">
       <title><filename>README.html</filename></title>
 
       <para>Nehmen Sie bitte keine <filename>README.html</filename>
 	in den Port auf. Diese Datei ist kein Bestandteil der
 	CVS-Sammlung sondern wird durch <command>make readme</command>
 	erzeugt.</para>
     </sect1>
 
     <sect1 id="dads-noinstall">
       <title>Einen Port durch <makevar>BROKEN</makevar>,
 	<makevar>FORBIDDEN</makevar> oder <makevar>IGNORE</makevar> als
 	nicht installierbar markieren</title>
 
       <para>In manchen F&auml;llen sollten Benutzer davon abgehalten
 	werden einen Port zu installieren. Um einem Benutzer
 	mitzuteilen, dass ein Port nicht installiert werden sollte,
 	gibt es mehrere Variablen f&uuml;r <command>make</command>,
 	die im <filename>Makefile</filename> des Ports genutzt werden
 	k&ouml;nnen. Der Wert der folgenden
 	<command>make</command>-Variablen wird dem Benutzer als Grund
 	f&uuml;r die Ablehnung der Installation des Ports
 	zur&uuml;ckgegeben. Bitte benutzen Sie die richtige
 	<command>make</command>-Variable, denn jede enth&auml;lt eine
 	v&ouml;llig andere Bedeutung f&uuml;r den Benutzer und das
 	automatische System, das von dem <filename>Makefile</filename>
 	abh&auml;ngt, wie <link linkend="build-cluster">der
 	Ports-Build-Custer</link>, <link
 	linkend="freshports">FreshPorts</link> und <link
 	linkend="portsmon">portsmon</link>.</para>
 
       <sect2 id="dads-noinstall-variables">
 	<title>Variablen</title>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><makevar>BROKEN</makevar> ist reserviert f&uuml;r
 	      Ports, welche momentan nicht korrekt kompiliert,
 	      installiert oder deinstalliert werden. Es sollte
 	      f&uuml;r Ports benutzt werden, von denen man annimmt,
 	      dass dies ein tempor&auml;res Problem ist.</para>
 
 	    <para>Falls angegeben, wird der Build-Cluster dennoch
 	      versuchen den Port zu bauen, um zu sehen, ob das
 	      zugrunde liegende Problem behoben wurde (das ist jedoch
 	      im Allgemeinen nicht der Fall).</para>
 
 	    <para>Benutzen Sie <makevar>BROKEN</makevar> zum
 	      Beispiel, wenn ein Port:</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para>nicht kompiliert</para>
 	      </listitem>
 
 	      <listitem>
 		<para>beim Konfiguration- oder Installation-Prozess
 		  scheitert</para>
 	      </listitem>
 
 	      <listitem>
 		<para>Dateien au&szlig;erhalb von
 		  <filename>${LOCALBASE}</filename> und
 		  <filename>${X11BASE}</filename> installiert</para>
 	      </listitem>
 
 	      <listitem>
 		<para>beim Deinstallieren nicht alle seine Dateien
 		  sauber entfernt (jedoch kann es akzeptable und
 		  w&uuml;nschenswert sein, Dateien, die vom Nutzer
 		  ver&auml;ndert wurden, nicht zu entfernen)</para>
 	      </listitem>
 	    </itemizedlist>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>FORBIDDEN</makevar> wird f&uuml;r Ports
 	      verwendet, die Sicherheitsl&uuml;cken enthalten oder die
 	      ernste Sicherheitsbedenken f&uuml;r das FreeBSD-System
 	      aufwerfen, wenn sie installiert sind (z.B. ein als
 	      unsicher bekanntes Programm, oder ein Programm, das
 	      einen Dienst zur Verf&uuml;gung stellt, der leicht
 	      kompromittiert werden kann). Ports sollten als
 	      <makevar>FORBIDDEN</makevar> gekennzeichnet werden,
 	      sobald ein Programm eine Schwachstelle hat und kein
 	      Update ver&ouml;ffentlicht wurde. Idealerweise sollten
 	      Ports so bald wie m&ouml;glich aktualisiert werden wenn
 	      eine Sicherheitsl&uuml;cke entdeckt wurde, um die Zahl
 	      verwundbarer FreeBSD-Hosts zu verringern (wir
 	      sch&auml;tzen es f&uuml;r unsere Sicherheit bekannt zu
 	      sein), obwohl es manchmal einen beachtlichen Zeitabstand
 	      zwischen der Bekanntmachung einer Schwachstelle und dem
 	      entsprechenden Update gibt. Bitte kennzeichnen Sie einen
 	      Port nicht aus irgendeinem Grund au&szlig;er Sicherheit
 	      als <makevar>FORBIDDEN</makevar>.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><makevar>IGNORE</makevar> ist f&uuml;r Ports
 	      reserviert, die aus anderen Gr&uuml;nden nicht gebaut
 	      werden sollten. Es sollte f&uuml;r Ports verwendet
 	      werden, in denen ein strukturelles Problem vermutet
 	      wird. Der Build-Cluster wird unter keinen Umst&auml;nden
 	      Ports, die mit <makevar>IGNORE</makevar> markiert sind,
 	      erstellen. Verwenden Sie <makevar>IGNORE</makevar> zum
 	      Beispiel, wenn ein Port:</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para>kompiliert, aber nicht richtig l&auml;uft</para>
 	      </listitem>
 
 	      <listitem>
 		<para>nicht auf der installierten Version von &os;
 		  l&auml;uft</para>
 	      </listitem>
 
 	      <listitem>
 		<para>&os; Kernelquelltext zum Bauen ben&ouml;tigt,
 		  aber der Benutzer diese nicht installiert hat</para>
 	      </listitem>
 
 	      <listitem>
 		<para>ein Distfile ben&ouml;tigt, welches aufgrund
 		  von Lizenzbeschr&auml;nkungen nicht automatisch
 		  abgerufen werden kann</para>
 	      </listitem>
 
 	      <listitem>
 		<para>nicht korrekt mit einem momentan installiertem
 		  Port arbeitet (der Port h&auml;ngt zum Beispiel von
 		  <filename role="package">www/apache21</filename> ab,
 		  aber <filename
 		  role="package">www/apache13</filename> ist
 		  installiert)</para>
 	      </listitem>
 	    </itemizedlist>
 
 	    <note>
 	      <para>Wenn ein Port mit einem momentan installiertem
 		Port kollidiert (zum Beispiel, wenn beide eine Datei
 		an die selbe Stelle installieren, diese aber eine
 		andere Funktion hat), benutzen Sie stattdessen
 		<makevar>CONFLICTS</makevar>.
 		<makevar>CONFLICTS</makevar> setzt
 		<makevar>IGNORE</makevar> dann
 		selbstst&auml;ndig.</para>
 	    </note>
 	  </listitem>
 
 	  <listitem>
 	    <para>Um einen Port nur auf bestimmte
 	      Systemarchitekturen mit <makevar>IGNORE</makevar> zu
 	      markieren, gibt es zwei Variablen, die automatisch
 	      <makevar>IGNORE</makevar> f&uuml;r Sie setzen:
 	      <makevar>ONLY_FOR_ARCHS</makevar> und
 	      <makevar>NOT_FOR_ARCHS</makevar>. Beispiele:</para>
 
 	    <programlisting>ONLY_FOR_ARCHS= i386 amd64</programlisting>
 
 	    <programlisting>NOT_FOR_ARCHS= alpha ia64 sparc64</programlisting>
 
 	    <para>Eine eigene <makevar>IGNORE</makevar>-Ausgabe kann
 	      mit <makevar>ONLY_FOR_ARCHS_REASON</makevar> und
 	      <makevar>NOT_FOR_ARCHS_REASON</makevar> festgelegt
 	      werden.  F&uuml;r eine bestimmte Architektur sind
 	      Angaben durch
 	      <makevar>ONLY_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></makevar>
 	      und
 	      <makevar>NOT_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></makevar>
 	      m&ouml;glich.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Wenn ein Port i386-Bin&auml;rdateien
 	      herunterl&auml;dt und installiert, sollte
 	      <makevar>IA32_BINARY_PORT</makevar> gesetzt werden. Wenn
 	      die Variable gesetzt ist, wird &uuml;berpr&uuml;ft, ob
 	      das Verzeichnis <filename>/usr/lib32</filename> f&uuml;r
 	      IA32-Versionen der Bibliotheken vorhanden ist, und ob
 	      der Kernel mit IA32-Kompatibilit&auml;t gebaut wurde.
 	      Wenn eine dieser zwei Voraussetzungen nicht erf&uuml;llt
 	      ist, wird <makevar>IGNORE</makevar> automatisch
 	      gesetzt.</para>
 	  </listitem>
 	</itemizedlist>
       </sect2>
 
       <sect2 id="dads-noinstall-notes">
 	<title>Anmerkungen zur Implementierung</title>
 
 	<para>Zeichenketten sollten nicht in Anf&uuml;hrungszeichen
 	  gesetzt werden. Auch die Wortwahl der Zeichenketten sollte
 	  die Art und Weise beachten, wie die Informationen dem Nutzer
 	  angezeigt werden. Beispiele:</para>
 
 	<programlisting>BROKEN= this port is unsupported on FreeBSD 5.x</programlisting>
 
 	<programlisting>IGNORE= is unsupported on FreeBSD 5.x</programlisting>
 
 	<para>resultieren in den folgenden Ausgaben von
 	  <command>make describe</command>:</para>
 
 	<programlisting>===&gt;  foobar-0.1 is marked as broken: this port is unsupported on FreeBSD 5.x.</programlisting>
 
 	<programlisting>===&gt;  foobar-0.1 is unsupported on FreeBSD 5.x.</programlisting>
       </sect2>
     </sect1>
 
     <sect1 id="dads-deprecated">
       <title>Kennzeichnen eines Ports zur Entfernung durch
 	<makevar>DEPRECATED</makevar> oder
 	<makevar>EXPIRATION_DATE</makevar></title>
 
       <para>Denken Sie bitte daran, dass <makevar>BROKEN</makevar>
 	und <makevar>FORBIDDEN</makevar> nur als tempor&auml;rer
 	Ausweg verwendet werden sollten, wenn ein Port nicht
 	funktioniert. Dauerhaft defekte Ports sollten komplett aus der
 	Ports-Sammlung entfernt werden.</para>
 
       <para>Wenn es sinnvoll ist, k&ouml;nnen Benutzer vor der
 	anstehenden Entfernung eines Ports mit
 	<makevar>DEPRECATED</makevar> und
 	<makevar>EXPIRATION_DATE</makevar> gewarnt werden. Ersteres
 	ist einfach eine Zeichenkette, die angibt, warum der Port
 	entfernt werden soll. Letzteres ist eine Zeichenkette im ISO
 	8601-Format (JJJJ-MM-TT). Beides wird dem Benutzer
 	gezeigt.</para>
 
       <para>Es ist m&ouml;glich <makevar>DEPRECATED</makevar> ohne
 	<makevar>EXPIRATION_DATE</makevar> zu setzen (zum Beispiel, um
 	eine neuere Version des Ports zu empfehlen), aber das
 	Gegenteil ist sinnlos.</para>
 
       <para>Es gibt keine Vorschrift wie lange die Vorwarnzeit sein
 	muss. Gegenw&auml;rtig ist es &uuml;blich einen Monat f&uuml;r
 	sicherheitsrelevante Probleme und zwei Monate f&uuml;r
 	Build-Probleme anzusetzen. Dies gibt allen interessierten
 	Committern ein wenig Zeit die Probleme zu beheben.</para>
     </sect1>
 
     <sect1 id="dads-dot-error">
       <title>Vermeiden Sie den Gebrauch des
 	<literal>.error</literal>-Konstruktes</title>
 
       <para>Der korrekte Weg eines <filename>Makefile</filename>
 	anzuzeigen, dass der Port aufgrund eines externen Grundes
 	nicht installiert werden kann (zum Beispiel, weil der Benutzer
 	eine ung&uuml;ltige Kombination von Build-Optionen angegeben
 	hat), ist <makevar>IGNORE</makevar> auf einen nicht leeren
 	Wert zu setzen. Dieser wird dann formatiert und dem Benutzer
 	von <command>make install</command> ausgegeben.</para>
 
       <para>Es ist ein verbreiteter Fehler <literal>.error</literal>
 	f&uuml;r diesem Zweck zu verwenden. Das Problem dabei ist,
 	dass viele automatisierte Werkzeuge, die mit dem Ports-Baum
 	arbeiten, in dieser Situation fehlschlagen. Am H&auml;ufigsten
 	tritt das Problem beim Versuch
 	<filename>/usr/ports/INDEX</filename> zu bauen auf (siehe
 	<xref linkend="make-describe">). Jedoch schlagen auch
 	trivialere Befehle wie <command>make -V maintainer</command>
 	in diesem Fall fehl. Dies ist nicht akzeptabel!</para>
 
       <example id="dot-error-breaks-index">
 	<title>Wie vermeidet man die Verwendung von
 	  <literal>.error</literal></title>
 
 	<para>Nehmen Sie an, dass die Zeile
 	  <programlisting>USE_POINTYHAT=yes</programlisting> in
 	  <filename>make.conf</filename> enthalten ist. Der erste der
 	  folgenden zwei <filename>Makefile</filename>-Schnipsel
 	  l&auml;sst <command>make index</command> fehlschlagen,
 	  w&auml;hrend der zweite dies nicht tut.</para>
 
 	<programlisting>.if USE_POINTYHAT
 .error "POINTYHAT is not supported"
 .endif</programlisting>
 	<programlisting>.if USE_POINTYHAT
 IGNORE=POINTYHAT is not supported
 .endif</programlisting>
       </example>
     </sect1>
 
     <sect1 id="dads-sysctl">
       <title>Verwendung von <filename>sysctl</filename></title>
 
       <para>Vom Gebrauch von sysctl wird, au&szlig;er in Targets,
 	abgeraten.  Das liegt daran, dass die Auswertung aller
 	<literal>makevar</literal>s, wie sie w&auml;hrend
 	<command>make index</command> verwendet werden, dann den
 	Befehl ausf&uuml;hren muss, welches den Prozess weiter
 	verlangsamt.</para>
 
       <para>Die Verwendung von &man.sysctl.8; sollte immer durch die
 	Variable <makevar>SYSCTL</makevar> erfolgen, da diese den
 	vollst&auml;ndigen Pfad enth&auml;lt und &uuml;berschrieben
 	werden kann, so dies als notwendig erachtet wird.</para>
     </sect1>
 
     <sect1 id="dads-rerolling-distfiles">
       <title>Erneutes Ausliefern von Distfiles</title>
 
       <para>Manchmal &auml;ndern die Autoren der Software den Inhalt
 	ver&ouml;ffentlichter Distfiles, ohne den Dateinamen zu
 	&auml;ndern.  Sie m&uuml;ssen &uuml;berpr&uuml;fen, ob die
 	&Auml;nderungen offizell sind und vom Autor durchgef&uuml;hrt
 	wurden. Es ist in der Vergangenheit vorgekommen, dass
 	Distfiles still und heimlich auf dem Download-Server
 	ge&auml;ndert wurden, um Schaden zu verursachen oder die
 	Sicherheit der Nutzer zu kompromittieren.</para>
 
       <para>Verschieben Sie das alte Distfile und laden Sie das neue
 	herunter. Entpacken Sie es und vergleichen Sie den Inhalt
 	mittels &man.diff.1;. Wenn Sie nichts Verd&auml;chtiges sehen
 	k&ouml;nnen Sie <filename>distinfo</filename> aktualisieren.
 	Stellen Sie sicher, dass die &Auml;nderungen in Ihrem PR oder
 	Commit-Protokoll zusammengefasst sind, um zu
 	Gew&auml;hrleisten, dass nichts Negatives passiert ist.</para>
 
       <para>Sie k&ouml;nnen auch mit den Autoren der Software in
 	Verbindung treten und sich die &Auml;nderungen best&auml;tigen
 	lassen.</para>
     </sect1>
 
     <sect1 id="dads-workarounds">
       <title>Notwendige Abhilfen (Workarounds)</title>
 
       <para>Manchmal ist es n&ouml;tig Fehler in Programmen, die mit
 	&auml;lteren Versionen von &os; ausgeliefert werden, zu
 	umgehen.</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>Einige Versionen von &man.make.1; waren zumindest
 	    auf &os; 4.8 und 5.0 in Bezug auf die Behandlung von
 	    Vergleichen mit <makevar>OSVERSION</makevar> defekt. Dies
 	    f&uuml;hrte h&auml;ufig zu Fehlern w&auml;hrend
 	    <command>make describe</command> (und damit auch
 	    w&auml;hrend des <command>make index</command> f&uuml;r
 	    alle Ports). Abhilfe schafft hier, den bedingten Vergleich
 	    in Leerzeichen einzuschlie&szlig;en, z.B.:
 	    <programlisting>if ( ${OSVERSION} &gt; 500023
 	    )</programlisting> Beachten Sie, dass eine
 	    Test-Installation eines Ports auf 4.9 oder 5.2 dieses
 	    Problem <emphasis>nicht</emphasis> aufsp&uuml;rt.</para>
 	</listitem>
       </itemizedlist>
     </sect1>
 
     <sect1 id="dads-misc">
       <title>Verschiedenes</title>
 
       <para>Die Dateien <filename>pkg-descr</filename> und
 	<filename>pkg-plist</filename> sollten beide doppelt
 	kontrolliert werden.  Wenn Sie einen Port nachpr&uuml;fen und
 	glauben, dass man es besser machen kann, dann verbessern Sie
 	ihn bitte.</para>
 
       <para>Bitte kopieren Sie nicht noch mehr Exemplare der
 	GNU General Public License in unser System.</para>
 
       <para>Bitte &uuml;berpr&uuml;fen Sie alle gesetzlichen Punkte
 	gr&uuml;ndlich! Lassen Sie uns bitte keine illegale Software
 	verbreiten!</para>
     </sect1>
   </chapter>
 
   <chapter id="porting-samplem">
     <title>Beispiel eines <filename>Makefile</filename></title>
 
     <para>Hier ein Beispiel f&uuml;r ein
       <filename>Makefile</filename>, welches als Vorlage f&uuml;r
       einen neuen Port dienen kann. Alle zus&auml;tzlichen Kommentare
       in eckigen Klammern m&uuml;ssen entfernt werden!</para>
 
     <para>Es wird empfohlen, die hier gezeigte Formatierung zu
       &uuml;bernehmen (Reihenfolge der Variablen, Leerzeichen zwischen
       einzelnen Abschnitten, usw.). Dadurch werden die wichtigen
       Informationen sofort ersichtlich.  Zur &Uuml;berpr&uuml;fung
       Ihres <filename>Makefile</filename>s sollten Sie <link
       linkend="porting-portlint">portlint</link> verwenden.</para>
 
     <programlisting>[the header...just to make it easier for us to identify the ports.]
 # New ports collection makefile for:   xdvi
 [the "version required" line is only needed when the PORTVERSION
  variable is not specific enough to describe the port.]
 # Date created:                26 May 1995
 [this is the person who did the original port to FreeBSD, in particular, the
 person who wrote the first version of this Makefile.  Remember, this should
 not be changed when upgrading the port later.]
 # Whom:                        Satoshi Asami &lt;asami@FreeBSD.org&gt;
 #
 # &dollar;FreeBSD&dollar;
 [ ^^^^^^^^^ This will be automatically replaced with RCS ID string by CVS
 when it is committed to our repository.  If upgrading a port, do not alter
 this line back to "&dollar;FreeBSD&dollar;".  CVS deals with it automatically.]
 #
 
 [section to describe the port itself and the master site - PORTNAME
  and PORTVERSION are always first, followed by CATEGORIES,
  and then MASTER_SITES, which can be followed by MASTER_SITE_SUBDIR.
  PKGNAMEPREFIX and PKGNAMESUFFIX, if needed, will be after that.
  Then comes DISTNAME, EXTRACT_SUFX and/or DISTFILES, and then
  EXTRACT_ONLY, as necessary.]
 PORTNAME=      xdvi
 PORTVERSION=   18.2
 CATEGORIES=    print
 [do not forget the trailing slash ("/")!
  if you are not using MASTER_SITE_* macros]
 MASTER_SITES=  ${MASTER_SITE_XCONTRIB}
 MASTER_SITE_SUBDIR= applications
 PKGNAMEPREFIX= ja-
 DISTNAME=      xdvi-pl18
 [set this if the source is not in the standard ".tar.gz" form]
 EXTRACT_SUFX=  .tar.Z
 
 [section for distributed patches -- can be empty]
 PATCH_SITES=   ftp://ftp.sra.co.jp/pub/X11/japanese/
 PATCHFILES=    xdvi-18.patch1.gz xdvi-18.patch2.gz
 
 [maintainer; *mandatory*!  This is the person who is volunteering to
  handle port updates, build breakages, and to whom a users can direct
  questions and bug reports.  To keep the quality of the Ports Collection
  as high as possible, we no longer accept new ports that are assigned to
  "ports@FreeBSD.org".]
 MAINTAINER=    asami@FreeBSD.org
 COMMENT=       A DVI Previewer for the X Window System
 
 [dependencies -- can be empty]
 RUN_DEPENDS=   gs:${PORTSDIR}/print/ghostscript
 LIB_DEPENDS=   Xpm.5:${PORTSDIR}/graphics/xpm
 
 [this section is for other standard bsd.port.mk variables that do not
  belong to any of the above]
 [If it asks questions during configure, build, install...]
 IS_INTERACTIVE=        yes
 [If it extracts to a directory other than ${DISTNAME}...]
 WRKSRC=                ${WRKDIR}/xdvi-new
 [If the distributed patches were not made relative to ${WRKSRC}, you
  may need to tweak this]
 PATCH_DIST_STRIP=      -p1
 [If it requires a "configure" script generated by GNU autoconf to be run]
 GNU_CONFIGURE= yes
 [If it requires GNU make, not /usr/bin/make, to build...]
 USE_GMAKE=     yes
 [If it is an X application and requires "xmkmf -a" to be run...]
 USE_IMAKE=     yes
 [et cetera.]
 
 [non-standard variables to be used in the rules below]
 MY_FAVORITE_RESPONSE=  "yeah, right"
 
 [then the special rules, in the order they are called]
 pre-fetch:
     i go fetch something, yeah
 
 post-patch:
     i need to do something after patch, great
 
 pre-install:
     and then some more stuff before installing, wow
 
 [and then the epilogue]
 .include &lt;bsd.port.mk&gt;</programlisting>
   </chapter>
 
   <chapter id="keeping-up">
     <title>Auf dem Laufenden bleiben</title>
 
     <para>Die &os; Ports-Sammlung ver&auml;ndert sich st&auml;ndig.
       Hier finden Sie einige Informationen, wie Sie auf dem Laufenden
       bleiben.
 
     <sect1 id="freshports">
       <title>FreshPorts</title>
 
       <para>Einer der einfachsten Wege, um sich &uuml;ber
 	Aktualisierungen, die bereits durchgef&uuml;hrt wurden, zu
 	informieren, ist sich bei <ulink
 	url="http://www.FreshPorts.org/">FreshPorts</ulink>
 	anzumelden.  Sie k&ouml;nnen dort beliebige Ports
 	ausw&auml;hlen, die Sie beobachten m&ouml;chten.  Maintainern
 	wird ausdr&uuml;cklich empfohlen sich anzumelden, da Sie nicht
 	nur &uuml;ber Ihre eigenen &Auml;nderungen informiert werden,
 	sondern auch &uuml;ber die aller anderen Committer (Diese sind
 	oft n&ouml;tig, um &uuml;ber &Auml;nderungen des zugrunde
 	liegenden Frameworks informiert zu bleiben.  Obwohl es
 	h&ouml;flich w&auml;re, vorher &uuml;ber solche
 	&Auml;nderungen benachrichtigt zu werden, wird es manchmal
 	vergessen oder ist einfach nicht m&ouml;glich.  Au&szlig;erdem
 	sind die &Auml;nderungen manchmal nur sehr klein. Wir erwarten
 	von jedem in solchen F&auml;llen nach bestem Gewissen zu
 	urteilen).</para>
 
       <para>Wenn Sie Fresh-Ports benutzen m&ouml;chten,
 	ben&ouml;tigen Sie nur einen Account. Falls Sie sich mit einer
 	<literal>@FreeBSD.org</literal> E-Mailadresse registriert
 	haben, werden Sie den Anmeldelink am rechten Rand der Seite
 	finden.  Diejenigen, die bereits einen FeshPorts-Account
 	haben, aber nicht Ihre <literal>@FreeBSD.org</literal>
 	E-Mailadresse benutzen, k&ouml;nnen einfach Ihre E-Mailadresse
 	auf <literal>@FreeBSD.org</literal> &auml;ndern, sich
 	anmelden, und dann die &Auml;nderung r&uuml;ckg&auml;ngig
 	machen.</para>
 
       <para>FreshPorts bietet auch eine
 	&Uuml;berpr&uuml;fungsfunktion, die automatisch alle Committs
 	zum &os; Ports-Baum testet. Wenn Sie sich f&uuml;r diesen
 	Dienst anmelden, werden Sie &uuml;ber alle Fehler, die bei der
 	&Uuml;berpr&uuml;fung Ihres Committs auftreten,
 	informiert.</para>
     </sect1>
 
     <sect1 id="cvsweb">
       <title>Die Webschnittstelle zum Quelltext-Repository</title>
 
       <para>Es ist m&ouml;glich die Dateien des Quellen-Repositories
 	mit Hilfe einer Webschnittstelle durchzusehen.
 	&Auml;nderungen, die das gesamte Ports-System betreffen,
 	werden jetzt in der Datei <ulink
 	url="http://cvsweb.FreeBSD.org/ports/CHANGES">CHANGES</ulink>
 	dokumentiert.  Solche, die nur bestimmte Ports betreffen, in
 	der Datei <ulink
 	url="http://cvsweb.FreeBSD.org/ports/UPDATING">UPDATING</ulink>.
 	Aber die ma&szlig;gebliche Antwort auf alle Fragen liegt
 	zweifellos darin, den Quelltext von <ulink
 	url="http://cvsweb.FreeBSD.org/ports/Mk/bsd.port.mk">bsd.port.mk</ulink>
 	und dazugeh&ouml;rige Dateien zu lesen.</para>
     </sect1>
 
     <sect1 id="ports-mailling-list">
       <title>Die &os; Ports-Mailingliste</title>
 
       <para>Wenn Sie Maintainer sind, sollten Sie in Erw&auml;gung
 	ziehen die &a.ports;-Mailingliste zu verfolgen. Wichtige
 	&Auml;nderungen an der grundlegenden Funktionsweise von Ports
 	werden dort angek&uuml;ndigt und dann in
 	<filename>CHANGES</filename> committet.</para>
     </sect1>
 
     <sect1 id="build-cluster">
       <title>Der Cluster zum Bauen von &os;-Ports auf <hostid
 	role="hostname">pointyhat.FreeBSD.org</hostid></title>
 
       <para>Eine der weniger bekannten St&auml;rken von &os; ist es,
 	dass ein ganzer Cluster von Maschinen nur daf&uuml;r
 	reserviert ist, andauernd die Ports-Sammlung zu bauen, und
 	zwar f&uuml;r jedes gro&szlig;e &os; Release und jede
 	Tier-1-Architektur. Die Ergebnisse k&ouml;nnen Sie unter
 	<ulink url="http://pointyhat.FreeBSD.org/">package building
 	logs and errors</ulink> finden.</para>
 
       <para>Alle Ports ausser denjenigen, die als
 	<makevar>IGNORE</makevar> markiert sind, werden gebaut. Ports,
 	die als <makevar>BROKEN</makevar> markiert sind, werden
 	dennoch ausprobiert, um zu sehen, ob das zugrunde liegende
 	Problem gel&ouml;st wurde (Dies wird erreicht, indem
 	<makevar>TRYBROKEN</makevar> an das
 	<filename>Makefile</filename> des Ports &uuml;bergeben
 	wird).</para>
     </sect1>
 
     <sect1 id="distfile-survey">
       <title>Die &os; Port-Distfile-Pr&uuml;fung</title>
 
       <para>Der Build-Cluster ist dazu bestimmt, das neueste Release
 	jedes Ports aus bereits heruntergeladenden Distfiles zu bauen.
 	Da sich das Internet aber st&auml;ndig ver&auml;ndert,
 	k&ouml;nnen Distfiles schnell verloren gehen. Die <ulink
 	url="http://people.FreeBSD.org/~fenner/portsurvey/">FreeBSD
 	Ports Distfiles Pr&uuml;fung</ulink> versucht jeden
 	Download-Standort f&uuml;r jeden Port anzufragen, um
 	herauszufinden, ob jedes Distfile noch verf&uuml;gbar ist.
 	Maintainer werden gebeten diesen Bericht regelm&auml;&szlig;ig
 	durchzusehen, nicht nur, um den Build-Prozess f&uuml;r die
 	Nutzer zu beschleunigen, sondern auch um zu vermeiden, dass
 	auf den Maschinen, die freiwillig zur Verf&uuml;gung gestellt
 	werden, um all diese Dateien anzubieten, Ressourcen
 	verschwendet werden.</para>
     </sect1>
 
     <sect1 id="portsmon">
       <title>Das &os; Ports-Monitoring-System</title>
 
       <para>Eine weitere praktische Ressource ist das <ulink
 	url="http://portsmon.FreeBSD.org">FreeBSD
 	Ports-Monitoring-System</ulink> (auch bekannt als
 	<literal>portsmon</literal>). Dieses System besteht aus einer
 	Datenbank, die Informationen von mehreren Quellen bezieht und
 	es erlaubt diese &uuml;ber ein Webinterface abzufragen.
 	Momentan werden die Ports-Problemberichte (PRs), die
 	Fehlerprotokolle des Build-Clusters und die einzelnen Dateien
 	der Ports-Sammlung verwendet. In Zukunft soll das auf die
 	Distfile-Pr&uuml;fung und weitere Informationsquellen
 	ausgedehnt werden.</para>
 
       <para>Als Ausgangspunkt k&ouml;nnen Sie alle Informationen
 	eines Ports mit Hilfe der <ulink
 	url="http://portsmon.FreeBSD.org/portoverview.py">&Uuml;bersicht
 	eines Ports</ulink> betrachten.</para>
 
       <para>Zum Zeitpunkt des Schreibens ist dies die einzige
 	Quelle, die GNATS PR-Eintr&auml;ge auf Portnamen abbildet
 	(PR-Einreicher geben den Portnamen nicht immer in der
 	Zusammenfassung an, obwohl wir uns das w&uuml;nschen
 	w&uuml;rden).  Also ist <literal>portsmon</literal> ein guter
 	Anlaufpunkt, wenn Sie herausfinden wollen, ob zu einem
 	existierenden Port PRs oder Buildfehler eingetragen sind. Oder
 	um herauszufinden, ob ein neuer Port, den Sie erstellen
 	wollen, bereits eingereicht wurde.</para>
     </sect1>
   </chapter>
 </book>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      End:
 -->
diff --git a/de_DE.ISO8859-1/share/sgml/mailing-lists.ent b/de_DE.ISO8859-1/share/sgml/mailing-lists.ent
index 440c404068..e576568a40 100644
--- a/de_DE.ISO8859-1/share/sgml/mailing-lists.ent
+++ b/de_DE.ISO8859-1/share/sgml/mailing-lists.ent
@@ -1,524 +1,528 @@
 <!--
      Namen der FreeBSD Mailinglisten und verwandter Software
 
-     $FreeBSDde: de-docproj/share/sgml/mailing-lists.ent,v 1.31 2007/02/15 17:06:06 jkois Exp $
+     $FreeBSDde: de-docproj/share/sgml/mailing-lists.ent,v 1.33 2007/11/10 17:41:56 miwi Exp $
      $FreeBSD$
-     basiert auf: 1.56
+     basiert auf: 1.57
 -->
 
 <!ENTITY a.mailman.listinfo "http://lists.FreeBSD.org/mailman/listinfo">
 <!ENTITY a.mailman.lists
   "<ulink url='&a.mailman.listinfo;'>FreeBSD list server</ulink>">
 <!ENTITY a.mailman.lists.link
   "<ulink url='&a.mailman.listinfo;'>&a.mailman.listinfo;</ulink>">
 
 <!-- Deutsche Mailinglisten -->
 
 <!ENTITY a.de.translators "'FreeBSD German Documentation Project'
   <email>de-bsd-translators@de.FreeBSD.org</email>">
 
 <!ENTITY a.de.questions "'Fragen und Antworten zu FreeBSD'
   <email>de-bsd-questions@de.FreeBSD.org</email>">
 
 <!-- Die Originale -->
 
 <!ENTITY a.acpi.url "&a.mailman.listinfo;/freebsd-acpi">
 <!ENTITY a.acpi "<ulink url='&a.acpi.url;'>FreeBSD ACPI</ulink>">
 <!ENTITY a.acpi.name "<ulink url='&a.acpi.url;'>freebsd-acpi</ulink>">
 
 <!ENTITY a.advocacy.url "&a.mailman.listinfo;/freebsd-advocacy">
 <!ENTITY a.advocacy "<ulink url='&a.advocacy.url;'>FreeBSD advocacy</ulink>">
 <!ENTITY a.advocacy.name
   "<ulink url='&a.advocacy.url;'>freebsd-advocacy</ulink>">
 
 <!ENTITY a.afs.url "&a.mailman.listinfo;/freebsd-afs">
 <!ENTITY a.afs "<ulink url='&a.afs.url;'>FreeBSD AFS porting</ulink>">
 <!ENTITY a.afs.name "<ulink url='&a.afs.url;'>freebsd-afs</ulink>">
 
 <!ENTITY a.aic7xxx.url "&a.mailman.listinfo;/aic7xxx">
 <!ENTITY a.aic7xxx "<ulink url='&a.aic7xxx.url;'>FreeBSD Adapteci
   AIC7xxx discussions</ulink>">
 <!ENTITY a.aic7xxx.name "<ulink url='&a.aic7xxx.url;'>freebsd-aic7xxx</ulink>">
 
 <!ENTITY a.alpha.url "&a.mailman.listinfo;/freebsd-alpha">
 <!ENTITY a.alpha "<ulink url='&a.alpha.url;'>FreeBSD Alpha porting</ulink>">
 <!ENTITY a.alpha.name "<ulink url='&a.alpha.url;'>freebsd-alpha</ulink>">
 
 <!ENTITY a.amd64.url "&a.mailman.listinfo;/freebsd-amd64">
 <!ENTITY a.amd64 "<ulink url='&a.amd64.url;'>Porting
   FreeBSD to AMD64 systems</ulink>">
 <!ENTITY a.amd64.name "<ulink url='&a.amd64.url;'>freebsd-amd64</ulink>">
 
 <!ENTITY a.announce.url "&a.mailman.listinfo;/freebsd-announce">
 <!ENTITY a.announce "<ulink url='&a.announce.url;'>FreeBSD
   announcements</ulink>">
 <!ENTITY a.announce.name "<ulink
   url='&a.announce.url;'>freebsd-announce</ulink>">
 
 <!ENTITY a.apache.url "&a.mailman.listinfo;/freebsd-apache">
 <!ENTITY a.apache "<ulink url='&a.apache.url;'>FreeBSD Apache</ulink>">
 <!ENTITY a.apache.name "<ulink url='&a.apache.url;'>freebsd-apache</ulink>">
 
 <!ENTITY a.arch.url "&a.mailman.listinfo;/freebsd-arch">
 <!ENTITY a.arch "<ulink url='&a.arch.url;'>FreeBSD architecture and
   design</ulink>">
 <!ENTITY a.arch.name "<ulink url='&a.arch.url;'>freebsd-arch</ulink>">
 
 <!ENTITY a.arm.url "&a.mailman.listinfo;/freebsd-arm">
 <!ENTITY a.arm "<ulink url='&a.arm.url;'>FreeBSD ARM porting</ulink>">
 <!ENTITY a.arm.name "<ulink url='&a.arm.url;'>freebsd-arm</ulink>">
 
 <!ENTITY a.atm.url "&a.mailman.listinfo;/freebsd-atm">
 <!ENTITY a.atm "<ulink url='&a.atm.url;'>FreeBSD ATM networking</ulink>">
 <!ENTITY a.atm.name "<ulink url='&a.atm.url;'>freebsd-atm</ulink>">
 
 <!ENTITY a.audit.url "&a.mailman.listinfo;/freebsd-audit">
 <!ENTITY a.audit "<ulink url='&a.audit.url;'>FreeBSD source code
   audit</ulink>">
 <!ENTITY a.audit.name "<ulink url='&a.audit.url;'>freebsd-audit</ulink>">
 
 <!ENTITY a.binup.url "&a.mailman.listinfo;/freebsd-binup">
 <!ENTITY a.binup "<ulink url='&a.binup.url;'>FreeBSD binary update
   system</ulink>">
 <!ENTITY a.binup.name "<ulink url='&a.binup.url;'>freebsd-binup</ulink>">
 
 <!ENTITY a.bluetooth.url "&a.mailman.listinfo;/freebsd-bluetooth">
 <!ENTITY a.bluetooth "<ulink url='&a.bluetooth.url;'>FreeBSD Bluetooth mailing list</ulink>">
 <!ENTITY a.bluetooth.name "<ulink url='&a.bluetooth.url;'>freebsd-bluetooth</ulink>">
 
 <!ENTITY a.bugbusters.url "&a.mailman.listinfo;/freebsd-bugbusters">
 <!ENTITY a.bugbusters "<ulink url='&a.bugbusters.url;'>FreeBSD
   bugbusters</ulink>">
 <!ENTITY a.bugbusters.name "<ulink
   url='&a.bugbusters.url;'>freebsd-bugbusters</ulink>">
 
 <!ENTITY a.bugs.url "&a.mailman.listinfo;/freebsd-bugs">
 <!ENTITY a.bugs "<ulink url='&a.bugs.url;'>FreeBSD problem reports</ulink>">
 <!ENTITY a.bugs.name "<ulink url='&a.bugs.url;'>freebsd-bugs</ulink>">
 
 <!ENTITY a.chat.url "&a.mailman.listinfo;/freebsd-chat">
 <!ENTITY a.chat "<ulink url='&a.chat.url;'>FreeBSD chat</ulink>">
 <!ENTITY a.chat.name "<ulink url='&a.chat.url;'>freebsd-chat</ulink>">
 
 <!ENTITY a.cluster.url "&a.mailman.listinfo;/freebsd-cluster">
 <!ENTITY a.cluster "<ulink url='&a.cluster.url;'>FreeBSD clustering</ulink>">
 <!ENTITY a.cluster.name "<ulink url='&a.cluster.url;'>freebsd-cluster</ulink>">
 
 <!ENTITY a.committers "<quote>FreeBSD committers</quote>">
 <!ENTITY a.committers.name "cvs-committers">
 
 <!ENTITY a.core "<quote>FreeBSD core team</quote>">
 <!ENTITY a.core.name "freebsd-core">
 
 <!ENTITY a.current.url "&a.mailman.listinfo;/freebsd-current">
 <!ENTITY a.current "<ulink url='&a.current.url;'>&os.current;</ulink>">
 <!ENTITY a.current.name "<ulink url='&a.current.url;'>freebsd-current</ulink>">
 
 <!ENTITY a.ctm-announce.url "&a.mailman.listinfo;/ctm-announce">
 <!ENTITY a.ctm-announce "<ulink url='&a.ctm-announce.url;'>CTM
   announcements</ulink>">
 <!ENTITY a.ctm-announce.name "<ulink
   url='&a.ctm-announce.url;'>ctm-announce</ulink>">
 
 <!ENTITY a.ctm-cvs-cur.url "&a.mailman.listinfo;/ctm-cvs-cur">
 <!ENTITY a.ctm-cvs-cur "<ulink url='&a.ctm-cvs-cur.url;'>CTM
   distribution of CVS files</ulink>">
 <!ENTITY a.ctm-cvs-cur.name "<ulink
   url='&a.ctm-cvs-cur.url;'>ctm-cvs-cur</ulink>">
 
 <!ENTITY a.ctm-src-4.url "&a.mailman.listinfo;/ctm-src-4">
 <!ENTITY a.ctm-src-4 "<ulink url='&a.ctm-src-4.url;'>CTM 4-STABLE
   src branch distribution</ulink>">
 <!ENTITY a.ctm-src-4.name "<ulink url='&a.ctm-src-4.url;'>ctm-src-4</ulink>">
 
 <!ENTITY a.ctm-src-cur.url "&a.mailman.listinfo;/ctm-src-cur">
 <!ENTITY a.ctm-src-cur "<ulink url='&a.ctm-src-cur.url;'>CTM -CURRENT
   src branch distribution</ulink>">
 <!ENTITY a.ctm-src-cur.name "<ulink
   url='&a.ctm-src-cur.url;'>ctm-src-cur</ulink>">
 
 <!ENTITY a.ctm-users.url "&a.mailman.listinfo;/ctm-users">
 <!ENTITY a.ctm-users "<ulink url='&a.ctm-users.url;'>CTM user
   discussion</ulink>">
 <!ENTITY a.ctm-users.name "<ulink url='&a.ctm-users.url;'>ctm-users</ulink>">
 
 <!ENTITY a.cvsall.url "&a.mailman.listinfo;/cvs-all">
 <!ENTITY a.cvsall "<ulink url='&a.cvsall.url;'>FreeBSD CVS commit
   message</ulink>">
 <!ENTITY a.cvsall.name "<ulink url='&a.cvsall.url;'>cvs-all</ulink>">
 
 <!ENTITY a.cvs-doc.url "&a.mailman.listinfo;/cvs-doc">
 <!ENTITY a.cvs-doc "<ulink url='&a.cvs-doc.url;'>FreeBSD CVS doc
   commit</ulink>">
 <!ENTITY a.cvs-doc.name "<ulink url='&a.cvs-doc.url;'>cvs-doc</ulink>">
 
 <!ENTITY a.cvs-ports.url "&a.mailman.listinfo;/cvs-ports">
 <!ENTITY a.cvs-ports "<ulink url='&a.cvs-ports.url;'>FreeBSD CVS ports
   commit</ulink>">
 <!ENTITY a.cvs-ports.name "<ulink url='&a.cvs-ports.url;'>cvs-ports</ulink>">
 
 <!ENTITY a.cvs-projects.url "&a.mailman.listinfo;/cvs-projects">
 <!ENTITY a.cvs-projects "<ulink url='&a.cvs-projects.url;'>FreeBSD CVS
   projects commit</ulink>">
 <!ENTITY a.cvs-projects.name "<ulink
   url='&a.cvs-projects.url;'>cvs-projects</ulink>">
 
 <!ENTITY a.cvs-src.url "&a.mailman.listinfo;/cvs-src">
 <!ENTITY a.cvs-src "<ulink url='&a.cvs-src.url;'>FreeBSD CVS src
   commit</ulink>">
 <!ENTITY a.cvs-src.name "<ulink url='&a.cvs-src.url;'>cvs-src</ulink>">
 
 <!ENTITY a.cvsweb.url "&a.mailman.listinfo;/freebsd-cvsweb">
 <!ENTITY a.cvsweb "<ulink url='&a.cvsweb.url;'>FreeBSD CVSweb
   maintenance</ulink>">
 <!ENTITY a.cvsweb.name "<ulink url='&a.cvsweb.url;'>freebsd-cvsweb</ulink>">
 
 <!ENTITY a.database.url "&a.mailman.listinfo;/freebsd-database">
 <!ENTITY a.database "<ulink url='&a.database.url;'>FreeBSD based
   Databases</ulink>">
 <!ENTITY a.database.name "<ulink
   url='&a.database.url;'>freebsd-database</ulink>">
 
 <!ENTITY a.developers "<quote>FreeBSD developers</quote>">
 <!ENTITY a.developers.name "freebsd-developers">
 
 <!ENTITY a.drivers.url "&a.mailman.listinfo;/freebsd-drivers">
 <!ENTITY a.drivers "<ulink url='&a.drivers.url;'>Writing device drivers
   for FreeBSD</ulink>">
 <!ENTITY a.drivers.name "<ulink url='&a.drivers.url;'>freebsd-drivers</ulink>">
 
 <!ENTITY a.doc.url "&a.mailman.listinfo;/freebsd-doc">
 <!ENTITY a.doc "<ulink url='&a.doc.url;'>FreeBSD documentation
   project</ulink>">
 <!ENTITY a.doc.name "<ulink url='&a.doc.url;'>freebsd-doc</ulink>">
 
 <!ENTITY a.doc-committers "<quote>FreeBSD doc/ Committer</quote>">
 <!ENTITY a.doc-committers.name "doc-committers">
 
 <!ENTITY a.doc-developers "<quote>FreeBSD doc/ developers</quote>">
 <!ENTITY a.doc-developers.name "doc-developers">
 
 <!ENTITY a.eclipse.url "&a.mailman.listinfo;/freebsd-eclipse">
 <!ENTITY a.eclipse "<ulink url='&a.eclipse.url;'>FreeBSD users of Eclipse EDI, tools, rich client apps and ports.</ulink>">
 <!ENTITY a.eclipse.name "<ulink url='&a.eclipse.url;'>freebsd-eclipse</ulink>">
 
 <!ENTITY a.embedded.url "&a.mailman.listinfo;/freebsd-embedded">
 <!ENTITY a.embedded "<ulink url='&a.embedded.url;'>FreeBSD-embedded mailing list</ulink>">
 <!ENTITY a.embedded.name "<ulink url='&a.embedded.url;'>freebsd-embedded</ulink>">
 
 <!ENTITY a.emulation.url "&a.mailman.listinfo;/freebsd-emulation">
 <!ENTITY a.emulation "<ulink url='&a.emulation.url;'>FreeBSD-emulation</ulink>">
 <!ENTITY a.emulation.name "<ulink
   url='&a.emulation.url;'>freebsd-emulation</ulink>">
 
 <!ENTITY a.eol.url "&a.mailman.listinfo;/freebsd-eol">
 <!ENTITY a.eol "<ulink url='&a.eol.url;'>FreeBSD-eol mailing list</ulink>">
 <!ENTITY a.eol.name "<ulink url='&a.eol.url;'>freebsd-eol</ulink>">
 
 <!ENTITY a.firewire.url "&a.mailman.listinfo;/freebsd-firewire">
 <!ENTITY a.firewire "<ulink url='&a.firewire.url;'>FreeBSD FireWire
   (IEEE 1394) discussion</ulink>">
 <!ENTITY a.firewire.name "<ulink
   url='&a.firewire.url;'>freebsd-firewire</ulink>">
 
 <!ENTITY a.fs.url "&a.mailman.listinfo;/freebsd-fs">
 <!ENTITY a.fs "<ulink url='&a.fs.url;'>FreeBSD filesystem project</ulink>">
 <!ENTITY a.fs.name "<ulink url='&a.fs.url;'>freebsd-fs</ulink>">
 
 <!ENTITY a.geom.url "&a.mailman.listinfo;/freebsd-geom">
 <!ENTITY a.geom "<ulink url='&a.geom.url;'>FreeBSD GEOM</ulink>">
 <!ENTITY a.geom.name "<ulink url='&a.geom.url;'>freebsd-geom</ulink>">
 
 <!ENTITY a.gnome.url "&a.mailman.listinfo;/freebsd-gnome">
 <!ENTITY a.gnome "<ulink url='&a.gnome.url;'>FreeBSD GNOME and
   GNOME applications</ulink>">
 <!ENTITY a.gnome.name "<ulink url='&a.gnome.url;'>freebsd-gnome</ulink>">
 
 <!ENTITY a.hackers.url "&a.mailman.listinfo;/freebsd-hackers">
 <!ENTITY a.hackers "<ulink url='&a.hackers.url;'>FreeBSD technical
   discussions</ulink>">
 <!ENTITY a.hackers.name "<ulink url='&a.hackers.url;'>freebsd-hackers</ulink>">
 
 <!ENTITY a.hardware.url "&a.mailman.listinfo;/freebsd-hardware">
 <!ENTITY a.hardware "<ulink url='&a.hardware.url;'>FreeBSD hardware
   and equipment</ulink>">
 <!ENTITY a.hardware.name "<ulink
   url='&a.hardware.url;'>freebsd-hardware</ulink>">
 
 <!ENTITY a.hubs.url "&a.mailman.listinfo;/freebsd-hubs">
 <!ENTITY a.hubs "<ulink url='&a.hubs.url;'>FreeBSD mirror sites</ulink>">
 <!ENTITY a.hubs.name "<ulink url='&a.hubs.url;'>freebsd-hubs</ulink>">
 
 <!ENTITY a.i18n.url "&a.mailman.listinfo;/freebsd-i18n">
 <!ENTITY a.i18n "<ulink url='&a.i18n.url;'>FreeBSD
   internationalization</ulink>">
 <!ENTITY a.i18n.name "<ulink url='&a.i18n.url;'>freebsd-i18n</ulink>">
 
 <!ENTITY a.i386.url "&a.mailman.listinfo;/freebsd-i386">
 <!ENTITY a.i386 "<ulink url='&a.i386.url;'>FreeBSD i386-specific
   issues</ulink>">
 <!ENTITY a.i386.name "<ulink url='&a.i386.url;'>freebsd-i386</ulink>">
 
 <!ENTITY a.ia32.url "&a.mailman.listinfo;/freebsd-ia32">
 <!ENTITY a.ia32 "<ulink url='&a.ia32.url;'>FreeBSD IA32 porting</ulink>">
 <!ENTITY a.ia32.name "<ulink url='&a.ia32.url;'>freebsd-ia32</ulink>">
 
 <!ENTITY a.ia64.url "&a.mailman.listinfo;/freebsd-ia64">
 <!ENTITY a.ia64 "<ulink url='&a.ia64.url;'>FreeBSD IA64 porting</ulink>">
 <!ENTITY a.ia64.name "<ulink url='&a.ia64.url;'>freebsd-ia64</ulink>">
 
 <!ENTITY a.ipfw.url "&a.mailman.listinfo;/freebsd-ipfw">
 <!ENTITY a.ipfw "<ulink url='&a.ipfw.url;'>FreeBSD IPFW code</ulink>">
 <!ENTITY a.ipfw.name "<ulink url='&a.ipfw.url;'>freebsd-ipfw</ulink>">
 
 <!ENTITY a.isdn.url "&a.mailman.listinfo;/freebsd-isdn">
 <!ENTITY a.isdn "<ulink url='&a.isdn.url;'>FreeBSD ISDN</ulink>">
 <!ENTITY a.isdn.name "<ulink url='&a.isdn.url;'>freebsd-isdn</ulink>">
 
 <!ENTITY a.isp.url "&a.mailman.listinfo;/freebsd-isp">
 <!ENTITY a.isp "<ulink url='&a.isp.url;'>FreeBSD Internet service
   providers</ulink>">
 <!ENTITY a.isp.name "<ulink url='&a.isp.url;'>freebsd-isp</ulink>">
 
+<!ENTITY a.jail.url "&a.mailman.listinfo;/freebsd-jail">
+<!ENTITY a.jail "<ulink url='&a.jail.url;'>FreeBSD jails mailing list</ulink>">
+<!ENTITY a.jail.name "<ulink url='&a.jail.url;'>freebsd-jail</ulink>">
+
 <!ENTITY a.java.url "&a.mailman.listinfo;/freebsd-java">
 <!ENTITY a.java "<ulink url='&a.java.url;'>FreeBSD Java Language</ulink>">
 <!ENTITY a.java.name "<ulink url='&a.java.url;'>freebsd-java</ulink>">
 
 <!ENTITY a.jobs.url "&a.mailman.listinfo;/freebsd-jobs">
 <!ENTITY a.jobs "<ulink url='&a.jobs.url;'>FreeBSD related employment</ulink>">
 <!ENTITY a.jobs.name "<ulink url='&a.jobs.url;'>freebsd-jobs</ulink>">
 
 <!ENTITY a.kde.url "https://mail.kde.org/mailman/listinfo/kde-freebsd">
 <!ENTITY a.kde "<ulink url='&a.kde.url;'>FreeBSD KDE/Qt and KDE
   applications</ulink>">
 <!ENTITY a.kde.name "<ulink url='&a.kde.url;'>freebsd-kde</ulink>">
 
 <!ENTITY a.lfs.url "&a.mailman.listinfo;/freebsd-lfs">
 <!ENTITY a.lfs "<ulink url='&a.lfs.url;'>FreeBSD LFS porting</ulink>">
 <!ENTITY a.lfs.name "<ulink url='&a.lfs.url;'>freebsd-lfs</ulink>">
 
 <!ENTITY a.libh.url "&a.mailman.listinfo;/freebsd-libh">
 <!ENTITY a.libh "<ulink url='&a.libh.url;'>FreeBSD libh installation
   and packaging system</ulink>">
 <!ENTITY a.libh.name "<ulink url='&a.libh.url;'>freebsd-libh</ulink>">
 
 <!ENTITY a.mips.url "&a.mailman.listinfo;/freebsd-mips">
 <!ENTITY a.mips "<ulink url='&a.mips.url;'>FreeBSD MIPS porting</ulink>">
 <!ENTITY a.mips.name "<ulink url='&a.mips.url;'>freebsd-mips</ulink>">
 
 <!ENTITY a.mirror-announce.url "&a.mailman.listinfo;/mirror-announce">
 <!ENTITY a.mirror-announce "<ulink url='&a.mirror-announce.url;'>FreeBSD
   mirror site administrators</ulink>">
 <!ENTITY a.mirror-announce.name "<ulink
   url='&a.mirror-announce.url;'>mirror-announce</ulink>">
 
 <!ENTITY a.mobile.url "&a.mailman.listinfo;/freebsd-mobile">
 <!ENTITY a.mobile "<ulink url='&a.mobile.url;'>FreeBSD laptop computer</ulink>">
 <!ENTITY a.mobile.name "<ulink url='&a.mobile.url;'>freebsd-mobile</ulink>">
 
 <!ENTITY a.mozilla.url "&a.mailman.listinfo;/freebsd-mozilla">
 <!ENTITY a.mozilla "<ulink url='&a.mozilla.url;'>FreeBSD port of the
   Mozilla browser</ulink>">
 <!ENTITY a.mozilla.name "<ulink url='&a.mozilla.url;'>freebsd-mozilla</ulink>">
 
 <!ENTITY a.multimedia.url "&a.mailman.listinfo;/freebsd-multimedia">
 <!ENTITY a.multimedia "<ulink url='&a.multimedia.url;'>FreeBSD
   multimedia</ulink>">
 <!ENTITY a.multimedia.name "<ulink
   url='&a.multimedia.url;'>freebsd-multimedia</ulink>">
 
 <!ENTITY a.net.url "&a.mailman.listinfo;/freebsd-net">
 <!ENTITY a.net "<ulink url='&a.net.url;'>FreeBSD networking</ulink>">
 <!ENTITY a.net.name "<ulink url='&a.net.url;'>freebsd-net</ulink>">
 
 <!ENTITY a.newbies.url "&a.mailman.listinfo;/freebsd-newbies">
 <!ENTITY a.newbies "<ulink url='&a.newbies.url;'>FreeBSD new users</ulink>">
 <!ENTITY a.newbies.name "<ulink url='&a.newbies.url;'>freebsd-newbies</ulink>">
 
 <!ENTITY a.newbus.url "&a.mailman.listinfo;/freebsd-new-bus">
 <!ENTITY a.newbus "<ulink url='&a.newbus.url;'>New Bus Architecture</ulink>">
 <!ENTITY a.newbus.name "<ulink url='&a.newbus.url;'>freebsd-new-bus</ulink>">
 
 <!ENTITY a.openoffice.url "&a.mailman.listinfo;/freebsd-openoffice">
 <!ENTITY a.openoffice "<ulink url='&a.openoffice.url;'>FreeBSD
   OpenOffice</ulink>">
 <!ENTITY a.openoffice.name "<ulink
   url='&a.openoffice.url;'>freebsd-openoffice</ulink>">
 
 <!ENTITY a.performance.url "&a.mailman.listinfo;/freebsd-performance">
 <!ENTITY a.performance "<ulink url='&a.performance.url;'>FreeBSD
   performance</ulink>">
 <!ENTITY a.performance.name "<ulink
   url='&a.performance.url;'>freebsd-performance</ulink>">
 
 <!ENTITY a.perl.url "&a.mailman.listinfo;/freebsd-perl">
 <!ENTITY a.perl "<ulink url='&a.perl.url;'>FreeBSD Perl</ulink>">
 <!ENTITY a.perl.name "<ulink url='&a.performance.url;'>freebsd-perl</ulink>">
 
 <!ENTITY a.pf.url "&a.mailman.listinfo;/freebsd-pf">
 <!ENTITY a.pf "<ulink url='&a.pf.url;'>FreeBSD packet filter mailing list</ulink>">
 <!ENTITY a.pf.name "<ulink url='&a.pf.url;'>freebsd-pf</ulink>">
 
 <!ENTITY a.platforms.url "&a.mailman.listinfo;/freebsd-platforms">
 <!ENTITY a.platforms "<ulink url='&a.platforms.url;'>FreeBSD non-Intel
   platforms porting</ulink>">
 <!ENTITY a.platforms.name "<ulink
   url='&a.platforms.url;'>freebsd-platforms</ulink>">
 
 <!ENTITY a.policy.url "&a.mailman.listinfo;/freebsd-policy">
 <!ENTITY a.policy "<ulink url='&a.policy.url;'>FreeBSD core team
   policy decisions</ulink>">
 <!ENTITY a.policy.name "<ulink url='&a.policy.url;'>freebsd-policy</ulink>">
 
 <!ENTITY a.ports.url "&a.mailman.listinfo;/freebsd-ports">
 <!ENTITY a.ports "<ulink url='&a.ports.url;'>FreeBSD ports</ulink>">
 <!ENTITY a.ports.name "<ulink url='&a.ports.url;'>freebsd-ports</ulink>">
 
 <!ENTITY a.ports-developers "<quote>FreeBSD ports/ developers</quote>">
 <!ENTITY a.ports-developers.name "ports-developers">
 
 <!ENTITY a.ports-bugs.url "&a.mailman.listinfo;/freebsd-ports-bugs">
 <!ENTITY a.ports-bugs "<ulink url='&a.ports-bugs.url;'>FreeBSD
   ports bugs</ulink>">
 <!ENTITY a.ports-bugs.name "<ulink
   url='&a.ports-bugs.url;'>freebsd-ports-bugs</ulink>">
 
 <!ENTITY a.ports-committers "<quote>FreeBSD ports/ Committer</quote>">
 <!ENTITY a.ports-committers.name "ports-committers">
 
 <!ENTITY a.ppc.url "&a.mailman.listinfo;/freebsd-ppc">
 <!ENTITY a.ppc "<ulink url='&a.ppc.url;'>FreeBSD PowerPC porting</ulink>">
 <!ENTITY a.ppc.name "<ulink url='&a.ppc.url;'>freebsd-ppc</ulink>">
 
 <!ENTITY a.proliant.url "&a.mailman.listinfo;/freebsd-proliant">
 <!ENTITY a.proliant "<ulink url='&a.proliant.url;'>Technical discussion of FreeBSD
   on HP ProLiant server platforms</ulink>">
 <!ENTITY a.proliant.name "<ulink url='&a.proliant.url;'>freebsd-proliant</ulink>">
 
 <!ENTITY a.python.url "&a.mailman.listinfo;/freebsd-python">
 <!ENTITY a.python "<ulink url='&a.python.url;'>FreeBSD Python mailing list</ulink>">
 <!ENTITY a.python.name "<ulink url='&a.python.url;'>freebsd-python</ulink>">
 
 <!ENTITY a.qa.url "&a.mailman.listinfo;/freebsd-qa">
 <!ENTITY a.qa "<ulink url='&a.qa.url;'>FreeBSD Quality Assurance</ulink>">
 <!ENTITY a.qa.name "<ulink url='&a.qa.url;'>freebsd-qa</ulink>">
 
 <!ENTITY a.questions.url "&a.mailman.listinfo;/freebsd-questions">
 <!ENTITY a.questions "<ulink url='&a.questions.url;'>FreeBSD general
   questions</ulink>">
 <!ENTITY a.questions.name "<ulink
   url='&a.questions.url;'>freebsd-questions</ulink>">
 
 <!ENTITY a.rc.url "&a.mailman.listinfo;/freebsd-rc">
 <!ENTITY a.rc "<ulink url='&a.rc.url;'>FreeBSD boot script system mailing list</ulink>">
 <!ENTITY a.rc.name "<ulink url='&a.rc.url;'>freebsd-rc</ulink>">
 
 <!ENTITY a.realtime.url "&a.mailman.listinfo;/freebsd-realtime">
 <!ENTITY a.realtime "<ulink url='&a.realtime.url;'>FreeBSD realtime
   extensions</ulink>">
 <!ENTITY a.realtime.name "<ulink
   url='&a.realtime.url;'>freebsd-realtime</ulink>">
 
 <!ENTITY a.scsi.url "&a.mailman.listinfo;/freebsd-scsi">
 <!ENTITY a.scsi "<ulink url='&a.scsi.url;'>FreeBSD SCSI subsystem</ulink>">
 <!ENTITY a.scsi.name "<ulink url='&a.scsi.url;'>freebsd-scsi</ulink>">
 
 <!ENTITY a.security.url "&a.mailman.listinfo;/freebsd-security">
 <!ENTITY a.security "<ulink url='&a.security.url;'>FreeBSD security</ulink>">
 <!ENTITY a.security.name "<ulink
   url='&a.security.url;'>freebsd-security</ulink>">
 
 <!ENTITY a.security-notifications.url
   "&a.mailman.listinfo;/freebsd-security-notifications">
 <!ENTITY a.security-notifications "<ulink
   url='&a.security-notifications.url;'>FreeBSD security notifications</ulink>">
 <!ENTITY a.security-notifications.name "<ulink
   url='&a.security-notifications.url;'>freebsd-security-notifications</ulink>">
 
 <!ENTITY a.small.url "&a.mailman.listinfo;/freebsd-small">
 <!ENTITY a.small "<ulink url='&a.small.url;'>FreeBSD-small</ulink>">
 <!ENTITY a.small.name "<ulink url='&a.small.url;'>freebsd-small</ulink>">
 
 <!ENTITY a.smp.url "&a.mailman.listinfo;/freebsd-smp">
 <!ENTITY a.smp "<ulink url='&a.smp.url;'>FreeBSD symmetric
   multiprocessing</ulink>">
 <!ENTITY a.smp.name "<ulink url='&a.smp.url;'>freebsd-smp</ulink>">
 
 <!ENTITY a.sparc.url "&a.mailman.listinfo;/freebsd-sparc64">
 <!ENTITY a.sparc "<ulink url='&a.sparc.url;'>FreeBSD SPARC porting</ulink>">
 <!ENTITY a.sparc.name "<ulink url='&a.sparc.url;'>freebsd-sparc64</ulink>">
 
 <!ENTITY a.src-committers "<quote>FreeBSD src/ Committer</quote>">
 <!ENTITY a.src-committers.name "freebsd-src-committers">
 
 <!ENTITY a.src-developers "<quote>FreeBSD src/ developers</quote>">
 <!ENTITY a.src-developers.name "freebsd-src-developers">
 
 <!ENTITY a.stable.url "&a.mailman.listinfo;/freebsd-stable">
 <!ENTITY a.stable "<ulink url='&a.stable.url;'>&os.stable;</ulink>">
 <!ENTITY a.stable.name "<ulink url='&a.stable.url;'>freebsd-stable</ulink>">
 
 <!ENTITY a.standards.url "&a.mailman.listinfo;/freebsd-standards">
 <!ENTITY a.standards "<ulink url='&a.standards.url;'>FreeBSD C99 and
   POSIX compliance</ulink>">
 <!ENTITY a.standards.name "<ulink
   url='&a.standards.url;'>freebsd-standards</ulink>">
 
 <!ENTITY a.sun4v.url "&a.mailman.listinfo;/freebsd-sun4v">
 <!ENTITY a.sun4v "<ulink url='&a.sun4v.url;'>FreeBSD sun4v porting mailing list</ulink>">
 <!ENTITY a.sun4v.name "<ulink url='&a.sun4v.url;'>freebsd-sun4v</ulink>">
 
 <!ENTITY a.test.url "&a.mailman.listinfo;/freebsd-test">
 <!ENTITY a.test "<ulink url='&a.test.url;'>FreeBSD test</ulink>">
 <!ENTITY a.test.name "<ulink url='&a.test.url;'>freebsd-test</ulink>">
 
 <!ENTITY a.testing.url "&a.mailman.listinfo;/freebsd-testing">
 <!ENTITY a.testing "<ulink url='&a.testing.url;'>FreeBSD performance
   and stability testing</ulink>">
 <!ENTITY a.testing.name "<ulink url='&a.testing.url;'>freebsd-testing</ulink>">
 
 <!ENTITY a.threads.url "&a.mailman.listinfo;/freebsd-threads">
 <!ENTITY a.threads "<ulink url='&a.threads.url;'>FreeBSD threads</ulink>">
 <!ENTITY a.threads.name "<ulink url='&a.threads.url;'>freebsd-threads</ulink>">
 
 <!ENTITY a.tokenring.url "&a.mailman.listinfo;/freebsd-tokenring">
 <!ENTITY a.tokenring "<ulink url='&a.tokenring.url;'>FreeBSD
   tokenring</ulink>">
 <!ENTITY a.tokenring.name "<ulink
   url='&a.tokenring.url;'>freebsd-tokenring</ulink>">
 
 <!ENTITY a.usb.url "&a.mailman.listinfo;/freebsd-usb">
 <!ENTITY a.usb "<ulink url='&a.usb.url;'>FreeBSD USB</ulink>">
 <!ENTITY a.usb.name "<ulink url='&a.usb.url;'>freebsd-usb</ulink>">
 
 <!ENTITY a.usergroups.url "&a.mailman.listinfo;/freebsd-user-groups">
 <!ENTITY a.usergroups "<ulink url='&a.usergroups.url;'>FreeBSD user group
   coordination</ulink>">
 <!ENTITY a.usergroups.name "<ulink
   url='&a.usergroups.url;'>freebsd-user-groups</ulink>">
 
 <!ENTITY a.vendors.url "&a.mailman.listinfo;/freebsd-vendors">
 <!ENTITY a.vendors "<ulink url='&a.vendors.url;'>FreeBSD vendors
   pre-release coordination</ulink>">
 <!ENTITY a.vendors.name "<ulink
   url='&a.vendors.url;'>freebsd-vendors</ulink>">
 
 <!ENTITY a.vuxml.url "&a.mailman.listinfo;/freebsd-vuxml">
 <!ENTITY a.vuxml "<unlink url='&a.vuxml.url;'>Diskussion &uuml;ber
   die Infrastruktur von VuXML</ulink>">
 <!ENTITY a.vuxml.name "<ulink url='&a.vuxml.url;'>freebsd-vuxml</ulink>">
 
 <!ENTITY a.www.url "&a.mailman.listinfo;/freebsd-www">
 <!ENTITY a.www "<ulink url='&a.www.url;'>FreeBSD Webmaster</ulink>">
 <!ENTITY a.www.name "<ulink url='&a.www.url;'>freebsd-www</ulink>">
 
 <!ENTITY a.x11.url "&a.mailman.listinfo;/freebsd-x11">
 <!ENTITY a.x11 "<ulink url='&a.x11.url;'>FreeBSD X11 mailing list</ulink>">
 <!ENTITY a.x11.name "<ulink url='&a.x11.url;'>freebsd-x11</ulink>">
 
 <!-- Keine echten Mailinglisten, nur technische Vereinfachungen -->
 
 <!ENTITY a.bugfollowup "<email>bug-followup@FreeBSD.org</email>">
 <!ENTITY a.bugsubmit "&a.bugfollowup;">
 
 <!ENTITY a.majordomo "<email>majordomo@FreeBSD.org</email>">
diff --git a/de_DE.ISO8859-1/share/sgml/teams.ent b/de_DE.ISO8859-1/share/sgml/teams.ent
index 342aef535e..0ed571d711 100644
--- a/de_DE.ISO8859-1/share/sgml/teams.ent
+++ b/de_DE.ISO8859-1/share/sgml/teams.ent
@@ -1,52 +1,58 @@
 <!--
      Names and email address of teams of people working on specified
      tasks. Usally they're just mail aliases set up at hub.FreeBSD.org
 
      Use these entities when referencing appropriate teams.
 
      Please keep this list in alphabetical order by entity names.
 
      IMPORTANT:  If you delete names from this file you *must* ensure that
                  all references to them have been removed from the handbook's
                  translations.  If they haven't then you *will* break the
                  builds for the other languages, and we will poke fun of you
                  in public.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/share/sgml/teams.ent,v 1.12 2004/11/03 23:37:33 mheinen Exp $
-     basiert auf: 1.15
+     $FreeBSDde: de-docproj/share/sgml/teams.ent,v 1.13 2007/11/10 15:13:23 miwi Exp $
+     basiert auf: 1.18
 -->
 
 <!ENTITY a.admins "FreeBSD Administrators <email>admins@FreeBSD.org</email>">
 
+<!ENTITY a.bugmeister "Problem Report Database administrators <email>bugmeister@FreeBSD.org</email>">
+
 <!ENTITY a.core-secretary "Core Team Secretary <email>core-secretary@FreeBSD.org </email>">
 
 <!ENTITY a.cvsadm "CVS Repository Meisters <email>cvsadm@FreeBSD.org</email>">
 
 <!ENTITY a.cvsup-master "CVSup Mirror Site Coordinator <email>cvsup-master@FreeBSD.org</email>">
 
 <!ENTITY a.dcvs "CVS doc Repository Meisters <email>dcvs@FreeBSD.org</email>">
 
 <!ENTITY a.doceng "Documentation Engineering Team <email>doceng@FreeBSD.org</email>">
 
 <!ENTITY a.donations "Donations Liaison Office <email>donations@FreeBSD.org</email>">
 
 <!ENTITY a.faq "FAQ Maintainer <email>faq@FreeBSD.org</email>">
 
 <!ENTITY a.ftp-master "FTP Mirror Site Coordinator <email>ftp-master@FreeBSD.org</email>">
 
 <!ENTITY a.mirror-admin "FTP/WWW Mirror Site Coordinator <email>mirror-admin@FreeBSD.org</email>">
 
 <!ENTITY a.ncvs "CVS src Repository Meisters <email>ncvs@FreeBSD.org</email>">
 
+<!ENTITY a.perforce-admin "Perforce Repository Meisters <email>perforce-admin@FreeBSD.org</email>">
+
 <!ENTITY a.pcvs "CVS ports Repository Meisters <email>pcvs@FreeBSD.org</email>">
 
 <!ENTITY a.portmgr "Ports Management Team <email>portmgr@FreeBSD.org</email>">
 
+<!ENTITY a.portmgr-secretary "Ports Management Team Secretary <email>portmgr-secretary@FreeBSD.org</email>">
+
 <!ENTITY a.projcvs "CVS Third-Party Projects Repository Meisters <email>projcvs@FreeBSD.org</email>">
 
 <!ENTITY a.re "Release Engineering Team <email>re@FreeBSD.org</email>">
 
 <!ENTITY a.security-officer "Security Officer Team <email>security-officer@FreeBSD.org</email>">
 
 <!ENTITY a.www "FreeBSD Webmasters <email>www@FreeBSD.org</email>">
diff --git a/de_DE.ISO8859-1/share/sgml/trademarks.sgml b/de_DE.ISO8859-1/share/sgml/trademarks.sgml
index d8a74baec4..5aef110aca 100644
--- a/de_DE.ISO8859-1/share/sgml/trademarks.sgml
+++ b/de_DE.ISO8859-1/share/sgml/trademarks.sgml
@@ -1,45 +1,45 @@
 <!-- 
      Trademark Legend, as required by The Open Group, Sun, etc..
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/share/sgml/trademarks.sgml,v 1.2 2003/09/03 20:11:21 mheinen Exp $
-     basiert auf: 1.5
+     $FreeBSDde: de-docproj/share/sgml/trademarks.sgml,v 1.4 2007/11/11 13:42:42 miwi Exp $
+     basiert auf: 1.6
 -->
 
 <legalnotice id="trademarks" role="trademarks">
 
   <para>FreeBSD ist ein eingetragenes Warenzeichen von
-    Wind River Systems, Inc.  Dies soll sich bald &auml;ndern.</para>
+    der FreeBSD Foundation.</para>
 
   <para>UNIX ist ein eingetragenes Warenzeichen von The Open Group
     in den Vereinigten Staaten und in anderen L&auml;ndern.</para>
 
   <para>Sun, Sun Microsystems, SunOS, Solaris, und Java
     sind Warenzeichen oder eingetragene Warenzeichen von
     Sun Microsystems, Inc. in den Vereinigten Staaten und
     in anderen L&auml;ndern.</para>
 
 <!-- Product Trademarks -->
 
   <para>Apple und QuickTime sind Warenzeichen oder eingetragene
     Warenzeichen von Apple Computer, Inc. in den Vereinigten Staaten
     und in anderen L&auml;ndern.</para>
 
   <para>Macromedia und Flash sind Warenzeichen oder eingetragene
     Warenzeichen von Macromedia, Inc. in den Vereinigten Staaten
     und/oder in anderen L&auml;ndern.</para>
 
   <para>Microsoft, Windows, und Windows Media sind Warenzeichen oder
     eingetragene Warenzeichen der Microsoft Corporation
     in den Vereinigten Staaten und/oder in anderen L&auml;ndern.</para>
 
   <para>PartitionMagic ist ein eingetragenes Warenzeichen von PowerQuest
     Corporation in den Vereinigten Staaten und/oder in anderen
     L&auml;ndern.</para>
 
   <para>Viele Produktbezeichnungen von Herstellern und
     Verk&auml;ufern sind Warenzeichen.  Soweit dem FreeBSD Project
     das Warenzeichen bekannt ist, werden die in diesem
     Buch vorkommenden Bezeichnungen mit dem Symbol &trade;
     gekennzeichnet.</para>
 </legalnotice>