[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