Einführung zu Subversion und kdesvnDieser Abschnitt ist hauptsächlich für Personen gedacht, die sich mit Subversion nicht auskennen und erklärt, wie Subversion bzw. Versionsverwaltungssysteme (RCS) funktionieren.
Achtung
Arbeitskopien müssen als lokale Pfade erreichbar sein. Subversion kennt keine Pseudo-Dateisysteme wie smb:// oder fish://. kdesvn übersetzt einige von ihnen, wenn möglich, wie zum Beispiel system:/home, aber das funktioniert nicht über ein Netzwerk.
Als erstes müssen Sie eine Arbeitskopie Ihres Repositorys erstellen. Dazu wählen Sie → → . Im folgenden Dialog müssen Sie eine URL des Repositorys z. B. http://localhost/repos/myproject eingeben. Auch Unterordner eines Repositorys z. B. http://localhost/repos/myproject/trunk sind möglich.
Wählen oder erstellen Sie einen lokalen Ordner, in dem die Arbeitskopie gespeichert wird.
Dann müssen Sie noch die Revision zum Auslesen wählen. Meistens wird das „HEAD“ sein. Damit haben Sie die neueste Version referenziert.
Nachdem Sie auf geklickt haben, erstellt kdesvn Ihre neue Arbeitskopie und wird sie öffnen, wenn diese Einstellung aktiviert ist.
Wenn Sie ein Repository zum Durchsehen geöffnet haben, können Sie einen Ordner markieren, dann → → wählen und den Dialog wie oben beschrieben ausfüllen. Dann wird nur der markierte Pfad ausgelesen.
Markieren Sie den oder die Einträge, die Sie einspielen möchten und wählen Sie im Menü → → (Strg+#)
Haben Sie bei dieser Aktion keinen Eintrag ausgewählt, verwendet kdesvn das oberste Element der geöffneten Arbeitskopie, d. h. den Pfad zur Arbeitskopie selbst.
Dieser Vorgang ist immer rekursiv, d. h. wenn ein Ordner ausgewählt ist, werden immer alle darunterliegenden geänderten Einträge gesendet. Haben Sie eingestellt, dass vor dem Einspielen alle Einträge überprüft werden sollen, werden im folgenden Dialog alle zu sendenden Einträge aufgelistet. Dann können Sie die Markierung für Einträge entfernen, die nicht gesendet werden sollen. In diesem Fall werden alle Einträge einzeln und nicht rekursiv gesendet. Sie können auch nicht versionierte Einträge zum Hinzufügen und Einspielen auswählen, wenn Sie nicht als ignoriert markiert sind. So können Sie erkennen, ob es neuere Einträge gibt, die Sie vergessen haben.
Geben Sie einen Kommentar über die eingespielten Änderungen, drücken Sie auf und die Übertragung beginnt.
Dies gleicht Ihre lokale Arbeitskopie mit dem Repository ab. Sie können kdesvn so einstellen, dass beim Öffnen einer Arbeitskopie die Überprüfung auf neuere bzw. geänderte Einträge durchgeführt wird. Dies geschieht im Hintergrund und Sie können in der Zwischenzeit mit kdesvn bereits arbeiten. Wenn die Überprüfung abgeschlossen ist, werden alle Einträge mit neueren Versionen und alle Ordner, die neuere Einträge enthalten, markiert.
Um die Änderungen zu holen, wählen Sie → → . Damit wird Ihre Arbeitskopie auf die neueste Version im Repository aktualisiert. Möchten Sie eine bestimmte Revision holen, wählen Sie → → und geben im folgenden Dialog die gewünschte Revision an.
Ist kein Eintrag ausgewählt, wird die gesamte geöffnete Arbeitskopie aktualisiert, ansonsten nur rekursiv vom ausgewählten Eintrag aus.
Für beide Operationen sind zwei Schritte erforderlich: Zuerst hinzufügen oder löschen und dann die Änderungen ins Repository einspielen. Vor dem Einspielen können Sie das Hinzufügen oder Löschen zurücknehmen.
Es gibt drei verschiedene Möglichkeiten, um Einträge in eine Arbeitskopie einzufügen.
- Wählen Sie nicht versionierte Einträge und fügen Sie sie hinzu
Kopieren Sie die Einträge mit Konqueror oder einer anderen Dateiverwaltung in den Bereich der Arbeitskopie. Gehen Sie die Liste durch und markieren die Einträge. Wählen Sie dann → → (Einfg). Möchten sie Ordner mit allen Untereinträgen hinzufügen, wählen Sie → → (Strg+Einfg) aus.
- Suchen und rekursiv hinzufügen
Sie können überprüfen, ob es in der Arbeitskopie irgendwo nicht versionierte Einträge gibt. Nach der Auswahl von → → wird ein Dialog geöffnet, in dem alle nicht versionierten Einträge aufgelistet sind. Drücken Sie auf , dann werden alle markierten Einträge zur Arbeitskopie hinzugefügt. Bei Einträgen, die nicht aufgenommen werden sollen, müssen Sie vorher die Markierung entfernen.
- Ziehen und Ablegen
Markieren Sie in Konqueror oder anderen kompatiblen Dateiverwaltungen Einträge, die Sie hinzufügen möchten und ziehen Sie sie in kdesvn. Sie können diese Einträge auf Ordner innerhalb geöffneter Arbeitskopien ablegen, dann kopiert kdesvn die abgelegten Einträge dahin und fügt die Einträge hinzu.
Das Löschen von Einträgen funktioniert immer rekursiv. Wenn Sie zum Beispiel einen Ordner löschen, werden auch alle Einträge in diesem Ordner mit gelöscht. Markieren Sie Ihre Wünsche und wählen Sie den Menüeintrag → → . Dann werden die Einträge aus der Version genommen und von der Festplatte gelöscht.
Die Anzeige des Protokolls kann mit Strg+L gestartet werden, wenn nur ein oder kein Eintrag in der Übersicht markiert ist. Abhängig von Ihren Einstellungen (siehe Tabelle 5.1, „Subversion“), wird kdesvn die Protokolleinträge beginnend mit „HEAD“ holen und sie anzeigen.
Auf der linken Seite sehen Sie die Liste mit den von kdesvn abgeholten Protokoll-Einträgen. Die Protokoll-Meldungen sind gekürzt, so dass sie in eine Zeile passen. Die vollständige Meldung erscheint im oberen rechten Fenster, wenn ein Eintrag markiert ist. Im rechten unteren Fenster sehen Sie eine Liste der geänderten Dateien. Diese Fenster erschien nur, wenn die Liste abhängig von Ihren Einstellungen geholt wird.
Mit den Knöpfen oben können Sie einen anderen Bereich des Protokolls zur Anzeige auswählen.
Wichtig
Dieser Bereich wird ohne voreingestellte Begrenzung benutzt, daher sollten Sie bei großen Repositorys damit vorsichtig sein.
Die unten angezeigten Knöpfe funktionieren nur für ausgewählte Einträge im Protokoll, nicht für Einträge, die in der Liste der geänderten Dateien markiert sind. Wenn Sie wird der Unterschied für alle geänderten Einträge in dieser Revision angezeigt, wenn sie gleich oder unterhalb des Subversions-Eintrags liegen, der vorher für das Abholen des Protokolle ausgewählt wurde. Das gleiche gilt für die Funktion .
funktionieren natürlich nur, wenn es sich um eine Datei handelt.
Für alle Listeneinträge in beiden Listen gibt es ein Kontextmenü mit einigen zusätzlichen Aktionen. In der linken Liste ist dies , d. h. als Start-Revision und , d. h. als End-Revision oder Ziel für Diff, das ist im „Unified Diff“ der mit +++ markierte Teil. Wenn Sie Revisionen für diese beiden Aktionen auswählen, werden Sie mit kleinen Pfeilen markiert.