[svnbook] r4703 committed - Translation: Basic Usage (up to "Listing versioned directories")
svnbook at googlecode.com
svnbook at googlecode.com
Thu Mar 6 15:30:51 CST 2014
Revision: 4703
Author: jmfelderhoff at gmx.eu
Date: Thu Mar 6 21:30:41 2014 UTC
Log: Translation: Basic Usage (up to "Listing versioned directories")
http://code.google.com/p/svnbook/source/detail?r=4703
Modified:
/branches/1.7/de/book/ch02-basic-usage.xml
=======================================
--- /branches/1.7/de/book/ch02-basic-usage.xml Thu Mar 6 06:54:26 2014 UTC
+++ /branches/1.7/de/book/ch02-basic-usage.xml Thu Mar 6 21:30:41 2014 UTC
@@ -3560,20 +3560,12 @@
Konflikt oder sonst zu jeder Zeit), machen Sie einfach Ihre
Änderungen rückgängig:</para>
-<!--
<informalexample>
<screen>
$ svn revert sandwich.txt
+<!--
Reverted 'sandwich.txt'
-$ ls sandwich.*
-sandwich.txt
-$
-</screen>
- </informalexample>
-->
- <informalexample>
- <screen>
-$ svn revert sandwich.txt
Rückgängig gemacht: »sandwich.txt«
$ ls sandwich.*
sandwich.txt
@@ -3627,19 +3619,14 @@
<option>--message</option> (<option>-m</option>) in der
Kommandozeile angeben:</para>
-<!--
<informalexample>
<screen>
$ svn commit -m "Corrected number of cheese slices."
+<!--
Sending sandwich.txt
Transmitting file data .
Committed revision 3.
-</screen>
- </informalexample>
-->
- <informalexample>
- <screen>
-$ svn commit -m "Anzahl Käsescheiben korrigiert."
Sende sandwich.txt
Übertrage Daten .
Revision 3 übertragen.
@@ -3659,19 +3646,14 @@
holen, indem Sie ihren Namen mit der Option
<option>--file</option> (<option>-F</option>) angeben:</para>
-<!--
<informalexample>
<screen>
$ svn commit -F logmsg
+<!--
Sending sandwich.txt
Transmitting file data .
Committed revision 4.
-</screen>
- </informalexample>
-->
- <informalexample>
- <screen>
-$ svn commit -F logmsg
Sende sandwich.txt
Übertrage Daten .
Revision 4 übertragen.
@@ -3711,22 +3693,15 @@
sollten, löschen Sie einfach den gesamten Text, sichern Sie
erneut und brechen dann ab:</para>
-<!--
<informalexample>
<screen>
$ svn commit
+<!--
Waiting for Emacs...Done
Log message unchanged or not specified
(a)bort, (c)ontinue, (e)dit
-a
-$
-</screen>
- </informalexample>
-->
- <informalexample>
- <screen>
-$ svn commit
Logmeldung unverändert oder nicht angegeben
A)bbrechen, Weitermac)hen, E)ditieren:
@@ -3752,23 +3727,18 @@
Übergabe mit einer Meldung fehlschlagen, dass eine oder
mehrere Ihrer Dateien nicht mehr aktuell sind:</para>
-<!--
<informalexample>
<screen>
+<!--
$ svn commit -m "Add another rule"
Sending rules.txt
-svn: Commit failed (details follow):
-svn: File '/sandwich.txt' is out of date
-…
-</screen>
- </informalexample>
+svn: E155011: Commit failed (details follow):
+svn: E155011: File '/home/sally/svn-work/sandwich.txt' is out of date
-->
- <informalexample>
- <screen>
$ svn commit -m "Noch eine Regel hinzufügen"
Sende rules.txt
-svn: Übertragen schlug fehl (Details folgen):
-svn: Datei »/rules.txt« ist veraltet
+svn: E155011: Übertragen schlug fehl (Details folgen):
+svn: E155011: Datei »/home/sally/svn-work/sandwich.txt« ist veraltet
…
</screen>
</informalexample>
@@ -3888,12 +3858,28 @@
<para>Retrieves a file as it existed in a particular
revision number and displays it on your screen</para>
-->
- <para>Holt eine Datei hervor wie sie mit einer bestimmten
+ <para>Holt eine Datei hervor, wie sie mit einer bestimmten
Revisionsnummer einmal ausgesehen hat und zeigt sie auf
dem Bildschirm an</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><command>svn annotate</command></term>
+ <listitem>
+<!--
+ <para>Retrieves a human-readable file as it existed in a
+ particular revision number, displaying its contents in a
+ tabular form with last-changed information attributed to
+ each line of the file.</para>
+-->
+ <para>Holt eine Datei hervor, wie sie mit einer bestimmten
+ Revisionsnummer einmal ausgesehen hat und zeigt den
+ Inhalt in Tabellenform mit Informationen, wann jede
+ Zeile das letzte Mal geändert wurde.</para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><command>svn list</command></term>
<listitem>
@@ -4150,44 +4136,35 @@
verfügbar – dem die Übergabe begleitenden
Protokolleintrag:</para>
-<!--
<informalexample>
<screen>
$ svn log
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+------------------------------------------------------------------------
r3 | sally | 2008-05-15 23:09:28 -0500 (Thu, 15 May 2008) | 1 line
+<!--
Added include lines and corrected # of cheese slices.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-r2 | harry | 2008-05-14 18:43:15 -0500 (Wed, 14 May 2008) | 1 line
-
-Added main() methods.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-r1 | sally | 2008-05-10 19:50:31 -0500 (Sat, 10 May 2008) | 1 line
-
-Initial import
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-</screen>
- </informalexample>
-->
- <informalexample>
- <screen>
-$ svn log
-------------------------------------------------------------------------
-r3 | sally | 2008-05-15 23:09:28 -0500 (Thu, 15 May 2008) | 1 line
-
include-Zeilen hinzugefügt und Anzahl der Käsescheiben korrigiert.
------------------------------------------------------------------------
r2 | harry | 2008-05-14 18:43:15 -0500 (Wed, 14 May 2008) | 1 line
+<!--
+Added main() methods.
+-->
main()-Methoden hinzugefügt.
------------------------------------------------------------------------
r1 | sally | 2008-05-10 19:50:31 -0500 (Sat, 10 May 2008) | 1 line
+<!--
+Initial import
+-->
Erstimport
------------------------------------------------------------------------
+-->
</screen>
</informalexample>
+
<!--
<para>Note that the log messages are printed in
<emphasis>reverse chronological order</emphasis> by default.
@@ -4203,58 +4180,47 @@
sehen möchten, übergeben Sie die Option
<option>--revision</option> (<option>-r</option>):</para>
+ <table id="svn.tour.history.log.tbl-1">
<!--
- <table id="svn.tour.history.log.tbl-1">
<title>Common log requests</title>
+-->
+ <title>Häufige Protokollanfragen</title>
<tgroup cols="2">
<thead>
<row>
+<!--
<entry>Command</entry>
<entry>Description</entry>
+-->
+ <entry>Befehl</entry>
+ <entry>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
<entry><userinput>svn log -r 5:19</userinput></entry>
+<!--
<entry>Display logs for revisions 5 through 19 in
chronological order</entry>
+-->
+ <entry>Anzeige der Protokolleinträge für die Revisionen
+ 5 bis 19 in chronologischer Reihenfolge</entry>
</row>
<row>
<entry><userinput>svn log -r 19:5</userinput></entry>
+<!--
<entry>Display logs for revisions 5 through 19 in
reverse chronological order</entry>
- </row>
- <row>
- <entry><userinput>svn log -r 8</userinput></entry>
- <entry>Display logs for revision 8 only</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
-->
- <table id="svn.tour.history.log.tbl-1">
- <title>Häufige Protokollanfragen</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Befehl</entry>
- <entry>Beschreibung</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><userinput>svn log -r 5:19</userinput></entry>
<entry>Anzeige der Protokolleinträge für die Revisionen
- 5 bis 19 in chronologischer Reihenfolge</entry>
- </row>
- <row>
- <entry><userinput>svn log -r 19:5</userinput></entry>
- <entry>Anzeige der Protokolleinträge für die Revisionen
5 bis 19 in umgekehrt chronologischer
Reihenfolge</entry>
</row>
<row>
<entry><userinput>svn log -r 8</userinput></entry>
+<!--
+ <entry>Display logs for revision 8 only</entry>
+-->
<entry>Anzeige des Protokolleintrags nur für Revision
8</entry>
</row>
@@ -4346,7 +4312,7 @@
<option>- -verbose</option> (<option>-v</option>) option.
Because Subversion allows you to move and copy files and
directories, it is important to be able to track path changes
- in the filesystem. So, in verbose mode, <command>svn
+ in the filesystem. So, in verbose mode, <command>svn
log</command> will include a list of changed paths in a
revision in its output:</para>
-->
@@ -4360,33 +4326,22 @@
von <command>svn log</command> eine Liste veränderter Pfade in
einer Revision:</para>
-<!--
<informalexample>
<screen>
$ svn log -r 8 -v
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+------------------------------------------------------------------------
r8 | sally | 2008-05-21 13:19:25 -0500 (Wed, 21 May 2008) | 1 line
+<!--
Changed paths:
+-->
+Geänderte Pfade:
M /trunk/code/foo.c
M /trunk/code/bar.h
A /trunk/code/doc/README
+<!--
Frozzled the sub-space winch.
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-</screen>
- </informalexample>
-->
- <informalexample>
- <screen>
-$ svn log -r 8 -v
-------------------------------------------------------------------------
-r8 | sally | 2008-05-21 13:19:25 -0500 (Wed, 21 May 2008) | 1 line
-Geänderte Pfade:
- M /trunk/code/foo.c
- M /trunk/code/bar.h
- A /trunk/code/doc/README
-
Die Unterraumwinde gefrozzelt.
------------------------------------------------------------------------
@@ -4394,19 +4349,17 @@
</informalexample>
<!--
- <para>
- <command>svn log</command> also takes
+ <para><command>svn log</command> also takes
a <option>- -quiet</option> (<option>-q</option>) option, which
suppresses the body of the log message. When combined
- with <option>- -verbose</option>, it
+ with <option>- -verbose</option> (<option>-v</option>), it
gives just the names of the changed files.</para>
-->
- <para>
- <command>svn log</command> akzeptiert ebenfalls die Option
- <option>--quiet</option> (<option>-q</option>), die den
+ <para><command>svn log</command> akzeptiert ebenfalls die
+ Option <option>--quiet</option> (<option>-q</option>), die den
Protokolleintrag unterdrückt. Zusammen mit der Option
- <option>--verbose</option> zeigt es nur die Namen der
- geänderten Dateien an.</para>
+ <option>--verbose</option> (<option>-v</option>) zeigt es nur
+ die Namen der geänderten Dateien an.</para>
<sidebar>
<!--
@@ -4462,6 +4415,31 @@
</sidebar>
+<!--
+ <para>As of Subversion 1.7, users of the Subversion command-line
+ can also take advantage of a special output mode
+ for <command>svn log</command> which integrates a difference
+ report such as is generated by the <command>svn diff</command>
+ command we introduced earlier. When you invoke <command>svn
+ log</command> with the <option>- -diff</option> option,
+ Subversion will append to each revision log chunk in the log
+ report a <command>diff</command>-style difference report.
+ This is a very convenient way to see both the high-level, semantic
+ changes and the line-based modifications of a revision all at
+ the same time!</para>
+-->
+ <para>Seit Subversion 1.7 können Anwender der Subversion
+ Kommandozeile den besonderen Ausgabemodus für
+ <command>svn log</command> verwenden, der eine Anzeige der
+ Unterschiede integriert, wie sie der Befehl <command>svn
+ diff</command> erzeugt, der oben eingeführt wurde. Wenn Sie
+ <command>svn log</command> mit der Option <option>--diff</option>
+ aufrufen, hängt Subversion an jedes Revisionsprotokoll einen
+ Bericht über die Unterschiede im <command>diff</command>-Stil.
+ Das ist sehr praktisch, um sowohl die groben semantischen als
+ auch die zeilenweisen Änderungen einer Revision gleichzeitig
+ zu sehen.</para>
+
</sect2>
<!-- ===============================================================
-->
@@ -4487,7 +4465,10 @@
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<sect3 id="svn.tour.history.browsing.cat">
- <title>svn cat</title>
+<!--
+ <title>Displaying file contents</title>
+-->
+ <title>Anzeige von Dateiinhalten</title>
<!--
@@ -4525,6 +4506,224 @@
</screen>
</informalexample>
+ </sect3>
+
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
+ <sect3 id="svn.tour.history.browsing.annotate">
+<!--
+ <title>Displaying line-by-line change attribution</title>
+-->
+ <title>Anzeigen der zeilenweisen Zuordnung von Änderungen</title>
+
+<!--
+ <para>Very similar to the <command>svn cat</command> command
+ we discussed in the previous section is the <command>svn
+ annotate</command> command. This command also displays the
+ contents of a versioned file, but it does so using a tabular
+ format. Each line of output shows not only a line of the
+ file's content but also the username, the revision number
+ and (optionally) the datestamp of the revision in which that
+ line was last modified.</para>
+-->
+ <para>Sehr ähnlich wie der im vorangegangenen Abschniitt
+ besprochene Befehl <command>svn cat</command> ist der Befehl
+ <command>svn annotate</command>. Auch dieser Befehl zeigt
+ den Inhalt einer versionierten Datei an, jedoch macht er das
+ tabellarisch. Jede ausgegebene Zeile zeigt nicht nur eine
+ Zeile des Dateiinhalts, sondern auch den Namen des
+ Erstellers, der Revisionsnummer und (optional) des
+ Zeitstempels der Revision, in der die Zeile zuletzt geändert
+ wurde.</para>
+
+<!--
+ <para>When used with a working copy file target, <command>svn
+ annotate</command> will by default show line-by-line
+ attribution of the file as it currently appears in the
+ working copy.</para>
+-->
+ <para>Wenn es auf eine Datei der Arbeitskopie angewendet wird,
+ zeigt <command>svn annotate</command> standardmäßig eine
+ zeilenweise Zuordnung der Datei, so wie sie gerade in der
+ Arbeitskopie vorliegt.</para>
+
+ <informalexample>
+ <screen>
+$ svn annotate rules.txt
+ 1 harry Be kind to others
+ 3 sally Freedom = Responsibility
+ 1 harry Everything in moderation
+ - - Chew with your mouth closed
+ - - Listen when others are speaking
+</screen>
+ </informalexample>
+
+<!--
+ <para>Notice that for some lines, there is no attribution
+ provided. In this case, that's because those lines have
+ been modified in the working copy's version of the file. In
+ this way, <command>svn annotate</command> becomes another
+ way for you to see which lines in the file you have
+ changed. You can use the <literal>BASE</literal> revision
+ keyword (see <xref linkend="svn.tour.revs.keywords" />) to
+ instead see the unmodified form of the file as it resides
+ in your working copy.</para>
+-->
+ <para>Beachten Sie, dass für einige Zeilen keine Zuordnung
+ angegeben wird. In diesem Fall liegt es daran, dass diese
+ Zeilen in der Arbeitskopie der Datei geändert wurden. Auf
+ diese Weise wird <command>svn annotate</command> eine
+ Alternative für Sie, um zu sehen, welche Zeilen in einer
+ Datei Sie geändert haben. Sie können das
+ Revisions-Schlüsselwort <literal>BASE</literal> verwenden
+ (siehe <xref linkend="svn.tour.revs.keywords" />), um
+ stattdessen die unveränderte Form der Datei in Ihrer
+ Arbeitskopie zu betrachten.</para>
+
+ <informalexample>
+ <screen>
+$ svn annotate rules.txt at BASE
+ 1 harry Be kind to others
+ 3 sally Freedom = Responsibility
+ 1 harry Everything in moderation
+ 1 harry Chew with your mouth open
+</screen>
+ </informalexample>
+
+<!--
+ <para>The <option>- -verbose (-v)</option> option causes
+ <command>svn annotate</command> to also include on each line
+ the datestamp associated with that line's reported revision
+ number. (This adds a significant amount of width to each
+ line of ouput, so we'll skip the demonstration here.)</para>
+-->
+ <para>Die Option <option>--verbose (-v)</option> veranlasst
+ <command>svn annotate</command>, auf jeder Zeile zusätzlich
+ den zur angezeigten Revisionsnummer gehörigen Zeitstempel
+ auszugeben. (Das erhöht erheblich die Breite jeder
+ Ausgabezeile, so dass wir an dieser Stelle auf eine
+ Demonstration verzichten.)</para>
+
+<!--
+ <para>As with <command>svn cat</command>, you can also
+ ask <command>svn annotate</command> to display previous
+ versions of the file. This can be a handy trick when, after
+ finding out who most recently modified a particular line of
+ interest in the file, you then wish to see who modified the
+ same line prior to that.</para>
+-->
+ <para>Wie bei <command>svn cat</command> können Sie auch
+ <command>svn annotate</command> auffordern, ältere
+ Revisionen der Datei anzuzeigen. Das kann ein nützlicher
+ Trick sein, wenn Sie wissen möchten, wer eine bestimmte
+ Zeile vor der letzten Änderung geändert hat.</para>
+
+ <informalexample>
+ <screen>
+$ svn blame rules.txt -r 2
+ 1 harry Be kind to others
+ 1 harry Freedom = Chocolate Ice Cream
+ 1 harry Everything in moderation
+ 1 harry Chew with your mouth open
+</screen>
+ </informalexample>
+
+<!--
+ <para>Unlike the <command>svn cat</command> command, the
+ functionality of <command>svn annotate</command> is tied
+ heavily to the idea of <quote>lines</quote> of text in a
+ human-readable file. As such, if you attempt to run the
+ command on a file that Subversion has determined is
+ <emphasis>not</emphasis> human-readable (per the file's
+ <literal>svn:mime-type</literal> property—see <xref
+ linkend="svn.advanced.props.special.mime-type" /> for
+ details), you'll get an error message.</para>
+-->
+ <para>Anders als beim Befehl <command>svn cat</command> ist
+ die Funktionalität von <command>svn annotate</command> stark
+ an das Konzept von <quote>Zeilen</quote> mit Text in einer
+ menschenlesbaren Datei gebunden. Somit führt der Versuch,
+ disen Befehl auf eine Datei anzuwenden, die Subversion als
+ <emphasis>nicht</emphasis> menschenlesbar (über die
+ Dateieigenschaft <literal>svn:mime-type</literal> –
+ siehe <xref linkend="svn.advanced.props.special.mime-type"
+ /> für Details) erachtet, bekommen Sie eine
+ Fehlermeldung.</para>
+
+ <informalexample>
+ <screen>
+$ svn annotate images/logo.png
+<!--
+Skipping binary file: 'images/logo.png'
+-->
+Überspringe Binärdatei: »images/logo.png«
+$
+</screen>
+ </informalexample>
+
+<!--
+ <para>As revealed in the error message, you can use
+ the <option>- -force</option> option to disable this check
+ and proceed with the annotation as if the file's contents
+ are, in fact, human-readable and line-based. Naturally, if
+ you force Subversion to try to perform line-based annotation
+ on a nontextual file, you'll get what you asked for: a
+ screenful of nonsense.</para>
+-->
+ <para>Wie die Fehlermeldung verrät, können Sie die Option
+ <option>--force</option> verwenden, um diese Überprüfung zu
+ unterbinden und mit der Zuordnung weitermachen, als handele
+ es sich tatsächlich um menschenlesbaren, zeilenbasierten
+ Dateiinhalt. Natürlich bekommen Sie, was Sie haben wollen,
+ wenn Sie Subversion dazu zwingen, eine zeilenbasierte
+ Zuordnung auf eine Nicht-Text-Datei anzuwenden: einen
+ Bildschirm voller Müll.</para>
+
+ <informalexample>
+ <screen>
+$ svn annotate images/logo.png --force
+ 6 harry \211PNG
+ 6 harry ^Z
+ 6 harry
+ 7 harry \274\361\MI\300\365\353^X\300…
+</screen>
+ </informalexample>
+
+ <tip>
+<!--
+ <para>Depending on your mood at the time you execute this
+ command and your reasons for doing so, you may find
+ yourself typing <userinput>svn blame …</userinput>
+ or <userinput>svn praise …</userinput> instead of
+ using the canonical <command>svn annotate</command>
+ command form. That's okay—the Subversion developers
+ anticipated as much, so those particular command aliases
+ work, too!</para>
+-->
+ <para>Abhängig von Ihrer Stimmung zum Zeitpunkt der
+ Ausführung dieses Befehls sowie Ihren Gründen dafür,
+ könnte es sein, dass Sie <userinput>svn blame
+ …</userinput> oder <userinput>svn praise
+ …</userinput> statt der kanonischen Kommandoform
+ <command>svn annotate</command> eintippen. Das geht in
+ Ordnung – die Entwickler von Subversion haben so
+ etwas erwartet, so dass diese besonderen Befehls-Aliase
+ auch funktionieren.</para>
+ </tip>
+
+<!--
+ <para>Finally, as with many of Subversion's informational
+ commands, you can also reference files in your <command>svn
+ annotate</command> command invocations by their repository
+ URLs, allowing access to this information even when you
+ don't have ready access to a working copy.</para>
+-->
+ <para>Schließlich können Sie, wie bei vielen der
+ informationellen Subversion-Befehle, auch in Aufrufen des
+ Befehls <command>svn annotate</command> Dateien über deren
+ Projektarchiv-URLs referenzieren, was Ihnen erlaubt, diese
+ Informationen auch ohne Zugang zu einer Arbeitskopie zu
+ erlangen.</para>
+
</sect3>
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
More information about the svnbook-dev
mailing list