TGI-Veranstaltungen WWW

Kontakt | Index | Suche | Rundgang | English

Diese Seite enthält eine kurze Anleitung zu CVS und einige Hinweise, wie CVS im Projektseminar Anatomie einer Open Source IDE eingesetzt wird.

[Projekthauptseite] [Allgemeines zu CVS] [Projektspezifisches zu CVS] [Weiterführende Informationen zu CVS]

Kurzanleitung zu CVS

CVS is a software control system that:

has all the features of RCS;
understands directory trees;
supports multiple users working on the same source;
has a nice emacs interface.

Central repository:

all files stored centrally;
everybody can check out copies;
check out multiple versions to different places;
check out/in from remote machines transparently.

Importing software:

external softare, e.g., CLIPS;
existing internal packages, e.g., COMET;

Importing a directory tree:

exclude files with regular expressions;
CVS takes over RCS/SCCS version info automatically;
entire package tagged for retrieval by name.

Most common commands

cvs checkout modules
Get files from the repository.
cvs update
Like checkout, but updates existing files with changes made by other developers.
cvs release
Delete checked out files that have been committed.
cvs commit file...
Force the effects of the following commands to change the repository. This makes things visible to other developers.
cvs add file...
Register a new file.
cvs remove file...
Register the removal of a file (you remove it yourself, first.)
cvs tag

When a module reaches a stable state:

cvs tag release-0-1
cvs checkout -r release-0-1

Useful emacs bindings:

Prefix is `C-x v'
`C-x v i' runs the command vc-register:
Register the visited file for version control.
`C-x v v' runs the command vc-next-action:
Check the visited file in or out, whichever is appropriate.
`C-x v u' runs the command vc-revert-buffer:
Revert the buffer and the file to the last checked in version.
`C-x v c' runs the command vc-cancel-version:
Remove the last-entered change from the master for the visited file. This undoes your last check-in.

When adding a new file:

cvs add file;
or Emacs vc-register (C-x v i);

Working with other people:

cvs watch --> email notification

[Projekthauptseite] [Allgemeines zu CVS] [Projektspezifisches zu CVS] [Weiterführende Informationen zu CVS]

Arbeiten im Projekt

Umgebung Initialisieren

Zu allererst muß die Environment-Variable CVSROOT auf das CVS-Repository-Verzeichnis gesetzt werden, für das Projekt geschieht dies durch
setenv CVSROOT /local/rzcspc1/cvs

Die Umgebungsvariablen sollten in dem initialen shell-script eingetragen werden (Z.B. in der Datei.cshrc).

Nun sollte ein lokales Verzeichnis angelegt werden, in dem die aktuellen Versionen der Dateien angelegt werden, z.B.
mkdir ~/java

Zum Definieren eines CVS-Editors existieren folgende Umgebungsvariablen, die z.B. im shell-script eingetragen werden können.
setenv CVSEDITOR /opt/bin/emacs
setenv EDITOR /opt/bin/emacs

Anlegen lokaler Kopien eines CVS-Repository: Checkout

Ein Checkout überschreibt die lokalen Dateien mit denen aus dem Repository. Da nach der Erzeugung eines loakeln Verzeihnisses keine Datein erzeugen, kopieren wir diese mit


cd ~/java 

cvs checkout de

WICHTIG: Beim "checkout" muß immer dasselbe lokale Verzeichnis das aktuelle Verzeichnis sein!

Also nicht aus Versehen in einem Unterverzeichnis checkout machen!

WICHTIG: Lokale Dateien werden beim checkout gnadenlos überschrieben! Deswegen vor jedem checkout alle lokalen Änderungen ins Repository stellen!

Dateien dem Repository hinzufügen

Wenn eine neue Datei, z.B. die Datei NewFoo.java im Verzeichnis ~/java/test1/, dem Repository hinzugefügt werden soll, so wechselt man mit
cd ~/java/test1
dorthin und ruft folgenden Befehl auf:
cvs add NewFoo.java
Nachdem man evtl. noch weitere Dateien hinzugefügt hat wird der aktuellen Zustand des Repository abschließend bestätigt:
cvs commit

Lokal vorgenommene Änderungen ins Repository stellen

Hat man lokal Änderungen an Dateien, die im Repository registriert sind, vorgenommen, sollten diese in regelmäßigen Abständen ins Repository zurückgeschrieben werden, damit die Änderungen für andere sichtbar werden. Liegt z.B. die Datei Foo.java im Verzeichnis ~/java/test1/ so wechselt man mit
cd ~/java/test1
dorthin und führt dort ein checkin durch:
cvs commit Foo.java
CVS startet einen Editor (default: vi), in dem man einen Kommentar zur Änderung eingeben kann. Wer sich das ersparen will, tippt z.B.
cvs commit -m "Dies und das hinzugefuegt." Foo.java

[Projekthauptseite] [Allgemeines zu CVS] [Projektspezifisches zu CVS] [Weiterführende Informationen zu CVS]

Weitere Informationen

Ausführliche Informationen zu CVS findet Ihr z.B. als Online Tutorial oder in der CVS-Hypertext-Hilfe
info -f cvs