[svnbook] r3828 committed - trunk/src/de/book/ch03-advanced-topics.xml:...

svnbook at googlecode.com svnbook at googlecode.com
Fri May 6 10:38:35 CDT 2011


Revision: 3828
Author:   jmfelderhoff at gmx.eu
Date:     Fri May  6 08:37:36 2011
Log:      trunk/src/de/book/ch03-advanced-topics.xml:
   * Ticket #140: Changelists As Operation Filters (cf.
     http://www.svnbook.de/ticket/140)

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

Modified:
  /trunk/src/de/book/ch03-advanced-topics.xml

=======================================
--- /trunk/src/de/book/ch03-advanced-topics.xml	Sun May  1 23:39:48 2011
+++ /trunk/src/de/book/ch03-advanced-topics.xml	Fri May  6 08:37:36 2011
@@ -7402,8 +7402,12 @@

      <!-- ===============================================================  
-->
      <sect2 id="svn.advanced.changelists.asfilters">
+<!--
        <title>Changelists As Operation Filters</title>
-
+-->
+      <title>Änderungslisten als Befehlsfilter</title>
+
+<!--
        <para>The visual grouping that Harry sees in the output of
          <command>svn status</command> as shown in our previous section
          is nice, but not entirely useful.  The
@@ -7411,9 +7415,19 @@
          operations that he might wish to perform on his working copy.
          Fortunately, many of Subversion's other operations understand
          how to operate on changelists via the use of the
-        <option>--changelist</option> option.</para>
-
-      <para>When provided with a <option>--changelist</option> option,
+        <option>- -changelist</option> option.</para>
+-->
+      <para>Die visuelle Gruppierung, die Harry in der Ausgabe von
+        <command>svn status</command> im vorangegangenenen Abschnitt
+        sieht, ist ganz nett, jedoch nicht so richtig nützlich. Der
+        Befehl <command>status</command> ist nur einer von mehreren,
+        die er vielleicht in seiner Arbeitskopie ausführen möchte.
+        Erfreulicherweise können viele andere Befehle von Subversion
+        auf Änderungslisten arbeiten, wenn die Option
+        <option>--changelist</option> verwendet wird.</para>
+
+<!--
+      <para>When provided with a <option>- -changelist</option> option,
          Subversion commands will limit the scope of their operation to
          only those files to which a particular changelist name is
          assigned.  If Harry now wants to see the actual changes he's
@@ -7421,6 +7435,17 @@
          changelist, he <emphasis>could</emphasis> explicitly list only
          the files that make up that changelist on the <command>svn
          diff</command> command line.</para>
+-->
+      <para>Wenn ihnen die Option <option>--changelist</option>
+        mitgegeben wird, beschränken Befehle von Subversion ihren
+        Wirkbereich auf die Dateien, die mit einer bestimmten
+        Änderungsliste verknüpft sind. Falls Harry nun die
+        eigentlichen Änderungen sehen möchte, die er an Dateien in
+        seiner Änderungsliste <literal>math-fixes</literal>
+        vorgenommen hat, <emphasis>könnte</emphasis> er in der
+        Kommandozeile des Befehls <command>svn diff</command>
+        ausdrücklich nur die Dateien angeben, die diese Änderungsliste
+        ausmachen.</para>

        <screen>
  $ svn diff integer.c mathops.c
@@ -7437,12 +7462,21 @@
  $
  </screen>

+<!--
        <para>That works okay for a few files, but what if Harry's
          change touched 20 or 30 files?  That would be an annoyingly
          long list of explicitly named files.  Now that he's using
          changelists, though, Harry can avoid explicitly listing the
          set of files in his changelist from now on, and instead
          provide just the changelist name:</para>
+-->
+      <para>Bei ein paar Dateien funktioniert das einwandfrei, was
+        wäre aber, wenn Harrys Änderung 20 oder 30 Dateien beträfe?
+        Das wäre eine schrecklich lange Liste ausdrücklich
+        aufgeführter Dateinamen. Da Harry nun jedoch Änderungslisten
+        verwendet, kann er das explizite Aufführen der Dateimenge in
+        seiner Änderungsliste von nun an vermeiden und stattdessen nur
+        den Namen der Änderungsliste angeben:</para>

        <screen>
  $ svn diff --changelist math-fixes
@@ -7459,41 +7493,81 @@
  $
  </screen>

+<!--
        <para>And when it's time to commit, Harry can again use the
-        <option>--changelist</option> option to limit the scope of the
+        <option>- -changelist</option> option to limit the scope of the
          commit to files in a certain changelist.  He might commit his
          user interface fix by doing the following:</para>
-
+-->
+      <para>Und wenn es an der Zeit ist, zu übertragen, kann Harry
+        wieder die Option <option>--changelist</option> verwenden, um
+        die Übertragung auf die Dateien einer bestimmten
+        Änderungsliste zu beschränken. Er könnte seine Fehlerbehebung
+        an der Benutzerschnittstelle etwa so übertragen:</para>
+
+<!--
        <screen>
  $ svn ci -m "Fix a UI bug found while working on math logic." \
-      --changelist ui-fix
+      - -changelist ui-fix
  Sending        button.c
  Transmitting file data .
  Committed revision 1158.
  $
+</screen>
+-->
+      <screen>
+$ svn ci -m "Fix a UI bug found while working on math logic." \
+      --changelist ui-fix
+Sende          button.c
+Übertrage Daten .
+Revision 1158 übertragen.
+$
  </screen>

+<!--
        <para>In fact, the <command>svn commit</command> command
          provides a second changelists-related option:
-        <option>--keep-changelists</option>.  Normally, changelist
+        <option>- -keep-changelists</option>.  Normally, changelist
          assignments are removed from files after they are committed.
-        But if <option>--keep-changelists</option> is provided,
+        But if <option>- -keep-changelists</option> is provided,
          Subversion will leave the changelist assignment on the
          committed (and now unmodified) files.  In any case, committing
          files assigned to one changelist leaves other changelists
          undisturbed.</para>
-
+-->
+      <para>Der Befehl <command>svn commit</command> verfügt über eine
+        zweite Option in Zusammenhang mit Änderungslisten:
+        <option>--keep-changelists</option>. Normalerweise werden
+        Verknüpfungen zu Änderungslisten nach der Übertragung von
+        Dateien aufgelöst. Wenn jedoch
+        <option>--keep-changelists</option> angegeben wird, bewahrt
+        Subversion die Verknüpfung der übertragenen (und nun
+        unveränderten) Dateien zur Änderungsliste. In allen Fällen
+        berührt die Übertragung von Dateien einer Änderungsliste alle
+        anderen Änderungslisten nicht.</para>
+
+<!--
        <screen>
  $ svn status

---- Changelist 'math-fixes':
+- - Changelist 'math-fixes':
  M      integer.c
  M      mathops.c
  $
  </screen>
-
+-->
+      <screen>
+$ svn status
+
+--- Änderungsliste »math-fixes«:
+M      integer.c
+M      mathops.c
+$
+</screen>
+
+<!--
        <note>
-        <para>The <option>--changelist</option> option acts only as a
+        <para>The <option>- -changelist</option> option acts only as a
            filter for Subversion command targets, and will not add
            targets to an operation.  For example, on a commit operation
            specified as <userinput>svn commit /path/to/dir</userinput>, the
@@ -7508,27 +7582,72 @@
            their changelist assignment, even if they are part of the
            same working copy as the operation's target(s).</para>
        </note>
-
+-->
+      <note>
+        <para>Die Option <option>--changelist</option> wirkt lediglich
+          als ein Filter für die Objekte eines Subversion-Befehls und
+          fügt keine neuen Objekte hinzu. Beispielsweise ist bei einem
+          Übertragungsbefehl, der als <userinput>svn commit
+            /path/to/dir</userinput> gegeben wird, das Objekt das
+          Verzeichnis <filename>/path/to/dir</filename> und seine
+          Kinder (unendlich tief). Wenn Sie diesem Befehl dann die
+          Angabe einer Änderungsliste hinzufügen, werden nur die
+          Dateien in und unterhalb von
+          <filename>/path/to/dir</filename> als zu übertragene Objekte
+          betrachtet, die mit dieser Änderungsliste verknüpft sind
+          – die Übertragung wird keine Dateien von anderen
+          Stellen (etwa <filename>/path/to/another-dir</filename>)
+          umfassen, egal, ob sie mit der Änderungsliste verknüpft
+          sind, auch wenn sie zur selben Arbeitskopie gehören wie die
+          Objekte des Befehls.</para>
+      </note>
+
+<!--
        <para>Even the <command>svn changelist</command> command accepts
-        the <option>--changelist</option> option.  This allows you to
+        the <option>- -changelist</option> option.  This allows you to
          quickly and easily rename or remove a changelist:</para>
-
+-->
+      <para>Auch der Befehl <command>svn changelist</command> versteht
+        die Option <option>--changelist</option>. Er ermöglicht Ihnen
+        das schnelle Umbenennen oder Entfernen einer
+        Änderungsliste:</para>
+
+<!--
        <screen>
-$ svn changelist math-bugs --changelist math-fixes --depth infinity .
+$ svn changelist math-bugs - -changelist math-fixes - -depth infinity .
  svn: warning: Removing 'integer.c' from changelist 'math-fixes'.
  Path 'integer.c' is now a member of changelist 'math-bugs'.
  svn: warning: Removing 'mathops.c' from changelist 'math-fixes'.
  Path 'mathops.c' is now a member of changelist 'math-bugs'.
-$ svn changelist --remove --changelist math-bugs --depth infinity .
+$ svn changelist - -remove - -changelist math-bugs - -depth infinity .
  Path 'integer.c' is no longer a member of a changelist.
  Path 'mathops.c' is no longer a member of a changelist.
  $
+</screen>
+-->
+      <screen>
+$ svn changelist math-bugs --changelist math-fixes --depth infinity .
+svn: warnung: Entferne »integer.c« aus Änderungsliste »math-fixes«.
+Pfad »integer.c« ist nun ein Element der Änderungsliste »math-bugs«.
+svn: warnung: Entferne »mathops.c« aus Änderungsliste »math-fixes«.
+Pfad »mathops.c« ist nun ein Element der Änderungsliste »math-bugs«.
+$ svn changelist --remove --changelist math-bugs --depth infinity .
+Pfad »integer.c« ist nicht länger ein Element einer Änderungsliste
+Pfad »mathops.c« ist nicht länger ein Element einer Änderungsliste
+$
  </screen>

+<!--
        <para>Finally, you can specify multiple instances of the
-        <option>--changelist</option> option on a single command
+        <option>- -changelist</option> option on a single command
          line.  Doing so limits the operation you are performing to
          files found in any of the specified changesets.</para>
+-->
+      <para>Schließlich können sie die Option
+        <option>--changelist</option> mehrfach für einen Befehl auf
+        einer einzelnen Kommandozeile angeben. Das beschränkt den
+        auszuführenden Befehl auf Dateien, die in irgendeiner der
+        angegebenen Änderungslisten zu finden sind.</para>

      </sect2>



More information about the svnbook-dev mailing list