![]() |
Übersicht -> Einfürung in CVS unter Windows | |
Letztes Update: 18. Januar 2002
In diesem Dokument möchte ich den CVS-Zugriff unter Windows beschreiben. Falls Sie Schreibzugriff auf den Server haben möchten, müssen Sie erst einen SSH2-Tunnel aufbauen. Das wird in der SSH2-Anleitung ausführlich beschrieben.
Ich beschreibe die Schritte anhand der kostenlosen Software WinCVS, da es eine grafische Oberfläche besitzt, einfach zu bedienen ist und einen großen Funktionsumfang hat. Ich verwende die Version 1.2. Falls es eine neuere Version gibt und die Anleitung nicht mehr stimmt, teilen Sie mir das bitte per E-Mail mit. WinCVS können Sie hier herunterladen.
Jeder kann anonym auf den CVS-Server zugreifen. Damit können allerdings keine Dateien geändert werden. Falls Sie aktiv am Lang/De-Projekt mitarbeiten, sollten Sie in Betracht ziehen, den Schreibzugriff zu beantragen. Allerdings ist es auch nicht sinnvoll, wenn Sie nur sehr wenige Dokumente erstellen bzw. ändern möchten, da sowohl auf Ihrer Seite als auch auf dem Server einige Arbeit erforderlich ist.
Die notwendigen Vorbereitungen sind auf der Seite SSH2-Einführung beschrieben.
Der anonyme Zugriff ist relativ leicht möglich. Führen Sie die folgenden Schritte aus:
Um sich anmelden zu können, muss erst ein SSH2-Tunnel hergestellt werden. Nähere Informationen dazu finden Sie hier. Anschließend verfahren Sie wie folgt:
Der manuelle Login ist nicht bei jedem Start erforderlich. Sie können einfach das Arbeiten beginnen.
Nach jedem Start sollten Sie prüfen, ob die Dateien auf Ihrer Festplatte aktuell sind. Klicken Sie dazu mit der rechten Maustaste auf das oberste CVS-Verzeichnis ("oo" oder "de", je nachdem, ob Sie anonym oder per SSH2-Tunnel angemeldet sind) und klicken Sie im Kontextmenü auf Update selection.... Nun werden die Dateien auf ihre Aktualität geprüft und ggf. aktualisiert. Grüne oder blaue Dateien bedeuten, dass diese aktualisiert wurden. Falls nur orange Verzeichnisse angezeigt werden, war kein Update notwendig.
Bei einem Checkout wird ein bestimmtes Verzeichnis auf dem Server 1:1 auf die Festplatte übertragen. Dort können Sie die Dateien bearbeiten und die Änderungen wieder auf den Server übertragen. Falls Sie keinen Schreibzugriff haben, können Sie die Datei per Mail an jemanden senden, der die Datei auf dem Server aktualisieren kann.
Erstellen Sie auf Ihrer Festplatte einen Ordner, in den Sie die Dateien ablegen können. Nennen Sie ihn beispielsweise OpenOffice CVS.
Führen Sie die folgenden Schritte durch:
Führen Sie die folgenden Schritte durch:
Nachdem Sie den Checkout eingeleitet haben, wird im Statusbereich der Fortschritt angezeigt. Sie erhalten eine Ausgabe, die ähnlich wie folgende aussieht (bei anonymem Zugriff weicht natürlich der Modulname ab):
cvs checkout -P de/www (in directory C:\OpenOffice-CVS)
cvs server: Updating de/www
U de/www/README_de_DE.txt
U de/www/about-cdrom.html
[...]
U de/www/images/spacer.gif
*****CVS exited normally with code 0*****
Die letzte Zeile bedeutet, dass kein Fehler aufgetreten ist. Würde hier eine "1" stehen, wäre ein Fehler aufgetreten. Das gilt für alle in diesem Dokument beschriebenen Vorgänge, vom Login bis zum Erstellen eines Diffs.
Das geht am einfachsten, wenn Sie sich zuerst einen Graphen zeichnen lassen. Dazu wählen Sie bitte im Kontextmenü der entsprechenden Datei Graph selection aus und klicken im erscheinenden Dialog auf OK. Sie sehen nun eine Grafik, in der alle vorhandenen Versionen angezeigt werden. Sie können eine Version auswählen und im Menü auf Graph | Diff selected klicken, um die ausgwählte Version mit der neusten zu vergleichen.
Den Graph können Sie übrigens über Graph | Close wieder schließen.
Dazu klicken Sie in der Dateiansicht im Kontextmenü auf Diff selection. Im erscheinenden Dialog markieren Sie den Eintrag Compare two revisions/tags/branches/dates. In die zwei Eingabefelder darunter können Sie nun zwei Versionsnummern eintragen.
Rufen Sie den Dialog über den Eintrag Diff selection im Kontextmenü der zu vergleichenden Datei auf.
Selektieren Sie dazu die Option Compare your local file with the same remote revision.
Wählen Sie den Punkt Compare your local file with another revision/tag/branch/date aus.
Nachdem Sie eine der oben aufgeführten Methoden ausgewählt haben, bekommen Sie eine Ausgabe, die der folgenden ähnelt. Diese ist bei jeder gewählten Methode ähnlich.
cvs diff -r 1.8 team.html (in directory C:\OpenOffice-CVS\de\www\dev\)
Index: team.html
===================================================================
RCS file: /cvs/de/www/dev/team.html,v
retrieving revision 1.8
retrieving revision 1.10
diff -r1.8 -r1.10
27c27
< <td>lesend</td>
---
> <td>schreibend</td>
112c112,114
< <td>www/de</td>
---
> <td>www/de<br>
> <a href="ftp://sunsite.informatik.rwth-aachen.de/pub/packages/OpenOffice">ftp-server</a>
> </td>
119c121,122
< <td>www/de</td>
---
> <td>www/de<br>
> <a href="http://whiteboard.openoffice.org/marketing/">marketing</a></td>
Im Kopf steht der Name der Datei und die zwei verglichenen Versionen (hier 1.8 und 1.10). Darunter folgen alle Änderungen. Zuerst wird die Zeilenangabe in der Quell- (links von dem "c") und der Zieldatei (rechts vom "c") angezeigt und darunter der Bereich in der Quelldatei (in rot) und in der Zieldatei (in blau).
Diese so genannten "diffs" kann man dazu verwenden, um eine Datei, die man übersetzt hat, zu aktualisieren. Es müssen ja nur die Bereiche aktualisiert werden, die auch im Original verändert wurden. Um Zugriff auf die Originaldateien zu bekommen, müssen Sie ein Checkout des entsprechenden Originalverzeichnisses machen. Die Verzeichnisse befinden sich alle unter /oo/www/www/<xxx>, wobei <xxx> für den Verzeichnisnamen steht, der auch auf der Website verwendet wird. Zum besseren Verständnis ein Beispiel: die Seite http://www.openoffice.org/bugs/issues.html finden Sie in dem Verzeichnis /oo/www/www/bugs.
Ich habe das Programm WinMerge verwendet, das direkt mit WinCVS zusammenarbeitet. Sie können es hier herunterladen. Dort ist auch eine DLL erhältlich, die die Benutzeroberfläche ins Deutsche ändert. Sie richten WinMerge wie folgt ein:
In Zukunft startet automatisch WinMerge, wenn Sie ein Diff anfertigen. Dort sehen Sie die Änderungen durch farbliche Hervorhebung in der kompletten Datei und erhalten nicht nur die Auszüge.
Kopieren Sie die Datei, die auf den Server soll, in das passende Verzeichnis des CVS-Verzeichnisbaums auf Ihrer Festplatte, der beim Checkout angelegt wurde. Wählen Sie die Datei aus und klicken Sie im Menü auf Modify | Add selection. Die Datei wird zum Übertragen auf den Server markiert und erst bei einem "Commit" der Datei tatsächlich übertragen.
Sie haben eine Datei geändert und möchten die Änderungen an den Server übertragen? Kein Problem, wählen Sie in der Dateiliste die geänderte Datei aus (die übrigens ein rotes Icon hat) und klicken Sie im Kontextmenü auf Commit selection. Dort können Sie einen kurzen Kommentar eingeben. Es empfiehlt sich mit ein paar Wörtern die Änderungen zu beschreiben. Sobald Sie auf OK klicken werden die Änderungen übertragen.