[svnbook] r4521 committed - Translation: Mergeinfo and Previews.

svnbook at googlecode.com svnbook at googlecode.com
Wed Jul 3 15:17:46 CDT 2013


Revision: 4521
Author:   jmfelderhoff at gmx.eu
Date:     Wed Jul  3 13:17:27 2013
Log:      Translation: Mergeinfo and Previews.

http://code.google.com/p/svnbook/source/detail?r=4521

Modified:
  /branches/1.6/de/book/ch04-branching-and-merging.xml

=======================================
--- /branches/1.6/de/book/ch04-branching-and-merging.xml	Tue Jul  2  
12:54:31 2013
+++ /branches/1.6/de/book/ch04-branching-and-merging.xml	Wed Jul  3  
13:17:27 2013
@@ -1838,80 +1838,126 @@
  <!--
        <para>The basic mechanism Subversion uses to track
          changesets—that is, which changes have been merged to
-        which branches—is by recording data in properties.
-        Specifically, merge data is tracked in
+        which branches—is by recording data in versioned
+        properties.  Specifically, merge data is tracked in
          the <literal>svn:mergeinfo</literal> property attached to
          files and directories.  (If you're not familiar with
-        Subversion properties, now is the time to skim
-        <xref linkend="svn.advanced.props"/>.)</para>
+        Subversion properties, see <xref linkend="svn.advanced.props"
+        />.)</para>
  -->
        <para>Der grundsätzliche Mechanismus, den Subversion verwendet,
          um Änderungsmengen zu verfolgen – d.h. welche Änderungen
          auf welchen Zweig übertragen worden sind – besteht aus
-        dem Festhalten von Daten in Eigenschaften. Daten über das
-        Zusammenführen werden speziell in der Eigenschaft
-        <literal>svn:mergeinfo</literal> vermerkt, die an Dateien und
-        Verzeichnissen hängt. (Falls Sie mit Subversion-Eigenschaften
-        nicht vertraut sind, ist es nun an der Zeit, <xref
-        linkend="svn.advanced.props"/> zu überfliegen.)</para>
+        der Datenspeicherung in versionierten Eigenschaften.
+        Namentlilch werden Daten die das Zusammenführen betreffen in
+        der Eigenschaft <literal>svn:mergeinfo</literal> festgehalten,
+        die mit Dateien und Verzeichnissen verknüpft ist. (Falls Sie
+        mit Subversion-Eigenschaften nicht vertraut sind, siehe <xref
+          linkend="svn.advanced.props"/>.) </para>

  <!--
-      <para>You can examine the property, just like any
-        other:</para>
+      <para>You can examine the property, just like any other:</para>
  -->
        <para>Sie können sich die Eigenschaft ansehen, wie jede andere
          auch:</para>

-      <screen>
+      <informalexample>
+        <screen>
  $ cd my-calc-branch
  $ svn propget svn:mergeinfo .
  /trunk:341-390
+$
  </screen>
+      </informalexample>

  <!--
-      <para>It is <emphasis>not</emphasis> recommended that you change
-        the value of this property yourself, unless you really know
-        what you're doing.  This property is automatically maintained
-        by Subversion whenever you run <command>svn merge</command>.
-        Its value indicates which changes (at a given path) have been
-        replicated into the directory in question.  In this case, the
-        path is <filename>/trunk</filename> and the directory which
-        has received the specific changes
-        is <filename>/branches/my-calc-branch</filename>.</para>
+      <warning>
+        <para>While is possible to
+          modify <literal>svn:mergeinfo</literal> just as you might
+          any other versioned property, we strongly discourage doing
+          so unless you <emphasis>really</emphasis> know what you're
+          doing.</para>
+      </warning>
  -->
-      <para>Es wird <emphasis>nicht</emphasis> empfohlen, dass Sie
-        selbst den Wert dieser Eigenschaft ändern, es sei denn, Sie
-        wissen wirklich, was Sie tun. Diese Eigenschaft wird
+      <warning>
+        <para>Obwohl es möglich ist, <literal>svn:mergeinfo</literal>
+          zu ändern wie jede andere versionierte Eigenschaft, raten
+          wir dringend davor ab, es sei denn, Sie wissen
+          <emphasis>wirklich</emphasis>, was Sie da machen.</para>
+      </warning>
+
+<!--
+      <para>The <literal>svn:mergeinfo</literal> property is
+        automatically maintained by Subversion whenever you
+        run <command>svn merge</command>.  Its value indicates which
+        changes made to a given path have been replicated into the
+        directory in question.  In our previous example, the path
+        which is the source of the merged changes is
+        <filename>/trunk</filename> and the directory which has
+        received the changes is
+        <filename>/branches/my-calc-branch</filename>.</para>
+-->
+
+      <para>Die Eigenschaft <literal>svn:mergeinfo</literal> wird
          automatisch von Subversion gepflegt, sobald Sie den Befehl
          <command>svn merge</command> ausführen. Ihr Wert gibt
-        Aufschluss darüber, welche Änderungen (von einem gegebenen
-        Pfad) mit dem in Frage kommenden Verzeichnis abgeglichen
-        wurden. In diesem Fall ist der Pfad
-        <filename>/trunk</filename>, und das Verzeichnis, das die
-        bestimmten Änderungen erhalten hat, ist
-        <filename>/branches/my-calc-branch</filename>.</para>
+        Aufschluss darüber, welche Änderungen an einem gegebenen Pfad
+        mit dem in Frage kommenden Verzeichnis abgeglichen wurden. Im
+        vorangegangenen Beispiel ist <filename>/trunk</filename> der
+        Ursprungspfad der zusammengeführten Änderungen und
+        <filename>/branches/my-calc-branch</filename> das
+        Zielverzeichnis.</para>

  <!--
-      <para>There's also a subcommand, <command>svn
+      <para>Subversion also provides a subcommand, <command>svn
          mergeinfo</command>, which can be helpful in seeing not only
          which changesets a directory has absorbed, but also which
          changesets it's still eligible to receive.  This gives a sort
-        of preview of the next set of changes that <command>svn
-        merge</command> will replicate to your branch.</para>
+        of preview of which changes a subsequent <command>svn
+        merge</command> operation would replicate to your
+        branch.</para>
  -->
-      <para>Es gibt auch einen Unterbefehl, <command>svn
-        mergeinfo</command>, der hilfreich dabei ist, nicht nur die
-        Änderungsmengen anzuzeigen, die ein Verzeichnis absorbiert
-        hat, sondern auch, welche Änderungsmengen für einen Abgleich
-        noch in Frage kommen. Das ergibt eine Art Vorschau der
-        nächsten Änderungsmengen, die <command>svn merge</command> auf
-        Ihren Zweig abgleichen wird.</para>
+      <para>Subversion stellt auch den Unterbefehl, <command>svn
+        mergeinfo</command> zur Verfügung, der dabei hilfreich sein
+        kann, nicht nur die in ein Verzeichnis eingeflossenen
+        Änderungsmengen anzuzeigen, sondern auch, welche
+        Änderungsmengen noch für einen Abgleich bereit stehen. Das
+        ergibt eine Art Vorschau der nächsten Änderungsmengen, die
+        <command>svn merge</command> auf Ihren Zweig abgleichen
+        wird.</para>

-      <screen>
+<!--
+      <informalexample>
+        <screen>
  $ cd my-calc-branch

+# Which changes have already been merged from trunk to branch?
+$ svn mergeinfo ^/calc/trunk
+r341
+r342
+r343
+…
+r388
+r389
+r390
+
+# Which changes are still eligible to merge from trunk to branch?
+$ svn mergeinfo ^/calc/trunk - -show-revs eligible
+r391
+r392
+r393
+r394
+r395
+$
+</screen>
+      </informalexample>
+-->
+      <informalexample>
+        <screen>
+$ cd my-calc-branch
+
  # Welche Änderungen wurden bereits vom Stamm auf den Zweig abgeglichen?
-$ svn mergeinfo http://svn.example.com/repos/calc/trunk
+$ svn mergeinfo ^/calc/trunk
  r341
  r342
  r343
@@ -1921,13 +1967,15 @@
  r390

  # Welche Änderungen kommen für einen Abgleich vom Stamm auf den Zweig noch  
in Frage?
-$ svn mergeinfo http://svn.example.com/repos/calc/trunk --show-revs  
eligible
+$ svn mergeinfo ^/calc/trunk --show-revs eligible
  r391
  r392
  r393
  r394
  r395
+$
  </screen>
+      </informalexample>

  <!--
        <para>The <command>svn mergeinfo</command> command requires
@@ -1944,12 +1992,12 @@
          <quote>Quell</quote>-URL (woher die Änderungen kommen würden)
          und einen optionalen <quote>Ziel</quote>-URL (wohin die
          Änderungen abgeglichen würden). Falls kein Ziel-URL angegeben
-        ist, wird angenommen, dass das aktuelle Arbeitsverzeichnis das
-        Ziel ist. Weil wir im vorangegangenen Beispiel unser
-        Arbeitsverzeichnis vom Zweig abfragen, geht der Befehl davon
-        aus, dass wir daran interessiert sind, Änderungen für
-        <filename>/branches/mybranch</filename> vom angegebenen
-        Stamm-URL zu erhalten.</para>
+        ist, wird das aktuelle Arbeitsverzeichnis als Ziel angenommen.
+        Da wir im vorangegangenen Beispiel unser dem Zweig
+        entsprechenden Arbeitsverzeichnis abfragen, geht der Befehl
+        davon aus, dass wir daran interessiert sind, Änderungen vom
+        angegebenen Stamm-URL für
+        <filename>/branches/mybranch</filename> zu erhalten.</para>

  <!--
        <para>Another way to get a more precise preview of a merge
@@ -1960,13 +2008,26 @@
          Abgleich zu bekommen, ist die Verwendung der Option
          <option>--dry-run</option>:</para>

-      <screen>
-$ svn merge http://svn.example.com/repos/calc/trunk --dry-run
+<!--
+      <informalexample>
+        <screen>
+$ svn merge ^/calc/trunk - -dry-run
  U    integer.c

+$ svn status
+#  nothing printed, working copy is still unchanged.
+</screen>
+      </informalexample>
+-->
+      <informalexample>
+        <screen>
+$ svn merge ^/calc/trunk --dry-run
+U    integer.c
+
  $ svn status
  #  es wird nichts ausgegeben, die Arbeitskopie ist unverändert
  </screen>
+      </informalexample>

  <!--
        <para>The <option>- -dry-run</option> option doesn't actually
@@ -1987,12 +2048,14 @@

        <tip>
  <!--
-        <para>After performing a merge operation, but before committing
-          the results of the merge, you can use <userinput>svn diff
-          - -depth=empty  
<replaceable>/path/to/merge/target</replaceable></userinput> to see only
-          the changes to the immediate target of your merge.  If your
-          merge target was a directory, only property differences will
-          be displayed.  This is a handy way to see the changes to the
+        <para>After performing a merge operation, but before
+          committing the results of the merge, you can
+          use <userinput>svn diff
+          - -depth=empty  
<replaceable>/path/to/merge/target</replaceable></userinput>
+          to see only the changes to the immediate target of your
+          merge.  If your merge target was a directory, only property
+          differences will be displayed.  This is a handy way to see
+          the changes to the
            <literal>svn:mergeinfo</literal> property recorded by the
            merge operation, which will remind you about what you've
            just merged.</para>
@@ -2017,9 +2080,9 @@
          modifications to your working copy—but we've already
          stressed that you shouldn't be merging into such an
          environment).  If you don't like the results of the merge,
-        simply run <userinput>svn revert . -R</userinput> to revert the  
changes from
-        your working copy and retry the command with different
-        options.  The merge isn't final until you
+        simply run <userinput>svn revert . -R</userinput> to revert
+        the changes from your working copy and retry the command with
+        different options.  The merge isn't final until you
          actually <command>svn commit</command> the results.</para>
  -->
        <para>Natürlich ist die beste Methode, eine Vorschau eines


More information about the svnbook-dev mailing list