How To: CVS unter Windows

Letztes Update: 29. Juli 2005

In diesem Dokument m?chte ich den CVS-Zugriff unter Windows beschreiben. 落ちるs 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.

Inhalt

Verwendete ソフトウェア
Lese- oder Schreibzugriff?
Anmeldung am CVS-Server: Bei anonymem Lesezugriff; Bei Schreibzugriff
Aktualisieren des CVS-Verzeichnisbaums auf der Festplatte
Durchf?hren eines Checkouts: Was ist ein Checkout?; Vorbereitung; Bei anonymem Zuriff; Bei Schreibzugriff; Der Statusbericht des Checkouts
?nderungen zwischen zwei Versionen einer Datei feststellen: Vergleich einer ?lteren mit der aktuellen 見解／翻訳／版 auf dem Server; Vergleichen 出身の zwei beliebigen Versionen; Vergleichen 出身の der 見解／翻訳／版 auf der Festplatte mit einer 見解／翻訳／版 auf dem Server; Ausgabe, die bei einem Diff erzeugt wird; Verwendung eines externen Diff-Programms
Neue Dateien auf den Server stellen
?nderungen an einer Datei an den Server ?bertragen

Verwendete ソフトウェア

Ich beschreibe die Schritte anhand der kostenlosen ソフトウェア WinCVS, da es eine grafische Oberfl?che besitzt, einfach zu bedienen ist und einen gro?en Funktionsumfang hat. Ich verwende die 見解／翻訳／版 1.02 bzw. 2.0. 落ちるs es eine neuere 見解／翻訳／版 gibt und die Anleitung nicht mehr stimmt, teilen Sie mir das bitte per E-Mail mit. WinCVS k?nnen Sie hier herunterladen.

Lese- oder Schreibzugriff?

Jeder kann anonym auf den CVS-Server zugreifen. Damit k?nnen allerdings keine Dateien ge?ndert werden. 落ちるs 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.

Anmeldung am CVS-Server

Bei anonymem Lesezugriff

Der anonyme Zugriff ist relativ leicht m?glich. F?hren Sie die folgenden Schritte aus:

落ちるs das Einstellungs-Fenster nach dem Start nicht automatisch angezeigt wird, ?ffnen Sie dieses ?ber den Men?eintrag Admin | Preferences... (in 見解／翻訳／版 2.0 finden Sie diese Konfiguration unter Admin | Login)
Stellen Sie den Server ein. Als CVSROOT geben Sie Folgendes ein: :pserver:anoncvs@anoncvs.services.openoffice.org:/cvs.
Bei Authentication stellen Sie "passwd" とじ込み／提出する on the CVS server (in 見解／翻訳／版 2.O nicht erforderlich).
Den 残り／休憩（する） k?nnen Sie bei den Standardeinstellungen belassen. Schlie?en Sie den Dialog mit einem Klick auf 承認する.
Sie k?nnen sich ?ber Admin | Login am Server anmelden. Sie k?nnen ein beliebiges Passwort eingeben.
落ちるs im Status-Fenster kein Fehler angezeigt wird (ein Fehler ist bei CVS "1"), sind Sie am Server angemeldet. Ansonsten ?berpr?fen Sie bitte nochmal Ihre Internetverbindung und die Einstellungen.

Bei Schreibzugriff

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:

落ちるs das Einstellungs-Fenster nach dem Start nicht automatisch angezeigt wird, ?ffnen Sie dieses ?ber den Men?eintrag Admin | Preferences...(in 見解／翻訳／版 2.0 finden Sie diese Konfiguration unter Admin | Login)
Stellen Sie den Server ein. Als CVSROOT geben Sie Folgendes ein: :pserver:<oousername>@localhost:/cvs. <oousername> ersetzen Sie durch den Namen Ihres OpenOffice-Zugangs.
Bei Authentication stellen Sie "passwd" とじ込み／提出する on the CVS server ein. (in 見解／翻訳／版 2.O nicht erforderlich)
Den 残り／休憩（する） k?nnen Sie bei den Standardeinstellungen belassen. Schlie?en Sie den Dialog mit einem Klick auf 承認する.
Sie k?nnen sich ?ber Admin | Login am Server anmelden. Als Passwort geben Sie Ihr OpenOffice-Passwort ein.
落ちるs im Status-Fenster kein Fehler angezeigt wird (ein Fehler ist bei CVS "1"), sind Sie am Server angemeldet sein. Ansonsten ?berpr?fen Sie bitte nochmal Ihre Internetverbindung und die Einstellungen.

Der manuelle Login ist nicht bei jedem Start erforderlich. Sie k?nnen einfach das Arbeiten beginnen.

Aktualisieren des CVS-Verzeichnisbaums auf der Festplatte

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 選択...(unter 見解／翻訳／版 2.0 Update). 修道女 werden die Dateien auf ihre Aktualit?t gepr?ft und ggf. aktualisiert. Gr?ne oder blaue Dateien bedeuten, dass diese aktualisiert wurden. 落ちるs nur orange Verzeichnisse angezeigt werden, war kein Update notwendig.

Durchf?hren eines Checkouts

Was ist ein Checkout?

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. 落ちるs Sie keinen Schreibzugriff haben, k?nnen Sie die Datei per Mail an jemanden senden, der die Datei auf dem Server aktualisieren kann.

Vorbereitung

Erstellen Sie auf Ihrer Festplatte einen Ordner, in den Sie die Dateien ablegen k?nnen. Nennen Sie ihn beispielsweise OpenOffice CVS.

Bei anonymem Zugriff

F?hren Sie die folgenden Schritte durch:

Klicken Sie auf den Men?eintrag Create | Checkout module...(unter 2.0 finden Sie diesen Punkt unter Remote | Checkout module)
Geben Sie als Modul de/www ein, um alle Web-Dokumente des de-Projekts zu bekommen.
Oder geben Sie als Modul de/documentation ein, um alle veröffentlichten Dokumentationen des de-Projekts zu bekommen.
Als Zielverzeichnis geben Sie das bei den Vorbereitungen angelegte Verzeichnis an.
Klicken Sie auf 承認する, um den Checkout vorzunehmen.
Lesen Sie unten weiter.

Bei Schreibzugriff

F?hren Sie die folgenden Schritte durch:

Klicken Sie auf den Men?eintrag Create | Checkout module...(unter 2.0 finden Sie diesen Punkt unter Remote | Checkout module)
Geben Sie als Modul de/www ein, um alle Dokumente des de-Projekts zu bekommen.
Oder geben Sie als Modul de/documentation ein, um alle veröffentlichten Dokumentationen des de-Projekts zu bekommen.
Als Zielverzeichnis geben Sie das bei den Vorbereitungen angelegte Verzeichnis an.
Klicken Sie auf 承認する, um den Checkout vorzunehmen.
Lesen Sie unten weiter.

Der Status des Checkouts

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 出口d 普通は 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.

?nderungen zwischen zwei Versionen einer Datei feststellen

Vergleich einer ?lteren mit der aktuellen 見解／翻訳／版 auf dem Server

Das geht am einfachsten, wenn Sie sich zuerst einen Graphen zeichnen lassen. Dazu w?hlen Sie bitte im Kontextmen? der entsprechenden Datei Graph 選択 (unter 見解／翻訳／版 2.0 "Graph") aus und klicken im erscheinenden Dialog auf 承認する. Sie sehen 修道女 eine Grafik, in der alle vorhandenen Versionen angezeigt werden. Sie k?nnen eine 見解／翻訳／版 ausw?hlen und im Men? auf Graph | Diff selected (unter 見解／翻訳／版 2.0 "Graph | Diff") klicken, um die ausgw?hlte 見解／翻訳／版 mit der neusten zu vergleichen.Klicken Sie im erscheinenden Dialog auf 承認する.

Den Graph k?nnen Sie ?brigens ?ber Graph | の近くに wieder schlie?en.

Vergleichen 出身の zwei beliebigen Versionen

Dazu klicken Sie in der Dateiansicht im Kontextmen? auf Diff 選択 (unter 見解／翻訳／版 2.0 Diff). Im erscheinenden Dialog markieren Sie den Eintrag Compare two 改正s/tags/支店s/dates (unter 見解／翻訳／版 2.0 entsprechender Eintrag in der Auswahlbox). In die zwei Eingabefelder darunter k?nnen Sie 修道女 zwei Versionsnummern eintragen.

Vergleichen 出身の der 見解／翻訳／版 auf der Festplatte mit einer 見解／翻訳／版 auf dem Server

Rufen Sie den Dialog ?ber den Eintrag Diff 選択 im Kontextmen? der zu vergleichenden Datei auf.

Vergleich mit der gleichen 見解／翻訳／版 auf dem Server

Selektieren Sie dazu die 選択 Compare your 地元のとじ込み／提出する with the same remote 改正.

Vergleich mit einer anderen 見解／翻訳／版

W?hlen Sie den Punkt Compare your 地元のとじ込み／提出する with another 改正/tag/支店/date aus. (unter 見解／翻訳／版 2.0 entsprechender Eintrag in der Auswahlbox)

Ausgabe, die bei einem Diff erzeugt wird

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\) 索引: team.html =================================================================== RCS とじ込み／提出する: /cvs/de/www/dev/team.html,v retrieving 改正 1.8 retrieving 改正 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/一括s/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 指名する der Datei und die zwei verglichenen Versionen (hier 1.8 und 1.10). Darunter folgen alle ?nderungen. Zuerst wird die Zeilenangabe in der 鎮圧する- (links 出身の 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 初めの 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 <事業／計画（する）>/www/<dir>, wobei <事業／計画（する）> f?r das SUb-Projekt und <dir> f?r den Verzeichnisnamen steht, der auch auf der Website verwendet wird.
Zum besseren Verst?ndnis ein Beispiel:
die Seite http://qa.openoffice.org/issue_handling/project_issues.html finden Sie in dem Verzeichnis qa/www/issue_handling.

Verwendung eines externen Diff-Programms

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:

Installieren Sie WinMerge.
Entpacken Sie die Sprach-DLL in das WinMerge-Verzeichnis.
Starten Sie WinMerge ?ber das Startmen?.
W?hlen Sie in dem Dialog 見解（をとる） | Language... die Sprache Deutsch (Deutschland).
Sie k?nnen WinMerge wieder schlie?en.
?ffnen Sie in WinCVS den Optionsdialog ?ber Admin | Preferences.
Wechseln Sie auf die Seite WinCvs.
Setzen Sie einen Haken vor 外部の diff program.
Klicken Sie auf ...
Wechseln Sie in das Verzeichnis, in das Sie WinMerge installiert haben und w?hlen Sie die winmerge.exe aus.
Schlie?en Sie den Dialog und die Optionen jeweils mit einem Klick auf 承認する.
Beim n?chsten Diff, das Sie anfertigen, w?hlen Sie im Diff-Dialog in der linken unteren Ecke Use the 外部の diff aus.

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.

Die folgenden Vorg?nge erfordern Schreibzugriff auf den Server.

Neue Dateien auf den Server stellen

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 修正する | 追加する選択 (Unter 見解／翻訳／版 2.0 修正する | 追加する). Die Datei wird zum ?bertragen auf den Server markiert und erst bei einem "Commit" der Datei tats?chlich ?bertragen.

?nderungen an einer Datei an den Server ?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 選択 (Unter 見解／翻訳／版 2.0 Commit). Dort k?nnen Sie einen kurzen Kommentar eingeben. Es empfiehlt sich mit ein paar W?rtern die ?nderungen zu beschreiben. Sobald Sie auf 承認する klicken werden die ?nderungen ?bertragen.