Das Concurrent Versions System

Transkript

1 Das Concurrent Versions System Prof.Dr. Ing.Walter Roth

2 Inhaltsverzeichnis 1 Ein Überblick über CVS Was ist CVS? Wie bekommt man CVS? Wo ist die Dokumentation zu CVS? Wie arbeitet man mit CVS? Kurzführung durch CVS: Einrichten des CVS Servers Erzeugen eines neuen Archivs Gruppe cvs erzeugen Verzeichnis für das Archiv erzeugen Archiv initialisieren Archivieren eines bereits vorhandenen Software-Projekts Einloggen auf einen entfernten CVS Server Zugriff auf einen nicht abgesicherten CVS-Server Zugriff auf einen abgesicherten CVS-Server Erstmaliges Abholen einer Arbeitskopie Speichern von Änderungen Aktualisieren einer Arbeitskopie Abholen von Archivkopien mit Datumsangabe MS Windows und CVS Verfügbare Software Installation Die unterschiedlichen Zeilenenden Umgang mit binären Dateien Erste Einstellungen für WinCVS Das erste Login Der erste Import eines Windows Projekts in das Archiv Die erste Arbeitskopie Einbuchen von Änderungen

3 1 Ein Überblick über CVS 1.1 Was ist CVS? CVS ist eine Software zur Verwaltung von Programmier-Projekten an denen viele Entwickler gleichzeitig arbeiten. CVS verwaltet ein Archiv, in das alle Entwickler ihre Änderungen und Erweiterungen einbuchen und aus dem jeder Entwickler die neuesten (und alle älteren) Versionen des Projekts laden kann. CVS ist das Wundermittel gegen plötzlich nicht mehr funktionierende Programme, mehrfache Bearbeitung des gleichen Problems durch unterschiedliche Entwickler, Inkonsistenz von Versionen und ähnlichen Dingen, die einem Entwicklungsteam das Leben schwer machen. 1.2 Wie bekommt man CVS? CVS ist Open Source und frei verfügbar. Der CVS Server sollte aus Sicherheitsgründen auf einem Linux oder Unix System installiert werden, auf dem sonst keine Netzwerkdienste laufen. Die Clients können unter Windows, Linux, anderen Unix Systemen oder MacOs laufen. Der Download der executables oder Sources kann von oder ftp.cvshome.org erfolgen. CVS ist in allen modernen Linux Distributionen enthalten. 1.3 Wo ist die Dokumentation zu CVS? Die Dokumentation wurde ursprünglich von Per Cederqvist geschrieben. Deshalb findet man sie häufig unter cederqvist. Unter Linux gibt es die info Seite CVS. Diese rufen Sie mit info: cvs auf. Unter Windows wird mit dem Paket WinCVS eine Hilfedatei installiert. Leider sind alle diese Dokumentationen mehr zum Nachschlagen gedacht und nicht unbedingt für den Anfänger geeignet. Deshalb habe ich diesen Text für Einsteiger geschrieben. Wenn man aber intensiv mit CVS arbeiten will, kommt man nicht umhin ziemlich viel zu lesen und selber auch auszuprobieren. Ein dazu geeignetes gutes Buch in einer sehr guten deutschen Übersetzung ist: Carl Fogel, Moshe Bar Open Source Projekte mit CVS erschienen bei MITP Wie arbeitet man mit CVS? Unter Linux am besten auf der Konsole, unter Windows gibt es auch einen GUI Client namens WinCVS. 2 Kurzführung durch CVS: Lesen Sie den folgenden Text zunächst vollständig durch, bevor Sie beginnen. 2.1 Einrichten des CVS Servers Die folgenden Ausführungen beziehen sich auf SuSe Linux 9.0. Installieren Sie das Paket cvs mit YAST. Die Standardkonfiguration benutzt das Verzeichnis /home/cvsroot für die Projektverwaltung. Diese Wahl des Verzeichnisses ist recht sinnvoll. Sie sollten davon nur dann abweichen, wenn Sie wirklich wichtige Gründe haben, zum Beispiel wenn Sie das CVS Archiv auf 3

4 einer vollständig getrennten Platte oder Partition anlegen möchten. Als nächstes müssen Sie den (x)inetd so konfigurieren, dass er den cvs Server startet, wenn eine Anfrage auf Port 2401 ankommt. Der xinitd Daemon (= speicherresidentes Programm) ist ein Programm, dass den Netzwerkverkehr überwacht und die ankommenden Anfragen (requests) an die in der Datei /etc/services angegebenen Programme (Dienste) weiterleitet. In der Standardeinstellung sind alle Dienste des xinetd deaktiviert. Wählen Sie dazu in der Startseite von YAST die Gruppe Netzwerkdienste aus. Ziemlich weit unten auf der Gruppenseite finden Sie den inetd (Symol: Verkehrsampel). Klicken Sie auf das Symbol. Es öffnet sich eine Liste mit den vorkonfigurierten Diensten. Wählen Sie aktivieren. Wählen Sie die Zeile mit cvspserver aus. Klicken Sie auf den Knopf Status wechseln unten rechts auf der Seite. Ändern Sie keine anderen Einstellungen, wenn Sie nicht genau wissen, was Sie tun. Die drei Minuszeichen --- links von cvspserver werden durch An ersetzt. Klicken Sie beenden. Alternativ können Sie die Konfigurationsdatei /etc/xinetd.conf bzw. die Datei cvs im Verzeichnis / etc/xinetd.d von Hand bearbeiten. Sie finden die Dokumentation dazu in den man-pages zu xinetd und xinetd.conf. Prüfen Sie jetzt zunächst die Funktion des cvs Servers. Stellen Sie dazu von einem anderen Computer eine Verbindung mit Telnet an Port 2401 her (z.b. telnet mein_computer 2401). Geben Sie irgendeinen sinnlosen Text ein (z.b. foo), und schließen Sie die Eingabe mit Return ab. Der Server muß jetzt mit einer Fehlermeldung antworten: cvs [pserver aborted]: bad auth protocol start: foo Falls das nicht funktioniert, prüfen Sie die Netzwerkverbindung mit ping. Prüfen Sie, ob der xinetd aktiv ist (z.b. kpm starten, in der Liste nach xinetd suchen). Auf der Linux Maschine können sie auch das Programm Etherreal (starten als root) zum Debuggen des Netzwerks verwenden. Dazu sollten Sie allerdings mit IP und TCP einigermaßen vertraut sein. 2.2 Erzeugen eines neuen Archivs Gruppe cvs erzeugen Falls es die (Benutzer-) Gruppe cvs noch nicht gibt, erzeugen Sie die Gruppe und fügen alle Benutzer hinzu, die mit cvs arbeiten sollen. Benutzen Sie dazu die Gruppenverwaltung von YAST. Wählen Sie auf der Startseite von YAST Sicherheit und Benutzer und dann Gruppen bearbeiten und anlegen. In der Verwaltungsseite wählen Sie oben rechts Gruppen und mit dem Knopf Filter festlegen unten links wählen Sie Systemgruppen. Es erscheint jetzt eine lange Liste. Wählen Sie jetzt Hinzufügen. Tragen Sie als Namen der Gruppe cvs und als Gruppen-id (gid) 500 ein. Wählen Sie aus der Liste der Benutzer alle Benutzer aus, die Zugriff auf das Archiv haben sollen und klicken Sie auf Weiter Verzeichnis für das Archiv erzeugen Erstellen Sie das Verzeichnis /home/cvsroot, auf das die Gruppe cvs Schreibzugriff hat. Starten Sie dazu den Konqueror (als root) indem Sie mit rechts auf den Bildschirmhintergrund klicken, im lokalen Menü Befehl ausführen wählen und dann kdesu konqueror eingeben. Wechseln Sie nach /home. Wählen Sie jetzt Bearbeiten/Neues Verzeichnis oder drücken Sie F10. Geben Sie als Namen für das Verzeichnis cvsroot ein und drücken Sie OK. Klicken Sie dann mit rechts auf das neue Verzeichnis und wählen Sie Eigenschaften aus dem lokalen Menü. Wählen Sie die Seite Berechtigungen. Dort muss als Benutzer und als Gruppe root eingetragen sein. Ändern Sie den Eintrag für die Gruppe auf cvs. Klicken Sie in der zweiten Zeile (Gruppe) der Berechtigungsliste auf das mittlere Kästchen (Einträge schreiben) und schalten Sie es damit ein. Schalten Sie aus Sicherheitsgründen in der letzten Zeile (Sonstige) alle Kästchen 4

5 aus. Klicken Sie OK. Jetzt haben alle Mitglieder der cvs Gruppe (und außerdem nur noch root) Schreibzugriff auf das Verzeichnis. 2.3 Archiv initialisieren Erzeugen Sie die Verzeichnisstruktur und die Hilfsdateien für Ihr neues Archiv mit: cvs -d absoluter_pfad_auf_das_cvs_archiv init Wenn Sie /home/cvsroot verwenden lautet das Kommando: cvs -d /home/cvsroot init 2.4 Archivieren eines bereits vorhandenen Software-Projekts Es empfiehlt sich, ein neues Projekt zunächst ohne cvs mit Hilfe einer IDE zu erzeugen. Der von der IDE erzeugte Rahmencode kann dann als Grundlage für das neue Projekt nach cvs importiert werden. Das erspart eine Menge Arbeit, die sonst für das Hinzufügen von neuen Dateien erforderlich wird. Wechslen Sie in das Hauptverzeichnis Ihres neuen Projekts (zb. cd /myproject). Sie können Ihr Projekt jetzt mit cvs -d absoluter_pfad_auf_das_cvs_archiv import \ -m Kommentar myproject start in das cvs Archiv übernehmen. Bequemer geht das, wenn Sie eine Umgebungsvariable CVSROOT exportieren, damit Sie nicht jedesmal den Pfad angeben müssen. CVSROOT=absoluter_Pfad_auf_das_cvs_Archiv export CVSROOT Das init Kommando wird danach kürzer: cvs import -m Kommentar myproject initial_import version0 Ihr Projekt ist danach unter dem Namen myproject als Version im Archiv gespeichert. Der Kommentar und der String start werden bei Versionsabfragen angezeigt. 2.5 Einloggen auf einen entfernten CVS Server Wenn Sie auf einem entfernten Rechner arbeiten wollen, müssen Sie sich zuerst einloggen. Grundsätzlich unterscheiden sich die CVS-Server in der Art der Zugriffsverwaltung. Für niedrige Sicherheitsansprüche kann man die pserver Zugriffskontrolle verwenden. Hier werden die Passwörter und die Daten als Klartext über das Netz übertragen. Diese Methode sollte man deshalb nur verwenden, wenn der Server nicht aus dem Internet errreicht werden kann. Die Zulassung der Benutzer kann auch unabhängig von den Benutzerkonten auf dem Server alleine durch das CVS- System erfolgen. Bei Servern, die im Internet erreichbar sind, ist grundsätzlich der abgesicherte Zugriff über ssh vorzusehen. Hier werden sowohl die Passwörter als auch die Daten ausschließlich verschlüsselt übertragen. Die zugelassenen Benutzer müssen in diesem Falle auf dem Server ein gültiges Benutzerkonto haben Zugriff auf einen nicht abgesicherten CVS-Server Für den (unsicheren) Zugriff über pserver initialisieren Sie die Umgebungs-Variable CVSROOT folgendermaßen: export CVSROOT=:pserver:Username@ServerName_Oder_ServerIP:/ absoluter_pfad_auf_das_cvs_archiv 5

6 Die drei : (Doppelpunkte) müssen unbedingt vorhanden sein. Außerdem dürfen keine Leerzeichen rechts oder links des = Zeichens vorhanden sein. Bitte alles in eine Zeile schreiben. Der Zeilenumbruch in diesem Text ist wegen der Seitenbreite eingefügt worden. Username ist der Benutzername, der auf dem Server bekannt ist. Der Benutzer muß Schreibberechtigung für das Archiv haben. Am einfachsten erreicht man das, wenn der Benutzer zu der Gruppe cvs hinzugefügt wird (siehe oben). Auf den Benutzernamen folgt und dann der Name des Servers. Statt des Servernamens kann man auch die IP Adresse des Severs angeben. Danach folgt der dritte : (Doppelpunkt) und der vollständige absolute Pfad auf das CVS-Archiv also zum Beispiel: /home/cvsroot. Sicherheitshalber sollten Sie jetzt prüfen, ob sich der Server meldet. Dazu verwenden Sie am besten das Programm ping. ping -c3 ServerName_Oder_ServerIP Wenn das geklappt hat, melden Sie sich mit cvs login bei dem Server an. Sie werden jetzt nach Ihrem Passwort gefragt. Geben Sie das Benutzerpasswort ein, das für den Benutzer auf dem Server gilt. ACHTUNG: Das Passwort wird im Klartext über das Netzwerk übertragen! Diese Art des Login ist also nur für lokale Netzwerke geeignet. Für ein Login über das Internet sollten Sie ssh verwenden Zugriff auf einen abgesicherten CVS-Server Bei einem über das Internet erreichbaren Server mit ssh (Secure Shell) Zugriff sind zwei Kommandos erforderlich: export CVSROOT=:ext:Username@ServerName_Oder_ServerIP:/ absoluter_pfad_auf_das_cvs_archiv export CVS_RSH=ssh Zusätzlich zu CVSROOT muss hier noch mit CVS_RSH die Zugriffsmethode ssh eingestellt werden. Das vollständige Kommando für den Studentenserver der FH Südwestfalen lautet zum Beispiel: export CVSROOT=:ext:Username@stud-in.fh-swf.de:/CVS export CVS_RSH=ssh 2.6 Erstmaliges Abholen einer Arbeitskopie Zuerst sollten Sie Ihre bereits existierende Verion sichern. Dazu benennen Sie Ihr Verzeichnis myproject einfach in myproject_old um. Außerdem sollte man unbedingt eine Kopie auf CD oder ein anderes unabhängiges Medium ziehen. Wechseln Sie jetzt in das Verzeichnis, in dem Sie das Projektverzeichnis Ihres Projekts erzeugen möchten (z.b. programming). Sie erhalten eine Arbeitskopie mit dem folgenden Kommando: cvs checkout myproject Es wird ein Verzeichnis myproject mit allen Unterverzeichnissen erstellt. Zusätzlich zu den Dateien und Verzeichnissen, die Sie importiert haben, enhält jetzt jedes Unterverzeichnis ein Verzeichnis mit Namen CVS mit Informationen zum Archiv. Im neu erstellten Verzeichnis myproject können Sie jetzt arbeiten. 2.7 Speichern von Änderungen Immer wenn Sie einen Arbeitsabschnitt abgeschlossen haben, also zum Beispiel abends, wenn Sie die Arbeit an einer funktionierenden Version beenden wollen, sollten Sie Ihre Änderungen in das 6

7 Archiv speichern lassen. Damit erzeugen Sie einen Projektstand, der jederzeit wieder hergestellt werden kann. Bevor Sie eine neue Version speichern lassen, sollten Sie sich zunächst den aktuellen Projektstand anzeigen lassen. So können Sie feststellen, ob Konflikte mit der Arbeit der anderen Entwickler aufgetreten sind. Dazu kann man das Kommando diff benutzen. Es werden die Unterschiede zwischen den eigenen und den Dateien im Archiv angezeigt. cvs diff -c erzeugt eine Ausgabe der unterschiedlichen Zeilen einschließlich etwas Kontext (-c Option). Wenn Sie auf diesem Wege festgestellt haben, dass andere Entwickler bereits Änderungen in das System eingebucht haben, sollten Sie diese Änderungen in Ihre eigene Arbeitskopie übernehmen, bevor Sie Ihre eigenen Änderungen ins Archiv einbuchen. Dazu verwenden Sie das Kommando: cvs update Sollten Sie allerdings mit den Änderungen nicht einverstanden sein, so müssen (sollten) Sie zunächst mit dem Entwickler Kontakt aufnehmen, der die Änderungen erzeugt hat, und sich auf einen gemeinsamen Text einigen. Lassen Sie Ihr Projekt nach dem update noch einmal kompilieren, damit sicher ist, dass auch wirklich alles in Ordnung ist. Wenn alles zur Zufreidenheit funktioniert, buchen Sie Ihre Änderungen mit: cvs commit -m Mein Kommentar zur aktuellen Änderung in das Archiv ein. 2.8 Aktualisieren einer Arbeitskopie Bevor Sie Ihre Arbeitskopie auf den neuesten Stand bringen lassen, sollten Sie sich zunächst den aktuellen Projektstand anzeigen lassen. So können Sie feststellen, ob Konflikte mit der Arbeit der anderen Entwickler aufgetreten sind. Dazu kann man das Kommando diff benutzen. Es werden die Unterschiede zwischen den eigenen und den Dateien im Archiv angezeigt. cvs diff -c Wenn CVS Konflikte erkennt, werden diese deutlich angezeigt. In diesem Falle sollten Sie zu dem Entwickler Kontakt aufnehmen, der die entsprechenden Änderungen erzeugt hat und sich auf eine gemeinsame Version einigen. Wenn alles in Ordnung ist, übernehemen Sie die Änderungen aus dem Archiv mit cvs update Damit wird Ihre Arbeitskopie auf den Stand des Archivs gebracht. 2.9 Abholen von Archivkopien mit Datumsangabe Häufig möchte man einen alten Zustand des Projekts wieder herstellen. Das kann zum Beispiel nützlich sein, um ein Programmgerüst für ein neues Projekt wieder zu verwenden, oder um nachzusehen, wann eine bestimmte Änderung durchgeführt wurde. Normalerweise möchte man aber nicht seine aktuelle Arbeitskopie ändern.deshalb empfiehlt es sichhier, einen neuen Checkout durchzuführen. Das Kommando: cvs checkout -D DATUM MeinProjekt Beispiel: cvs checkout -D 01-Dec-2006 MeinProjekt holt den Stand des Projekts MeinProjekt zu dem angegebenen Datum ab. DATUM muss in folgendem Format angegeben werden: TT-MMM-YYYY zum Beispiel : 22-Nov-2006 Die Monate werden als Abkürzungen der englischen Monatsnamen mit drei Buchstaben angegeben. Die -D Option steht auch für das Update Kommando zur Verfügung. Damit kann man zum Beispiel den Stand einer einzelnen Datei zum angegebenen Datum ahbholen. 7

8 3 MS Windows und CVS 3.1 Verfügbare Software Unter Windows gibt es ein Programmpaket mit Namen WinCVS, dass den CVS Client enthält und zusätzlich eine grafische Oberfläche (GUI) zur Bedienung zur Verfügung stellt. Der CVS Server dagegen muss auf einem Unix Rechner laufen. Sie können unter Windows aber auch genauso wie unter Linux von der Kommandozeile aus arbeiten, wenn WinCVS installiert ist. WinCVS stellt Ihnen dazu sogar eine recht komfortable eigene Kommandozeile zur Verfügung. Dies empfiehlt sich insbesondere dann, wenn man sich sicher sein will, dass genau das Kommando, das man selbst eingegeben hat, an CVS weitergegeben wird. Insbesondere bei der Anmeldung entwickelt die GUI Oberfläche nämlich eine beträchtliche Eigeninitiative und stellt ziemlich überraschende Kommandos zusammen. Allerdings werden alle Kommandos und Rückmeldungen in dem Konsolenfenster unterhalb des GUI Haupfensters angezeigt, sodass man hier relativ leicht debuggen kann. Außerdem unterstützt die GUI nicht alle Kommandos, die in CVS möglich sind. 3.2 Installation Laden Sie von der Website das fertige binäre Paket für Windows (ab Win98 / Win2000) herunter. Das Paket ist im zip Format gepackt und kann nach dem Entpacken installiert werden, indem Sie setup.exe starten. Vorsichtshalber sollten Sie aber vorher noch einen Virenscan durchführen. Die Installation lief bei mir auf einem Windows ME System problemlos ab. Es werden eine Programmgruppe, das cvs Programm, einige dll's und Hilfsprogramme sowie Hilfedateien installiert. 3.3 Die unterschiedlichen Zeilenenden Textdateien unter Windows und unter Unix unterscheiden sich durch die Zeilenenden. Unter Windows wird als Endezeichen 0x0D 0x0A angehängt, unter Unix nur 0x0D. Dies führt bei einfachen Editoren, wie zum Beispiel Notepad zu Problemen. Deshalb konvertiert CVS automatisch die Zeilenenden in das auf dem Zielsystem verwendete Format, wenn es Dateien aus dem Archiv abholt oder in das Archiv einbucht. Dieses Verhalten führt bei binären Dateien zu Problemen, da die entsprechenden Zeichen zufällig in den Dateien auftauchen und die Dateien durch die Änderungen verfälscht werden. 3.4 Umgang mit binären Dateien Binäre Dateien müssen als solche gekennzeichnet werden. Dann kann CVS sie problemlos verwalten. Allerdings ist eine Anzeige von Unterschieden zwischen den Versionen einer Datei nicht möglich. Es wird immer nur die gesamte Datei ausgetauscht. Um Dateien als binär zu kennzeichnen, gibt es zwei Möglichkeiten. Soll eine Gruppe von Dateien anhand der Endung als binär erkannt werden, so sollte man einen entsprechenden Eintrag in die Datei CVSROOT/cvswrappers hineinschreiben. Die folgenden Einträge markieren.gif,.res und. bmp Dateien als binär: *.gif -k 'b' *.bmp -k 'b' *.res -k 'b' Dies empfiehlt sich, wenn man zum Beispiel mit Borland Delphi oder Borland C++ Builder arbeitet. Die zweite Methode kennzeichnet eine einzige Datei als binär und kann auch noch im Nachhinein auf bereits bestehende Archive angewendet werden. Benutzen Sie dazu die admin Funktion von CVS. 8

9 cvs admin -kb mypicture.ico cvs commit mypicture.ico Damit ändern Sie zunächst den Status der schon im Archiv vorhandenen (und wahrscheinlich durch die Konversion der Zeilenenden beschädigten) mypicture.ico Datei auf binär. Mit dem zweiten Kommando kopieren Sie die noch in Ihrer Arbeitskopie vorhandene (und hoffentlich intakte) Datei myproject.dfm in das Archiv. Diesmal wird CVS die Datei nicht verfälschen, da es ja nun weiß, das es sich um eine binäre Datei handelt. 3.5 Erste Einstellungen für WinCVS Starten Sie WinCVS. Wählen Sie im Menü Admin/Preferences. Es öffnet sich ein mehrseitiger Dialog. Auf der Seite General müssen Sie unbedingt die Einträge für CVSROOT und Authentication ausfüllen. CVSROOT müssen Sie dabei folgendermaßen angeben: also zum Beispiel so: Als Authentication Methode wählen Sie passwd file on the server aus. Diese Einstellung ist nur für lokale Netzwerke geeignet, das Passwort wird im Klartext über das Netz übertragen. Falls Sie über das Internet arbeiten wollen, sollten Sie unbedingt SSH verwenden. Leider funktioniert das laut Bugliste nicht richtig unter Windows ;-(, aber dafür kann man ja auch Linux verwenden. Achten Sie darauf, das der verwendete User Name so geschrieben ist, wie er auf dem Server bekannt ist. Die Einstellungen auf den anderen Seiten des Dialogs können Sie so lassen, wie sie sind. 3.6 Das erste Login Prüfen Sie zunächst, ob die Netzwerkverbindung zum Server funktioniert und der CVS- Server antwortet. Starten Sie dazu eine DOS-Konsole und geben Sie ping Severname also zum Beispiel ping amd800 ein. Es kann einige 10 Sekunden dauern, bis der Server antwortet. Auf jeden Fall sollten spätestens nach einer Minute die Antworten erscheinen. Funktioniert dies nicht, müssen Sie zunächst das Netzwerk in Ordnung bringen. Es muss auf jeden Fall TCP/IP installiert sein und einwandfrei arbeiten. Wenn ping funktioniert hat, sprechen Sie den CVS Server auf Port 2401 an. Dazu benutzt man am einfachsten das Programm telnet. Schreiben Sie auf der DOS Konsole das Kommando: telnet Servername 2401 Es öffnet sich ein Telnet-Fenster. Dort geben Sie unsinnigen Text, zum Beispiel. foo ein. Wundern Sie sich nicht, wenn Sie keine Buchstaben sehen, drücken Sie einfach die Eingabetaste. Der Server muss jetzt antworten. cvs [pserver aborted]: bad auth protocol start: foo Wenn das nicht funktioniert, sehen Sie unter Einrichten des CVS Servers in diesem Text nach. Wenn alles in Ordnung ist, können Sie WinCVS starten. Wählen Sie im Menü Admin/Login aus. Im folgenden Passwort-Dialog geben Sie Ihr Passwort für den Server ein. Achtung:das Passwort wird im Klartext über das Netz übertragen. Im Konsolenfenster unten im WinCVS Hauptfenster erscheint: cvs login (Logging in to Nach einiger Zeit erscheint dann hoffentlich: cvs exited normally (return code 0) Wenn ein von Null verschiedener return code angezeigt wird, ist das Login fehlgeschlagen. Außer einem falsch geschriebenen Passwort kann es auch daran liegen, dass Sie auf dem Server nicht als 9

10 User bekannt sind. Sorgen sie in diesem Falle dafür, dass ein entsprechender Account für Sie eingerichtet wird. 3.7 Der erste Import eines Windows Projekts in das Archiv Sie sollten dazu ein bereits funktionierendes Projekt verwenden. Starten Sie WinCVS. Wechseln Sie mit dem Verzeichnisbaum an der linken Seite in das oberste Projektverzeichnis. Wählen Sie im Menü Create / Import Module aus. Den nächsten Dialog können Sie einfach mit OK bestätigen. Es öffnet sich dann eine Liste mit Dateitypen. Achten sie darauf, dass Sie hier alle Binärdateien, die Sie in das Archiv übernehmen wollen, als binär markieren. Sie sollten für.exe,.dsm..dsk,.dof und ähnliche Dateitypen den Status auf IGNORE ändern, damit diese von der IDE erzeugten Zwischendateien nicht in das Archiv übernommen werden. Wenn Sie jetzt bestätigen, wird das Projekt in das Archiv kopiert. Achten Sie darauf, dass als return code 0 angezeigt wird. Falls nicht, hatten Sie vermutlich keine Schreibberechtigung auf dem Server. Kontrollieren Sie, falls möglich, ob das neue Archiv als Unterverzeichnis unter CVSROOT auf dem Server angelegt wurde. 3.8 Die erste Arbeitskopie Damit Ihr ursprüngliches Projekt nicht überschrieben wird, ändern Sie vorsichtshalber den Verzeichnisnamen auf zum Beispiel myproject_old. Wählen Sie jetzt im Hauptmenü von WinCVS Create / Checkout Module. Im folgenden Dialog geben Sie den Namen des Projekts und das Zielverzeichnis an und bestätigen mit OK. Es wird eine Arbeitskopie vom Server geholt. Die Liste der kopierten Dateien wird angezeigt. Alle Dateien in dieser Arbeitskopie sind zunächst schreibgeschützt. Achten Sie darauf, dass alle binären Dateien als binär gekennzeichnet sind. Sie können Jetzt die Dateien, die Sie bearbeiten wollen, mit Trace / Edit Selection zum Schreiben freigeben. Öffnen Sie jetzt das Projekt mit Ihrer IDE und bearbeiten Sie die Dateien. Nach dem ersten Kompilieren hat die IDE eine Menge neue Dateien erzeugt. Kontrollieren Sie, ob WinCVS alle diese Dateien (.obj,.dcu usw.) als non cvs file kennzeichnet. 3.9 Einbuchen von Änderungen Wenn Sie mit Ihrer Arbeit an den Dateien fertig sind, lassen Sie sich die Änderungen gegenüber dem Archiv am besten mit diff anzeigen. Dazu markieren Sie die entsprechende Datei im Hauptfenster von WinCVS und wählen aus dem Hauptmenü Query / Diff Selection. Die Änderungen werden im unteren Fenster angezeigt. Wenn alles in Ordnung ist, können Sie Ihre Änderungen mit Query / Commit Selection in das Archiv einbuchen. Die entsprechenden Dateien in Ihrer lokalen Kopie werden von WinCVS automatisch wieder gegen Editieren gesperrt. 10