Borland® StarTeam® 2006 - Borland Technical Publications

Tabelle der StarTeam Schlüsselwörter
Indem Sie die Schlüsselworterweiterung für ein Projekt aktivieren, können Sie Schlüsselwörter in Textdateien
einbetten. Diese Schlüsselwörter werden während des Auscheckens von Dateien automatisch erweitert, um Dateiund
Revisionsinformationen in der Datei bereitzustellen. Dabei sollte pro Zeile nur ein Schlüsselwort verwendet
werden.
Element
$Author$
$Date$ and $DateUTC$
$Header$ und $HeaderUTC$
$History$
Beschreibung
Der Benutzer, der die Revision eingecheckt hat.
Die Datums- und Zeitstempel für die Revision. $DateUTC$
ist identisch mit $Date$. Die UTC-Zeit ersetzt jedoch eine
lokale Zeit. Die UTC-Zeit endet mit einem "Z", wodurch sie
leichter identifiziert werden kann.
Eine Kombination aus Arbeitsdatei, Revision, Datum und
Autor. $HeaderUTC$ ist identisch mit $Header$. Die UTC-
Zeit ersetzt jedoch eine lokale Zeit. Die UTC-Zeit endet mit
einem "Z", wodurch sie leichter identifiziert werden kann.
Für Java-Benutzer kann $Header$ Probleme verursachen,
wenn \u (für Unicode) im erweiterten Header angezeigt wird.
Angenommen, eine Datei namens foo.java wird in D:
\util gespeichert. Wenn Sie sie das erste Mal mit $Header
$ kompilieren, wird der Header wie folgt erweitert:
$Header: D:\util\foo.java, 1, 27/07/99
11:05:48, StarTeam Server Administrator$
Auch wenn sich dieser Header in einem Java-Kommentar
befindet, sucht der Java-Compiler immer nach \u. Wenn Sie
die Datei foo.java erneut compilieren, wird ein Compiler-
Fehler angezeigt.
Wird zur Quelldatei hinzugefügt, in der Regel in einem
Kommentarfeld. Das Schlüsselwort $History$ erstellt einen
Protokolldatensatz für die neueste (aktuelle) Revision und
fügt die Informationen hinter dem Schlüsselwort ein. Wenn
die Datei beispielsweise das erste Mal ausgecheckt wird,
würde sie Folgendes enthalten:
// ...
// $History
// 1 IhrProjekt 1.0 2005-11-19 00:06:57Z Joe
Smith
// Dies ist ein Revisionskommentar.
// $
StarTeam fügt die Protokollinformationen zur Datei hinzu und
platziert sie außerhalb des Zeichens "$" sodass sie zu einem
Versionsteil der Datei werden. Da die Protokolldatensätze
Teil des mit Versionsbezeichnung versehenen Dateiinhalts
werden, können Sie zusätzliche oder überflüssige
Protokolldatensätze jederzeit löschen. Wenn diese Datei
geändert und dann eingecheckt wird, wird bei allen
nachfolgenden Auscheckvorgängen sofort ein zusätzlicher
Datensatz hinter das Schlüsselwort $History$ eingefügt:
1894