Inhaltsverzeichnis
SubWCRev ist ein Windows Kommandozeilenprogramm, das dazu verwendet werden kann, den Status einer Subversion Arbeitskopie zu ermitteln und optional Schlüsselwörter in einer Vorlagendatei zu ersetzen. Dies wird häufig als Teil eines automatisierten Erstellungsprozesses verwendet, um Informationen über die Arbeitskopie in das erstellte Objekt einfließen zu lassen. Beispielsweise kann man damit die Revisionsnummer in einen „Über...“ Dialog einbetten.
SubWCRev liest den Subversion Status aller Dateien einer Arbeitskopie. Externals werden standardmäßig ausgeschlossen. Es ermittelt die höchste Revisionsnummer sowie deren Zeitstempel. Außerdem wird festgehalten, ob es lokale Änderungen in der Arbeitskopie sowie gemischte Revisionsnummern aus verschiedenen Aktualisierungen gibt. Die Revisionsnummer, der Revisionsbereich und der Änderungsstatus werden auf die Standardausgabe ausgegeben.
SubWCRev.exe wird per Kommandozeile oder Skript aufgerufen und besitzt folgende Parameter:
SubWCRev ArbeitsKopiePfad [QuellDatei ZielDatei] [-nmdfe]
ArbeitsKopiePfad ist der Pfad der zu prüfenden Arbeitskopie. Sie können SubWCRev nur auf Arbeitskopien und nicht direkt auf Projektarchive anwenden. Der Pfad kann absolut oder relativ zum aktuellen Arbeitsverzeichnis sein.
Wenn Sie möchten, dass SubWCRev Schlüsselwortersetzungen durchführt, so dass Felder wie Revisionsnummer und URL in einer Textdatei gespeichert werden, müssen Sie eine Schablone QuellDatei und eine Ausgabedatei ZielDatei angeben, die die ersetzte Version der Schablone enthält.
Es gibt mehrere Kommandozeilenoptionen, die die Arbeitsweise von SubWCRev beeinflussen. Wenn Sie mehr als einen verwenden, müssen die Optionen in einer einzelnen Gruppe angegeben werden, z.B. -nm, nicht -n -m.
Tabelle 6.1. Liste der Kommandozeilenoptionen
| Wechseln zu | Beschreibung |
|---|---|
| -n | Wenn dieser Schalter angegeben wurde, gibt SubWCRev ERRORLEVEL 7 zurück, falls die Arbeitskopie lokale Modifikationen enthält. Damit kann das Erzeugen mit nicht übertragenen Änderungen vermieden werden. |
| -m | Wenn dieser Schalter angegeben wurde, gibt SubWCRev ERRORLEVEL 8 zurück, falls die Arbeitskopie gemischte Revisionen enthält. Damit kann das Erzeugen mit einer nur teilweise aktuellen Arbeitskopie vermieden werden. |
| -d | Wenn dieser Schalter angegeben wurde, gibt SubWCRev ERRORLEVEL 9 zurück, falls die Zieldatei bereits existiert. |
| -f | Wenn dieser Schalter angegeben wurde, wird SubWCRev die „last-changed“ Revision von Ordnern beachten. Die Vorgabe ist, dass nur Dateien zum Ermitteln der Revisionsnummern herangezogen werden. |
| -e | Wenn dieser Schalter angegeben wurde, wird SubWCRev Verzeichnisse überprüfen, die mittels svn:externals eingebunden wurden, falls diese auf dasselbe Projektarchiv verweisen. Die Vorgabe ist, externe Verweise zu ignorieren. |
| -x | Wenn dieser Schalter angegeben wurde, gibt SubWCRev die Revisionsnummern in HEX aus. |
| -X | Wenn dieser Schalter angegeben wurde, gibt SubWCRev die Revisionsnummern in HEX mit vorangestelltem '0X' aus. |