Unterstützung von Schlüsselworterweiterungen
Visual SourceSafe unterstützt die Schlüsselworterweiterung, durch die Schlüsselwörter in Text- und HTML-Dateien mit versionsspezifischen Informationen erweitert werden. Wenn Sie eine Datei hinzufügen oder einchecken, die diese Schlüsselwörter als Kommentar enthält, sucht Visual SourceSafe nach den Schlüsselwörtern und fügt relevante versionsspezifische Informationen automatisch nach den Wörtern ein. Beispielsweise wird Visual SourceSafe durch die Zeichenfolge $Revision: $ angewiesen, das Schlüsselwort Revision automatisch mit der aktuellen Dateiversionsnummer zu erweitern.
Hinweis
In der Standardeinstellung ist die Schlüsselworterweiterung für alle Dateien deaktiviert. Sie muss durch den Visual SourceSafe-Administrator aktiviert werden. Weitere Informationen finden Sie unter Gewusst wie: Aktivieren der Schlüsselworterweiterung.
Visual SourceSafe-Standardschlüsselwörter
Die folgende Tabelle führt alle Visual SourceSafe-Schlüsselwörter auf. Einige Schlüsselwörter sind redundant, entweder aus Gründen der Benutzerfreundlichkeit oder um abwärtskompatibel mit anderen Versionskontrollsystemen wie dem UNIX-Dienstprogramm RCS zu sein. Weitere Informationen über die Einrichtung einer Textdatei für die Schlüsselworterweiterung finden Sie unter Gewusst wie: Verwenden der Schlüsselworterweiterung in Text- oder HTML-Dateien.
Hinweis
Bei Schlüsselwörtern muss die Groß- und Kleinschreibung beachtet werden. Verwenden Sie die Großschreibung genau so, wie beschrieben.
- $Archive: $
Gibt den Visual SourceSafe-Speicherort für Archivdateien an.
- $Author: $
Gibt den Benutzer an, der die Datei zuletzt geändert hat.
- $Date: $
Gibt Datum und Uhrzeit des letzten Eincheckvorgangs an.
- $Header: $
Gibt einen Header im Format Logfile, Revision, Date, Author an.
- $History: $
Gibt die Dateiversionsgeschichte im Visual SourceSafe-Format an.
- $JustDate: $
Gibt ein einfaches Datum ohne Zeitangabe an.
- $Log: $
Gibt eine Dateiversionsgeschichte im RCS-Format an.
- $Logfile: $
Gibt analog zum Archive-Schlüsselwort den Speicherort für Protokolldateien an.
- $Modtime: $
Gibt Datum und Uhrzeit der letzten Änderung an.
- $Revision: $
Gibt eine Visual SourceSafe-Versionsnummer an.
- $Workfile: $
Gibt den Dateinamen an.
- $NoKeywords: $
Gibt an, dass für alle nachfolgenden Schlüsselwörter keine Schlüsselworterweiterung verwendet wird.
Sie können beispielsweise Folgendes in eine Datei einfügen:
$Revision: $
Wenn Sie eine Datei einchecken, ersetzt Visual SourceSafe die Revisionsspezifikation mit folgendem Code:
$Revision: 23 $
Nach dem nächsten Eincheckvorgang der Datei wird 23 mit 24 ersetzt usw. Sie finden die Version Ihrer Dateikopie immer am Anfang der Datei ohne dafür Visual SourceSafe ausführen zu müssen.
Visual SourceSafe-Schlüsselwörter für HTML-Dateien
Visual SourceSafe-Schlüsselwörter für HTML sind mit Visual SourceSafe-Standardschlüsselwörtern nahe zu identisch. Sie unterscheiden sich nur durch ein vor dem Wort eingefügtes zusätzliches Dollarzeichen. Ein HTML-Schlüsselwort sieht beispielsweise aus wie folgt: $$JustDate: $, während das gleiche Standardschlüsselwort so aussieht: $JustDate: $. Diese Schlüsselwörter sind nur für die Verwendung in HTML-Dateien vorgesehen und sollten nicht in Dateien ohne HTML-Code verwendet werden. Weitere Informationen über die Erstellung einer HTML-Datei für die Schlüsselworterweiterung finden Sie unter Gewusst wie: Verwenden der Schlüsselworterweiterung in Text- oder HTML-Dateien.
Leerzeichen bei Schlüsselwörtern
In der Standardeinstellung ersetzt Visual SourceSafe das Leerzeichen zwischen einem Schlüsselwort und dem nachfolgenden Dollarzeichen mit dem von Ihnen angegebenen Wert. Dies erschwert allerdings das Erstellen einer ansprechenden spaltenförmigen Darstellung.
Sie können dieses Problem lösen, indem Sie nach dem Schlüsselwort zwei Doppelpunkte anstatt einem einfügen und dann die gewünschte Anzahl an darzustellenden Leerzeichen hinzufügen. Visual SourceSafe erkennt dadurch, dass sich das Dollarzeichen nach dem Schlüsselwort genau an der gewünschten Stelle befindet. Visual SourceSafe fügt Leerzeichen hinzu oder kürzt den Wert, um sicherzustellen, dass die Spalten erhalten bleiben. Nachfolgend ist ein Beispiel für ein Leerzeichen ausgleichendes Schlüsselwort angegeben:
$Revision:: $
Visual SourceSafe erweitert das Schlüsselwort mit der Versionsnummer der Datei und behält den zusätzlichen Leerraum bei, den Sie vor dem Dollarzeichen einfügen, sodass die Revisionsnummernspalte ihre Breite behält.
Hinweis
Das Leerzeichenfeature für Schlüsselwörter ist nützlich, um Schlüsselwortinformationen in Binärdateien einzubetten, in denen es auf die genaue Länge der Daten ankommt.
Verwendung der Expand_Keywords_Locally-Initialisierungsvariable
Visual SourceSafe verwendet die Expand_Keywords_Locally-Initialisierungsvariable, um die automatische Ersetzung von mit Schlüsselwörtern erweiterten Dateien in Ihrem Arbeitsordner zu steuern. Weitere Informationen finden Sie unter Initialisierungsvariable "Expand_Keywords_Locally".
Verwendung von Kommentarzeichen für Schlüsselwörter
Stellen Sie, wenn Sie mit Quellcode oder anderen kompatiblen Dateien arbeiten, sicher, dass Visual SourceSafe Versionsinformationen als Kommentare liest. Der Datenbankadministrator kann Kommentarzeichen definieren, die Visual SourceSafe vor und nach den Schlüsselwörtern History und Log einfügt. Weitere Informationen finden Sie unter Gewusst wie: Aktivieren der Schlüsselworterweiterung.
Visual SourceSafe verbindet jede Dateinamenerweiterung, die als Schlüsselworterweiterung definiert ist, mit einer Zeichenfolge und fügt diese vor jeder Zeile ein. Diese Verbindung kann optional mit einer Zeichenfolge nach jeder Zeile ergänzt werden. Beide Zeichenfolgen werden in Anführungszeichen und durch Kommata getrennt eingefügt. Wenn keine Schlüsselwortkommentare angegeben wurden, werden die folgenden Kommentare zugrunde gelegt:
*.asm = " | "
*.vb = "rem"
*.bat = "rem"
*.s = " | "
<Alle anderen> = "* "
Siehe auch
Aufgaben
Gewusst wie: Aktivieren der Schlüsselworterweiterung
Gewusst wie: Verwenden der Schlüsselworterweiterung in Text- oder HTML-Dateien