Diese Dokumentation wurde zur Beschreibung der Serie 1.6.x von Subversion erstellt. Falls Sie eine unterschiedliche Version von Subversion einsetzen, sei Ihnen dringend angeraten, bei http://www.svnbook.com/ vorbeizuschauen und stattdessen die zu Ihrer Version von Subversion passende Version dieser Dokumentation heranzzuiehen.

Name

svnversion — Die lokale(n) Revision(en) einer Arbeitskopie zusammenfassen.

Aufruf

svnversion [OPTIONS] [WC_PATH [TRAIL_URL]]

Beschreibung

svnversion ist ein Programm, um die Revisionsmischung einer Arbeitskopie zusammenzufassen. Als Ergebnis wird die Revisionsnummer oder ein Bereich von Revisionen in die Standardausgabe geschrieben.

Gewöhnlich wird diese Ausgabe in Ihrem Build-Prozess verwendet, um die Versionsnummer Ihres Programms zu definieren.

Falls angegeben, ist TRAIL_URL der hintere Teil des URL, der verwendet wird, um festzustellen, ob WC_PATH selbst umgestellt ist (die Erkennung von Umstellungen innerhalb von WC_PATH hängt nicht von TRAIL_URL ab).

Wenn WC_PATH nicht definiert ist, wird das aktuelle Verzeichnis als Arbeitskopiepfad herangezogen. TRAIL_URL kann nicht definiert werden, ohne dass WC_PATH explizit angegeben ist.

Optionen

Ebenso wie svnserve besitzt svnversion keine Unterbefehle – lediglich Optionen:

--no-newline (-n)

Der sonst übliche Zeilenvorschub in der Ausgabe wird weggelassen.

--committed (-c)

Verwendet die zuletzt geänderten Revisionen statt der aktuellen (d.h., der höchsten lokal verfügbaren) Revisionen.

--help (-h)

Gibt eine zusammenfassende Hilfe aus.

--version

Gibt die Version von svnversion aus und beendet sich ohne Fehler.

Beispiele

Falls die gesamter Arbeitskopie dieselbe Revision hat (etwa unmittelbar nach einer Aktualisierung), wird diese Revision ausgegeben:

$ svnversion
4168

Sie können TRAIL_URL hinzufügen, um sicherzustellen, dass die Arbeitskopie nicht wider Erwarten umgestellt wurde. Beachten Sie, dass WC_PATH für diesen Befehl erforderlich ist:

$ svnversion . /var/svn/trunk
4168

Für eine Arbeitskopie mit gemischten Revisionen wird der Bereich der vorhandenen Revisionen ausgegeben:

$ svnversion
4123:4168

Falls die Arbeitskopie Änderungen enthält, wird ein 'M' angefügt:

$ svnversion
4168M

Falls die Arbeitskopie umgestellt ist, wird ein 'S' angefügt:

$ svnversion
4168S

svnversion teilt Ihnen auch mit, falls es sich bei der Ziel-Arbeitskopie um einen Verzeichnis-Teilbaum handelt (siehe „Verzeichnis-Teilbäume“), indem der Code 'P' angehängt wird:

$ svnversion
4168P

Hier ist also eine Arbeitskopie als Verzeichnis-Teilbaum mit gemischten Revisionen, die umgestellt wurde und Änderungen enthält:

$ svnversion
4123:4168MSP

Falls es in einem Verzeichnis aufgerufen wird, das keine Arbeitskopie ist, nimmt svnversion an, es sei eine exportierte Arbeitskopie und gibt exported aus:

$ svnversion
exported