Diese Dokumentation wurde zur Beschreibung der Serie 1.7.x von Apache™ Subversion® erstellt. Falls Sie eine unterschiedliche Version von Subversion einsetzen, sei Ihnen dringend angeraten, bei http://www.svnbook.com/ vorbeizuschauen und stattdessen die zu Ihrer Version von Subversion passende Version dieser Dokumentation heranzzuiehen.

Kapitel 2. Grundlegende Benutzung

Inhaltsverzeichnis

Hilfe!
Wie Sie Daten in Ihr Projektarchiv bekommen
Importieren von Dateien und Verzeichnissen
Empfohlene Aufteilung des Projektarchivs
Was steckt in einem Namen?
Erstellen einer Arbeitskopie
Der grundlegende Arbeitszyklus
Aktualisieren Sie Ihre Arbeitskopie
Nehmen Sie Ihre Änderungen vor
Überprüfen Sie Ihre Änderungen
Verschaffen Sie sich einen Überblick über Ihre Änderungen
Untersuchen Sie die Details Ihrer lokalen Änderungen
Beheben Sie Ihre Fehler
Lösen Sie etwaige Konflikte auf
Interaktive Begutachtung der Konflikte
Interaktive Konfliktauflösung
Aufschieben der Konfliktauflösung
Manuelle Konfliktauflösung
Verwerfen Ihrer Änderungen zugunsten einer aktualisierten Revision aus dem Projektarchiv
Die Verwendung von svn revert
Übergeben Ihrer Änderungen
Geschichtsforschung
Detaillierte Untersuchung der Änderungsgeschichte
Untersuchen lokaler Änderungen
Vergleichen der Arbeitskopie mit dem Projektarchiv
Vergleichen von Projektarchiv-Revisionen
Erzeugung einer Liste der Änderungsgeschichte
Stöbern im Projektarchiv
Anzeige von Dateiinhalten
Anzeigen der zeilenweisen Zuordnung von Änderungen
Auflistung versionierter Verzeichnisse
Bereitstellung älterer Projektarchiv-Schnappschüsse
Manchmal müssen Sie einfach nur aufräumen
Entsorgen einer Arbeitskopie
Wiederherstellung nach einer Unterbrechung
Umgang mit Strukturkonflikten
Ein Beispiel für einen Baumkonflikt
Zusammenfassung

Theorie ist nützlich, doch deren Anwendung ist der pure Spaß. Lassen Sie uns nun zu den Details von Subversion kommen. Wenn Sie das Ende dieses Kapitels erreicht haben, werden Sie in der Lage sein, alle Aufgaben zu erledigen, die sich bei der normalen täglichen Arbeit mit Subversion stellen. Sie werden damit beginnen, Ihre Dateien in Subversion einzupflegen, gefolgt von einem initialen Checkout Ihres Codes. Dann werden wir bei unserem Rundgang zeigen, wie Änderungen gemacht und diese Änderungen untersucht werden. Sie werden auch sehen, wie Sie die Änderungen anderer in Ihre Arbeitskopie bringen, untersuchen, und sich durch eventuell auftretende Konflikte arbeiten können.

Dieses Kapitel ist nicht als erschöpfende Liste aller Befehle von Subversion gedacht ist – es ist eher eine Einführung in die gebräuchlichsten Aufgaben von Subversion, denen Sie begegnen werden. Dieses Kapitel setzt voraus, dass Sie Kapitel 1, Grundlegende Konzepte gelesen und verstanden haben und dass Sie mit dem allgemeinen Subversion-Modell vertraut sind. Für eine vollständige Referenz aller Befehle, siehe Kapitel 9, Die vollständige Subversion Referenz.

Dieses Kapitel geht weiter davon aus, dass der Leser Informationen sucht, wie er auf grundlegende Art mit einem bestehenden Subversion-Projektarchiv interagieren kann. Kein Projektarchiv bedeutet, keine Arbeitskopie; keine Arbeitskopie bedeutet, nicht viel Interesse an diesem Kapitel. Es gibt viele Orte im Internet, die freie oder preiswerte Bewirtungsdienste für Subversion-Projektarchive anbieten. Oder, falls Sie es bevorzugen sollten, Ihre eigenen Projektarchive einzurichten und zu verwalten, schauen Sie sich Kapitel 5, Verwaltung des Projektarchivs an. Erwarten Sie aber nicht, dass die Beispiele in diesem Kapitel funktionieren, ohne dass der Anwender Zugriff auf ein Subversion-Projektarchiv hat.

Zum Schluss sei noch gesagt, dass jede Subversion-Operation, die über ein Netzwerk mit dem Projektarchiv Kontakt aufnimmt, möglicherweise erfordert, dass sich der Anwender authentifiziert. Der Einfachheit halber vermeiden unsere Beispiele über das gesamte Kapitel hinweg die Darstellung und Erörterung der Authentifizierung. Beachten Sie, dass sie wahrscheinlich dazu gezwungen werden, dem Server zumindest einen Anwendernamen und ein Passwort anzugeben, falls Sie das hier erlangte Wissen auf einer echten Subversion-Instanz anwenden möchten. Für eine detaillierte Beschreibung, wie Subversion Authentifizierung und Client-Berechtigungsnachweise behandelt, siehe „Client-Zugangsdaten“