[svnbook] r3783 committed - * trunk/src/de/book/ch03-advanced-topics.xml:...
svnbook at googlecode.com
svnbook at googlecode.com
Mon Sep 20 13:06:25 CDT 2010
Revision: 3783
Author: jmfelderhoff at gmx.eu
Date: Mon Sep 20 11:02:54 2010
Log: * trunk/src/de/book/ch03-advanced-topics.xml:
- Fixes ticket #135 (cf. http://www.svnbook.de/report/6).
http://code.google.com/p/svnbook/source/detail?r=3783
Modified:
/trunk/src/de/book/ch03-advanced-topics.xml
=======================================
--- /trunk/src/de/book/ch03-advanced-topics.xml Sat Sep 4 07:44:45 2010
+++ /trunk/src/de/book/ch03-advanced-topics.xml Mon Sep 20 11:02:54 2010
@@ -3047,8 +3047,12 @@
<!-- =================================================================
-->
<!-- =================================================================
-->
<sect1 id="svn.advanced.props.special.keywords">
+<!--
<title>Keyword Substitution</title>
-
+-->
+ <title>Ersetzung von Schlüsselworten</title>
+
+<!--
<para>Subversion has the ability to substitute
<firstterm>keywords</firstterm>—pieces of useful,
dynamic information about a versioned file—into the
@@ -3060,7 +3064,20 @@
for any process except the version control system to keep
the data completely up to date. Left to human authors, the
information would inevitably grow stale.</para>
-
+-->
+ <para>Subversion ist in der Lage,
+ <firstterm>Schlüsselworte</firstterm> – nützliche
+ dynamische Informationshäppchen zu einer versionierten Datei
+ – im Dateiinhalt zu ersetzen. Schlüsselworte liefern im
+ Allgemeinen Informationen zur letzten Änderung an der Datei. Da
+ diese Information sich mit jeder Änderung der Datei auch ändert,
+ noch wichtiger, <emphasis>nachdem</emphasis> sich die Datei
+ ändert, ist es für jeden Prozess außer dem
+ Versionskontrollsystem ein ziemlicher Aufwand, die Daten
+ vollständig aktuell zu halten. Würde das den Autoren überlassen,
+ veralterten die Informationen unausweichlich.</para>
+
+<!--
<para>For example, say you have a document in which you would
like to display the last date on which it was modified. You
could burden every author of that document to, just before
@@ -3074,22 +3091,54 @@
location in the file. This anchor is just a string of text
formatted as
<literal>$</literal><replaceable>KeywordName</replaceable><literal>$</literal>.</para>
-
+-->
+ <para>Nehmen wir beispielsweise an, dass Sie ein Dokument haben,
+ in dem das Datum der letzten Änderung angezeigt werden soll. Sie
+ könnten natürlich jedem Bearbeiter auferlegen, kurz vor dem
+ Übertragen ihrer Änderungen, den Teil des Dokumentes, der das
+ Änderungsdatum enthält, entsprechend anzupassen. Früher oder
+ später jedoch wird jemand vergessen, das zu tun. Teilen Sie
+ stattdessen Subversion mit, eine Schlüsselwort-Ersetzung mit dem
+ Schlüsselwort <literal>LastChangedDate</literal> vorzunehmen.
+ Sie kontrollieren, wo das Schlüsselwort in Ihrem Dokument
+ eingefügt wird, indem Sie einen
+ <firstterm>Schlüsselwort-Anker</firstterm> an die gewünschte
+ Stelle der Datei setzen. Dieser Anker ist einfach eine
+ Zeichenkette, die formatiert ist wie
+
<literal>$</literal><replaceable>KeywordName</replaceable><literal>$</literal>.</para>
+
+<!--
<para>All keywords are case-sensitive where they appear as
anchors in files: you must use the correct capitalization
for the keyword to be expanded. You should consider the
value of the <literal>svn:keywords</literal> property to be
case-sensitive, too—certain keyword names will be recognized
regardless of case, but this behavior is deprecated.</para>
-
+-->
+ <para>Bei allen Schlüsselworten, die als Anker in Dateien
+ verwendet werden, ist die Groß- und Kleinschreibung relevant. Sie
+ müssen die korrekte Schreibung verwenden, damit das
+ Schlüsselwort ersetzt wird. Sie sollten davon ausgehen, dass
+ auch die Gross- und Kleinschreibung der Eigenschaftswerte von
+ <literal>svn:keywords</literal> relevant ist – bestimmte
+ Schlüsselworte werden dessenungeachtet erkannt, jedoch wird
+ abgeraten, von diesem Verhalten auszugehen.</para>
+
+<!--
<para>Subversion defines the list of keywords available for
substitution. That list contains the following five keywords,
some of which have aliases that you can also use:</para>
+-->
+ <para>Subversion definiert die Liste der Schlüsselworte, die für
+ die Ersetzung verfügbar sind. Diese Liste enthält die folgenden
+ fünf Schlüsselworte, von denen einige Aliasnamen besitzen, die
+ Sie auch verwenden können.</para>
<variablelist>
<varlistentry>
<term><literal>Date</literal></term>
<listitem>
+<!--
<para>This keyword describes the last time the file was
known to have been changed in the repository, and is of
the form <literal>$Date: 2006-07-22 21:42:37 -0700 (Sat,
@@ -3098,43 +3147,75 @@
<literal>Id</literal> keyword, which uses UTC, the
<literal>Date</literal> keyword displays dates using the
local time zone.</para>
+-->
+ <para>Dieses Schlüsselwort beschreibt den letzten bekannten
+ Zeitpunkt einer Änderung dieser Datei im Projektarchiv und
+ hat das Format <literal>$Date: 2006-07-22 21:42:37 -0700
+ (Sat, 22 Jul 2006) $</literal>. Es kann auch als
+ <literal>LastChangedDate</literal> angegeben werden.
+ Anders als das Schlüsselwort <literal>Id</literal>, das
+ UTC verwendet, zeigt das Schlüsselwort
+ <literal>Date</literal> Zeitpunkte in der örtlichen
+ Zeitzone an.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Revision</literal></term>
<listitem>
+<!--
<para>This keyword describes the last known revision in
which this file changed in the repository, and looks
something like <literal>$Revision: 144 $</literal>.
It may also be specified as
<literal>LastChangedRevision</literal> or
<literal>Rev</literal>.</para>
+-->
+ <para>Dieses Schlüsselwort beschreibt die letzte bekannte
+ Revision einer Änderung dieser Datei im Projektarchiv und
+ sieht etwa so aus: <literal>$Revision: 144 $</literal>. Es
+ kann auch als <literal>LastChangedRevision</literal> oder
+ <literal>Rev</literal> angegeben werden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Author</literal></term>
<listitem>
+<!--
<para>This keyword describes the last known user to
change this file in the repository, and looks
something like <literal>$Author: harry $</literal>.
It may also be specified as
<literal>LastChangedBy</literal>.</para>
+-->
+ <para>Dieses Schlüsselwort beschreibt den letzten bekannten
+ Autor einer Änderung dieser Datei im Projektarchiv und sieht
+ etwa so aus: <literal>$Author: harry $</literal>. Es kann
+ auch als <literal>LastChangedBy</literal> angegeben
+ werden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>HeadURL</literal></term>
<listitem>
+<!--
<para>This keyword describes the full URL to the latest
version of the file in the repository, and looks
something like <literal>$HeadURL:
http://svn.collab.net/repos/trunk/README $</literal>.
It may be abbreviated as
<literal>URL</literal>.</para>
+-->
+ <para>Dieses Schlüsselwort beschreibt den vollständigen URL
+ zur letzten Version der Datei im Projektarchiv und sieht
+ etwa so aus: <literal>$HeadURL:
+ http://svn.collab.net/repos/trunk/README $</literal>.
+ Es kann zu <literal>URL</literal> abgekürzt werden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Id</literal></term>
<listitem>
+<!--
<para>This keyword is a compressed combination of the other
keywords. Its substitution looks something like
<literal>$Id: calc.c 148 2006-07-28 21:30:43Z sally
@@ -3145,10 +3226,21 @@
keyword is in UTC, unlike that of the
<literal>Date</literal> keyword (which uses the local time
zone).</para>
+-->
+ <para>Dieses Schlüsselwort ist eine komprimierte Kombination
+ aus den anderen Schlüsselworten. Seine Ersetzung sieht
+ etwa so aus: <literal>$Id: calc.c 148 2006-07-28 21:30:43Z
+ sally $</literal>, und sie bedeutet, dass die Datei
+ <filename>calc.c</filename> zuletzt in Revision 148 am
+ Abend des 28. Juli 2006 von <literal>sally</literal>
+ geändert wurde. Der angegebene Zeitpunkt ist in UTC,
+ anders als beim Schlüsselwort <literal>Date</literal> (das
+ die örtliche Zeitzone verwendet).</para>
</listitem>
</varlistentry>
</variablelist>
+<!--
<para>Several of the preceding descriptions use the phrase
<quote>last known</quote> or similar wording. Keep in mind that
keyword expansion is a client-side operation, and your client
@@ -3158,7 +3250,19 @@
keywords will never expand to different values even if those
versioned files are being changed regularly in the
repository.</para>
-
+-->
+ <para>Einige der vorangegangenen Beschreibungen verwenden
+ Formulierungen wie <quote>letzte bekannte</quote> oder
+ Ähnliches. Denken Sie daran, dass die Schlüsselwort-Ersetzung
+ vom Client vorgenommen wird und dieser nur Änderungen
+ <quote>kennt</quote>, die im Projektarchiv stattgefunden haben,
+ als Sie Ihre Arbeitskopie aktualisiert haben, um diese
+ Änderungen zu bekommen. Falls Sie Ihre Arbeitskopie nie
+ aktualisieren, werden Ihre Schlüsselworte niemals durch
+ andere Werte ersetzt werden, auch wenn diese Dateien
+ regelmäßig im Projektarchiv geändert werden.</para>
+
+<!--
<para>Simply adding keyword anchor text to your file does
nothing special. Subversion will never attempt to perform
textual substitutions on your file contents unless
@@ -3170,36 +3274,85 @@
about how to use keywords, and you don't want Subversion to
substitute your beautiful examples of unsubstituted keyword
anchors!</para>
-
+-->
+ <para>Einfach einen Schlüsselwort-Anker in Ihre Datei einzufügen,
+ bewirkt nichts. Subversion wird niemals versuchen, eine
+ Textersetzung in Ihren Dateiinhalten vorzunehmen, falls Sie es
+ nicht ausdrücklich dazu auffordern. Schließlich könnten Sie ja
+ ein Dokument
+ <footnote>
+ <para>… oder sogar einen Buchabschnitt …</para>
+ </footnote>
+ über die Verwendung von Schlüsselworten schreiben und deshalb
+ nicht wollen, dass Subversion Ihre schönen Beispiele nicht
+ ersetzter Schlüsselwort-Anker ersetzt!</para>
+
+<!--
<para>To tell Subversion whether to substitute keywords
on a particular file, we again turn to the property-related
subcommands. The <literal>svn:keywords</literal> property,
when set on a versioned file, controls which keywords will
be substituted on that file. The value is a space-delimited
list of keyword names or aliases.</para>
-
+-->
+ <para>Um Subversion mitzuteilen, ob Schlüsselworte in einer
+ bestimmten Datei ersetzt werden sollen, wenden wir uns wiederum
+ den Unterbefehlen zu, die mit Eigenschaften zu tun haben. Die
+ Eigenschaft <literal>svn:keywords</literal> an einer
+ versionierten Datei kontolliert, welche Schlüsselworte in
+ dieser Datei ersetzt werden. Der Wert ist eine durch Leerzeichen
+ getrennte Liste aus Schlüsselwort-Namen oder deren
+ Aliasnamen.</para>
+
+<!--
<para>For example, say you have a versioned file named
<filename>weather.txt</filename> that looks like
this:</para>
-
+-->
+ <para>Nehmen wir an, sie haben eine versionierte Datei namens
+ <filename>weather.txt</filename>, die folgendermaßen
+ aussieht:</para>
+
+<!--
<programlisting>
Here is the latest report from the front lines.
$LastChangedDate$
$Rev$
Cumulus clouds are appearing more frequently as summer approaches.
</programlisting>
-
+-->
+ <programlisting>
+Hier ist der neueste Bericht von der vordersten Front.
+$LastChangedDate$
+$Rev$
+Cumulus-Wolken entstehen öfter, wenn der Sommer naht.
+</programlisting>
+
+<!--
<para>With no <literal>svn:keywords</literal> property set on
that file, Subversion will do nothing special. Now, let's
enable substitution of the
<literal>LastChangedDate</literal> keyword.</para>
-
+-->
+ <para>Ohne die Eigenschaft <literal>svn:keywords</literal> auf
+ dieser Datei wird Subversion nichts Besonderes machen. Nun
+ schalten wir die Ersetzung des Schlüsselwortes
+ <literal>LastChangedDate</literal> ein.</para>
+
+<!--
<screen>
$ svn propset svn:keywords "Date Author" weather.txt
property 'svn:keywords' set on 'weather.txt'
$
-</screen>
-
+</screen>
+-->
+ <screen>
+$ svn propset svn:keywords "Date Author" weather.txt
+Eigenschaft »svn:keywords« für »weather.txt« gesetzt
+$
+</screen>
+
+<!--
<para>Now you have made a local property modification on the
<filename>weather.txt</filename> file. You will see no
changes to the file's contents (unless you made some of your
@@ -3210,7 +3363,20 @@
substitute keywords that are not present in the file and
will not substitute keywords that are not present in the
<literal>svn:keywords</literal> property value.</para>
-
+-->
+ <para>Nun haben Sie eine lokale Änderung an einer Eigenschaft der
+ Datei <filename>weather.txt</filename> vorgenommen. Sie werden
+ keine Änderungen am Dateiinhalt erkennen können (es sei denn,
+ sie hätten einige vor dem Setzen der Eigenschaft gemacht).
+ Beachten Sie, dass die Datei einen Anker für das Schlüsselwort
+ <literal>Rev</literal> enthielt, wir dieses Schlüsselwort jedoch
+ nicht in den Wert der von uns gesetzten Eigenschaft aufnahmen.
+ Es ist Subversion ein Vergnügen, alle Aufforderungen zu
+ ignorieren, Schlüsselworte zu ersetzen, die nicht in der Datei
+ oder im Wert der Eigenschaft <literal>svn:keywords</literal>
+ vorhanden sind.</para>
+
+<!--
<para>Immediately after you commit this property change,
Subversion will update your working file with the new
substitute text. Instead of seeing your keyword anchor
@@ -3220,19 +3386,45 @@
(<literal>$</literal>) characters. And as we predicted, the
<literal>Rev</literal> keyword was not substituted because
we didn't ask for it to be.</para>
-
+-->
+ <para>Unmittelbar nachdem Sie diese Änderung der Eigenschaft
+ übertragen haben, wird Subversion Ihre Arbeitsdatei mit dem
+ neuen Ersatztext aktualisieren. Statt des Schlüsselwort-Ankers
+ <literal>$LastChangedDate$</literal> werden Sie das Ergebnis der
+ Ersetzung sehen. Das Ergebnis enthält auch das Schlüsselwort und
+ wird weiterhin durch die Dollarzeichen (<literal>$</literal>)
+ begrenzt. Und wie wir vorhergesehen hatten, wurde das
+ Schlüsselwort <literal>Rev</literal> nicht ersetzt, da wir es
+ nicht wollten.</para>
+
+<!--
<para>Note also that we set the <literal>svn:keywords</literal>
property to <literal>Date Author</literal>, yet the keyword
anchor used the alias <literal>$LastChangedDate$</literal>
and still expanded correctly:</para>
-
+-->
+ <para>Beachten Sie auch, dass wir die Eigenschaft
+ <literal>svn:keywords</literal> auf <literal>Date
+ Author</literal> setzten, der Schlüsselwort-Anker aber das
+ Alias <literal>$LastChangedDate$</literal> verwendete und
+ trotzdem korrekt erweitert wurde:</para>
+
+<!--
<screen>
Here is the latest report from the front lines.
$LastChangedDate: 2006-07-22 21:42:37 -0700 (Sat, 22 Jul 2006) $
$Rev$
Cumulus clouds are appearing more frequently as summer approaches.
</screen>
-
+-->
+ <screen>
+Hier ist der neueste Bericht von der vordersten Front.
+$LastChangedDate: 2006-07-22 21:42:37 -0700 (Sat, 22 Jul 2006) $
+$Rev$
+Cumulus-Wolken entstehen öfter, wenn der Sommer naht.
+</screen>
+
+<!--
<para>If someone else now commits a change to
<filename>weather.txt</filename>, your copy of that file
will continue to display the same substituted keyword value
@@ -3240,10 +3432,23 @@
time, the keywords in your <filename>weather.txt</filename>
file will be resubstituted with information that
reflects the most recent known commit to that file.</para>
+-->
+ <para>Falls nun jemand anderes eine Änderung an
+ <filename>weather.txt</filename> überträgt, wird Ihre Kopie der
+ Datei den gleichen ersetzten Wert des Schlüsselwortes anzeigen
+ wie vorher – bis Sie Ihre Arbeitskopie aktualisieren. Zu
+ diesem Zeitpunkt werden die Schlüsselworte in Ihrer Datei
+ <filename>weather.txt</filename> mit Informationen ersetzt, die
+ der letzten bekannten Übertragung dieser Datei
+ entsprechen.</para>
<sidebar>
+<!--
<title>Where's $GlobalRev$?</title>
-
+-->
+ <title>Wo ist $GlobalRev$?</title>
+
+<!--
<para>New users are often confused by how the
<literal>$Rev$</literal> keyword works. Since the repository
has a single, globally increasing revision number, many people
@@ -3256,7 +3461,22 @@
support of a Subversion keyword to do so, how can you
automatically get the global revision number into your
files?</para>
-
+-->
+ <para>Neue Benutzer sind oft darüber verwirrt, wie das
+ Schlüsselwort <literal>$Rev$</literal> funktioniert. Da das
+ Projektarchiv eine einzelne, global größer werdende
+ Revisionsnummer besitzt, nehmen viele Leute an, dass diese
+ Nummer sich im Wert des Schlüsselwortes
+ <literal>$Rev$</literal> widerspiegelt. Jedoch wird
+ <literal>$Rev$</literal> ersetzt mit der letzten Revision, in
+ der die Datei sich <emphasis>geändert</emphasis> hat, nicht
+ die letzte Revision, auf die sie aktualisiert wurde. Dieses
+ Verständnis beseitigt zwar die Verwirrung, jedoch bleibt oft
+ Enttäuschung zurück – wie kommt die globale
+ Revisionsnummer ohne ein Subversion-Schlüsselwort automatisch
+ in Ihre Dateien?</para>
+
+<!--
<para>To do this, you need external processing. Subversion
ships with a tool called <command>svnversion</command>, which
was designed for just this purpose. It crawls your working
@@ -3265,9 +3485,20 @@
that revision information into your files. For more
information on <command>svnversion</command>, see <xref
linkend="svn.ref.svnversion"/>.</para>
+-->
+ <para>Dies bedarf einer externen Behandlung. Subversion liefert
+ das Werkzeug <command>svnversion</command> mit, das allein für
+ diesen Zweck gedacht ist. Es arbeitet sich durch Ihre
+ Arbeitskopie und gibt die Revision(en) aus, die es findet. Sie
+ können dieses Programm zusammen mit etwas zusätzlicher
+ Programmierung drumherum verwenden, um diese
+ Revisions-Information in Ihre Dateien einzufügen. Für
+ weitergehende Informationen zu <command>svnversion</command>,
+ siehe <xref linkend="svn.ref.svnversion"/>.</para>
</sidebar>
+<!--
<para>Subversion 1.2 introduced a new variant of the keyword
syntax, which brought additional, useful—though perhaps
atypical—functionality. You can now tell Subversion
@@ -3284,29 +3515,74 @@
substituted field; if it is too long, it is truncated with a
special hash (<literal>#</literal>) character just before
the final dollar sign terminator.</para>
-
+-->
+ <para>Subversion 1.2 führte eine neue Variante der
+ Schlüsselwort-Syntax ein, die eine zusätzliche nützliche
+ – wenn auch vielleicht atypische – Funktionsweise
+ mitbrachte. Sie können Subversion nun mitteilen, eine feste
+ Länge (die Anzahl verwendeter Bytes) für ein ersetztes
+ Schlüsselwort vorzuhalten. Indem ein doppelter Doppelpunkt
+ (<literal>::</literal>) nach dem Namen des Schlüsselwortes
+ geschrieben wird, dem eine Anzahl von Leerzeichen folgt,
+ definieren Sie diese feste Breite. Wenn Subversion nun dieses
+ Schlüsselwort durch das Schlüsselwort und seinen Wert ersetzt,
+ werden im Wesentlichen nur die Leerzeichen ersetzt, so dass die
+ Gesamtbreite des Schlüsselwort-Felds unverändert bleibt.
+ Falls der ersetzte Wert kürzer als das definierte Feld ist,
+ werden am Ende des ersetzten Feldes zusätzliche Füllzeichen
+ (Leerzeichen) eingefügt; falls er zu lang ist, wird er mit einem
+ speziellen Nummernzeichen (<literal>#</literal>) unmittelbar vor
+ dem letzten Dollarzeichen abgeschnitten.</para>
+
+<!--
<para>For example, say you have a document in which you have
some section of tabular data reflecting the document's
Subversion keywords. Using the original Subversion keyword
substitution syntax, your file might look something
like:</para>
-
+-->
+ <para>Nehmen wir zum Beispiel an, Sie hätten ein Dokument, in dem
+ sich ein tabellarischer Abschnitt mit den
+ Subversion-Schlüsselworten befindet. Mit der originalen Syntax
+ für die Schlüsselwort-Ersetzung von Subversion würde die Datei
+ etwa so aussehen:</para>
+
+<!--
<screen>
$Rev$: Revision of last commit
$Author$: Author of last commit
$Date$: Date of last commit
</screen>
-
+-->
+ <screen>
+$Rev$: Revision der letzten Übertragung
+$Author$: Autor der letzten Übertragung
+$Date$: Datum der letzten Übertragung
+</screen>
+
+<!--
<para>Now, that looks nice and tabular at the start of things.
But when you then commit that file (with keyword substitution
enabled, of course), you see:</para>
-
+-->
+ <para>Zu Beginn sieht das noch hübsch aus. Wenn Sie die Datei dann
+ allerdings (natürlich mit aktivierter Schlüsselwort-Ersetzung)
+ übertragen, sehen Sie:</para>
+
+<!--
<screen>
$Rev: 12 $: Revision of last commit
$Author: harry $: Author of last commit
$Date: 2006-03-15 02:33:03 -0500 (Wed, 15 Mar 2006) $: Date of last
commit
</screen>
-
+-->
+ <screen>
+$Rev: 12 $: Revision der letzten Übertragung
+$Author: harry $: Autor der letzten Übertragung
+$Date: 2006-03-15 02:33:03 -0500 (Wed, 15 Mar 2006) $: Datum der
letzten Übertragung
+</screen>
+
+<!--
<para>The result is not so beautiful. And you might be
tempted to then adjust the file after the substitution so
that it again looks tabular. But that holds only as long as
@@ -3317,13 +3593,32 @@
you are using Subversion 1.2 or later, you can use the new
fixed-length keyword syntax and define some field widths that
seem sane, so your file might look like this:</para>
-
+-->
+ <para>Das Ergebnis ist weniger hübsch. Vielleicht sind Sie
+ versucht, die Datei zu korrigieren, so dass es wieder
+ tabellarisch aussieht. Allerdings hält das nur so lange vor,
+ wie die Werte der Schlüsselworte die gleiche Länge haben. Falls
+ die Revision der letzten Änderung eine weitere Stelle einnimmt
+ (etwa von 99 auf 100) oder eine Person mit einem längeren
+ Benutzernamen die Datei überträgt, sieht alles wieder schief
+ aus. Wenn Sie jedoch Subversion 1.2 oder neuer verwenden, können
+ Sie die neue Schlüsselwort-Syntax mit fester Länge verwenden und
+ vernünftige Feldlängen definieren, etwa:</para>
+
+<!--
<screen>
$Rev:: $: Revision of last commit
$Author:: $: Author of last commit
$Date:: $: Date of last commit
</screen>
-
+-->
+ <screen>
+$Rev:: $: Revision der letzten Übertragung
+$Author:: $: Autor der letzten Übertragung
+$Date:: $: Datum der letzten Übertragung
+</screen>
+
+<!--
<para>You commit this change to your file. This time,
Subversion notices the new fixed-length keyword syntax and
maintains the width of the fields as defined by the padding
@@ -3333,20 +3628,47 @@
<literal>Rev</literal> and <literal>Author</literal> are
padded with spaces, and the long <literal>Date</literal>
field is truncated by a hash character:</para>
-
+-->
+ <para>Sie übertragen diese Änderung an Ihrer Datei. Diesmal
+ bemerkt Subversion die neue Schlüsselwort-Syntax mit fester
+ Länge und behält die Breite der Felder bei, die Sie durch die
+ Füllzeichen zwischen den doppelten Doppelpunkten und dem
+ abschließenden Dollarzeichen definiert haben. Nach Ersetzung ist
+ die Breite der Felder völlig unverändert – die kurzen
+ Werte für <literal>Rev</literal> und <literal>Author</literal>
+ sind mit Leerzeichen aufgefüllt und das lange Feld
+ <literal>Date</literal> wird mit einem Nummernzeichen
+ abgeschnitten:</para>
+
+<!--
<screen>
$Rev:: 13 $: Revision of last commit
$Author:: harry $: Author of last commit
$Date:: 2006-03-15 0#$: Date of last commit
</screen>
-
+-->
+ <screen>
+$Rev:: 13 $: Revision der letzten Übertragung
+$Author:: harry $: Autor der letzten Übertragung
+$Date:: 2006-03-15 0#$: Datum der letzten Übertragung
+</screen>
+
+<!--
<para>The use of fixed-length keywords is especially handy
when performing substitutions into complex file formats that
themselves use fixed-length fields for data, or for which
the stored size of a given data field is overbearingly
difficult to modify from outside the format's native
application (such as for Microsoft Office documents).</para>
-
+-->
+ <para>Die Verwendung von Schlüsselworten fester Länge ist
+ besonders praktisch, wenn Ersetzungen in komplexe Dateiformate
+ vorgenommen werden sollen, die ihrerseits Felder fester Länge
+ für Daten verwenden oder deren Größe für ein Datenfeld sich
+ außerhalb der Anwendung nur sehr schwer ändern läßt (etwa für
+ Dokumente in Microsoft Office ).</para>
+
+<!--
<warning>
<para>Be aware that because the width of a keyword field is
measured in bytes, the potential for corruption of
@@ -3364,6 +3686,24 @@
choose a size that allows for this type of byte-wise
expansion.</para>
</warning>
+-->
+ <warning>
+ <para>Denken Sie daran, dass die Möglichkeit besteht, dass aus
+ Multibyte-Zeichen bestehende Werte korrumpiert werden können,
+ da die Breite eines Schlüsselwort-Feldes in Bytes gemessen
+ wird. Ein Benutzername, der einige Multibyte-UTF-8-Zeichen
+ enthält könnte mitten in einer Zeichenfolge abgeschnitten
+ werden, die eines dieser Zeichen repräsentiert. Auf Byte-Ebene
+ handelt es sich dabei bloß um eine Kürzung, ein UTF-8-Text
+ wird jedoch wahrscheinlich als Zeichenkette mit einem falschen
+ oder missratenen letzten Zeichen wiedergegeben. Es ist
+ denkbar, dass bestimmte Anwendungen beim Versuch, die Datei zu
+ laden, den fehlerhaften UTF-8-Text erkennen, die gesamte Datei
+ als fehlerhaft einstufen und deren Bearbeitung vollständig
+ verweigern. Falls Sie also Schlüsselworte auf eine feste Länge
+ beschränken, sollten Sie eine Größe wählen, die diese Art der
+ Ersetzung berücksichtigt.</para>
+ </warning>
</sect1>
More information about the svnbook-dev
mailing list