Date: Fri, 14 Aug 2015 17:16:04 +0000 (UTC) From: Bjoern Heidotting <bhd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47230 - head/de_DE.ISO8859-1/books/handbook/cutting-edge Message-ID: <201508141716.t7EHG4He055078@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: bhd Date: Fri Aug 14 17:16:03 2015 New Revision: 47230 URL: https://svnweb.freebsd.org/changeset/doc/47230 Log: Update to r39399: Update the cutting-edge chapter for obtaining/updating the FreeBSD Documentation Project sources to reflect the CVS->SVN conversion. Approved by: bcr (mentor) Modified: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml Modified: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml Fri Aug 14 17:09:27 2015 (r47229) +++ head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml Fri Aug 14 17:16:03 2015 (r47230) @@ -5,7 +5,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38879 + basiert auf: r39399 --> <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> @@ -755,13 +755,13 @@ Fetching 133 new ports or files... done. ausgeliefert wird, zu aktualisieren, indem eine lokale Kopie der aktuellen &os;-Dokumentationssammlung verwendet wird.</para> - <sect2 xml:id="csup-doc"> - <title>Verwenden von CVSup um die Dokumentation zu aktualisieren</title> - - <para>Die Quellen und die installierte Kopie der &os; Dokumentation - kann mittels <application>CVSup</application> aktualisiert werden, - indem ein ähnlicher Mechanismus angewendet wird, wie derjenige - für die Betriebssystemquellen (vergleichen Sie mit <xref linkend="makeworld"/>). Dieser Abschnitt beschreibt:</para> + <sect2 xml:id="dsvn-doc"> + <title>Verwenden von <application>Subversion</application> um + die Dokumentation zu aktualisieren</title> + + <para>Die Dokumentationsquellen von &os; können mittels + <application>Subversion</application> aktualisiert werden. + Dieser Abschnitt beschreibt:</para> <itemizedlist> <listitem> @@ -772,7 +772,7 @@ Fetching 133 new ports or files... done. <listitem> <para>Wie man eine Kopie der Dokumentationsquellen nach <filename>/usr/doc</filename> herunterlädt, unter - Verwendung von <application>CVSup</application>.</para> + Verwendung von <application>Subversion</application>.</para> </listitem> <listitem> @@ -792,7 +792,7 @@ Fetching 133 new ports or files... done. </sect2> <sect2 xml:id="installing-documentation-toolchain"> - <title>CVSup und die Werkzeugsammlung der Dokumentation + <title><application>Subversion</application> und die Werkzeugsammlung der Dokumentation installieren</title> <para>Die &os; Dokumentation aus dem Quellen zu erstellen benötigt @@ -822,69 +822,35 @@ Fetching 133 new ports or files... done. wird.</para> </note> - <para>Für weitere Informationen über das Installieren und - Verwenden von <application>CVSup</application>, lesen Sie <link linkend="cvsup">CVSup verwenden</link>.</para> + <para><application>Subversion</application> wird über den Port + <package>textproc/docproj</package> mit installiert.</para> </sect2> <sect2 xml:id="updating-documentation-sources"> <title>Die Dokumentationsquellen aktualisieren</title> - <para>Das Programm <application>CVSup</application> kann eine saubere - Kopie der Dokumentationsquellen holen, indem es die Datei - <filename>/usr/share/examples/cvsup/doc-supfile</filename> als - Konfigurationsvorlage verwendet. Der Standard-Host zum Aktualisieren - ist auf einen Platzhalterwert im <filename>doc-supfile</filename> - gesetzt, aber &man.cvsup.1; akzeptiert auch einen Hostnamen über - die Kommandozeile. Somit können die Dokumentationsquellen von - einem der <application>CVSup</application>-Server geholt werden, indem - man eingibt:</para> - - <screen>&prompt.root; <userinput>cvsup -h cvsup.FreeBSD.org -g -L 2 /usr/share/examples/cvsup/doc-supfile</userinput></screen> - - <para>Ändern Sie <replaceable>cvsup.FreeBSD.org</replaceable> auf - den Ihnen am nächsten gelegenen - <application>CVSup</application>-Server. Eine vollständige Liste - von Spiegelservern finden Sie unter <xref linkend="cvsup-mirrors"/>.</para> + <para>Das Programm <application>Subversion</application> kann eine saubere + Kopie der Dokumentationsquellen holen:</para> + + <screen>&prompt.root; <userinput>svn checkout <literal>svn://svn.freebsd.org/doc/head</literal> <filename>/usr/doc</filename></userinput></screen> <para>Es dauert eine Weile, wenn die Dokumentationsquellen das allererste Mal heruntergeladen werden. Lassen Sie es laufen, bis es fertig ist.</para> <para>Zukünftige Aktualisierungen der Dokumentationsquellen - können Sie über den gleichen Befehl bekommen. Das Programm - <application>CVSup</application> lädt und kopiert nur diejenigen - Aktualisierungen herunter, die seit seinem letzten Aufruf hinzugekommen - sind. Deshalb sollte jeder weitere Aufruf von - <application>CVSup</application> nach dem Ersten wesentlich schneller - abgeschlossen sein.</para> + können wie folgt durchgeführt werden:</para> + + <screen>&prompt.root; <userinput>svn update <filename>/usr/doc</filename></userinput></screen> <para>Nachdem die Quellen einmal ausgecheckt wurden, besteht ein anderer - Weg, die Dokumentation zu aktualisieren, darin, das - <filename>Makefile</filename> im Verzeichnis <filename>/usr/doc</filename> anzupassen. Durch setzen von - <varname>SUP_UPDATE</varname>, <varname>SUPHOST</varname> und - <varname>DOCSUPFILE</varname> in der Datei - <filename>/etc/make.conf</filename> ist es jetzt möglich, - folgendes zu tun:</para> + Weg, die Dokumentation zu aktualisieren, durch das + <filename>Makefile</filename> im Verzeichnis + <filename>/usr/doc</filename>:</para> <screen>&prompt.root; <userinput>cd /usr/doc</userinput> &prompt.root; <userinput>make update</userinput></screen> - <para>Ein typischer Satz dieser &man.make.1;-Optionen für - <filename>/etc/make.conf</filename> ist:</para> - - <programlisting>SUP_UPDATE= yes -SUPHOST?= cvsup.freebsd.org -DOCSUPFILE?= /usr/share/examples/cvsup/doc-supfile</programlisting> - - <note> - <para>Das Setzen des Werts von <varname>SUPHOST</varname> und - <varname>DOCSUPFILE</varname> auf <literal>?=</literal> erlaubt es, - diese in der Kommandozeile von make zu überschreiben. Diese - Methode wird empfohlen, um Optionen zu <filename>make.conf</filename> - hinzuzufügen, um zu verhindern, dass man die Datei jedes Mal - bearbeiten muss, um einen anderen Wert für die Option - auszuprobieren.</para> - </note> </sect2> <sect2 xml:id="updating-documentation-options"> @@ -925,15 +891,6 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d </varlistentry> <varlistentry> - <term><varname>SUPHOST</varname></term> - - <listitem> - <para>Der Hostname des <application>CVSup</application>-Servers, - der verwendet werden soll, um Aktualisierungen zu holen.</para> - </listitem> - </varlistentry> - - <varlistentry> <term><varname>DOCDIR</varname></term> <listitem> @@ -966,15 +923,6 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d <screen>&prompt.root; <userinput>cd /usr/doc</userinput> &prompt.root; <userinput>make install clean</userinput></screen> - <para>Wenn <filename>make.conf</filename> mit den richtigen Optionen - <varname>DOCSUPFILE</varname>, <varname>SUPHOST</varname> und - <varname>SUP_UPDATE</varname> eingerichtet wurde, kann der - Installationsschritt mit einer Aktualisierung der Dokumentationsquellen - kombiniert werden, indem man eingibt:</para> - - <screen>&prompt.root; <userinput>cd /usr/doc</userinput> -&prompt.root; <userinput>make update install clean</userinput></screen> - <para>Wenn nur eine Aktualisierung einer bestimmten Sprache gewünscht wird, kann &man.make.1; in einem sprachspezifischen Unterverzeichnis von <filename>/usr/doc</filename> @@ -1014,7 +962,7 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d Dokumentationsquellen benötigt eine grosse Anzahl an Werkzeugen, Programmen und Hilfsmitteln, die <emphasis>documentation toolchain</emphasis>, ein gewisser Grad an Vertrautheit mit - <application>CVS</application> und ausgecheckte Quellen von einem + <application>Subversion</application> und ausgecheckte Quellen von einem Repository, sowie ein paar manuelle Schritte, um diese ausgecheckten Quellen zu bauen. In diesem Abschnitt wird eine alternative Art und Weise vorgestellt, wie man die installierte Kopie der @@ -1143,7 +1091,7 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d <note> <para>Beachten Sie, dass sich der Standardpfad von dem Verzeichnis unterscheidet, das von der - <application>CVSup</application>-Methode verwendet wird. + <application>Subversion</application>-Methode verwendet wird. Das liegt daran, dass ein Port installiert wird und diese üblicherweise im Verzeichnis <filename>/usr/local</filename> abgelegt werden. Durch setzen der <varname>PREFIX</varname>-Variablen kann
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201508141716.t7EHG4He055078>