Update to r40050:

Add information on how to update the source code using Subversion, and
therefore deprecate CVS and CVSup as ways of updating.

Reviewed by:	bcr
This commit is contained in:
Bjoern Heidotting 2015-09-24 17:26:27 +00:00
parent 197a6aa414
commit 25669ff80b
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=47438

View file

@ -5,7 +5,7 @@
$FreeBSD$
$FreeBSDde$
basiert auf: r39749
basiert auf: r40050
-->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="updating-upgrading">
<info><title>&os; aktualisieren</title>
@ -56,6 +56,7 @@
<listitem>
<para>wissen, wie Sie Ihr System mit
<application>freebsd-update</application>,
<application>Subversion</application>,
<application>CVSup</application>,
<application>CVS</application> oder
<application>CTM</application>
@ -69,7 +70,8 @@
<listitem>
<para>wissen, wie Sie ihre Dokumentation mit
<application>CVSup</application> oder Dokumentations-Ports
<application>Subversion</application> oder
Dokumentations-Ports
<!-- oder <application>Docsnap</application> -->
aktuell halten können.</para>
</listitem>
@ -100,15 +102,11 @@
</itemizedlist>
<note>
<para>Im gesamten Kapitel wird der Befehl <command>cvsup</command>
verwendet, um die &os; Quellen zu beziehen und zu aktualisieren. Um es
zu verwenden, benötigen Sie einen Port oder ein Paket wie
<package>net/cvsup</package> (falls Sie den
graphischen <command>cvsup</command>-Client nicht benötigen,
können Sie auch nur den Port
<filename>net/cvsup-without-gui</filename> installieren).
Alternativ können Sie auch &man.csup.1; verwenden, das bereits
Teil des Basissystems ist.</para>
<para>Im gesamten Kapitel wird der Befehl <command>svn</command>
verwendet, um die &os; Quellen zu beziehen und zu
aktualisieren. Um es zu verwenden, müssen Sie den Port oder
das Paket <package>devel/subversion</package>
installieren.</para>
</note>
</sect1>
@ -1378,23 +1376,39 @@ Fetching 133 new ports or files... done.</screen>
<listitem>
<para>Beschaffen Sie sich die Quellen von einem
<link linkend="mirrors">&os;-Spiegel</link>. Sie haben
dazu zwei Möglichkeiten:</para>
dazu drei Möglichkeiten:</para>
<orderedlist>
<listitem>
<para>Benutzen Sie das Programm <link linkend="svn">svn</link>, um den gewünschten
Entwicklungs- oder Release-Zweig auszuchecken.
Dies ist die empfohlene Methode für den Zugang zur
Entwicklung von &os;. Das bevorzugte URL-Präfix für
<application>Subversion</application> zum Auschecken
des -CURRENT Basissystems ist
<literal>http://svn.freebsd.org/base/head</literal>.
Aufgrund der Größe des Repositories ist es
empfehlenswert, nur die gewünschten Teilbäume
auszuchecken.</para>
</listitem>
<listitem>
<para>Benutzen Sie das Programm
<link linkend="cvsup">cvsup</link><indexterm><primary><command>cvsup</command></primary></indexterm>
mit der Datei <filename>standard-supfile</filename>
mit der Datei
<filename>standard-supfile</filename>
aus dem Verzeichnis
<filename>/usr/share/examples/cvsup</filename>.
Dies ist die empfohlene Methode, da Sie die ganzen
Quellen nur einmal herunterladen und danach nur noch
Änderungen beziehen. Viele lassen
<command>cvsup</command> aus <command>cron</command>
heraus laufen, um ihre Quellen automatisch auf Stand
zu bringen. Sie müssen die obige Sup-Datei
anpassen und <link linkend="cvsup">cvsup</link><indexterm><primary>-CURRENT</primary><secondary>mit <application>CVSup</application> synchronisieren</secondary></indexterm>
in Ihrer Umgebung konfigurieren.</para>
Sie müssen die obige <filename>supfile</filename>
anpassen und
<link linkend="cvsup">cvsup</link><indexterm><primary>-CURRENT</primary><secondary>mit <application>CVSup</application> synchronisieren</secondary></indexterm>
für Ihre Umgebung konfigurieren.</para>
<warning>
<para><command>cvsup</command> wurde vom Projekt als
veraltet eingestuft. Der Einsatz dieses Programms
wird nicht weiter empfohlen.</para>
</warning>
<note>
<para>Die <filename>standard-supfile</filename>-Beispieldatei
@ -1424,10 +1438,9 @@ Fetching 133 new ports or files... done.</screen>
mühsam und Sie können beschädigte Dateien
erhalten. Daher wird es selten benutzt, was wiederum
dazu führt, dass es über längere Zeit
nicht funktioniert. Wir empfehlen jedem mit einem
9600&nbsp;bps oder schnellerem Modem,
<application>CVSup</application>
zu benutzen.</para>
nicht funktioniert. Wir empfehlen die Nutzung von
<application>Subversion</application> für jedes
System mit Internet-Anbindung.</para>
</listitem>
</orderedlist>
</listitem>
@ -1545,7 +1558,7 @@ Fetching 133 new ports or files... done.</screen>
<para>Abonnieren Sie die passende
<application>SVN</application>-Liste für den jeweiligen
Branch, den Sie verfolgen. Wenn Sie beispielsweise den Zweig
7-STABLE verfolgen, lesen Sie die &a.svn-src-stable-7.name;.
9-STABLE verfolgen, lesen Sie die &a.svn-src-stable-9.name;.
Dort sehen Sie zu jeder Änderung das Commit-Log, das
Informationen zu möglichen Seiteneffekten
enthält.</para>
@ -1572,30 +1585,55 @@ Fetching 133 new ports or files... done.</screen>
<para>Wenn Sie schon ein älteres Release von &os;
und das System mit dem Quellcode aktualisieren wollen,
benutzen Sie einen der <link linkend="mirrors">&os;-Spiegel</link>. Sie haben
dazu zwei Möglichkeiten:</para>
dazu drei Möglichkeiten:</para>
<orderedlist>
<listitem>
<para>Benutzen Sie das Programm
<link linkend="cvsup">cvsup</link><indexterm><primary><command>cvsup</command></primary></indexterm>
mit der Datei <filename>stable-supfile</filename><indexterm><primary>-STABLE</primary><secondary>mit <application>CVSup</application> synchronisieren</secondary></indexterm>
aus dem Verzeichnis
<filename>/usr/share/examples/cvsup</filename>.
Dies ist die empfohlene Methode, da Sie die ganzen
Quellen nur einmal herunterladen und danach nur noch
Änderungen beziehen. Viele lassen
<command>cvsup</command> aus <command>cron</command>
heraus laufen, um ihre Quellen automatisch auf Stand
zu bringen. Sie müssen das oben erwähnte
<filename>supfile</filename> anpassen und <link linkend="cvsup">cvsup</link> konfigurieren.</para>
<link
linkend="svn">svn</link><indexterm><primary>-STABLE</primary><secondary>mit <application>Subversion</application> synchronisieren</secondary></indexterm>,
um den gewünschten Entwicklungs- oder Release-Zweig
auszuchecken. Dies ist die empfohlene Methode für den
Zugang zur Entwicklung von &os;. Die Zweige umfassen
<literal>head</literal>, für den aktuellen
Entwicklungszweig, sowie weitere Zweige die in
<link xlink:href="&url.base;/releng/">www.freebsd.org/base</link>
bezeichnet sind, wie beispielsweise
<literal>stable/9</literal> oder
<literal>stable/10</literal>. Das bevorzugte
URL-Präfix für <application>Subversion</application>
zum Auschecken des Basissystems ist
<literal>http://svn.freebsd.org/base/</literal>.
Aufgrund der Größe des Repositories ist es
empfehlenswert, nur die gewünschten Teilbäume
auszuchecken.</para>
</listitem>
<listitem>
<para>Benutzen Sie <application>
CTM</application><indexterm><primary>-STABLE</primary><secondary>mit CTM synchronisieren</secondary></indexterm>. Wenn Sie über
keine schnelle und billige Internet-Anbindung
verfügen, sollten Sie diese Methode in Betracht
ziehen.</para>
<para>Benutzen Sie das Programm
<link linkend="cvsup">cvsup</link><indexterm><primary><command>cvsup</command></primary></indexterm>
mit der Datei
<filename>stable-supfile</filename><indexterm><primary>-STABLE</primary><secondary>mit <application>CVSup</application> synchronisiereny</secondary></indexterm>
aus dem Verzeichnis
<filename>/usr/share/examples/cvsup</filename>.
Sie müssen das oben erwähnte
<filename>supfile</filename> anpassen und
<link linkend="cvsup">cvsup</link>
konfigurieren.</para>
<warning>
<para><command>cvsup</command> wurde vom Projekt als
veraltet eingestuft. Der Einsatz dieses Programms
wird nicht weiter empfohlen.</para>
</warning>
</listitem>
<listitem>
<para>Benutzen Sie
<application>CTM</application><indexterm><primary>-STABLE</primary><secondary>mit CTM synchronisieren</secondary></indexterm>.
Wenn Sie über keine schnelle und billige
Internet-Anbindung verfügen, sollten Sie diese
Methode in Betracht ziehen.</para>
</listitem>
</orderedlist>
</listitem>
@ -1632,6 +1670,7 @@ Fetching 133 new ports or files... done.</screen>
<para>Sie können eine Internet-Verbindung (oder E-Mail) dazu
nutzen, Teile von &os;, wie die Quellen zu einzelnen Projekten, oder
das Gesamtsystem, aktuell zu halten. Dazu bieten wir die Dienste
<link linkend="svn">Subversion</link>,
<link linkend="anoncvs">AnonymousCVS</link>,
<link linkend="cvsup">CVSup</link> und
<link linkend="ctm">CTM</link> an.</para>
@ -1654,7 +1693,8 @@ Fetching 133 new ports or files... done.</screen>
<secondary>anonymous</secondary>
</indexterm>
<para><application>Anonymous CVS</application> und
<para><application>Subversion</application>,
<application>Anonymous CVS</application> und
<application>CVSup</application> benutzen die
<foreignphrase>Pull</foreignphrase>-Methode
<footnote>
@ -1662,22 +1702,24 @@ Fetching 133 new ports or files... done.</screen>
<emphasis>ziehen</emphasis>. Der Client holt sich bei dieser
Methode die Dateien ab.</para>
</footnote>, um die Quellen zu aktualisieren. Im Fall von
<application>CVSup</application> ruft der Benutzer oder ein
<command>cron</command>-Skript <command>cvsup</command> auf, das
wiederum mit einem <command>cvsupd</command> Server interagiert, um
Ihre Quellen zu aktualisieren. Mit beiden Methoden erhalten Sie
aktuelle Updates zu einem genau von Ihnen bestimmten Zeitpunkt. Sie
können die Prozedur auf bestimmte Dateien oder Verzeichnisse
<application>Subversion</application> ruft der Benutzer (oder
ein <command>cron</command>-Skript) das Programm
<command>svn</command> auf, das die Quellen aktualisiert.
<application>Subversion</application> ist die empfohlene
Methode, um die lokalen Quellen zu aktualisieren.
<command>cvsup</command> und <command>cvs</command> arbeiten
nach ähnlichen Prinzipien, gelten aber im Vergleich zu
Subversion als veraltet. Mit beiden Methoden erhalten Sie
aktuelle Updates zu einem genau von Ihnen bestimmten Zeitpunkt.
Sie können die Prozedur auf bestimmte Dateien oder Verzeichnisse
einschränken, so dass Sie nur die Updates bekommen, die
für Sie von Interesse sind. Die Updates werden zur Laufzeit,
abhängig von den Sachen, die Sie schon haben und den Sachen, die
Sie haben wollen, auf dem Server generiert. <application>Anonymous
CVS</application> ist eine Erweiterung von
<application>CVS</application>, die es Ihnen erlaubt, Änderungen
direkt aus einem entfernten CVS-Repository zu ziehen.
<application>Anonymous CVS</application> ist leichter zu handhaben
als <application>CVSup</application>, doch ist letzteres sehr viel
effizienter.</para>
Sie haben wollen, auf dem Server generiert. Falls es keinen
überzeugenden Grund gibt, sollte
<application>Subversion</application> den Vorzug vor anderen
Synchronisierungsmechanismen erhalten, da die Unterstützung für
die älteren Mechanismen in Zukunft eingestellt wird.</para>
<indexterm>
<primary><application>CTM</application></primary>