SWT Vorlesung SS97 - CVS Informationen

	Vorlesung Softwaretechnologie SS97 Univ.-Prof. Dr. Armin B. Cremers Günter Kniesel, Jens Wolff

CVS Informationen

1. CVS Quick Hack	Das Notwendigste zum sofortigen Staren.
2. CVS Überblick	Ein kurzer Überblick über die wichtigsten CVS Kommandos.
3. CVS Manpages	Manpages zu CVS im HTTP Format. (Auf UNIX-Ebene geht natürlich auch man cvs)
4. Troubleshooting	Bekannte Probleme und ihre Lösungen.

Überblick

Es wird im folgenden ein kurzer Überblick über die wichtigesten CVS Kommandos gegeben.
Wesentlich ausführlicher sind natürlich die Manpages.

Aufbau des CVS Repository

Setzen der Umgebungsvariabel

Die Versionsverwaltung findet im CVS in einem Verzeichnis statt, welches durch die Umgebungsvariable CVSROOT spezifiziert wird. Es muß also ein Verzeichnis angelegt werden, welches als CVSROOT zur Verügung stehen soll.
Man kann sich diese Umgebungsvariable danach auch direkt in seine .cshrc schreiben.

Anlegen eines Repositories

Es müssen die "System-Dateien" von CVS angelegt werden. Diese dienen der Verwaltung der Versionsänderungen. Ebenso wird ein Verzeichnis mit dem Namen CVSROOT angelegt:

Importieren von Verzeichnisbäumen

Als nächstes müssen die vorhandenen Dateien in das Repository importiert werden. Dafür muß man in dem Verzeichnis sein, in dem sich die original Daten befinden.
Z.B.:

cvs import -m 'Erstellung des Repositories' loesung start start

(Falls noch keine Dateien existieren, sollte man zumindest eine Dummy-Datei erzeugen, z.B. mit "touch dummy")

Syntax:

Usage: cvs import [-d] [-k subst] [-I ign] [-m msg] [-b branch]
                  [-W spec] repository vendor-tag release-tags...
        -d      Use the file's modification time as the time of import.
        -k sub  Set default RCS keyword substitution mode.
        -I ign  More files to ignore (! to reset).
        -b bra  Vendor branch id.
        -m msg  Log message.
        -W spec Wrappers specification line.

Erstellen einer Arbeitsumgebung

Eine Arbeitsumgebung (Sandbox) ist ein Verzeichnis, in der Benutzer nur an einer lokalen Kopie des Repositories arbeitet. Da jeder Benutzer eine eigene lokale Kopie verwaltet, ist es möglich, daß ein ganzes Team an den Daten im Repository arbeiten kann.
Es wird ein Verzeichnis angelegt, das den gleichen Namen wie das Repository hat und alle Daten des Repository werden in das lokale Verzeichnis kopiert:

mkdir $HOME/SWT_Loesungen

          cd $HOME/SWT_Loesungen

          cvs checkout loesung

Syntax:

cvs checkout [-ANPcflnps] [-r rev | -D date] [-d dir] [-k kopt] modules...
        -A      Reset any sticky tags/date/kopts.
        -N      Don't shorten module paths if -d specified.
        -P      Prune empty directories.
        -c      "cat" the module database.
        -f      Force a head revision match if tag/date not found.
        -l      Local directory only, not recursive
        -n      Do not run module program (if any).
        -p      Check out files to standard output (avoids stickiness).
        -s      Like -c, but include module status.
        -r rev  Check out revision or tag. (implies -P) (is sticky)
        -D date Check out revisions as of date. (implies -P) (is sticky)
        -d dir  Check out into dir instead of module name.
        -k kopt Use RCS kopt -k option on checkout.
        -j rev  Merge in changes made between current revision and rev.

Aktualisieren der Arbeitsumgebung

Bevor man anfängt auf seiner lokalen Kopie zu arbeiten, sollte man immer die aktuellste Version des Repositories haben.

cd $HOME/SWT_Loesungen/loesung

          cvs update

Syntax:

Usage: cvs update [-APdflRp] [-k kopt] [-r rev|-D date] [-j rev]
                  [-I ign] [-W spec] [files...]
        -A      Reset any sticky tags/date/kopts.
        -P      Prune empty directories.
        -d      Build directories, like checkout does.
        -f      Force a head revision match if tag/date not found.
        -l      Local directory only, no recursion.
        -R      Process directories recursively.
        -p      Send updates to standard output (avoids stickiness).
        -k kopt Use RCS kopt -k option on checkout.
        -r rev  Update using specified revision/tag (is sticky).
        -D date Set date to update from (is sticky).
        -j rev  Merge in changes made between current revision and rev.
        -I ign  More files to ignore (! to reset).
        -W spec Wrappers specification line.

Aktualisieren des Repositories

Die Änderungen, die man in der lokalen Kopie gemacht hat, müssen natürlich auch den anderen Benutzern zur Verfügung gestellt werden.

cvs commit loesung1.java

(schreibt die Änderungen in der Datei loesung1.java ins Repository)

Syntax:

Usage: cvs commit [-nRlf] [-m msg | -F logfile] [-r rev] files...
        -n      Do not run the module program (if any).
        -R      Process directories recursively.
        -l      Local directory only (not recursive).
        -f      Force the file to be committed; disables recursion.
        -F file Read the log message from file.
        -m msg  Log message.
        -r rev  Commit to this branch or trunk revision.

Hinzufügen neuer Dateien

Neu hinzugefügte Dateien und Verzeichnisse müssen im Repository angemeldet werden.

mkdir New

          cvs add New

Danach darf man nicht vergessen diese mit commit auch richtig ins Repository zu kopieren.

Quick Hack

Zum sofortigen Starten ist hier nur das notwendigste zusammengefaßt, um ein CVS Repository anzulegen.

cd $HOME
mkdir CVS
setenv CVSROOT $HOME/CVS
cvs init
mkdir SWT_Loesungen
cd SWT_Loesungen
touch dummy
cvs import -m 'Erstellung des Repositories' loesung start start
cvs checkout loesung

Nachtrag

Ich hoffe diese Seite hat bei der Bewältigung der Aufgaben geholfen. Falls jemand irgendwelche Anmerkungen zu dieser Seite, zu den Aufgaben, zu dem Übungsbetrieb oder zu sonst irgendwas anzubringen sind, kann mir gerne eine Mail schicken.

[Uni-Bonn] [Informatik] [III] [Softwaretechnologie] [Übungen]

This page was last modified at 28.04.1997 by Werner Halft
The URL of this page is http://www.informatik.uni-bonn.de/III/lehre/vorlesungen/SWT/SS97/HTML/CVS.html