[svnbook commit] r3429 - trunk/src/de/book
codesite-noreply at google.com
codesite-noreply at google.com
Mon Feb 16 15:04:20 CST 2009
Author: jmfelderhoff at gmx.eu
Date: Mon Feb 16 13:03:45 2009
New Revision: 3429
Modified:
trunk/src/de/book/ch05-repository-admin.xml
Log:
* trunk/src/de/book/ch05-repository-admin.xml
- Fixes ticket #212 (cf. http://www.svnbook.de/report/6).
Modified: trunk/src/de/book/ch05-repository-admin.xml
==============================================================================
--- trunk/src/de/book/ch05-repository-admin.xml (original)
+++ trunk/src/de/book/ch05-repository-admin.xml Mon Feb 16 13:03:45 2009
@@ -2130,7 +2130,8 @@
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<sect3 id="svn.reposadmin.maint.tk.svnlook">
<title>svnlook</title>
-
+
+<!--
<para><command>svnlook</command> is a tool provided by
Subversion for examining the various revisions and
<firstterm>transactions</firstterm> (which are revisions
@@ -2142,10 +2143,28 @@
committed (in the case of the <command>post-commit</command>
hook) to the repository. A repository administrator may use
this tool for diagnostic purposes.</para>
-
+-->
+ <para><command>svnlook</command> ist ein von Subversion
+ mitgeliefertes Dienstprogramm zum Untersuchen der
+ mannigfaltigen Revisionen und
+ <firstterm>Transaktionen</firstterm> (bei denen es sich um
+ Revisionen in Entstehung handelt) in einem Repository. Kein
+ Teil dieses Programms versucht, das Repository zu verändern.
+ <command>svnlook</command> wird üblicherweise von
+ Repository-Hooks verwendet, um die abzuliefernden Änderungen
+ zu melden (im Fall des <command>pre-commit</command>-Hooks)
+ oder die gerade an das Repository übergeben wurden (im Fall
+ des <command>post-commit</command>-hooks). Ein
+ Repository-Administrator kann dieses Programm zur Diagnose
+ benutzen.</para>
+
+<!--
<para><command>svnlook</command> has a straightforward
syntax:</para>
-
+-->
+ <para><command>svnlook</command> besitzt eine überschaubare
+ Syntax:</para>
+
<screen>
$ svnlook help
general usage: svnlook SUBCOMMAND REPOS_PATH [ARGS & OPTIONS ...]
@@ -2157,32 +2176,56 @@
…
</screen>
+<!--
<para>Most of <command>svnlook</command>'s
subcommands can operate on either a revision or a
transaction tree, printing information about the tree
itself, or how it differs from the previous revision of the
- repository. You use the <option>--revision</option>
- (<option>-r</option>) and <option>--transaction</option>
+ repository. You use the <option>- -revision</option>
+ (<option>-r</option>) and <option>- -transaction</option>
(<option>-t</option>) options to specify which revision or
transaction, respectively, to examine. In the absence of
- both the <option>--revision</option> (<option>-r</option>)
- and <option>--transaction</option> (<option>-t</option>)
+ both the <option>- -revision</option> (<option>-r</option>)
+ and <option>- -transaction</option> (<option>-t</option>)
options, <command>svnlook</command> will examine the
youngest (or <literal>HEAD</literal>) revision in the
repository. So the following two commands do exactly the
same thing when 19 is the youngest revision in the
repository located at
<filename>/var/svn/repos</filename>:</para>
+-->
+ <para>Die meisten Unterbefehle von <command>svnlook</command>
+ können entweder auf einem Revisions- oder auf einem
+ Transaktionsbaum arbeiten, indem sie Informationen über den
+ Baum an sich ausgeben oder darüber, inwiefern er sich von
+ einer früheren Revision des Repositorys unterscheidet. Sie
+ verwenden die Optionen <option>--revision</option>
+ (<option>-r</option>) und <option>--transaction</option>
+ (<option>-t</option>), um die zu untersuchende Revision bzw.
+ Transaktion anzugeben. Ohne eine der Optionen
+ <option>--revision</option> (<option>-r</option>) und
+ <option>--transaction</option> (<option>-t</option>)
+ untersucht Subversion die jüngste (oder
+ <literal>HEAD</literal>) Revision des Repositorys. Das
+ heisst, die beiden folgenden Befehle machen genau dasselbe,
+ wenn 19 die jüngste Revision im Repository unter
+ <filename>/var/svn/repos</filename> ist:</para>
<screen>
$ svnlook info /var/svn/repos
$ svnlook info /var/svn/repos -r 19
</screen>
+<!--
<para>One exception to these rules about subcommands is
the <command>svnlook youngest</command> subcommand, which
takes no options and simply prints out the repository's
youngest revision number:</para>
+-->
+ <para>Eine Ausnahme von diesen Regeln zu Unterbefehlen ist der
+ Unterbefehl <command>svnlook youngest</command>, der keine
+ Optionen entgegennimmt und einfach die jüngste
+ Revisionsnummer des Repositorys ausgibt:</para>
<screen>
$ svnlook youngest /var/svn/repos
@@ -2191,18 +2234,33 @@
</screen>
<note>
+<!--
<para>Keep in mind that the only transactions you can browse
are uncommitted ones. Most repositories will have no such
transactions because transactions are usually either
committed (in which case, you should access them as
- revision with the <option>--revision</option>
+ revision with the <option>- -revision</option>
(<option>-r</option>) option) or aborted and
removed.</para>
+-->
+ <para>Beachten Sie, dass Sie nur Transaktionen untersuchen
+ können, die noch nicht übergeben sind. Die meisten
+ Repositorys haben keine derartigen Transaktionen, da
+ Transaktionen entweder übergeben (in diesem Fall sollten
+ Sie darauf mit der Option <option>--revision</option>
+ (<option>-r</option>) zugreifen) oder abgebrochen und
+ entfernt sind.</para>
</note>
+<!--
<para>Output from <command>svnlook</command> is designed to be
both human- and machine-parsable. Take, as an example, the
output of the <command>svnlook info</command> subcommand:</para>
+-->
+ <para>Die Ausgabe <command>svnlook</command> ist so gestaltet,
+ dass sie sowohl für Menschen als auch für Maschinen lesbar
+ ist. Nehmen wir zum Beispiel die Ausgabe des Unterbefehls
+ <command>svnlook info</command>:</para>
<screen>
$ svnlook info /var/svn/repos
@@ -2214,25 +2272,44 @@
$
</screen>
+<!--
<para>The output of <command>svnlook info</command> consists
of the following, in the order given:</para>
+-->
+ <para>Die Ausgabe von <command>svnlook info</command> besteht
+ aus dem Folgenden in entsprechender Reihenfolge:</para>
<orderedlist>
<listitem>
+<!--
<para>The author, followed by a newline</para>
+-->
+ <para>Der Autor gefolgt von einem Zeilenvorschub</para>
</listitem>
<listitem>
+<!--
<para>The date, followed by a newline</para>
+-->
+ <para>Das Datum gefolgt von einem Zeilenvorschub</para>
</listitem>
<listitem>
+<!--
<para>The number of characters in the log message,
followed by a newline</para>
+-->
+ <para>Die Anzahl der Zeichen der Protokollnachricht
+ gefolgt von einem Zeilenvorschub.</para>
</listitem>
<listitem>
+<!--
<para>The log message itself, followed by a newline</para>
+-->
+ <para>Die eigentliche Protokollnachricht gefolgt von einem
+ Zeilenvorschub</para>
</listitem>
</orderedlist>
+<!--
<para>This output is human-readable, meaning items such as the
datestamp are displayed using a textual representation
instead of something more obscure (such as the number of
@@ -2246,7 +2323,23 @@
allocate for the message, or at least how many bytes to skip
in the event that this output is not the last bit of data in
the stream.</para>
+-->
+ <para>Diese Ausgabe ist für Menschen lesbar, d.h., Dinge wie
+ der Zeitstempel werden als Text dargestellt statt als
+ irgendetwas Obskures (wie die Anzahl der Nanosekunden seit
+ der Mann von Bofrost das letzte Mal da war). Jedoch ist die
+ Ausgabe auch maschinenlesbar – weil die
+ Protokollnachricht mehrere Zeilen umfassen und von der Länge
+ her unbegrenzt sein kann, liefert <command>svnlook</command>
+ die Länge der Nachricht vor der eigentlichen Nachricht. Das
+ erlaubt Scripten und anderen Programmen, die um diesen
+ Befehl herumgeschrieben wurden, intelligente Entscheidungen
+ in Bezug auf die Protokollnachricht zu treffen, etwa wieviel
+ Speicher für die Nachricht anzufordern ist oder zumindest
+ wieviele Bytes zu überspringen sind, falls diese Ausgabe
+ nicht das letzte Stück im Datenstrom sein sollte.</para>
+<!--
<para><command>svnlook</command> can perform a variety of
other queries: displaying subsets of bits of information
we've mentioned previously, recursively listing versioned
@@ -2255,6 +2348,16 @@
differences made to files and directories, and so on. See
<xref linkend="svn.ref.svnlook" /> for a full reference of
<command>svnlook</command>'s features.</para>
+-->
+ <para><command>svnlook</command> kann eine Auswahl anderer
+ Abfragen ausführen: Teilmengen der bereits erwähnten
+ Informationen ausgeben, versionierte Verzeichnisbäume
+ rekursiv auflisten, berichten, welche Pfade in einer
+ bestimmten Revision oder Transaktion verändert wurden,
+ textuelle und property-basierte Unterschiede an Dateien und
+ Verzeichnissen aufzeigen, usw. Siehe <xref
+ linkend="svn.ref.svnlook" /> für eine vollständige Referenz
+ der Funktionen von <command>svnlook</command>.</para>
</sect3>
More information about the svnbook-dev
mailing list