[svnbook] r3756 committed - * trunk/src/de/book/ch03-advanced-topics.xml...

svnbook at googlecode.com svnbook at googlecode.com
Fri Jul 9 10:07:10 CDT 2010


Revision: 3756
Author: jmfelderhoff at gmx.eu
Date: Fri Jul  9 08:05:05 2010
Log: * trunk/src/de/book/ch03-advanced-topics.xml
   - Fixes ticket #132 (cf. http://www.svnbook.de/report/6).

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

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

=======================================
--- /trunk/src/de/book/ch03-advanced-topics.xml	Thu Jul  1 12:54:55 2010
+++ /trunk/src/de/book/ch03-advanced-topics.xml	Fri Jul  9 08:05:05 2010
@@ -908,36 +908,74 @@

      <!-- ===============================================================  
-->
      <sect2 id="svn.advanced.props.manip">
+<!--
        <title>Manipulating Properties</title>
-
+-->
+      <title>Ändern von Propertys</title>
+
+<!--
        <para>The <command>svn</command> program affords a few ways to
          add or modify file and directory properties.  For properties
          with short, human-readable values, perhaps the simplest way to
          add a new property is to specify the property name and value
          on the command line of the <command>svn propset</command>
          subcommand:</para>
-
+-->
+      <para>Das Programm <command>svn</command> gestattet es, Datei
+        und Verzeichnis-Propertys auf verschiedene Weise hinzuzufügen
+        oder zu ändern. Für Propertys mit kurzen, menschenlesbaren
+        Werten ist es vermutlich am einfachsten, ein neues Property zu
+        vergeben, indem dessen Name und Wert auf der Kommandozeile für
+        den Unterbefehl <command>svn propset</command> angegeben
+        wird:</para>
+
+<!--
        <screen>
  $ svn propset copyright '(c) 2006 Red-Bean Software' calc/button.c
  property 'copyright' set on 'calc/button.c'
  $
  </screen>
-
+-->
+      <screen>
+$ svn propset copyright '(c) 2006 Red-Bean Software' calc/button.c
+Eigenschaft »copyright« für »calc/button.c« gesetzt
+$
+</screen>
+
+<!--
        <para>But we've been touting the flexibility that Subversion
          offers for your property values.  And if you are planning to
          have a multiline textual, or even binary, property value, you
          probably do not want to supply that value on the command line.
          So the <command>svn propset</command> subcommand takes a
-        <option>--file</option> (<option>-F</option>) option for
+        <option>- -file</option> (<option>-F</option>) option for
          specifying the name of a file that contains the new property
          value.</para>
-
+-->
+      <para>Jedoch haben wir die von Subversion gebotene Flexibilität
+        bei der Behandlung Ihrer Property-Werte angepriesen; und wenn
+        Sie planen, einen mehrzeiligen textuellen oder sogar binären
+        Property-Wert zu verwenden, wollen Sie diesen wahrscheinlich
+        nicht auf den Kommandozeile angeben. Deshalb besitzt der
+        Unterbefehl <command>svn propset</command> eine Option
+        <option>--file</option> (<option>-F</option>), um den Namen
+        einer Datei angeben zu können, deren Inhalt den neuen
+        Property-Wert ergibt.</para>
+
+<!--
        <screen>
  $ svn propset license -F /path/to/LICENSE calc/button.c
  property 'license' set on 'calc/button.c'
  $
+</screen>
+-->
+      <screen>
+$ svn propset license -F /path/to/LICENSE calc/button.c
+Eigenschaft »license« für »calc/button.c« gesetzt
+$
  </screen>

+<!--
        <para>There are some restrictions on the names you can use for
          properties.  A property name must start with a letter, a colon
          (<literal>:</literal>), or an underscore
@@ -949,7 +987,21 @@
              ASCII subset of the syntax for XML "Name".</para>
            </footnote>
        </para>
-
+-->
+      <para>Es gibt einige Einschränkungen für die Vergabe von
+        Property-Namen. Ein Property-Name muss mit einem Buchstaben,
+        einem Doppelpunkt (<literal>:</literal>) oder einem
+        Unterstrich (<literal>_</literal>) beginnen; danach können Sie
+        auch Ziffern, Bindestriche (<literal>-</literal>) und Punkte
+        (<literal>.</literal>) verwenden.
+          <footnote>
+            <para>Wenn Sie XML kennen, so ist das etwa die
+              ASCII-Teilmenge der Syntax für die Produktion "Name" in
+              XML.</para>
+          </footnote>
+      </para>
+
+<!--
        <para>In addition to the <command>propset</command> command, the
          <command>svn</command> program supplies the
          <command>propedit</command> command.  This command uses the
@@ -966,28 +1018,62 @@
          value of the property, it will accept that as the new property
          value.  If you exit your editor without making any changes, no
          property modification will occur:</para>
-
+-->
+      <para>Zusätzlich zum Befehl <command>propset</command> bietet
+        das Programm <command>svn</command> den Befehl
+        <command>propedit</command>. Dieser Befehl verwendet den
+        konfigurierten Editor (siehe <xref
+          linkend="svn.advanced.confarea.opts.config" />), um
+        Propertys hinzuzufügen oder zu ändern. Wenn Sie den Befehl
+        aufrufen, startet <command>svn</command> Ihren Editor mit
+        einer temporären Datei, die den gegenwärtigen Wert des
+        Propertys beinhaltet (oder leer ist, falls Sie ein neues
+        Property hinzufügen). Dann bearbeiten Sie diesen Wert in Ihrem
+        Editor bis er dem Wert entspricht, den Sie für das Property
+        verwenden möchten, speichern die Datei und beenden den Editor.
+        Falls Subversion feststellt, dass Sie tatsächlich den
+        bestehenden Wert des Propertys geändert haben, wird das als
+        neuer Wert angenommen. Wenn Sie Ihren Editor ohne Änderungen
+        beenden, wird das Property nicht verändert:</para>
+
+<!--
        <screen>
  $ svn propedit copyright calc/button.c  ### exit the editor without changes
  No changes to property 'copyright' on 'calc/button.c'
  $
+</screen>
+-->
+      <screen>
+$ svn propedit copyright calc/button.c  ### Editor ohne Änderung verlassen
+Keine Änderungen der Eigenschaft »copyright« für »calc/button.c«
+$
  </screen>

+<!--
        <para>We should note that, as with other <command>svn</command>
          subcommands, those related to properties can act on multiple
          paths at once.  This enables you to modify properties on whole
          sets of files with a single command.  For example, we could
          have done the following:</para>
+-->
+      <para>Hier sollten wir anmerken, dass die
+        <command>svn</command>-Unterbefehle, die mit Propertys zu tun
+        haben, ähnlich wie bei anderen Unterbefehlen, auch auf mehrere
+        Pfade gleichzeitig angewendet werden können. Dadurch wird es
+        Ihnen ermöglicht, mit einem Befehl die Propertys auf einer
+        Menge von Dateien zu bearbeiten. Wir hätten beispielsweise das
+        Folgende machen können:</para>

        <screen>
  $ svn propset copyright '(c) 2006 Red-Bean Software' calc/*
-property 'copyright' set on 'calc/Makefile'
-property 'copyright' set on 'calc/button.c'
-property 'copyright' set on 'calc/integer.c'
+Eigenschaft »copyright« für »calc/Makefile« gesetzt
+Eigenschaft »copyright« für »calc/button.c« gesetzt
+Eigenschaft »copyright« für »calc/integer.c« gesetzt
  …
  $
  </screen>

+<!--
        <para>All of this property adding and editing isn't really very
          useful if you can't easily get the stored property value.  So
          the <command>svn</command> program supplies two subcommands
@@ -999,7 +1085,21 @@
          propget</command>.  This command will, given a property name and a  
path (or set of
          paths), print the value of the property to
          the standard output stream.</para>
-
+-->
+      <para>Das ganze Hinzufügen und Bearbeiten von Propertys ist
+        nicht gerade nützlich, falls an die gespeicherten Werte nicht
+        einfach heranzukommen ist. Also bietet das Programm
+        <command>svn</command> zwei Unterbefehle zur Anzeige der Namen
+        und Werte von Propertys an Dateien und Verzeichnissen.
+        Der Befehl <command>svn proplist</command> listet alle
+        Property-Namen auf, die für einen Pfad vergeben sind. Sobald
+        Sie die Property-Namen auf einem Element kennen, können Sie
+        die Werte einzeln mittels <command>svn propget</command>
+        abrufen. Wenn diesem Befehl ein Property-Name und ein Pfad
+        (oder eine Menge von Pfaden) mitgegeben wird, wird der Wert
+        des Propertys nach Standardausgabe geschrieben.</para>
+
+<!--
        <screen>
  $ svn proplist calc/button.c
  Properties on 'calc/button.c':
@@ -1008,12 +1108,23 @@
  $ svn propget copyright calc/button.c
  (c) 2006 Red-Bean Software
  </screen>
-
-      <para>There's even a variation of the
-        <command>proplist</command> command that will list both the
-        name and the value for all of the properties.  Simply supply the
-        <option>--verbose</option> (<option>-v</option>) option.</para>
-
+-->
+      <screen>
+$ svn proplist calc/button.c
+Eigenschaften zu »calc/button.c«:
+  copyright
+  license
+$ svn propget copyright calc/button.c
+(c) 2006 Red-Bean Software
+</screen>
+
+      <para>Es gibt sogar eine Variante des Befehls
+        <command>proplist</command>, die es erlaubt, sowohl die Namen
+        als auch die Werte aller Propertys auszugeben. Übergeben Sie
+        einfach die Option <option>--verbose</option>
+        (<option>-v</option>).</para>
+
+<!--
        <screen>
  $ svn proplist -v calc/button.c
  Properties on 'calc/button.c':
@@ -1030,14 +1141,41 @@
  red-beans-and-rice.
  …
  </screen>
-
+-->
+      <screen>
+$ svn proplist -v calc/button.c
+Eigenschaften für »calc/button.c«:
+  copyright : (c) 2006 Red-Bean Software
+  license :  
================================================================
+Copyright (c) 2006 Red-Bean Software.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions, and the recipe for Fitz's famous
+red-beans-and-rice.
+…
+</screen>
+
+<!--
        <para>The last property-related subcommand is
          <command>propdel</command>.  Since Subversion allows you to
          store properties with empty values, you can't remove a
          property altogether using <command>svn propedit</command> or
          <command>svn propset</command>.  For example, this command will
          <emphasis>not</emphasis> yield the desired effect:</para>
-
+-->
+      <para>Der letzte Unterbefehl, der mit Propertys zu tun hat, ist
+        <command>propdel</command>. Da Subversion Propertys mit
+        leeren Werten erlaubt, können Sie ein Property nicht
+        vollständig mit <command>svn propedit</command> oder mit
+        <command>svn propset</command> entfernen. So hat
+        beispielsweise dieser Befehl <emphasis>nicht</emphasis> den
+        erwünschten Effekt:</para>
+
+<!--
        <screen>
  $ svn propset license '' calc/button.c
  property 'license' set on 'calc/button.c'
@@ -1046,12 +1184,23 @@
    copyright : (c) 2006 Red-Bean Software
    license :
  $
+</screen>
+-->
+      <screen>
+$ svn propset license '' calc/button.c
+Eigenschaft »license« für »calc/button.c« gesetzt
+$ svn proplist -v calc/button.c
+Eigenschaften zu »calc/button.c«:
+  copyright : (c) 2006 Red-Bean Software
+  license :
+$
  </screen>

-      <para>You need to use the <command>propdel</command> subcommand
-        to delete properties altogether.  The syntax is similar to the
-        other property commands:</para>
-
+      <para>Zum vollständigen Löschen von Propertys müssen Sie den
+        Unterbefehl <command>propdel</command> verwenden. Die Syntax
+        ist den anderen Property-Befehlen ähnlich:</para>
+
+<!--
        <screen>
  $ svn propdel license calc/button.c
  property 'license' deleted from 'calc/button.c'.
@@ -1059,12 +1208,22 @@
  Properties on 'calc/button.c':
    copyright : (c) 2006 Red-Bean Software
  $
+</screen>
+-->
+      <screen>
+$ svn propdel license calc/button.c
+Eigenschaft »license« wurde von »calc/button.c« gelöscht.
+$ svn proplist -v calc/button.c
+Eigenschaften zu »calc/button.c«:
+  copyright : (c) 2006 Red-Bean Software
+$
  </screen>

+<!--
        <para>Remember those unversioned revision properties?  You can
          modify those, too, using the same <command>svn</command>
          subcommands that we just described.  Simply add the
-        <option>--revprop</option> command-line parameter and specify
+        <option>- -revprop</option> command-line parameter and specify
          the revision whose property you wish to modify.  Since
          revisions are global, you don't need to specify a target path
          to these property-related commands so long as you are
@@ -1078,29 +1237,76 @@
            <para>Fixing spelling errors, grammatical gotchas, and
              <quote>just-plain-wrongness</quote> in commit log
              messages is perhaps the most common use case for the
-            <option>--revprop</option> option.</para>
+            <option>- -revprop</option> option.</para>
          </footnote>
          If your current working directory is part of a working copy of
          your repository, you can simply run the
          <command>svn propset</command> command with no target path:</para>
-
+-->
+      <para>Können Sie sich an diese unversionierten
+        Revisions-Propertys erinnern? Auch diese können Sie mit den
+        eben beschriebenen Unterbefehlen von <command>svn</command>
+        verändern. Geben Sie einfach den Kommandozeilenparameter
+        <option>--revprop</option> an und die Revision, dessen
+        Property Sie ändern möchten. Da Revisionen global sind,
+        brauchen Sie keinen Zielpfad für diese Property-Unterbefehle
+        anzugeben sofern Sie sich in einer Arbeitskopie des
+        Projektarchivs befinden, dessen Revisions-Property Sie ändern
+        möchten. Anderenfalls können Sie den URL irgendeines Pfades im
+        entsprechenden Repository angeben (inklusive des
+        Wurzelverzeichnisses des Projektarchivs). Sie möchten
+        beispielsweise die Protokollnachricht einer bestehenden
+        Revision ändern.
+        <footnote>
+          <para>Das Berichtigen von Rechtschreibfehlern, grammatischen
+            Stolpersteinen und <quote>einfacher
+              Unrichtigkeiten</quote> in Protokollnachrichten ist
+            vielleicht der häufigste Anwendungsfall für die Option
+            <option>--revprop</option>.</para>
+        </footnote>
+        Falls Ihr aktuelles Arbeitsverzeichnis Teil einer Arbeitskopie
+        Ihres Projektarchivs ist, können Sie einfach den Befehl
+        <command>svn propset</command> ohne Zielpfad aufrufen:</para>
+
+<!--
        <screen>
-$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 --revprop
+$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 - -revprop
  property 'svn:log' set on repository revision '11'
  $
+</screen>
+-->
+      <screen>
+$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 --revprop
+Eigenschaft »svn:log« wurde für Revision »11« im Projektarchiv gesetzt
+$
  </screen>

+<!--
        <para>But even if you haven't checked out a working copy from
          that repository, you can still effect the property change by
          providing the repository's root URL:</para>
-
+-->
+      <para>Selbst wenn Sie keine Arbeitskopie aus diesem
+        Projektarchiv ausgecheckt haben, können Sie dennoch die
+        Änderung am Property durchführen, indem Sie den URL der Wurzel
+        des Projektarchivs angeben:</para>
+
+<!--
        <screen>
-$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 --revprop  
\
+$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 -  
-revprop \
                http://svn.example.com/repos/project
  property 'svn:log' set on repository revision '11'
  $
+</screen>
+-->
+      <screen>
+$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 --revprop  
\
+              http://svn.example.com/repos/project
+Eigenschaft »svn:log« wurde für Revision »11« im Projektarchiv gesetzt.
+$
  </screen>

+<!--
        <para>Note that the ability to modify these unversioned
          properties must be explicitly added by the repository
          administrator (see <xref linkend="svn.reposadmin.maint.setlog" />).
@@ -1109,8 +1315,20 @@
          The repository administrator can set up methods to protect
          against this loss, and by default, modification of
          unversioned properties is disabled.</para>
+-->
+      <para>Beachten Sie, dass die Fähigkeit, diese unversionierten
+        Propertys zu verändern, ausdrücklich vom Administrator des
+        Projektarchivs hinzugefügt werden muss (siehe <xref
+          linkend="svn.reposadmin.maint.setlog" />). Das geschieht aus
+        dem Grund, dass diese Propertys nicht versioniert sind, und
+        Sie Gefahr laufen, durch unvorsichtiges Bearbeiten
+        Informationen zu verlieren. Der Administrator des
+        Projektarchivs kann Schutzmaßnahmen gegen diesen Verlust
+        ergreifen, und standardmäßig ist die Veränderung
+        unversionierter Propertys nicht freigeschaltet.</para>

        <tip>
+<!--
          <para>Users should, where possible, use <command>svn
            propedit</command> instead of <command>svn
            propset</command>.  While the end result of the commands is
@@ -1122,6 +1340,18 @@
            significantly easier to modify multiline property values in
            a text editor than at the command line.</para>
        </tip>
+-->
+        <para>Benutzer sollten nach Möglichkeit <command>svn
+            propedit</command> statt <command>svn propset</command>
+          verwenden. Während das Endergebnis dieser Befehle identisch
+          ist, wird bei ersterem der aktuelle Wert des zu ändernden
+          Propertys angezeigt, was dabei hilft, sicherzustellen, dass
+          die Änderung auch die beabsichtigte war. Das gilt besonders
+          für unversionierte Revisions-Propertys. Darüberhinaus ist es
+          auch bedeutend einfacher, mehrzeilige Property-Werte in
+          einem Texteditor statt auf der Kommandozeile zu
+          bearbeiten.</para>
+      </tip>

      </sect2>



More information about the svnbook-dev mailing list