TortoiseSVN läuft unter Windows Vista oder höher und steht als 32- oder 64-Bit-Version zur Verfügung. Das Installationsprogramm für 64-Bit-Windows enthält auch die 32-Bit-Erweiterungen. Das bedeutet, dass Sie die 32-Bit-Version nicht zusätzlich installieren müssen, damit Ihnen in 32-Bit-Anwendungen die TortoiseSVN-Kontextmenüs und überlagerten Symbole zur Verfügung stehen.

Windows 98, Windows ME und Windows NT4 werden ab Version 1.2.0 nicht mehr unterstützt. Windows 2000 und XP bis SP2 werden ab Version 1.7.0 nicht mehr unterstützt. Windows XP mit SP3 wird ab Version 1.9.0 nicht mehr unterstützt.

TortoiseSVN wird als selbst installierende Anwendung ausgeliefert. Starten Sie die Installation durch einen Doppelklick auf die Datei und folgen Sie den Anweisungen. Das Installationsprogramm wird sich um alles weiter kümmern. Vergessen Sie nicht, nach der Installation Ihren Rechner neu zu starten.

Es stehen Sprachpakete zur Verfügung, die die Anwenderoberfläche von TortoiseSVN in viele verschiedene Sprachen übersetzen. Bitte lesen Sie in Anhang G, Sprachpakete und Rechtschreibprüfung nach, wie die Sprachpakete installiert werden.

Falls Sie während oder nach der Installation von TortoiseSVN auf Probleme stoßen, schauen Sie bitte in unserer Online-FAQ unter https://tortoisesvn.net/faq.html nach.

Für ein richtiges Projekt sollten Sie das Projektarchiv auf einem separaten Subversion-Server einrichten. Aus Gründen der Einfacheit werden wir für die Einführung ein lokales Projektarchiv verwenden, das sie direkt auf Ihrer Festplatte anlegen können, ohne dass Sie einen Server benötigen.

Zuerst legen Sie ein neues, leeres Verzeichnis auf ihrem Rechner an. Sie können es überall erstellen, aber in dieser Einleitung nennen wir es C:\svn_repos. Machen Sie einen Rechtsklick auf den neuen Ordner und wählen Sie TortoiseSVN → Projektarchiv hier erstellen aus dem Kontextmenü. Das Projektarchiv wird innerhalb des Ordners erstellt und steht fortan zur Verfügung. Legen Sie auch gleich die Standard-Ordnerstruktur für das Projektarchiv an, indem Sie auf Ordnerstruktur anlegen klicken.

Jetzt haben wir ein Projektarchiv, aber es ist noch vollkommen leer. Nehmen wir an, Sie haben eine Reihe von Dateien in C:\Projects\Widget1, die Sie hinzufügen möchten. Navigieren Sie zum Widget1-Ordner im Explorer und klicken Sie mit der rechten Maustaste darauf. Wählen Sie jetzt TortoiseSVN → Importieren..., worauf folgender Dialog erscheint:

Abbildung 1.2. Der Import-Dialog

Ein Subversion-Projektarchiv wird durch eine URL beschrieben, die es uns ermöglicht, Projektarchive überall im Internet zu referenzieren. In diesem Fall müssen wir auf unser eigenes lokales Projektarchiv verweisen, das die URL file:///c:/svn_repos/trunk hat und in das wir unser eigenes Projekt namens Widget1 einfügen. Beachten Sie die 3 Schrägstriche nach file: und dass durchgängig Vorwärts-Schrägstriche verwendet werden.

Die andere wichtige Funktion dieses Dialogfensters ist das Eingabefeld für die Import-Meldung. Darin geben Sie eine Meldung ein, die beschreibt, was Sie geändert haben. Wenn Sie dann später Ihre Projekthistorie durchsuchen, stellen diese Logmeldungen einen wertvollen Hinweis für Änderungen an Ihren Quellen dar. In diesem Fall können Sie einfach etwas eintragen wie „Importiert des Widget1-Projekts“. Klicken Sie auf OK, und der Ordner wird zum Projektarchiv hinzugefügt.

Nun, da wir ein Projekt in unserem Projektarchiv haben, müssen wir eine Arbeitskopie für die tägliche Arbeit erstellen. Beachten Sie, dass das Importieren eines Ordners diesen nicht automatisch in eine Arbeitskopie verwandelt. Der Subversion-Begriff für das Erstellen einer frischen Arbeitskopie lautet Auschecken. Wir werden jetzt den Ordner Widget1 unseres Projektarchivs in einen Entwicklungsordner auf dem PC, C:\Projects\Widget1-Dev genannt, auschecken. Erstellen Sie diesen Ordner, klicken dann mit der rechten Maustaste darauf und wählen Sie TortoiseSVN → Auschecken.... Geben Sie die auszucheckende URL, in diesem Fall file:///c:/svn_repos/trunk/Widget1 ein, und klicken Sie auf OK. Unser Entwicklungsordner wird dann mit Dateien aus dem Projektarchiv gefüllt.

Sie werden feststellen, dass sich die Darstellung dieses Ordners von der unseres ursprünglichen Ordners unterscheidet. Jede Datei hat ein grünes Häkchen in der linken unteren Ecke. Dies sind die TortoiseSVN-Statussymbole, die nur in einer Arbeitskopie vorhanden sind. Grün zeigt an, dass die Datei gegenüber der Version aus dem Projektarchiv nicht verändert wurde.

Zeit zu arbeiten. Im Ordner Widget1-Dev ändern wir jetzt Dateien - nehmen wir an, wir ändern Widget1.c und ReadMe.txt. Beachten Sie, dass sich die überlagerten Symbole dieser Dateien jetzt auf Rot geändert haben, was bedeutet, dass lokal Änderungen vorgenommen wurden.

Aber was sind die Änderungen? Klicken Sie mit der rechten Maustaste auf die geänderten Dateien und wählen Sie TortoiseSVN → Vergleich. Das Vergleichsprogramm von TortoiseSVN wird gestartet und zeigt genau an, welche Zeilen sich geändert haben.

Abbildung 1.3. Dateiunterschiede betrachten

OK, wir sind also mit den Änderungen zufrieden und werden nun das Projektarchiv aktualisieren. Diese Aktion wird als Übertragen der Änderungen bezeichnet. Klicken Sie mit der rechten Maustaste auf den Widget1-Dev-Ordner und wählen Sie TortoiseSVN → Übertragen. Der Übertragen-Dialog listet die geänderten Dateien auf, jeweils mit einem Kontrollkästchen. Möglicherweise möchten Sie nur eine Teilmenge der Dateien auswählen, aber in diesem Fall werden wir die Änderungen an beiden Dateien übernehmen. Geben Sie eine Meldung ein, die beschreibt, worum es bei der Änderung geht, und klicken auf OK. Im Fortschrittsdialog sehen Sie, wie die Dateien in das Projektarchiv hochgeladen werden, nun Sie sind fertig.

Während sich das Projekt weiter entwickelt, müssen Sie neue Dateien hinzufügen. Angenommen, Sie fügen einige neuen Funktionen in Extras.c hinzu und fügen einen Verweis im vorhandenen Makefile hinzu. Klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie TortoiseSVN → Hinzufügen.... Der Hinzufügen-Dialog zeigt Ihnen nun alle nicht versionierten Dateien, und Sie können diejenigen auswählen, die Sie hinzufügen möchten. Eine weitere Möglichkeit, Dateien hinzuzufügen, besteht darin, mit der rechten Maustaste auf die Datei selbst zu klicken und TortoiseSVN → Hinzufügen zu wählen.

Wenn Sie jetzt den Ordner übertragen, wird die neue Datei als hinzugefügt und die vorhandene Datei als verändert angezeigt. Beachten Sie, dass Sie auf die Dateien doppelklicken können, um die enthaltenen Änderungen zu überprüfen.

Eine der nützlichsten Funktionen von TortoiseSVN ist der Log-Dialog. Er listet Ihnen alle Übertragungen einer Datei oder eines Ordners auf und zeigt die detaillierten Logmeldungen an, die Sie eingegeben haben. Sie haben doch wie empfohlen eine Logmeldung eingegeben, oder? Wenn nicht, sehen Sie jetzt, warum das wichtig ist.

Abbildung 1.4. Der Log-Dialog

OK, ich habe ein wenig geschummelt und ein Beispiel aus dem Projektarchiv von TortoiseSVN verwendet.

Der obere Bereich zeigt eine Liste der Revisionen zusammen mit dem Anfang der Logmeldungen an. Wenn Sie eine dieser Revisionen auswählen, wird im mittleren Bereich die vollständige Logmeldung für die Revision dargestellt und im unteren Bereich eine Liste der geänderten Dateien und Ordner.

Jeder dieser Bereiche hat ein Kontextmenü, das Ihnen viel mehr Möglichkeiten bietet, diese Informationen zu nutzen. Im unteren Bereich können Sie auf eine Datei doppelklicken, um sich die Änderungen in dieser Revision anzeigen zu lassen. Lesen „Log-Dialog“ für die vollständige Darstellung.

Eine Funktion aller Versionskontrollsysteme ist, dass sich die Änderungen rückgängig machen lassen, die Sie zuvor ausgeführt haben. Wie zu erwarten, bietet TortoiseSVN hierzu einen leichten Zugang.

Wenn Sie Änderungen loswerden möchten, die Sie noch nicht übertragen haben und Ihre Datei in den Zustand vor Ihrer Bearbeitung zurückversetzen möchten, ist TortoiseSVN → Rückgängig... Ihr Freund. Diese Aktion verwirft Ihre Änderungen (in den Papierkorb, nur für alle Fälle) und kehrt zu der Version zurück, mit der Sie begonnen hatten. Wenn Sie nur einige der Änderungen loswerden möchten, können Sie TortoiseMerge nutzen, um die Unterschiede anzuzeigen und selektiv geänderte Zeilen wiederherzustellen.

Wenn Sie die Auswirkungen einer bestimmten Revision rückgängig machen möchten, beginnen Sie mit dem Log-Dialog und suchen Sie dort die problematische Revision auf. Wählen Sie Kontextmenü → Änderungen dieser Revision rückgängig machen und die betreffenden Änderungen werden rückgängig gemacht.

Stellen Sie sich folgende Szene vor: angenommen, wir haben zwei Mitarbeiter, Harry und Sally. Sie beide beschließen, dieselbe Datei gleichzeitig zu ändern. Wenn Harry seine Änderungen zuerst im Projektarchiv speichert, dann ist es möglich, dass Sally (ein paar Augenblicke später) ungewollt diese Änderungen durch ihre eigenen überschreibt. Obwohl die Änderungen von Harry nicht verloren sind (das Versionskontrollsystem speichert alle Änderungen), werden Harrys Änderungen in der aktuellsten Version von Sally nicht vorhanden sein, weil Sally diese Änderungen nie gesehen hat. Harrys Änderungen sind also trotzdem verloren - oder zumindest fehlen diese in der aktuellsten Version. Dies ist definitiv eine Situation, die wir verhindern wollen!

Abbildung 2.2. Das zu vermeidende Problem

Viele Versionskontrollsysteme nutzen ein Sperren-Ändern-Freigeben-Modell, was eine sehr einfache Lösung ist. In einem solchen System kann jeweils nur eine einzige Person eine Datei ändern. Zuerst muss Harry die Datei sperren, dann kann er mit dem Ändern beginnen. Sperren ist so ähnlich wie das Ausleihen eines Buchs aus der Bibliothek; wenn Harry die Datei gesperrt hat, dann kann Sally keine Änderungen an dieser Datei mehr vornehmen. Wenn sie es dennoch versucht, bekommt sie eine Fehlermeldung zu sehen. Alles, was sie tun kann, ist die Datei lesen und darauf zu warten, dass Harry die Datei wieder freigibt. Erst dann kann Sally die Datei sperren und ihre Änderungen vornehmen.

Abbildung 2.3. Die Sperren-Ändern-Freigeben-Lösung

Das Problem an der Sperren-Ändern-Freigeben-Lösung ist, dass diese zu restriktiv ist und oft zu einem Hindernis für die Benutzer wird:

Subversion, CVS und andere Versionskontrollsysteme nutzen ein Kopieren-Ändern-Zusammenführen-Modell als Alternative zur Sperrlösung. In diesem Modell hat jeder Benutzer eine persönliche Arbeitskopie des Projekts. Die Benutzer arbeiten dann parallel und ändern jeweils ihre persönliche Arbeitskopie. Schließlich werden diese privaten Arbeitskopien zu einer endgültigen Version zusammengeführt. Das Versionskontrollsystem hilft beim Zusammenführen, überlässt die endgültige Kontrolle aber dem Benutzer selbst.

Hier ein Beispiel. Angenommen, Harry und Sally haben jeder eine private Arbeitskopie von dem selben Projekt. Sie arbeiten parallel und ändern dieselbe Datei A in ihren Arbeitskopien. Sally speichert ihre Änderungen zuerst im Projektarchiv. Wenn Harry nun dasselbe versucht, bekommt er eine Meldung vom Projektarchiv, dass seine Datei nicht aktuell ist. In anderen Worten, die Datei A wurde irgendwie im Projektarchiv verändert, seit er sie das letzte Mal aktualisiert hat. Also aktualisiert Harry seine Arbeitskopie anhand des Projektarchivs und führt die Änderungen aus dem Projektarchiv mit seinen eigenen zusammen. Die Chancen stehen gut, dass die Änderungen von Sally mit seinen verträglich sind, und so kann Harry die aktualisierte Datei nun meist ohne weiteres im Projektarchiv speichern.

Abbildung 2.4. Die Kopieren-Ändern-Zusammenführen-Lösung

Abbildung 2.5. ...Kopieren-Ändern-Zusammenführen fortgesetzt

Aber was, wenn die Änderungen von Sally sich mit Harrys Änderungen tatsächlich überschneiden? Was dann? Diese Situation wird Konflikt genannt und ist üblicherweise kein großes Problem. Wenn Harry in diesem Falle seine Arbeitskopie aktualisiert und die Änderungen von Sally mit den seinen zusammenführt, wird seine Kopie der Datei A als „In Konflikt“ markiert; er kann dann beide Versionen der Datei ansehen und manuell zwischen den Änderungen von Sally oder seinen eigenen wählen. Beachten Sie, dass solche Konflikte nicht durch Software gelöst werden kann; nur Menschen sind in der Lage, die Änderungen auch zu verstehen und die notwendigen intelligenten Entscheidungen zu treffen. Erst wenn Harry von Hand den Konflikt aufgelöst hat (vielleicht durch ein Gespräch mit Sally!), kann er die aktualisierte Datei an das Projektarchiv zurück übertragen.

Das Kopieren-Ändern-Zusammenführen-Modell mag ein wenig chaotisch aussehen, aber in der Praxis bewährt es sich sehr gut. Benutzer können parallel arbeiten, müssen niemals aufeinander warten. Wenn sie an denselben Dateien arbeiten, stellt sich heraus, dass die meiste Zeit keine Konflikte auftreten. Und die Zeit, die benötigt wird, um einen der wirklich seltenen Konflikte zu lösen, ist viel kürzer als die Zeit, die man auf die Freigabe einer gesperrten Datei warten müsste.

Letztlich hängt alles von einem einzigen kritischen Faktor ab: der Kommunikation unter den Benutzern. Wenn die Benutzer nur schlecht miteinander kommunizieren, werden vermehrt Konflikte auftreten. Kein System kann Benutzer zur Kommunikation zwingen, und kein System kann logische Konflikte erkennen.

Es gibt eine Situation, in der das Sperren-Ändern-Freigeben-Modell Vorteile bietet. Das ist bei Dateien der Fall, die sich nicht automatisch zusammenführen lassen. Wenn Ihr Projektarchiv zum Beispiel Grafiken enthält und zwei Personen gleichzeitig dieselbe Grafik ändern, kann Subversion nicht entscheiden, wie die Änderungen zusammengeführt werden. Entweder Harry oder Sally wird seine Änderungen verlieren.

Subversion verwendet standardmäßig das Kopieren-Ändern-Zusammenführen-Modell, und in den meisten Fällen wird das alles sein, was Sie jemals benötigen werden. Mit der Einführung von Version 1.2 unterstützt Subversion auch das Sperren von Dateien, so dass Ihnen diese Möglichkeit ebenfalls zur Verfügung steht.

Sie haben bereits über Arbeitskopien gelesen; nun werden wir zeigen, wie Subversion diese erstellt und benutzt.

Eine Subversion-Arbeitskopie ist eine ganz normale Ordnerstruktur auf einem lokalen Dateisystem, die eine Anzahl von Dateien enthält. Sie können diese Dateien ändern wie Sie wollen, und falls es Quellcode-Dateien sind, können Sie diese kompilieren wie sonst auch. Ihre Arbeitskopie ist Ihr eigenes privates Arbeitsfeld: Subversion wird nie Änderungen von anderen einfügen oder Ihre Änderungen anderen zur Verfügung stellen, ohne dass Sie Subversion explizit dazu auffordern.

Nachdem Sie einige Änderungen an den Dateien in Ihrer Arbeitskopie vorgenommen haben und überprüft haben, dass diese immer noch korrekt funktionieren, stellt Ihnen Subversion Befehle zur Verfügung, um Ihre Änderungen zu publizieren (durch Speichern im zentralen Projektarchiv), d. h. anderen zur Verfügung zu stellen. Falls andere Benutzer ihre Änderungen veröffentlicht haben, stellt Subversion Befehle zur Verfügung, mit denen Sie diese Änderungen in Ihre Arbeitskopie einfügen können (durch Lesen aus dem zentralen Projektarchiv).

Eine Arbeitskopie enthält auch einige Extradateien, die Subversion erzeugt und verwaltet, um diese Kommandos auszuführen. Insbesondere enthält Ihre Arbeitskopie ein Unterverzeichnis namens .svn, das auch Verwaltungsordner der Arbeitskopie genannt wird. Die Dateien in diesem Verwaltungsordner benutzt Subversion, um zu erkennen, welche Dateien unveröffentlichte Änderungen enthalten und welche Dateien in Bezug zur Arbeit anderer Teammitglieder veraltet sind. Vor der Version 1.7 unterhielt Subversion einen .svn-Ordner in jedem versionierten Unterverzeichnis Ihrer Arbeitskopie. Subversion 1.7 wählt hier einen völlig anderen Ansatz: jede Arbeitskopie enthält von jetzt an nur noch einen Verwaltungsordner, der direkt im Wurzelverzeichnis dieser Arbeitskopie angesiedelt ist.

Ein typisches Subversion-Projektarchiv enthält oft Dateien (oder Quellcode) von mehreren Projekten; normalerweise ist jedes Projekt ein Unterordner im Dateibaum. In einem solchen Umfeld enthält eine Arbeitskopie normalerweise nur einen bestimmten Unterordner des Projektarchivs.

Als Beispiel nehmen Sie an, dass Sie ein Projektarchiv haben, das zwei Softwareprojekte enthält.

Abbildung 2.6. Das Dateisystem des Projektarchivs

Mit anderen Worten: das Hauptverzeichnis des Projektarchivs hat zwei Unterordner: paint und calc.

Um eine Arbeitskopie zu erhalten, müssen Sie einen dieser Unterordner aus dem Projektarchiv auschecken. Der Begriff auschecken klingt so, als würden dadurch Ressourcen gesperrt oder reserviert, aber dem ist nicht so. Es wird lediglich eine private Kopie des Projekts für Sie erzeugt.

Angenommen, Sie machen Änderungen an der Datei button.c. Da der .svn-Ordner den Originalinhalt und das Änderungsdatum gespeichert hat, kann Subversion feststellen, dass Sie diese Datei geändert haben. Jedoch wird Subversion diese Änderungen erst veröffentlichen, wenn Sie Subversion dazu ausdrücklich auffordern. Der Vorgang des Veröffentlichens ist allgemein mit dem Begriff Übertragen oder Einchecken (engl. to commit oder to check in) belegt.

Um Ihre Änderungen anderen zur Verfügung zu stellen, verwenden Sie den Befehl Übertragen.

Danach sind Ihre Änderungen an der Datei button.c im Projektarchiv gespeichert; falls jemand anders nun eine neue Arbeitskopie von /calc auscheckt, wird diese auch Ihre letzten Änderungen an der Datei button.c enthalten.

Nehmen Sie an, Sie haben eine Mitarbeiterin, Sally, die eine Arbeitskopie von /calc zur selben Zeit wie Sie ausgecheckt hat. Wenn Sie Ihre Änderungen übertragen, bleibt die Arbeitskopie von Sally unverändert. Subversion ändert nur dann etwas an einer Arbeitskopie, wenn Sie es ausdrücklich dazu auffordern.

Um ihre Arbeitskopie auf den neusten Stand zu bringen, sagt Sally Subversion, dass es ihre Arbeitskopie aktualisieren soll mittels des Aktualisieren-Befehls. Dies wird Ihre Änderungen in die Arbeitskopie von Sally übernehmen, genau wie alle weiteren Änderungen, die andere vorgenommen haben, seit Sally ihre Arbeitskopie zuletzt aktualisiert hat.

Beachten Sie, dass Sally nicht angeben muss, welche Dateien genau Subversion aktualisieren soll; Subversion nutzt die Informationen im .svn Ordner und weitere Informationen aus dem Projektarchiv, um dies selbst festzustellen.

Auf Subversion Projektarchive kann mittels vieler verschiedener Methoden zugegriffen werden - lokal oder durch verschiedene Netzwerk-Protokolle. Auf ein Objekt im Projektarchiv wird immer über eine URL zugegriffen. Das URL-Schema zeigt die Zugriffsmethode:

In den weitaus meisten Fällen nutzen Subversion-URLs die Standardsyntax und erlauben, dass Servernamen und Portnummern als Teil der URL angegeben werden. Beachten Sie jedoch, dass die Zugriffsmethode file:// normalerweise nur für den Zugriff auf lokale Projektarchive verwendet wird, obwohl auch mittels eines UNC-Pfades auf ein Projektarchiv im Netzwerk zugegriffen werden kann. In diesem Fall nimmt die URL die Form file://rechnername/pfad/zum/projektarchiv an. Bei einem lokalen Projektarchiv muss der Rechnername entweder leer oder localhost sein. Deshalb enthalten lokale Pfade meistens drei Schrägstriche, file:///pfad/zum/projektarchiv.

Zudem müssen Benutzer des Schemas file:// auf Windowsrechnern eine nicht offizielle „Standard“-Syntax für die URL verwenden. Jede der folgenden URLs funktioniert, wobei X das Laufwerk mit dem Projektarchiv ist:

file:///X:/path/to/repos
...
file:///X|/path/to/repos
...
      

Beachten Sie, dass die URL normale Schrägstriche verwendet, obwohl Windows-Pfade mit umgekehrten Schrägstrichen angegeben werden.

Sie können zwar per Netzwerkfreigabe auf ein FSFS-Projektarchiv zugreifen, dies wird jedoch aus verschiedenen Gründen nicht empfohlen:

Ein Übertragen-Befehl kann Änderungen an beliebig vielen Dateien und Ordnern als eine einzige atomare Operation übertragen. In Ihrer Arbeitskopie können Sie Dateien ändern, erstellen, löschen, umbenennen und verschieben und dann alle diese Änderungen in einem einzigen Schritt übertragen.

Im Projektarchiv wird jede Übertragung als eine einzige atomare Transaktion behandelt: entweder werden alle Änderungen abgespeichert oder gar keine. Subversion stellt dies sogar im Falle von Systemabstürzen, Netzwerkproblemen, Stromausfällen oder anderen Problemen sicher.

Jedes mal wenn ein Projektarchiv eine Übertragung akzeptiert, wird dadurch ein neuer Zustand der Dateistruktur erzeugt. Ein solcher Zustand wird Revision genannt. Jeder Revision wird eine natürliche Zahl zugeordnet, jeweils um eins größer als die vorherige Revision. Der Ursprungszustand eines Projektarchivs bei der Erstellung ist also Revision 0. Revision 0 enthält nichts außer einem leeren Hauptverzeichnis.

Eine Möglichkeit, sich das Projektarchiv vorzustellen, ist als eine Reihe von Bäumen. Stellen Sie sich eine Reihe von Revisionsnummern vor, beginnend mit 0, die sich von links nach rechts ausdehnt. An jeder Revisionsnummer hängt ein Dateibaum, und jeder dieser Bäume ist eine „Momentaufnahme“ davon, wie das Projektarchiv nach der jeweiligen Übertragung ausgesehen hat.

Abbildung 2.7. Das Projektarchiv

Es ist wichtig zu beachten, dass Arbeitskopien nicht immer mit einer einzigen Revision des Projektarchivs übereinstimmen; sie können Dateien von verschiedenen Revisionen enthalten. Nehmen Sie zum Beispiel an, Sie haben aus einem Projektarchiv eine Arbeitskopie ausgecheckt, bei welcher die neueste Revision die 4 ist:

calc/Makefile:4
integer.c:4
button.c:4
      

In diesem Moment entspricht die Arbeitskopie exakt der Revision 4 im Projektarchiv. Nun nehmen Sie an, Sie ändern die Datei button.c und übertragen diese Änderungen. Nehmen Sie weiter an, dass keine weiteren Änderungen vorgenommen wurden und Ihre Übertragung eine neue Revision 5 im Projektarchiv erstellt. Ihre Arbeitskopie wird dann so aussehen:

calc/Makefile:4
integer.c:4
button.c:5
      

Nehmen Sie nun an, dass jetzt Sally Änderungen an der Datei integer.c überträgt und damit eine Revision 6 erstellt. Wenn Sie nun Ihre Arbeitskopie aktualisieren, wird diese so aussehen:

calc/Makefile:6
integer.c:6
button.c:6
      

Sallys Änderungen an der Datei integer.c werden in Ihre Arbeitskopie eingefügt, und Ihre Änderungen in der Datei button.c werden immer noch vorhanden sein. In diesem Beispiel ist der Inhalt der Datei Makefile identisch in den Revisionen 4, 5 und 6, aber Subversion markiert Ihre lokale Kopie von Makefile mit Revision 6 um zu zeigen, dass diese immer noch aktuell ist. Also wird, nachdem Sie eine saubere Aktualisierung durchgeführt haben, Ihre Arbeitskopie exakt einer Revision im Projektarchiv entsprechen.

Für jede Datei in einer Arbeitskopie zeichnet Subversion zwei wesentliche Informationen im .svn-Administrationsordner auf:

Mittels dieser Informationen ist Subversion in der Lage, durch Anfragen an das Projektarchiv herauszufinden, in welchem der folgenden vier Zustände eine Datei ist:

Nun haben Sie ein neues Projektarchiv in D:\SVN\MyNewRepository erstellt.

Um das lokale Projektarchiv anzusprechen, benötigen Sie den Pfad zum Projektarchiv-Ordner. Beachten Sie, dass Subversion alle Projektarchivpfade in der Form file:///C:/SVNRepository/ benötigt.

Um ein Projektarchiv auf einer Netzwerkfreigabe anzusprechen, können Sie entweder die Freigabe als Laufwerk verbinden oder den UNC-Pfad benutzen. UNC-Pfade haben die Form file://ServerName/Pfad/zum/Projektarchiv/. Beachten Sie, dass hier nur 2 Schrägstriche vor dem Servernamen stehen.

Vor Subversion 1.2 mussten UNC-Pfade in dem obskuren Format file:///\ServerName/path/to/repos angegeben werden. Dieses Format wird weiterhin unterstützt, aber nicht empfohlen.

Obwohl es theoretisch möglich ist, ein FSFS-Projektarchiv auf einer Netzwerkfreigabe anzulegen und mehrere Anwender per file://-Protokoll darauf zugreifen zu lassen, raten wir aus mehreren Gründen dringend davon ab:

Der Zugriff per file:// ist ausschließlich für lokalen Einzelbenutzerzugriff gedacht, speziell zum Testen und Debuggen. Wenn Sie das Projektarchiv gemeinsam nutzen wollen, sollten Sie wirklich einen richtigen Server einrichten. Das ist nicht annähernd so kompliziert, wie Sie vielleicht denken. Lesen Sie „Zugriff auf das Projektarchiv“ als Anleitung zur Auswahl und Einrichtung eines Servers.

Bevor Sie Daten in das Projektarchiv importieren, sollten Sie sich Gedanken darüber machen, wie Sie Ihre Daten organisieren wollen. Wenn Sie eine der empfohlenen Strukturen verwenden, werden Sie es später sehr viel einfacher haben.

Es gibt ein paar empfohlene Standards, um die Daten innerhalb eines Projektarchivs zu organisieren. Die meisten Leute erstellen einen trunk-Ordner für die „Stammentwicklung“, einen branches-Ordner für die Entwicklungszweige und einen tags-Ordner zum Markieren von Ständen. Wenn ein Projektarchiv nur ein einziges Projekt enthält, ist die folgende Struktur zu empfehlen:

/trunk
/branches
/tags
    

Da dieses Layout so häufig benutzt wird, schlägt Ihnen TortoiseSVN beim Erstellen eines neuen Projektarchivs vor, diese Struktur anzulegen.

Falls ein Projektarchiv jedoch mehrere Projekte enthält, wird innerhalb der Struktur nach Zweigen (branches) organisiert:

/trunk/paint
/trunk/calc
/branches/paint
/branches/calc
/tags/paint
/tags/calc
    

...oder nach Projekt:

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags
    

Nach Projekt zu organisieren ist sinnvoll, wenn die Projekte nicht eng miteinander verwandt sind und jedes für sich bearbeitet wird. Für verwandte Projekte, die Sie alle in einem Rutsch auschecken wollen oder die in einer Distribution zusammengefasst sind, ist es oft besser, nach Zweigen zu organisieren. Auf diese Weise müssen Sie nur den Stamm auschecken und die Beziehungen zwischen den Unterprojekten sind einfacher zu erkennen.

Wenn Sie die Struktur /trunk /tags /branches wählen, müssen Sie lediglich den gesamten Stamm kopieren, wenn Sie Zweige oder Marken erstellen. In gewisser Weise ist das der flexibelste Ansatz.

Für völlig unabhängige Projekte sollten Sie besser pro Projekt ein einzelnes Projektarchiv anlegen. Wenn Sie Änderungen übertragen, wird die Revisionsnummer des Projektarchivs und nicht die des Projekts hoch gezählt. Bei mehreren unabhängigen Projekten, die sich ein Archiv teilen, kann das zu Konfusion führen, wenn z. B. an einem der Projekte überhaupt nicht gearbeitet wird, an anderen jedoch viel. TortoiseSVN und Subversion zum Beispiel erscheinen auf demselben Server (tigris.org), sind aber völlig selbstständige Projekt(archiv)e mit voneinander unabhängiger Entwicklung und ohne Verwirrung über Versionsnummern.

Natürlich können Sie diese Empfehlungen auch ignorieren. Es steht Ihnen frei, ein Layout zu wählen, das am besten für Sie oder Ihr Team geeignet ist. Beachten Sie auch, dass egal, welche Wahl Sie treffen, diese nicht fix ist. Sie können das Layout später immer noch reorganisieren. Weil Zweige (branches) und Marken (tags) gewöhnliche Ordner in Subversion sind, können Sie diese ganz einfach mit TortoiseSVN umbenennen oder verschieben, wie Sie wollen.

Von einem Layout zu einem anderen zu wechseln ist lediglich eine Abfolge serverseitiger Umbenennungen. Wenn Ihnen die Art und Weise nicht gefällt, wie Dinge im Projektarchiv organisiert sind, jonglieren Sie einfach mit den Verzeichnissen herum.

Wenn Sie noch keine Ordnerstruktur in Ihrem Projektarchiv angelegt haben, sollten Sie das jetzt erledigen. Es gibt zwei Möglichkeiten dafür. Wenn Sie nur die einfache /trunk /tags /branches-Struktur wünschen, können Sie diese in drei Schritten mit Hilfe des Projektarchivbetrachters anlegen. Wenn Sie eine tiefer verschachtelte Hierarchie wünschen, sollten Sie die zunächst auf der lokalen Platte anlegen und dann in einem Schritt wie hier importieren:

Beachten Sie bitte, dass der Name des Ordners, den Sie importieren, nicht im Projektarchiv erscheint, sondern nur seine Inhalte. Erzeugen Sie z. B. folgende Ordnerstruktur:

C:\Temp\New\trunk
C:\Temp\New\branches
C:\Temp\New\tags

Importieren Sie C:\Temp\New in die Wurzel des Projektarchivs, die dann folgendermaßen aussehen wird:

/trunk
/branches
/tags

Abbildung 4.1. Explorer mit überlagerten Symbolen

Eine der auffälligsten Eigenschaften von TortoiseSVN sind die überlagerten Symbole, die auf Dateien und Ordnern in Ihrer Arbeitskopie erscheinen. Sie zeigen Ihnen auf einen Blick an, welche Objekte verändert wurden. Lesen Sie in „Überlagerte Symbole“ nach, was die einzelnen Symbole bedeuten.

Abbildung 4.2. Kontextmenü für einen Ordner unter Versionskontrolle

Alle Befehle von TortoiseSVN werden über das Kontextmenü des Windows Explorers aufgerufen. Die meisten sind direkt sichtbar, wenn Sie einen Rechtsklick auf eine Datei oder Ordner machen. Welche Befehle angezeigt werden, hängt davon ab, ob das angeklickte Objekt oder sein übergeordneter Ordner unter Versionskontrolle stehen oder nicht. Das TortoiseSVN-Menü wird auch im Dateimenü des Explorers angezeigt.

In manchen Fällen werden Sie mehrere TortoiseSVN-Einträge sehen. Das ist kein Fehler!

Abbildung 4.3. Explorer-Kontextmenü für Verknüpfungen in einem versionierten Ordner

In diesem Beispiel sehen Sie eine nicht versionierte Verknüpfung in einem versionierten Ordner. Das Dateimenü des Explorers zeigt drei Einträge für TortoiseSVN an. Einer steht für den Ordner, einer für die Verknüpfung und einer für das Objekt, auf das die Verknüpfung zeigt. Damit Sie die drei Menüs unterscheiden können, besitzen die Symbole einen Indikator in der unteren rechten Ecke, der anzeigt, ob es sich um eine Datei, einen Ordner, eine Verknüpfung oder eine Mehrfachauswahl handelt.

Abbildung 4.4. Rechts-Ziehen-Menü für einen Ordner unter Versionskontrolle

Andere Befehle sind als Ziehen und Ablegen-Funktion vorhanden, wenn Sie Dateien oder Ordner innerhalb einer Arbeitskopie Rechts-Ziehen oder wenn Sie eine nicht versionskontrollierte Datei in eine Arbeitskopie Rechts-Ziehen.

Einige allgemeine Aktionen haben wohlbekannte Windows-Tastaturkürzel, werden aber nicht auf Schaltflächen oder in Menüs angezeigt. Wenn Ihnen einige wichtige Funktionen wie Aktualisieren der Anzeige nicht klar sind, schauen Sie hier nach.

Wenn das Projektarchiv, auf das Sie zugreifen wollen, passwortgeschützt ist, erscheint folgender Anmeldedialog.

Abbildung 4.5. Anmeldedialog

Geben Sie Ihren Benutzernamen und Ihr Passwort ein. Die Option bewirkt, dass TortoiseSVN die Anmeldeinformationen in einem von drei Unterordnern des Subversion-Konfigurationsverzeichnisses %APPDATA%\Subversion\auth ablegt:

Wenn Sie die Anmeldedaten löschen wollen, können Sie dies von der Gespeicherte Daten-Seite der TortoiseSVN-Optionen aus tun. Die Schaltfläche Alle löschen löscht die Anmeldedaten aller Projektarchive. Die Schaltfläche Löschen... öffnet einen Dialog, in dem Sie wählen können, welche Anmeldedaten gelöscht werden sollen. Siehe

Wenn Sie möchten, dass Ihre Subversion-Anmeldeinformationen beim Abmelden oder Herunterfahren von Windows gelöscht werden, erstellen Sie ein Skript, dass das Verzeichnis %APPDATA%\Subversion\auth löscht, z. B.

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"

Eine Erklärung, wie man solche Skripte installiert, finden Sie unter https://www.windows-help-central.com/windows-shutdown-script.html.

Für weitere Informationen über Serverkonfiguration und Zugriffskontrolle lesen Sie bitte „Zugriff auf das Projektarchiv“.

Viele der Dialoge von TortoiseSVN zeigen eine große Menge an Informationen an. Manchmal ist es sinnvoll, nur die Breite oder die Höhe zu maximieren, statt das Fenster auf Vollbild zu vergrößern. Zu diesem Zweck stehen Ihnen Abkürzungen auf der Maximieren-Schaltfläche zur Verfügung. Klicken Sie mit der mittleren Maustaste, wird vertikal maximiert, mit der rechten Maustaste horizontal.

Falls Sie in ein bereits existierendes Projektarchiv importieren, das schon einige Projekte enthält, ist dessen Struktur bereits festgelegt. Wenn Sie Daten in ein neues Projektarchiv importieren, sollten Sie sich vorher darüber Gedanken machen, wie Sie es organisieren. Lesen Sie „Struktur des Projektarchivs“ für weitere Hinweise.

Dieser Abschnitt beschreibt den Import-Befehl von Subversion, der dazu gedacht ist, eine Verzeichnisstruktur in ein Projektarchiv zu importieren. Obwohl er für diese Aufgabe geeignet ist, besitzt er doch einige Nachteile:

Aus diesen Gründen empfehlen wir, dass Sie den Import-Befehl gar nicht nutzen, sondern die in „Import an Ort und Stelle“ beschriebene zweistufige Methode. Es sei denn, Sie führen den einfachen Schritt zum Anlegen der initialen /trunk /tags /branches-Struktur im Projektarchiv durch. Da Sie schon diesen Abschnitt lesen, folgt nun eine kurze Einführung ...

Bevor Sie ein Projekt in das Projektarchiv importieren, sollten Sie:

Wählen Sie nun den übergeordneten Ordner Ihrer Ordnerstruktur im Windows Explorer und öffnen Sie mit einem Rechtsklick das Kontextmenü. Wählen Sie den Befehl TortoiseSVN → Importieren..., worauf der folgende Dialog erscheint:

Abbildung 4.6. Der Import-Dialog

In diesem Dialog geben Sie die URL des Projektarchivs ein, in das Sie Ihr Projekt importieren wollen. Es ist sehr wichtig zu verstehen, dass der lokale Ordner, den Sie importieren, nicht im Projektarchiv landet, sondern nur sein Inhalt. Wenn Sie z. B. die folgende Struktur haben:

C:\Projekte\Grafik\source
C:\Projekte\Grafik\doku
C:\Projekte\Grafik\bilder

und Sie importieren C:\Projekte\Grafik in http://meinserver.com/svn/trunk, könnten Sie überrascht feststellen, dass Ihre Unterverzeichnisse direkt in trunk anstelle eines Grafik-Unterverzeichnisses landen. Sie müssen das Unterverzeichnis als Teil der URL http://meinserver.com/svn/trunk/Grafik-X angeben. Beachten Sie, dass der Importbefehl automatisch Unterverzeichnisse im Projektarchiv anlegt, wenn diese noch nicht existieren.

Die Importmeldung wird als Logmeldung verwendet.

Standardmäßig werden Dateien und Ordner, die dem globalen Ignoriermuster entsprechen, nicht importiert. Um dieses Verhalten zu übergehen, aktivieren Sie die Option Ignorierte Dateien einschließen. Lesen Sie in „Allgemeine Einstellungen“ nach, wie man globale Ignoriermuster einrichtet.

Sobald Sie auf OK klicken, beginnt TortoiseSVN, die Daten in das Projektarchiv zu importieren. Beachten Sie bitte, dass dadurch Ihr Importordner nicht unter Versionskontrolle gestellt wird! Um eine Arbeitskopie zu erhalten, in der die Daten unter Versionskontrolle sind, müssen Sie die Daten frisch aus dem Projektarchiv auschecken. Oder Sie lesen weiter, um herauszufinden, wie man beim Import eine Arbeitskopie an Ort und Stelle erzeugen kann.

Angenommen, Sie haben bereits ein Projektarchiv und wollen eine neue Ordnerstruktur hinzufügen, folgen Sie diesen Schritten:

Manchmal ist es notwendig, eine Datei unter Versionskontrolle zu haben, die benutzerspezifische Daten (z. B. absolute Pfade zu Anwendungen) enthält. Das bedeutet: Sie haben eine Datei, die von jedem Benutzer verändert werden muss, um sie an seine lokalen Einstellungen anzupassen. Aber eine Datei unter Versionskontrolle würde von jedem Benutzer jeweils wieder zum Projektarchiv übertragen werden und so die Änderungen von anderen Benutzern wieder überschreiben.

In solchen Fällen empfehlen wir die Verwendung von sogenannten Schablonen. Sie erstellen eine Datei, die alle Daten enthält, die Ihre Entwickler benötigen, fügen diese Datei der Versionskontrolle hinzu und lassen die Entwickler diese Datei auschecken. Anschließend muss jeder Entwickler eine Kopie dieser Datei erstellen und diese Kopie umbenennen. Danach ist das Ändern der Kopie kein Problem mehr.

Als Beispiel sehen Sie sich einmal das Erstellungsskript von TortoiseSVN an. Es ruft eine Datei namens default.build.user auf, die im Projektarchiv gar nicht existiert. Dort gibt es nur die Datei default.build.user.tmpl, die für jeden Entwickler die Vorlage für die Datei default.build.user darstellt. Bevor also das Skript ausgeführt werden kann, muss jeder Benutzer eine Kopie davon erstellen und in default.build.user umbenennen. In dieser Datei stehen Kommentare, mit denen wir erklären, welche Zeilen an die lokalen Einstellungen angepasst werden müssen.

Um die Benutzer nicht zu stören, ist die Datei default.build.user auch in der Ignorierliste ihres Elternordners eingetragen. Das heißt, wir haben die Subversion-Eigenschaft svn:ignored für diese Datei gesetzt. Damit erscheint diese Datei nicht in jedem Übertragen-Dialog als (noch) nicht versioniert.

Sie können die Tiefe der Rekursion beim Auschecken festlegen. Wenn Sie nur einige Bereiche eines großen Quellbaumes wollen, können Sie den obersten Ordner auschecken und danach die gewünschten Ordner rekursiv aktualisieren.

Um einfach nur die Elemente, die Sie auschecken wollen, auszuwählen und dafür zu sorgen, dass die resultierende Arbeitskopie nur die gewählten Objekte enthält, klicken Sie auf die Wähle Objekte... Schaltfläche. Diese öffnet einen neuen Dialog, in dem Sie die gewünschten Objekte markieren können. Die resultierende Arbeitskopie wird als spärliche Arbeitskopie bezeichnet. Wenn sie diese Arbeitskopie aktualisieren, werden die fehlenden Objekte ignoriert und nur die gewählten Dateien und Ordner aktualisiert.

Wenn Sie eine spärliche Arbeitskopie erstellen (indem Sie z. B. etwas anderes als vollständig rekursiv für die Auschecktiefe wählen), können Sie später einfach Unterordner mit einer der folgenden Methoden hinzufügen oder entfernen.

Diese Funktion ist sehr nützlich, wenn Sie nur Teile einer großen Projektstruktur auschecken wollen und gleichzeitig die Bequemlichkeit einer einzelnen Arbeitskopie wünschen. Nehmen wir an, Sie haben eine große Verzeichnisstruktur mit den Ordnern Projekt01 bis Projekt99 und Sie möchten nur die Ordner Projekt03, Projekt25 und Projekt76/Unterprojekt auschecken. Dann gehen Sie in folgenden Schritten vor:

Wenn Ihre Arbeitskopie auf dem neuesten Stand ist und keine Konflikte vorhanden sind, können Sie Ihre Änderungen übertragen. Wählen Sie die Dateien/Ordner aus, die Sie übertragen wollen, und wählen Sie den Befehl TortoiseSVN → Übertragen....

Abbildung 4.8. Der Übertragen-Dialog

Der Dialog zeigt alle geänderten Dateien einschließlich hinzugefügter, gelöschter oder nicht versionierter Dateien an. Wenn Sie bestimmte Dateien nicht übertragen wollen, wählen Sie diese einfach ab. Dateien, die noch nicht unter Versionskontrolle stehen, können Sie durch Markieren vor dem Übertragen hinzufügen.

Um schnell Gruppen von Dateien, z. B. alle versionierten oder alle geänderten Dateien auszuwählen, klicken Sie einfach auf die verschiedenen Auswahloptionen oberhalb der Dateiliste.

Informationen über die Färbung und Überlagerungen der Objekte entsprechend ihres Status finden Sie unter „Prüfe auf Änderungen“.

Objekte, die zu einem anderen Pfad im Projektarchiv gewechselt wurden, werden durch ein (s) gekennzeichnet. Vielleicht haben Sie während der Entwicklung etwas auf einen Zweig umgeschaltet und vergessen, zurück zu trunk zu wechseln. Dies ist Ihr Warnzeichen!

Durch einen Doppelklick auf eine Datei im Übertragen-Dialog wird das Vergleichsprogramm gestartet, sodass Sie die Änderungen, die Sie vorgenommen haben, genauer ansehen können. Das Kontextmenü bietet weitere Optionen, wie Sie im Bild sehen können. Sie können von hier aus auch Dateien in eine andere Anwendung, z. B. einen Texteditor oder eine Entwicklungsumgebung, ziehen.

Sie können Einträge an- oder abwählen, indem Sie das Kästchen links vom Eintrag markieren. Für Verzeichnisse können Sie Umschalt-Auswahl verwenden, um die Auswahl rekursiv zu machen.

Die im unteren Bereich angezeigten Spalten können angepasst werden. Wenn Sie einen Rechtsklick auf einen Spaltenkopf machen, erscheint ein Kontextmenü, aus dem Sie die anzuzeigenden Spalten auswählen können. Sie können auch die Spaltenbreiten anpassen, indem sie die Spaltenköpfe mit den Ziehmarken justieren. Diese Einstellungen werden gespeichert, sodass Sie beim nächsten Mal dieselben Spalten sehen.

Standardmäßig werden bei einer erfolgreichen Übertragung die von Ihnen gesperrten Dateien wieder freigegeben. Wenn Sie jedoch die Sperren behalten möchten, aktivieren Sie die Option Sperren behalten. Als Vorgabewert des Auswahlkästchen wird aus der Einstellung no_unlock in der Subversion-Konfigurationsdatei verwendet. Lesen Sie in „Allgemeine Einstellungen“ nach, wie Sie die Subversion-Konfigurationsdatei bearbeiten können.

Der Übertragen-Dialog unterstützt die Änderungslisten von Subversion, mit der zueinander gehörende Dateien gruppiert werden können. Eine Beschreibung dieser Funktion findet sich in „Änderungslisten“.

Manchmal möchten Sie nur Teile der Änderungen übertragen, die Sie an einer Datei vorgenommen haben. So etwas passiert normalerweise, wenn Sie an etwas arbeiten, jedoch ein dringender Bugfix übertragen werden muss, der sich in derselben Datei befindet, an der Sie gerade arbeiten.

Machen Sie einen Rechtsklick auf die Datei und wählen Sie Kontextmenü → Nach dem Übertragen wiederherstellen. Dadurch wird eine Kopie der Datei im aktuellen Zustand erstellt. Anschließend können Sie die Datei z. B. in einem Texteditor bearbeiten und die Änderungen entfernen, die Sie nicht übertragen möchten. Nach dem Speichern übertragen Sie die Datei.

Nachdem die Übertragung durchgeführt wurde, wird die Kopie der Datei automatisch wiederhergestellt. Sie erhalten Ihre Datei inklusive der nicht übertragenen Änderungen zurück.

Manchmal arbeiten Sie mit versionierten Dateien, die sich häufig ändern, die Sie aber nicht übertragen wollen. Eventuell deutet das auf einen Mangel in Ihrem Erstellungsprozess hin: Warum sind diese Dateien versioniert? Sollten Sie nicht besser mit Vorlagen arbeiten? Aber manchmal ist es unvermeidlich. Ein klassischer Grund ist, dass Ihre Entwicklungsumgebung bei jedem Generieren einen Zeitstempel in der Projektdatei verändert. Die Projektdatei muss versioniert sein, da sie alle zum Generieren erforderlichen Einstellungen enthält, aber sie muss nicht übertragen werden, nur weil sich der Zeitstempel geändert hat.

Um in diesen heiklen Fällen zu helfen, gibt es eine reservierte Änderungsliste namens ignore-on-commit. Jede zu dieser Änderungsliste hinzugefügte Datei wird im Übertragen-Dialog nicht markiert. Sie können die Änderungen übertragen, müssen die Datei aber von Hand wählen.

Achten Sie darauf, dass Sie eine Logmeldung eingeben, die die von Ihnen vorgenommenen Änderungen beschreibt. So können Sie später beim Durchblättern der Projekt-Logmeldungen sehen, was wann passiert ist. Die Nachricht kann so lang oder so kurz sein, wie Sie möchten. Viele Projekte haben Richtlinien für das, was enthalten sein sollte, die zu verwendende Sprache und manchmal sogar ein strenges Format.

Sie können Ihre Logmeldungen mit einfachen Formatierungen versehen. Dazu wird eine Konvention ähnlich derer in E-Mails angewendet. Um text zu formatieren, verwenden Sie *text* für fett, _text_ für unterstrichen und ^text^ für kursiv.

Abbildung 4.9. Rechtschreibprüfung beim Eingeben einer Logmeldung

TortoiseSVN enthält eine Rechtschreibprüfung, die Sie bei der Korrektur Ihrer Logmeldungen unterstützt. Sie hebt sämtliche falsch geschriebenen Wörter hervor. Verwenden Sie das Kontextmenü, um auf die Korrekturvorschläge zuzugreifen. Verständlicherweise kennt die Rechtschreibprüfung nicht jeden technischen Ausdruck, den Sie verwenden, sodass manchmal korrekt geschriebene Wörter als fehlerhaft markiert werden. Aber keine Sorge. Sie können diese Wörter über das Kontextmenü zu Ihrem persönlichen Wörterbuch hinzufügen.

Der Dialog zur Eingabe von Logmeldungen enthält auch eine Funktion zum Autovervollständigen von Datei- und Funktionsnamen. Diese verwendet reguläre Ausdrücke, um Klassen- sowie Funktionsnamen aus den (Text-) Dateien, die Sie übertragen, zu extrahieren sowie die Dateinamen selbst. Wenn ein von Ihnen eingegebenes Wort mit einem Eintrag in der Liste übereinstimmt (sobald Sie mindestens drei Zeichen eingegeben oder Strg+Leerzeichen gedrückt haben), erscheint eine Liste, aus der Sie den vollständigen Namen wählen können. Die mit TortoiseSVN gelieferten regulären Ausdrücke befinden sich im TortoiseSVN-Installationsordner bin. Sie können auch Ihre eigenen regulären Ausdrücke definieren und in %APPDATA%\TortoiseSVN\autolist.txt speichern. Selbstverständlich wird ihre eigene Autolist bei einem Update von TortoiseSVN nicht überschrieben. Sollten Sie noch keine Erfahrung mit regulären Ausdrücken besitzen, können Sie sich die Einführung in https://en.wikipedia.org/wiki/Regular_expression

Den regulären Ausdruck korrekt hinzubekommen, kann trickreich sein. Um Ihnen dabei etwas zur Hand zu gehen, gibt es einen Testdialog, in dem Sie einen regulären Ausdruck gegen eine Liste von Dateien testen können. Diesen Dialog können Sie per Kommandozeile mittels TortoiseProc.exe /command:autotexttest starten.

Weiterhin enthält das Logfenster die Möglichkeit, Textbausteine zu verwenden. Diese werden in der Vorschlagsliste angezeigt, sobald Sie das Kürzel für einen Textbaustein eingegeben haben. Indem Sie den Baustein auswählen, wird der vollständige Text in die Logmeldung eingefügt. Die mit TortoiseSVN installierten Textbausteine finden Sie im bin-Ordner des Installationsverzeichnisses. Sie können auch Ihre eigenen Textbausteine erstellen und in %APPDATA%\TortoiseSVN\snippet.txt ablegen. # dient als Kommentarzeichen. Zeilenumbrüche können mittels \n und \r eingefügt werden. Für einen Rückwärtsschrägstrich verwenden Sie \\.

Sie können die zuletzt verwendeten Logmeldungen wiederverwenden. Dazu klicken Sie auf Letzte Meldungen und wählen einen Eintrag aus der Liste der Meldungen für dieses Projektarchiv aus. Die Anzahl der zu speichernden Logmeldungen kann in den Einstellungen festgelegt werden.

Auf der Seite Gespeicherte Daten in den TortoiseSVN-Einstellungen können Sie alle gespeicherten Logmeldungen auf einmal löschen. Alternativ können Sie im Fenster Letzte Meldungen Meldungen markieren und mittels Entfernen einzeln löschen.

Wenn Sie die markierten Pfade in Ihre Logmeldung aufnehmen möchten, können Sie den Befehl Kontextmenü → Namensliste einfügen im Eingabefeld verwenden.

Eine weitere Möglichkeit besteht darin, die Dateien einfach aus der Dateiliste in das Eingabefeld zu ziehen.

Wenn Sie schlussendlich auf OK klicken, wird die Übertragung gestartet und der Fortschrittsdialog angezeigt.

Abbildung 4.10. Eine laufende Übertragung im Fortschrittsdialog

Der Fortschrittsdialog verwendet eine Farbcodierung, um verschiedene Aktionen anzuzeigen

.

Dies ist das Standard-Farbschema, aber Sie können die Farben im Einstellungsdialog anpassen. Siehe „TortoiseSVN-Farben“ für weitere Informationen.

Ein Konflikt tritt dann auf, wenn mehrere Personen die gleichen Zeilen in einer Datei verändert haben. Da Subversion nichts über Ihr Projekt weiß, überlässt es in solchen Fällen Ihnen, den Konflikt aufzulösen. Die sich in Konflikt befindlichen Bereiche sind folgendermaßen markiert:

<<<<<<< Dateiname
    Ihre Änderungen
=======
    Code aus dem Projektarchiv
>>>>>>> Revision

Außerdem werden für jede Datei in Konflikt drei weitere Dateien in Ihrem Verzeichnis erstellt:

Sie können entweder einen externen Konflikteditor perTortoiseSVN → Konflikt bearbeiten aufrufen oder Sie können den Konflikt mit einem beliebigen Texteditor manuell auflösen. Sie müssen entscheiden, wie der Code aussehen soll, die notwendigen Änderungen vornehmen und die Datei speichern. Mit einem Konflikteditor wie TortoiseMerge oder einem der anderen beliebten Programme ist das im allgemeinen einfacher, da diese die betroffenen Dateien normalerweise in einer Drei-Fenster-Sicht anzeigen und Sie sich keine Gedanken über die Konfliktmarken machen müssen. Wenn Sie einen Texteditor verwenden, müssen sie manuell nach Zeilen suchen, die mit <<<<<<< beginnen.

Anschließend müssen Sie Subversion noch mitteilen, dass Sie den Konflikt aufgelöst haben. Dies geschieht mit dem Befehl TortoiseSVN → Konflikt aufgelöst. Bitte beachten Sie, dass dieser Befehl nicht den Konflikt selbst löst, sondern nur Subversion mitteilt, dass Sie selbst den Konflikt bereits gelöst haben. Der Befehl macht nichts weiter als die drei zusätzlich erstellten Dateien filename.ext.mine und filename.ext.r*zu löschen, damit sie Ihre Änderungen in das Projektarchiv übertragen können.

Wenn ein Konflikt zwischen Binärdaten besteht, versucht Subversion nicht, die Daten selbst zusammenzuführen. Die lokale Datei bleibt unverändert (exakt so, wie sie Ihrer letzten Änderung entspricht) und Sie erhalten Dateiname.ext.r* Dateien. Wenn Sie Ihre eigenen Änderungen verwerfen wollen, tun Sie das mit dem Befehl Rückgängig. Wenn Sie Ihre Version beibehalten und die Version im Projektarchiv überschreiben wollen, verwenden Sie den Befehl Konflikt aufgelöst und übertragen anschließend die Daten ins Projektarchiv.

Sie können den Befehl Konflikt aufgelöst für mehrere Dateien verwenden, indem Sie den übergeordneten Ordner markieren und TortoiseSVN → Konflikt aufgelöst... aus dem Kontextmenü wählen. Dies öffnet einen Auswahldialog, in dem alle konfliktbehafteten Dateien aufgelistet sind. Wählen Sie die Dateien, die Sie als aufgelöst markieren wollen.

Ein Eigenschaftskonflikt entsteht dann, wenn zwei oder mehr Entwickler dieselbe SVN-Eigenschaft verändert haben. Wie bei Dateikonflikten können nur Entwickler solche Konflikte auflösen.

Wenn eine der Änderungen die andere überschreiben soll, wählen Sie entweder Mit der lokalen Eigenschaft auflösen oder Mit der Eigenschaft aus dem Projektarchiv auflösen. Wenn die Änderungen zusammengeführt werden müssen, wählen Sie Revisionseigenschaft bearbeiten, tragen dort den gewünschten Wert ein und markieren den Konflikt als aufgelöst.

Ein Baumkonflikt entsteht, wenn ein Entwickler eine Datei oder einen Ordner umbenannt, verschoben oder gelöscht hat, den ein anderer Entwickler ebenfalls umbenannt, verschoben, gelöscht oder bearbeitet hat. Es gibt verschiedene Ursachen für Baumkonflikte und alle erfordern unterschiedliche Vorgehensweisen, um den Konflikt aufzulösen.

Wenn eine Datei in Subversion lokal gelöscht wird, wird sie auch aus dem lokalen Dateisystem gelöscht. Das bedeutet, dass kein überlagertes Symbol angezeigt werden kann, wenn sie Teil eines Baumkonfliktes ist und dass Sie den Konflikt nicht mit Hilfe eines Rechtsklicks auflösen können. Verwenden Sie stattdessen den Auf Änderungen prüfen Dialog, um den Konflikt bearbeiten zu können.

TortoiseSVN kann dabei helfen, Änderungen zusammenzuführen, aber es kann zusätzliche Arbeit erforderlich sein, um die Konflikte aufzulösen. Bedenken Sie, dass nach eine Aktualisierung die BASE der Arbeitskopie dem Inhalt des Projektarchivs entspricht. Wenn Sie eine Änderung nach dem Aktualisieren rückgängig machen, wird das Objekt in den Status des Projektarchivs zurückversetzt und nicht in den Zustand, in dem Sie begonnen haben, Ihre eigenen Änderungen durchzuführen.

Abbildung 4.12. Explorer mit überlagerten Symbolen

Nun, da Sie eine frisch ausgecheckte Arbeitskopie eines Subversion-Projektarchivs haben, zeigt Ihnen der Explorer diese Dateien und Ordner mit leicht geänderten Symbolen an. Dies ist mit ein Grund, weshalb TortoiseSVN so populär ist. TortoiseSVN fügt jedem Datei-/Ordnersymbol ein kleines überlagertes Symbol hinzu. Abhängig vom Subversion-Status der Datei ist das Überlagerungssymbol unterschiedlich.

Eine frisch ausgecheckte Arbeitskopie hat nur überlagerte Symbole mit grünem Haken. Dies bedeutet, dass der Subversion-Status normal ist.

Sobald Sie eine Datei ändern, ändert sich auch der Status der Datei auf verändert und das überlagerte Symbol ändert sich in ein rotes Ausrufezeichen. Auf diese Weise können Sie mit einem Blick feststellen, welche Dateien Sie geändert und noch nicht in das Projektarchiv übertragen haben.

Falls während einer Aktualisierung ein Konflikt auftrat, werden solche Dateien mit einem gelben Ausrufezeichen markiert.

Wenn eine Datei die svn:needs-lock-Eigenschaft besitzt, setzt Subversion den Schreibschutz für diese Datei, bis Sie eine Sperre für die Datei holen. Schreibgeschützte Dateien erhalten dieses Symbol, um anzuzeigen, dass Sie die Datei erst sperren müssen, bevor Sie sie bearbeiten können.

Wenn Sie die Sperre für eine Datei besitzen und der Subversion-Status normal ist, erinnert Sie dieses Symbol daran, dass Sie die Sperre wieder freigeben müssen, wenn Sie sie nicht benötigen, damit andere ihre Änderungen übertragen können.

Dieses überlagerte Symbol zeigt, dass Dateien oder Ordner zum Löschen aus der Versionskontrolle markiert wurden oder dass TortoiseSVN eine Datei unter Versionskontrolle vermisst.

Das Pluszeichen bedeutet, dass eine Datei oder ein Ordner neu zur Versionskontrolle hinzugefügt wurde.

Das Balkensymbol bedeutet, dass eine Datei oder ein Ordner von der Versionskontrolle ignoriert wird. Dieses Symbol ist optional.

Dieses Symbol wird für Dateien und Ordner verwendet, die sich weder unter Versionskontrolle befinden noch ignoriert sind. Das Symbol ist optional.

Sie werden möglicherweise feststellen, dass nicht alle diese Symbole auf Ihrem Rechner dargestellt werden. Das liegt daran, dass Windows die Anzahl der überlagerten Symbole beschränkt. Windows selber verwendet einige. Wenn Sie gleichzeitig eine ältere Version von TortoiseCVS installiert haben, sind nicht genügend Plätze für die Symbole beider Anwendungen frei. Deshalb versucht TortoiseSVN, ein „Guter Bürger(tm)“ zu sein und schränkt seine Verwendung von überlagerten Symbolen ein, damit andere Anwendungen eine Chance haben.

Da es mittlerweile viele Tortoise-Clients gibt (TortoiseCVS, TortoiseHG ...) wird die Beschränkung der überlagerten Symbole zu einem echten Problem. Als Lösungsansatz wurde im TortoiseSVN-Projekt ein gemeinsamer Satz von Symbolen implementiert, der als DLL geladen wird und von allen Tortoise-Clients genutzt werden kann. Fragen Sie Ihren Tortoise-Anbieter, ob er die gemeinsam genutzten Symbole bereits unterstützt :-)

Eine Beschreibung, wie die überlagerten Symbole mit dem Subversion-Status zusammenhängen und weitere technische Details finden sich in „Überlagerte Symbole“.

Abbildung 4.13. Explorer-Eigenschaftsseite, Subversion-Tab

Manchmal ist es notwendig, detailliertere Informationen über eine Datei oder einen Ordner zu haben, als dies mit den überlagerten Symbolen möglich ist. Sie können diese zusätzlichen Informationen über den Eigenschaftsdialog des Explorers anzeigen. Wählen Sie dazu die Datei oder den Ordner aus, öffnen Sie das Kontextmenü mit der rechten Maustaste und wählen Sie den Eintrag Windows Menü → Eigenschaften aus. Beachten Sie: Dies ist der normale Eintrag im Kontextmenü des Explorers und nicht der Eintrag im TortoiseSVN-Untermenü! Im darauffolgenden Dialog hat TortoiseSVN einen Karteireiter für Dateien/Ordner unter Subversionkontrolle angelegt, auf dem Sie alle Informationen finden.

Abbildung 4.14. Prüfe auf Änderungen

Oft ist es nützlich zu wissen, welche Dateien von anderen bereits geändert und im Projektarchiv gespeichert wurden. Dazu gibt es den Befehl TortoiseSVN → Auf Änderungen überprüfen.... Dieser Dialog zeigt Ihnen alle veränderten oder unversionierten Dateien in Ihrer Arbeitskopie.

Mit der Schaltfläche Projektarchiv prüfen können Sie das Projektarchiv auf Änderungen prüfen. Auf diese Weise können Sie vor dem Aktualisieren feststellen, ob es möglicherweise Konflikte gibt. Sie können aus diesem Dialog heraus auch einzelne Dateien - ohne den gesamten Ordner - aus dem Projektarchiv aktualisieren. Standardmäßig holt Projektarchiv prüfen nur den Status des Projektarchivs, entsprechend der Tiefe der Arbeitskopie. Wenn Sie alle Dateien und Ordner des Projektarchivs, inklusive derer sehen möchten, die Sie nicht ausgecheckt haben, halten Sie die Umschalt-Taste gedrückt, während Sie auf Projektarchiv prüfen klicken.

Der Dialog verwendet eine Farbcodierung, um verschiedene Status anzuzeigen.

Dies ist das Standard-Farbschema, aber Sie können die Farben im Einstellungsdialog anpassen. Siehe „TortoiseSVN-Farben“ für weitere Informationen.

Die überlagerten Symbole dienen auch dazu, andere Status anzuzeigen. Das folgende Bild zeigt alle möglichen, bei Bedarf angezeigten, überlagerten Symbole.

Überlagerte Symbole werden für die folgenden Zustände angezeigt:

Objekte, die zu einem anderen Pfad im Projektarchiv gewechselt wurden, werden durch ein (s) gekennzeichnet. Vielleicht haben Sie während der Entwicklung etwas auf einen Zweig umgeschaltet und vergessen, zurück zu trunk zu wechseln. Dies ist Ihr Warnzeichen! Das Kontextmenü erlaubt es Ihnen, auf den normalen Pfad zurück zu wechseln.

Aus dem Kontextmenü des Dialoges heraus können Sie sich die Unterschiede anzeigen lassen. Wählen Sie die lokalen Änderungen, die Sie gemacht haben, mittels Kontextmenü → Vergleiche mit Basis. Prüfen Sie die Änderungen im Projektarchiv, die andere gemacht haben, mittels Kontextmenü Zeige Unterschiede als Standard-Diff

Sie können auch Änderungen in einzelnen Dateien rückgängig machen. Wenn Sie aus Versehen eine Datei gelöscht haben, wird sie in diesem Dialog als Fehlend angezeigt und kann mittels Rückgängig wiederhergestellt werden.

Nicht versionierte und ignorierte Dateien können von hier aus mittels Kontextmenü → Löschendirekt in den Papierkorb verschoben werden. Wenn Sie die Dateien unter Umgehung des Papierkorbes permanent löschen wollen, halten Sie die Umschalt-Taste gedrückt, während Sie Löschen klicken.

Wenn Sie eine Datei im Detail betrachten möchten, können Sie sie von hier aus in eine andere Anwendung, z. B. einen Texteditor oder eine Entwicklungsumgebung, ziehen oder Sie können eine Kopie speichern, indem Sie die Datei einfach in einen Ordner im Explorer ziehen.

Die angezeigten Spalten können angepasst werden. Wenn Sie einen Rechtsklick auf einen Spaltenkopf machen, erscheint ein Kontextmenü, aus dem Sie die anzuzeigenden Spalten auswählen können. Sie können auch die Spaltenbreiten anpassen, indem Sie die Spaltenköpfe mit den Ziehmarken justieren. Diese Einstellungen werden gespeichert, sodass Sie beim nächsten Mal wieder die gleichen Spalten sehen.

Wenn Sie gleichzeitig an mehreren voneinander unabhängigen Aufgaben arbeiten, können Sie Dateien in Änderungslisten zusammenfassen. Lesen Sie „Änderungslisten“ für weitere Informationen.

Am unteren Rand des Dialoges sehen Sie eine Zusammenfassung der Revisionen in Ihrer Arbeitskopie. Es handelt sich dabei um die übertragenen Revisionen, nicht die aktualisierten. Sie stellen den Revisionsbereich dar, in dem die Dateien zuletzt übertragen wurden. Beachten Sie bitte, dass der angezeigte Bereich sich nur die dargestellten Objekte bezieht, nicht auf alle in der Arbeitskopie vorhandenen Objekte. Wenn Sie diese Information sehen möchten, wählen Sie die Option Zeige unmodifizierte Daten.

Oft möchten Sie sehen, was Sie in einer Datei geändert haben. Das können Sie durch das Markieren einer Datei mit dem TortoiseSVN-Kontextmenübefehl Vergleiche tun. Diese Funktion startet TortoiseMerge (oder ein externes Vergleichsprogramm), das Ihnen die lokalen Änderungen (gegenüber der BASE-Revision) seit dem letzten Auschecken oder Aktualisieren anzeigt.

Abbildung 4.18. Der Log-Dialog

Es gibt mehrere Orte, von denen Sie den Log-Dialog starten können:

Wenn das Projektarchiv nicht erreicht werden kann, wird der Offline gehen-Dialog, angezeigt, der in „Offline-Modus“ beschrieben wird.

Der obere Bereich enthält eine Aktionen-Spalte, in der Symbole die Änderungen einer Revision zusammenfassen. Es gibt vier verschiedene Symbole, die jeweils in einer eigenen Spalte angezeigt werden.

in der ersten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner geändert wurde.

in der zweiten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner neu zur Versionskontrolle hinzugefügt wurde.

in der dritten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner aus der Versionskontrolle gelöscht wurde.

in der vierten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner ersetzt wurde.

in der vierten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner verschoben wurde.

in der vierten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner verschoben bzw. umbenannt wurde.

in der vierten Spalte zeigt an, dass in einer Revision eine Datei oder ein Ordner zusammengeführt wurde.

in der vierten Spalte zeigt an, dass in einer Revision eine Datei oder ein Verzeichnis rückwärts zusammengeführt wurde.

Abbildung 4.19. Das Kontextmenü des Log-Dialogs

Der obere Bereich des Log-Dialogs besitzt ein Kontextmenü, das Ihnen Zugriff auf weitere Informationen ermöglicht. Einige Funktionen stehen nur bei Dateien, andere bei Ordnern zur Verfügung.

Abbildung 4.20. Der Code Collaborator-Einstellungsdialog

Abbildung 4.21. Kontextmenü des Log-Dialogs für zwei ausgewählte Revisionen

Wenn Sie (mit Strg) zwei Revisionen auf einmal auswählen, reduziert sich das Kontextmenü auf folgende Funktionen:

Wenn Sie mehrere aufeinander folgende Revisionen (mittels der üblichen Strg- oder Umschalt-Taste) markieren, bietet das Kontextmenü eine Funktion an, alle Änderungen innerhalb des Revisionsbereiches rückgängig zu machen. Dies ist der einfachste Weg, einen Satz von Änderungen in einem Schritt zurückzunehmen.

Sie können, wie bereits oben beschrieben, die gewählten Revisionen auch in einer anderen Arbeitskopie zusammenführen.

Falls alle markierten Revisionen den selben Autor haben, können Sie den Autor dieser Revisionen in einem Schritt ändern.

Abbildung 4.22. Kontextmenü der Dateiliste des Log-Dialogs

Der untere Bereich des Log-Dialogs hat ein Kontextmenü, das Ihnen erlaubt

Wenn mehrere Dateien im Log-Dialog markiert sind, ändert sich das Kontextmenü in:

Abbildung 4.23. Der untere Bereich im Log-Dialog mit angezeigtem Kontextmenü, wenn mehrere Dateien ausgewählt sind.

Der Log-Dialog zeigt aus mehreren Gründen nicht immer alle Änderungen an, die jemals gemacht wurden:

Wenn Sie mehr Logmeldungen sehen wollen, klicken Sie auf die Nächste 100-Schaltfläche, um weitere 100 Meldungen zu holen. Sie können dies so oft wie nötig wiederholen.

Daneben befindet sich eine Mehrfachschaltfläche, die sich den letzten gewählten Zustand merkt. Klicken Sie auf den Pfeil, um die anderen Möglichkeiten zu sehen.

Wählen Sie Zeige Bereich, wenn Sie einen bestimmten Revisionsbereich betrachten wollen. Ein Dialog wird dann die Anfangs- und Endrevision von Ihnen abfragen.

Wählen Sie Zeige Alle, wenn Sie alle Logmeldungen von HEAD zurück bis zur Revision 1 sehen möchten.

Drücken Sie die Taste F5, um die neueste Version zu aktualisieren, falls es Übertragungen gab, während der Log-Dialog geöffnet war.

Um den Log-Puffer zu aktualisieren, drücken Sie Strg+F5.

Da der Log-Dialog Ihnen die Logmeldungen ab der HEAD-Revision zeigt, kann es vorkommen, dass Logmeldungen für Änderungen angezeigt werden, die sich noch nicht in Ihrer Arbeitskopie befinden. Um dies zu verdeutlichen, wird die Logmeldung, die der aktuellen Revision der Arbeitskopie entspricht, in Fettdruck hervorgehoben.

Wenn Sie das Log für einen Ordner anzeigen, entspricht die hervorgehobene Revision der höchsten innerhalb des Ordners gefundenen Revisionsnummer. Diese zu ermitteln, erfordert ein rekursives Durchsuchen der Unterordner. Dieser Vorgang läuft in einem separaten Prozess ab, um die Anzeige der Logmeldungen nicht zu verzögern. Aus diesem Grund erscheint die Hervorhebung der Ordnerrevision unter Umständen verzögert.

Subversion 1.5 und neuer speichern die in einem Zweig zusammengeführten Revisionen in einer Eigenschaft des Zweiges ab. Dies ermöglicht es, eine detaillierte Historie von bereits durchgeführten Integrationsschritten zu erhalten. Wenn Sie zum Beispiel eine neue Funktion in einem Zweig entwickeln und die fertige Entwicklung im Stamm zusammenführen, wird das Log für den Stamm nur eine Revision anzeigen, obwohl darin vielleicht 1000 Revisionen des Zweiges enthalten sind.

Abbildung 4.24. Der Log-Dialog mit bereits zusammengeführten Revisionen

Wenn Sie im Detail sehen wollen, welche Revisionen als Teil einer Übertragung integriert wurden, aktivieren Sie die Option Versionen vom Zusammenführen einschließen. Damit werden die Logmeldungen erneut geholt und die Einträge aus den zusammengeführten Revisionen dazwischen sortiert. Zusammengeführte Revisionen werden in grau angezeigt, weil es sich um Änderungen an einem anderen Teil des Baumes handelt.

Datenintegration ist niemals einfach! Während Sie eine Funktion auf dem Zweig entwickeln, werden Sie dort sicher ab und zu Änderungen aus dem Stamm zusammenführen, um mit der Hauptentwicklung synchron zu bleiben. Deshalb wird die Historie des Zweiges eine weitere Ebene an Informationen über Datenintegration enthalten. Diese verschiedenen Ebenen werden durch unterschiedlich tiefe Einrückungen im Log-Dialog angezeigt.

Revisionseigenschaften unterscheiden sich vollständig von den Subversion-Eigenschaften jedes Objekts. Revisionseigenschaften sind mit einer bestimmten Revisionsnummer des Projektarchivs verbundene beschreibende Objekte, zum Beispiel Logmeldung, Datum und Autor der Übertragung.

Manchmal ist es notwendig, eine Logmeldung nachträglich zu ändern. Sei es, weil die Meldung Rechtschreibfehler enthält oder weil Sie die Meldung mit mehr Informationen erweitern müssen oder aus anderen Gründen. Oder Sie müssen den Autor der Revision ändern, weil Sie vielleicht vergessen haben, eine Authentifizierung für Übertragungen auf dem Server einzurichten oder...

Subversion lässt Sie Revisionseigenschaften jederzeit ändern. Aber da solche Änderungen nicht wieder rückgängig gemacht werden können (diese Änderungen werden nicht aufgezeichnet), ist die Funktion standardmäßig deaktiviert. Um diese Funktion zu aktivieren, müssen Sie eine pre-revprop-change-Aktion für das Projektarchiv einrichten. Bitte lesen Sie dazu im Kapitel Hook Scripts des Subversion-Buchs nach, wie das gemacht wird. Lesen Sie auch „Serverseitige Aktionsskripte“, um mehr Informationen über das Einrichten von Aktionen auf einem Windows-PC zu erhalten.

Sobald Sie die gewünschten Aktionsskripte für das Projektarchiv eingerichtet haben, können Sie sowohl den Autor als auch die Logmeldung (oder jede andere Revisionseigenschaft) über das Kontextmenü der Revisionsliste nachträglich ändern. Die Logmeldung selbst kann auch über das Kontextmenü des Textfeldes geändert werden.

Mit Hilfe der Filter am oberen Rand des Log-Dialogs können Sie die Logmeldungen auf diejenigen einschränken, die Sie interessieren. Die Von und Bis ermöglichen es, die Ausgabe auf einen bestimmten Zeitraum zu reduzieren. Die Suchmaske filtert die Meldungen heraus, welche die angegebene Zeichenfolge beinhalten.

Klicken Sie auf das Suchsymbol, um auszuwählen, welche Werte Sie durchsuchen möchten und um die Suche mit regulären Ausdrücken zu aktivieren. Normalerweise benötigen Sie nur eine einfache Textsuche, aber wenn Sie komplexere Suchbegriffe formulieren wollen, können Sie reguläre Ausdrücke verwenden. Wenn Sie mit dem Mauszeiger über das Eingabefeld fahren, erscheint ein Hinweistext zur Textsuche und den regulären Ausdrücken. Der Filter vergleicht Ihren Suchtext mit den Logmeldungen und zeigt nur die Einträge an, die mit dem Suchtext übereinstimmen.

Die einfache Suche nach Teilzeichenfolgen funktioniert ähnlich wie eine Suchmaschine. Zu suchende Zeichenfolgen werden durch Leerzeichen getrennt und alle Zeichenfolgen müssen übereinstimmen. Sie können ein – voranstellen, damit eine bestimmte Teilzeichenfolge nicht gefunden wird (inverse Suche für diesen Begriff). Wenn Sie ein ! voranstellen, wird der gesamte Ausdruck invertiert. Weiterhin können Sie ein + voranstellen, um anzugeben, dass eine Teilzeichenfolge eingeschlossen werden soll, auch wenn sie zuvor mit einem - ausgeschlossen wurde. Beachten Sie, dass die Reihenfolge der Einschließung/Ausschließung hier relevant ist. Anführungszeichen schließen eine Zeichenfolge ein, die Leerzeichen enthält. Wenn Sie ein Anführungszeichen suchen möchten, schreiben Sie zwei Anführungszeichen hintereinander. Beachten Sie, dass der umgekehrten Schrägstrich nicht als Sonderzeichen verwendet wird und keine besonderen Bedeutung bei der einfachen Suche hat. Einige Beispiele erleichtern das Verständnis:

Alice Bob -Eve

sucht nach Zeichenfolgen, die beides, Alice und Bob, aber nicht Eve enthalten.

Alice -Bob +Eve

sucht nach Zeichenfolgen, die Alice, aber nicht Bob enthalten oder die Eve enthalten.

-Fall +SonderFall

sucht nach Zeichenfolgen, die Fall nicht enthalten, aber dennoch Zeichenfolgen, die SonderFall enthalten.

! Alice Bob

sucht nach Zeichenfolgen, die Alice und Bob nicht enthalten.

! -Alice -Bob 

erinnern Sie De Morgan's Theorem? NICHT (nicht Alice und nicht Bob) reduziert sich zu (Alice oder Bob).

"Alice und Bob"

sucht explizit nach „Alice und Bob“.

""

sucht ein doppeltes Anführungszeichen im Text.

"Alice sagt ""Hallo"" zu Bob" 

sucht nach „Alice sagt "Hallo" zu Bob“.

Reguläre Ausdrücke zu erklären würde den Rahmen dieses Handbuchs sprengen, aber Sie finden eine Dokumentation und Anleitung auf http://www.regular-expressions.info/ .

Beachten Sie, dass diese Filter nur auf die bereits heruntergeladenen Meldungen wirken. Sie haben keinen Einfluss darauf, welche Meldungen aus dem Projektarchiv heruntergeladen werden.

Sie können auch die Pfade in der unteren Liste filtern, indem Sie die Option Zeige nur betroffene Pfade nutzen. Betroffene Pfade enthalten den Pfad, für den das Log angezeigt wurde. Wenn sie das Log für einen Ordner anzeigen, heißt dies alle Pfade innerhalb dieses Ordners oder darunter. Bei Dateien betrifft das nur die Datei selbst. Normalerweise zeigt der Log-Dialog alle in der Übertragung enthaltenen Pfade, allerdings in grau. Wenn die Option aktiviert ist, werden die übrigen Pfade ausgeblendet.

Manchmal erfordern es Ihre Arbeitsgewohnheiten, dass Logmeldungen ein bestimmtes Format haben. Dadurch ist unter Umständen der Text, der die Änderungen beschreibt, in der Zusammenfassung von TortoiseSVN nicht sichtbar. Die Eigenschaft tsvn:logsummary kann dazu verwendet werden, einen Teil der Logmeldung zu extrahieren und als Zusammenfassung anzuzeigen. In „TortoiseSVN-Projekteigenschaften“ wird beschrieben, wie die Eigenschaft benutzt wird.

Die Statistiken-Schaltfläche zeigt ein Formular mit interessanten Informationen über die angezeigten Revisionen an. Es zeigt zum Beispiel, wie viele Autoren (Personen, die Übertragungen gemacht haben) am Werk waren, wie viele Übertragungen jeder von ihnen gemacht hat, wöchentlicher Projektfortschritt und vieles mehr. Endlich haben Sie die Möglichkeit, zu überprüfen, wer fleißig am Projekt mitarbeitet und wer hinterherhängt ;-)

Übertragungen per Autor

Abbildung 4.25. Übertragungen per Autor als Histogramm

Dieser Graph zeigt, welche Autoren aktiv am Projekt gearbeitet haben, als einfaches Histogramm, überlagertes Histogramm oder Kuchendiagramm.

Abbildung 4.26. Übertragungen per Autor als Tortendiagramm

Wenn es einige wenige Hauptautoren und viele Autoren mit wenigen Beiträgen gibt, kann die Anzahl der kleinen Segmente den Graphen unleserlich machen. Der Schieber am unteren Rand erlaubt es Ihnen, einen Prozentwert der gesamten Übertragungen als Schwellwert festzulegen, unterhalb dessen die Autoren in der Gruppe Andere zusammengefasst werden.

Die Seite Übertragungen nach Datum

Abbildung 4.27. Das Diagramm Übertragungen nach Datum

Diese Seite zeigt Ihnen eine Zusammenfassung der Projektaktivität in Hinblick auf Übertragungen und Autoren an. Damit können Sie auf einen Blick erkennen, wann und durch wen am Projekt gearbeitet wurde.

Sobald es mehrere Autoren gibt, werden Sie entsprechend viele Linien im Diagramm sehen. Es gibt zwei verschiedene Ansichten: normal, in der die Aktivität eines Autors relativ zur Grundlinie angezeigt wird und gestapelt, bei der die Aktivität eines Autors relativ zur vorherigen Linie angezeigt wird. Die zweite Option vermeidet sich kreuzende Linien, erschwert es aber auch, die Aktivität eines einzelnen Autors zu bewerten.

Standardmäßig wird Groß-/Kleinschreibung bei der Analyse berücksichtigt, sodass PeterEgan und PeteRegan als zwei verschiedene Autoren erkannt werden. In vielen Fällen werden Benutzernamen inkonsistent eingegeben. Deshalb können Sie den Vergleich mit Groß-/Kleinschreibung bei Autoren ignorieren entsprechend anpassen.

Beachten Sie, dass die Statistiken den gleichen Zeitraum wie der Log-Dialog abdecken. Wenn dieser nur eine Revision anzeigt, sagt die Statistik nicht viel aus.

Abbildung 4.28. Der Dialog zum Offline gehen

Wenn der Server nicht erreichbar ist und Sie den Log-Puffer aktiviert haben, können Sie den Log-Dialog und den Revisionsgraphen auch offline benutzen. Dabei werden die Daten aus dem Puffer gelesen, sodass Sie wie gewohnt weiterarbeiten können. Allerdings ist es möglich, dass die angezeigten Informationen veraltet oder unvollständig sind.

Hier haben Sie drei Möglichkeiten:

Die Option Diese Einstellung immer verwenden verhindert, dass der Dialog wieder erscheint und verwendet stets die von Ihnen gewählte Aktion. Sie können die Vorgabe jederzeit über TortoiseSVN → Optionen ändern.

Wenn Sie den Server auf neue Logmeldungen überprüfen wollen, können Sie die Sicht einfach per F5 aktualisieren. Falls Sie den Log-Puffer verwenden (standardmäßig aktiv), wird das Projektarchiv auf neue Meldungen abgefragt und nur diese werden geholt. Falls der Log-Puffer offline war, wird gleichzeitig versucht, ihn wieder online zu schalten.

Falls Sie den Log-Puffer verwenden und denken, dass sich der Inhalt oder der Autor einer Logmeldung geändert haben, können Sie Umschalt+F5 oder Strg+F5 benutzen, um die angezeigten Meldungen erneut vom Server zu holen. Beachten Sie, dass das nur die gerade angezeigten Meldungen betrifft und dass nicht der gesamte Puffer für das Projektarchiv ungültig wird.

Wenn Sie ein externes Vergleichsprogramm konfiguriert haben, können Sie die Umschalt-Taste beim Vergleichen drücken, um das alternative Vergleichsprogramm aufzurufen. Lesen Sie in „Einstellungen für externe Programme“ nach, wie weitere Vergleichsprogramme eingerichtet werden.

Manchmal werden Sie während eines Projektes die Zeilenenden von CRLF auf LF umstellen oder Sie werden die Einrückung eines Abschnitts ändern. Unglücklicherweise wird dadurch eine große Anzahl Zeilen als verändert markiert, obwohl diese Unterschiede die Bedeutung des Programmcodes nicht beeinflussen. Mit den folgenden Optionen können Sie einstellen, wie diese Unterschiede beim Vergleichen behandelt werden sollen. Sie finden die Einstellungen in den Zusammenführen- und Annotieren-Dialogen sowie in den Einstellungen für TortoiseMerge.

Ignoriere Zeilenende schließt Änderungen aus, die nur aus unterschiedlichen Zeilenumbrüchen bestehen.

Vergleiche Leerzeichen umfasst alle Änderungen bei Leerzeichen und Einrückungen als hinzugefügte bzw. gelöschte Zeilen.

Ignoriere Änderungen in Leerzeichen schließt Änderungen in der Anzahl oder dem Typ von Leerzeichen, z. B. Änderung der Einrückung oder Wechsel von Tab zu Leerzeichen aus. Komplett neue oder vollständig gelöschte Leerzeichen werden weiterhin als Änderung angezeigt.

Ignoriere alle Leerzeichen schließt sämtliche Änderungen aus, die nur aus Leerzeichen bestehen.

Selbstverständlich wird jede Zeile mit geänderten Inhalten stets als Differenz angezeigt.

Abbildung 4.29. Der Dialog zum Vergleichen von Revisionen

Wenn Sie zwei Bäume im Projektarchivbetrachter markieren oder wenn Sie zwei Revisionen einer Datei im Log-Dialog wählen, können Sie Kontextmenü → Revisionen vergleichen aufrufen.

Dieser Dialog zeigt eine Liste aller Dateien, die geändert wurden und erlaubt Ihnen, sie mit Hilfe des Kontextmenüs einzeln zu vergleichen oder zu annotieren.

Sie können einen Änderungsbaum exportieren. Das ist nützlich, wenn Sie jemandem Ihre Projektstruktur schicken wollen, die aber nur die geänderten Dateien enthalten soll. Diese Funktion arbeitet nur auf den markierten Dateien. Das bedeutet, dass Sie die gewünschten Dateien - normalerweise alle - markieren und dann per Kontextmenü → Exportiere Auswahl in... in den im folgenden Dialog abgefragten Ort herausschreiben.

Sie können auch die Liste der geänderten Dateien in eine Textdatei herausschreiben, indem Sie Kontextmenü → Speichere Liste der gewählten Dateien in... wählen.

Wenn Sie die Liste der Dateien und der Aktionen (verändert, hinzugefügt, gelöscht) exportieren wollen, können Sie dies mit Kontextmenü → Auswahl in Zwischenablage kopieren erreichen.

Die obere Schaltfläche ermöglicht es Ihnen, die Richtung des Vergleichs festzulegen. Sie können sich die Änderungen anzeigen lassen, um von A nach B zu kommen oder umgekehrt.

Die Schaltflächen mit den Revisionsnummern dienen dazu, einen anderen Revisionsbereich auszuwählen. Wenn Sie den Bereich ändern, wird die Liste der Objekte, die sich darin geändert haben, aktualisiert.

Wenn die Liste der Dateien sehr lang ist, kann sie mit Hilfe des Suchfeldes auf die Dateien mit einer bestimmten Zeichenfolge beschränkt werden. Es wird eine einfache Textsuche durchgeführt. Wenn Sie z. B. nur C-Quelltexte angezeigt haben wollen, geben Sie .c statt *.c ein.

Es gibt viele Programme einschließlich unseres TortoiseMerge, mit denen Unterschiede zwischen Textdateien angezeigt werden können. Wir wollen aber oft auch sehen, wie sich ein Bild geändert hat. Deshalb haben wir TortoiseIDiff entwickelt.

Abbildung 4.30. Ein Programm zum Vergleichen von Bildern

TortoiseSVN → Vergleich für jedes übliche Bildformat wird TortoiseIDiff starten, um die Unterschiede anzuzeigen. In der Standardansicht werden die Bilder nebeneinander dargestellt. Mit der Symbolleiste oder dem Menü können Sie die Bilder auch übereinander darstellen beziehungsweise überlagern. Der Schieber ermöglicht es Ihnen, die Transparenz der Überlagerung einstellen.

Außerdem können Sie die Ansicht vergrößern oder verkleinern und den aktuellen Bildausschnitt mit der Maus verschieben. Wenn Sie Bilder verknüpfen aktivieren, werden die Bewegungssteuerelemente (Rollbalken, Mausrad) der Bilder miteinander verknüpft.

Die Infobox im Bild zeigt Details wie Größe, Auflösung und Farbtiefe des Bildes an. Wenn sie Ihnen im Weg liegt, kann sie mit Ansicht → Bildinformation ausgeblendet werden. Die Bildinformation wird als Hinweistext angezeigt, wenn Sie mit der Maus über den Bildtitel fahren.

Wenn die Bilder überlagert sind, wird die relative Intensität der Bilder (Alpha-Überblendung) durch einen Schieber am linken Rand gesteuert. Sie können direkt auf den Schieber klicken, um einen Wert einzustellen. Sie können den Schieber auf einen bestimmten Wert ziehen oder per Strg+Umschalt-Mausrad einstellen.

Die Schaltfläche oberhalb des Schiebers schaltet zwischen 0 % und 100 % Überblendung um. Wenn Sie die Schaltfläche doppelklicken, wird die Überblendung im Sekundentakt umgeschaltet, bis Sie die Schaltfläche erneut betätigen. Diese Funktion kann ihnen helfen, kleine Änderungen in Bildern zu entdecken.

Manchmal möchten Sie lieber die Unterschiede statt einer Überblendung angezeigt bekommen, z. B., weil Sie das Layout zweier Versionen einer Platine miteinander vergleichen wollen. Wenn Sie die Überblendung deaktivieren, werden stattdessen die Unterschiede durch ein XOR der Bildpunkte hervorgehoben. Änderungen werden dadurch farbig, unveränderte Bereiche weiß dargestellt.

Wenn Sie Nicht-Text-Dokumente vergleichen wollen, müssen Sie normalerweise die Software verwenden, mit der das Dokument erstellt wurde, da diese das Dateiformat kennt. Für die häufig verwendeten Programme Microsoft Office und Open Office existiert in der Tat einige Unterstützung für das Anzeigen von Unterschieden. TortoiseSVN enthält Skripte, die diese mit den richtigen Einstellungen aufrufen, wenn Sie Dateien mit bekannten Erweiterungen vergleichen. Sie können sehen, welche Erweiterungen unterstützt werden und Ihre eigenen hinzufügen, indem Sie TortoiseSVN → Einstellungen klicken und die Erweitert... Seite im Abschnitt Externe Programme aufrufen.

Wenn TortoiseMerge nicht all das kann, was Sie benötigen, versuchen Sie es doch mit einem der vielen Open-Source- oder kommerziellen Programme. Jeder hat seine Lieblingsanwendung und diese Liste ist keinesfalls vollständig, aber hier sind ein paar Beispiele, die Sie sich anschauen sollten:

Lesen Sie „Einstellungen für externe Programme“ für Informationen über die Einrichtung von TortoiseSVN zur Verwendung dieser Werkzeuge.

Die Ausschluss-Muster von Subversion verwenden Platzhalter, eine ursprünglich aus der Unix-Welt stammende Technik, um Dateien oder Ordner zu spezifizieren. Folgende Zeichen haben eine besondere Bedeutung:

Die Platzhaltersuche beachtet Groß-/Kleinschreibung, was unter Windows zu Problemen führen kann. Sie können auf die harte Tour erzwingen, dass Groß-/Kleinschreibung ignoriert wird, indem Sie Buchstabenpaare angeben, um z. B. *.tmp auszuschließen *.[Tt][Mm][Pp].

Eine offizielle Definition für Platzhalterzeichen findet sich in der IEEE für die „Shell Command Language“ im Abschnitt Pattern Matching Notation.

Verwenden Sie TortoiseSVN → Löschen, um Dateien oder Ordner aus der Versionskontrolle zu entfernen.

Wenn Sie mittels TortoiseSVN → Löschen eine Datei oder einen Ordner löschen, wird das Objekt sofort aus Ihrer Arbeitskopie entfernt und markiert, damit es beim nächsten Übertragen aus dem Projektarchiv gelöscht wird. Das überlagerte Symbol des Elternordners zeigt den Status „Verändert“ an. Solange Sie das Löschen noch nicht übertragen haben, können Sie das Objekt mittels TortoiseSVN → Rückgängig auf dem Elternordner wiederherstellen.

Wenn Sie eine Datei oder einen Ordner aus dem Projektarchiv löschen, aber lokal noch als unversioniertes Objekt beibehalten wollen, wählen Sie Erweitertes Kontextmenü → Löschen (lokal erhalten). Sie müssen die Umschalt-Taste gedrückt halten, während Sie einen Rechtsklick auf ein Objekt im rechten Fenster des Explorers machen, um das erweiterte Kontextmenü zu sehen.

Wenn ein Objekt über den Explorer anstelle des TortoiseSVN-Menüs gelöscht wird, zeigt Ihnen der Übertragen-Dialog die fehlenden Objekte an und erlaubt Ihnen, diese aus der Versionskontrolle zu entfernen. Wenn Sie allerdings vorher Ihre Arbeitskopie aktualisieren, wird Subversion die fehlenden Objekte erkennen und durch die aktuelle Version aus dem Projektarchiv ersetzen. Falls Sie ein Objekt löschen wollen, das sich in der Versionskontrolle befindet, müssen Sie dazu TortoiseSVN → Löschen verwenden, damit Subversion nicht raten muss, was Sie wirklich tun wollen.

Wenn Sie eine Datei oder einen Ordner an Ort und Stelle umbenennen wollen, wählen Sie Kontextmenü → Umbenennen.... Sie müssen nur noch den neuen Namen angeben.

Wenn Sie Dateien innerhalb Ihrer Arbeitskopie, zum Beispiel in einen anderen Ordner, verschieben möchten, können Sie ebenfalls die Ziehen und Ablegen-Funktion mit der rechten Maustaste verwenden:

Eine weitere Möglichkeit, Dateien zu kopieren oder zu verschieben, besteht darin, die Kopieren/Ausschneiden-Befehle von Windows zu verwenden. Markieren Sie die gewünschte(n) Datei(en) und rufen Sie per Rechtsklick entweder Kontextmenü → Kopieren oder Kontextmenü → Ausschneiden aus, je nachdem, ob Sie die Objekte kopieren oder verschieben wollen. Dann navigieren Sie zum Zielordner und fügen die Datei(en) per Rechtsklick TortoiseSVN → Einfügen an der gewünschten Stelle ein.

Sie können auch mit Hilfe des Projektarchiv-Betrachters Objekte verschieben. Lesen Sie in „Projektarchivbetrachter“ nach, wie man mit dem Betrachter arbeitet.

Wenn das Projektarchiv bereits zwei Dateien mit gleichem Namen, aber unterschiedlicher Groß-/Kleinschreibung (z. B. TEST.TXT und test.txt) enthält, können Sie diesen Ordner unter Windows nicht mehr aktualisieren oder auschecken. Während Subversion bei Dateinamen Groß-/Kleinschreibung beachtet, wird sie von Windows ignoriert.

Dies passiert manchmal, wenn aus verschiedenen Arbeitskopien Dateien mit dem gleichen Namen, aber unterschiedlicher Groß-/Kleinschreibung, übertragen werden. Eine weitere Möglichkeit sind Übertragungen aus einem Betriebssystem wie Linux, das Groß-/Kleinschreibung berücksichtigt.

In diesem Falle müssen Sie entscheiden, welche der beiden Dateien Sie behalten möchten und die andere Datei aus dem Projektarchiv löschen oder umbenennen.

Manchmal wird Ihre freundliche Entwicklungsumgebung beim Umarbeiten von Projekten Dateien für Sie umbenennen und Subversion nicht davon in Kenntnis setzen. Wenn Sie dann Ihre Änderungen übertragen wollen, zeigt Ihnen Subversion die alte Datei als fehlend und die neue als nicht versioniert an. Sie könnten jetzt einfach die neue Datei übertragen, aber Sie würden dadurch die Historie der Datei verlieren, da Subversion nicht weiß, dass die beiden Dateien zusammenhängen.

Besser ist es, wenn Sie Subversion mitteilen, dass diese Änderung eigentlich eine Umbenennung war. Sie können das in den Übertragen- und Auf Änderung prüfen-Dialogen tun. Markieren Sie einfach beide, die alte (fehlende) und die neue (unversionierte) Datei und wählen Sie Kontextmenü → Umbenennen reparieren, um die beiden Dateien zu einer Umbenennung zusammenzufassen.

Meistens tragen Sie in Ihre Ignorierliste sämtliche generierten Dateien ein, da diese normalerweise von der Versionierung ausgeschlossen werden sollen. Aber was ist, wenn Sie all diese ignorierten Dateien löschen wollen, um Ihr Projekt sauber generieren zu können? Meistens gibt es eine entsprechende Funktion im Makefile, aber falls es noch kein Makefile gibt oder dieses gerade überarbeitet wird, wäre es nützlich, eine Funktion zum Bereinigen der Arbeitskopie zu haben.

TortoiseSVN stellt eine solche Funktion unter Erweitertes Kontextmenü → Unversionierte Objekte löschen... zur Verfügung. Sie müssen die Umschalt-Taste drücken, während Sie einen Rechtsklick auf einen Ordner im rechten Fenster des Explorers machen, um das erweiterte Kontextmenü zu sehen. Daraufhin wird ein Dialog mit sämtlichen nicht versionierten Dateien in Ihrer Arbeitskopie angezeigt, in dem Sie die zu löschenden Objekte auswählen können.

Wenn solche Objekte gelöscht werden, werden sie in den Papierkorb verschoben, sodass Sie eine versehentlich gelöschte Datei, die eigentlich versioniert werden sollte, wiederherstellen können.

Abbildung 4.37. Subversion-Eigenschaftsseite

Sie können die Subversion-Eigenschaften sowohl im Windows-Eigenschaftendialog als auch im Kontextmenü mit TortoiseSVN → Eigenschaften und in Statuslisten mit Kontextmenü → Eigenschaften anzeigen und verändern.

Sie können Ihre eigenen Eigenschaften oder Subversion-Eigenschaften hinzufügen. Diese beginnen alle mit svn:. svn:externals ist solch eine Eigenschaft. Sehen Sie sich „Externe Objekte“ an, um mehr über das Thema zu erfahren.

Um mehr Informationen über Eigenschaften in Subversion zu erhalten, schauen Sie sich das entsprechende Kapitel Eigenschaften im Subversion-Buch an.

Eigenschaften hinzufügen und bearbeiten

Abbildung 4.38. Eigenschaften hinzufügen

Um eine Eigenschaft hinzuzufügen, klicken Sie zunächst auf Neu.... Wählen Sie die gewünschte Eigenschaft aus dem Menü und tragen Sie die benötigten Informationen im entsprechenden Dialog ein. Diese eigenschaftsspezifischen Dialoge sind in „Eigenschaftseditoren“ detailliert beschrieben.

Um eine Eigenschaft hinzuzufügen, die nicht über einen eigenen Dialog verfügt, wählen Sie Erweitert im Menü Neu.... Dann wählen Sie entweder eine existierende Eigenschaft aus dem Kombinationsfeld oder tragen eine eigene Eigenschaft ein.

Wenn Sie eine Eigenschaft für mehrere Objekte gleichzeitig setzen wollen, markieren Sie die Dateien / Ordner im Explorer und wählen Sie Kontextmenü → Eigenschaften.

Wenn Sie die Eigenschaft rekursiv für alle Dateien und Ordner unterhalb des aktuellen Ordners setzen wollen, wählen Sie die Rekursiv-Option.

Um eine Eigenschaft zu verändern, wählen Sie die Eigenschaft in der Liste der existierenden Eigenschaften aus und klicken dann auf Bearbeiten....

Um eine Eigenschaft zu löschen, wählen Sie die Eigenschaft zunächst aus der Liste aus. Klicken Sie anschließend auf Entfernen.

Die svn:externals Eigenschaft kann genutzt werden, um andere Projekte aus dem gleichen oder einem anderen Projektarchiv in die Arbeitskopie einzubinden. Weitere Informationen finden sich in „Externe Objekte“.

Eigenschaften der HEAD-Revision bearbeiten

Da Eigenschaften versioniert sind, können Sie die Eigenschaften der vorherigen Revisionen nicht bearbeiten. Wenn Sie Eigenschaften im Log-Dialog oder aus einer Nicht-HEAD-Revision im Repository-Browser betrachten, sehen Sie eine Liste der Eigenschaften und Werte, aber keine Steuerelemente zum Bearbeiten.

TortoiseSVN besitzt ein paar eigene spezielle Eigenschaften, die mit tsvn: beginnen.

TortoiseSVN kann einige Fehlerverfolgungssysteme in Subversion integrieren. Dies geschieht über Eigenschaften, die mit bugtraq: beginnen. Wie Sie mit diesen Eigenschaften umgehen, ist in „Integration mit einem System zur Fehlerverfolgung“ erklärt.

TortoiseSVN kann auch mit einigen webbasierten Projektarchivbetrachtern unter Verwendung von Eigenschaften, die mit webviewer: beginnen, zusammenarbeiten. Lesen Sie „Integration mit webbasierten Projektarchivbetrachtern“ für weitere Informationen.

Wenn Sie mit TortoiseSVN neue Unterordner zu einer Arbeitskopie hinzufügen, werden sämtliche Projekteigenschaften des Elternordners auf den Unterordner übertragen.

Einige Eigenschaften müssen bestimmte Werte verwenden, oder auf bestimmte Art formatiert sein, damit sie für die Automatisierung verwendet werden. Um Ihnen die Formatierung zu vereinfachen, stellt TortoiseSVN Dialoge für einige Eigenschaften zur Verfügung, die die Auswahlmöglichkeiten anzeigen oder die Eigenschaft in ihre individuellen Komponenten aufbrechen.

Externer Inhalt

Abbildung 4.41. Eigenschaftsseite svn:externals

Die Eigenschaft svn:externals kann genutzt werden, um andere Projekte aus dem gleichen oder einem anderen Projektarchiv in die Arbeitskopie einzubinden. Weitere Informationen finden sich in „Externe Objekte“.

Sie müssen die Subversion-URL des externen Ordners sowie den Namen des Unterordners angeben, als der der externe Ordner ausgecheckt wird. Sie können Externals in der HEAD-Revision auschecken, sodass bei Änderungen am externen Objekt Ihre Arbeitskopie die Änderungen erhält. Wenn Sie allerdings möchten, dass das External auf eine bestimmte Revision verweist, können Sie die zu verwendende Revisionsnummer als fixe Revision mit angeben. Wenn das externe Objekt in der Zukunft umbenannt wird, kann Subversion es in Ihrer Arbeitskopie nicht mehr aktualisieren. Indem Sie eine fixe Revision angeben, teilen Sie Subversion mit, in einer bestimmten Revision (anstelle HEAD) nach dem Objekt mit dem angegebenen Namen zu suchen.

Die Schaltfläche HEAD-Revision finden holt die HEAD-Revision jeder externen URL und zeigt sie in der rechten Spalte an. Nachdem diese Revision bekannt ist, genügt ein einfacher Rechtsklick, um den externen Verweis fest an diese HEAD-Revision zu binden. Wenn die HEAD-Revision noch nicht bekannt ist, wird sie bei einem Rechtsklick zunächst geholt.

SVN-Schlüsselwörter

Abbildung 4.42. Eigenschaftsseite svn:keywords

Wählt die Schlüsselwörter aus, die in der Datei expandiert werden sollen.

Zeilenendestil

Abbildung 4.43. Eigenschaftsseite svn:eol-style

Stellen Sie den von Ihnen gewünschten Zeilenendestil ein und TortoiseSVN wird den korrekten Wert verwenden.

Integration mit Fehlerverfolgungssystemen

Abbildung 4.44. Eigenschaftsseite tsvn:bugtraq

Größen der Logmeldungen

Abbildung 4.45. Eigenschaften der Logmeldungen

These 3 properties control the formatting of log messages. The first 2 disable the OK in the commit or lock dialogs until the message meets the minimum length. The border position shows a marker at the given column width as a guide for projects which have width limits on their log messages. Setting a value to zero will delete the property.

Projektsprache

Abbildung 4.46. Sprach-Eigenschaftsseite

Legt die Sprache für die Rechtschreibprüfung der Logmeldungen im Übertragen-Dialog fest. Die Option Dateilisten wird aktiviert, wenn sie einen Rechtsklick in die Logmeldung machen und Dateiliste einfügen wählen. Standardmäßig wird der Subversion-Status in Ihrer Sprache angezeigt. Wenn diese Option aktiv ist, wird der Status bei Projekten, die nur englische Logmeldungen erfordern, immer auf Englisch eingefügt.

MIME-Typ

Abbildung 4.47. Eigenschaftsseite svn:mime-type

svn:needs-lock

Abbildung 4.48. Eigenschaftsseite svn:needs-lock

This property simply controls whether a file will be checked out as read-only if there is no lock held for it in the working copy.

svn:executable

Abbildung 4.49. Eigenschaftsseite svn:executable

This property controls whether a file will be given executable status when checked out on a Unix/Linux system. It has no effect on a Windows checkout.

Vorlage für Zusammenführen-Log

Jedes Mal, wenn Revisionen zu einer Arbeitskopie zusammengeführt werden, erzeugt TortoiseSVN von allen zusammengeführten Revisionen eine Logmeldung. Diese Meldungen können über die Schaltfläche Letzte Meldungen im Übertragen-Dialog abgerufen werden.

Sie können die generierte Nachricht mit den folgenden Eigenschaften anpassen:

Abbildung 4.50. Eigenschaftsdialog Vorlage für Zusammenführen-Log

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

Diese Eigenschaft definiert den ersten Teil der generierten Protokollmeldung. Die folgenden Schlüsselwörter können verwendet werden:

{revisions}

Eine kommaseparierte Liste der zusammengeführten Revisionen, z. B. 3, 5, 6, 7

{revisionsr}

Wie {revisions}, aber jeder Revision wird ein r vorangestellt, z. B. r3, r5, r6, r7

{revrange}

Eine kommaseparierte Liste der zusammengeführten Revisionen, wenn möglich in Bereiche gruppiert, z. B. 3, 5-7

{mergeurl}

Die Quell-URL des Zusammenführens, d. h., von wo die Revisionen zusammengeführt werden.

Der Standardwert für diese Zeichenfolge ist Revision(en) {Revrange} von {Mergeurl}: mit einem Zeilenumbruch am Ende.

tsvn:mergelogtemplatemsg

Diese Eigenschaft gibt an, wie der Text für jede zusammengeführte Revision aussehen soll. Die folgenden Schlüsselwörter können verwendet werden:

{msg}

Die Logmeldung der zusammengeführten Revision, wie sie eingegeben wurde.

{msgoneline}

Wie {msg}, aber alle Zeilenumbrüche werden durch ein Leerzeichen ersetzt, sodass die ganze Logmeldung auf einer einzigen Zeile angezeigt wird.

{author}

Der Autor der zusammengeführten Revision.

{rev}

Die zusammengeführte Version selbst.

{bugids}

Die Fehler-IDs der zusammengeführten Revision, wenn es welche gibt.

tsvn:mergelogtemplatemsgtitlebottom

Diese Eigenschaft gibt die Position des Titels an, der mittels tsvn:mergelogtemplatetitle oder tsvn:mergelogtemplatereversetitle festgelegt wurde. Wenn die Eigenschaft auf yes oder true gesetzt wird, wird der Titel ans Ende und nicht an den Anfang gesetzt.

Wichtig

Dies funktioniert nur, wenn die zusammengeführten Revisionen bereits im Log-Puffer sind. Wenn Sie den Log-Puffer deaktiviert oder das Log vor dem Zusammenführen nicht angezeigt haben, wird die generierte Meldung keine Informationen über die zusammengeführten Revisionen enthalten.

Nehmen wir an, Sie erstellen eine Arbeitskopie von /projekt1 in D:\dev\projekt1. Markieren Sie den Ordner D:\dev\projekt1, machen Sie einen Rechtsklick und wählen Sie Windows Menü → Eigenschaften aus dem Kontextmenü. Der Windows-Eigenschaftendialog erscheint, auf dessen Subversion-Tab können Sie Eigenschaften anschauen, verändern oder setzen. Klicken Sie auf Eigenschaften.... Im TortoiseSVN-Eigenschaftendialog machen Sie entweder einen Doppelklick auf svn:externals, wenn der Eintrag existiert oder klicken Sie auf Neu... und wählen Sie externals aus dem Menü. Dann füllen Sie den Dialog mit den benötigten Informationen aus.

Wenn der lokale Pfad Leerzeichen oder andere Sonderzeichen enthalten soll, können Sie ihn in doppelte Anführungszeichen setzen oder im Unix-Stil jedem Sonderzeichen einen \ (umgekehrter Schrägstrich) voranstellen. Dies bedeutet auch, dass Sie den normalen Schrägstrich / als Pfadtrennzeichen verwenden müssen. Beachten Sie, dass dieses Verhalten mit Subversion 1.6 eingeführt wurde und mit älteren Clients nicht funktioniert.

Wenn das externe Projekt im selben Projektarchiv befindet, werden alle Änderungen in diesem externen Projekt im Übertragen-Dialog aufgelistet und gemeinsam mit dem Hauptprojekt übertragen.

Wenn sich ein externes Projekt in einem anderen Projektarchiv befindet, werden Sie zwar über Änderungen im externen Projekt informiert, Sie müssen diese jedoch separat übertragen.

Wenn Sie absolute URLs in Ihren svn:externals-Verweisen verwenden und Sie Ihre Arbeitskopie umplatzieren, weil sich z. B. die URL des Projektarchivs ändert, ändern sich die Verweise und funktionieren unter Umständen nicht mehr.

Um solche Probleme zu vermeiden, unterstützen Subversion-Clients ab Version 1.5 relative externe URLs. Es stehen vier verschiedene Methoden zur Verfügung, um externe URLs festzulegen. In den folgenden Beispielen nehmen wir zwei Projektarchive an: Eines in http://example.com/svn/repos-1 und ein weiteres in http://example.com/svn/repos-2. Wir haben http://example.com/svn/repos-1/projekt/trunk in C:\Projekt ausgecheckt und die Eigenschaft svn:externals ist auf trunk gesetzt.

Sie können außerdem eine fixe und eine Arbeitsrevision für die URL angeben, falls erforderlich. Um mehr über fixe und Arbeitsrevisionen zu erfahren, lesen Sie bitte das entsprechende Kapitel im Subversion-Buch.

Wenn sie mehr Informationen brauchen, wie TortoiseSVN Eigenschaften behandelt, lesen Sie „Projekt-Einstellungen“.

Um sich über verschiedene Methoden zum Zugriff auf gemeinsame Unterprojekte zu informieren, lesen Sie „Ein gemeinsames Unterprojekt einbinden“.

Beginnend mit Subversion 1.6 können Sie einzelne externe Dateien unter Verwendung der gleichen Syntax wie für Ordner an Ihre Arbeitskopie binden. Es gibt jedoch ein paar Einschränkungen.

Eine externe Datei verhält sich in den meisten Fällen wie jede andere versionierte Datei, sie kann aber nicht mit den normalen Befehlen gelöscht oder verschoben werden. Stattdessen muss die Eigenschaft svn:externals verändert werden.

Wenn Sie bereits eine Arbeitskopie mit den Dateien oder Ordnern haben, die Sie als Externals in eine andere Arbeitskopie einbinden wollen, können Sie diese einfach per Ziehen und Ablegen im Windows Explorer hinzufügen.

Ziehen Sie einfach das Objekt mit der rechten Maustaste von der einen Arbeitskopie an den Ort, an dem es als External eingebunden werden soll. Ein Kontextmenü erscheint, aus dem Sie die FunktionSVN Als External hier hinzufügen wählen. Dadurch wird die Eigenschaft svn:externals automatisch gesetzt. Alles, was Sie danach tun müssen, ist die geänderte Eigenschaft zu übertragen und Ihre Arbeitskopie zu aktualisieren.

Wenn Sie beim Importieren Ihres Projektes die empfohlene Ordnerstruktur verwendet haben, ist ein Verzweigen oder Markieren sehr einfach:

Abbildung 4.51. Der Verzweigen/Markieren-Dialog

Wählen Sie den Ordner Ihrer Arbeitskopie, von dem Sie einen Zweig oder eine Marke erstellen wollen, und wählen Sie den Befehl TortoiseSVN → Verzweigen/Markieren... im Kontextmenü.

Standardmäßig wird die Ziel-URL mit der Quell-URL Ihrer Arbeitskopie vorbelegt. Sie müssen nun diese URL in den Pfad Ihrer neuen Verzweigung oder Markierung ändern. Anstelle von

http://svn.collab.net/repos/ProjektName/trunk

könnte sie wie folgt lauten:

http://svn.collab.net/repos/ProjektName/tags/Version_1.10

Wenn Sie sich nicht mehr daran erinnern, welchen Namen Sie zuletzt vergeben hatten, klicken Sie einfach auf die rechte Schaltfläche. Damit öffnet sich der Projektarchivbetrachter und Sie können sich die Struktur des Projektarchivs ansehen.

Nun haben Sie mehrere Möglichkeiten, die Quelle der Kopie auszuwählen:

Wenn Sie wollen, dass Ihre Arbeitskopie sofort zum neuen Zweig/Marke wechselt, aktivieren Sie die Option Arbeitskopie zum neuen Zweig/Marke wechseln. Wenn Sie das tun, stellen Sie bitte vorher sicher, dass Ihre Arbeitskopie keine Änderungen enthält. Wenn sie Änderungen enthält, werden diese beim Wechseln mit dem Zweig zusammengeführt.

Falls Ihre Arbeitskopie weitere mittels svn:externals eingebundene Projekte enthält, werden diese am Ende des Dialogs aufgelistet. Für jedes externe Ziel wird der Pfad und die Quell-URL angezeigt.

Wenn Sie sicherstellen möchten, dass die neue Marke sich immer in einem konsistenten Zustand befindet, sorgen Sie dafür, dass die Revisionen aller Externals fixiert werden. Sollten Sie das nicht tun und die Externals zeigen auf eine HEAD-Revision, die sich ja in der Zukunft ändern könnte, so wird beim Auschecken der neuen Marke die HEAD-Revision des Externals ausgecheckt und Ihre Marke lässt sich unter Umständen nicht mehr übersetzen. Es ist also immer eine gute Idee, die Externals beim Anlegen einer Marke auf eine fixe Revision zu setzen.

Die Externals werden, abhängig von der Quelle der Markierung, entweder automatisch an der aktuelle HEAD-Revision des Projektarchivs oder die BASE-Revision der Arbeitskopie fixiert:

Klicken Sie OK, um die neue Kopie in das Projektarchiv zu übertragen und vergessen Sie dabei nicht, eine Logmeldung anzugeben. Beachten Sie, dass diese Kopie innerhalb des Projektarchivs angelegt wird.

Beachten Sie, dass das Anlegen eines Zweiges oder einer Marke sich nicht auf Ihre Arbeitskopie auswirkt, es sei denn, Sie haben die Option zum Wechseln auf den Zweig gleich mit aktiviert. Auch wenn Sie den Zweig aus der Arbeitskopie heraus erstellen, werden die Änderungen darin in den neuen Zweig übertragen und nicht in den Stamm. Die geänderten Dateien Ihrer Arbeitskopie bleiben als gegenüber dem Stamm verändert markiert.

Sie können einen Zweig oder eine Marke ohne eine Arbeitskopie zu erstellen. Dazu öffnen Sie zunächst den Projektarchivbetrachter. Dort können Sie Ordner an einen neuen Platz ziehen und ablegen. Dabei müssen Sie die Strg-Taste gedrückt halten, um eine Kopie zu erstellen. Andernfalls wird der Ordner nur verschoben und nicht kopiert.

Alternativ können Sie einen Ordner mit gedrückter rechter Maustaste ziehen und ablegen. Sobald Sie die Maustaste loslassen, können Sie per Kontextmenü wählen, ob der Ordner verschoben oder kopiert werden soll. Zum Erstellen eines Zweiges oder einer Marke müssen Sie den Ordner kopieren.

Eine weitere Möglichkeit dazu besteht im Log-Dialog. Lassen Sie sich das Log anzeigen, markieren eine Revision in der Liste und wählen Kontextmenü → Erstelle Zweig/Marke von Revision.

...das ist hier (eigentlich nicht) die Frage. Während beim Auschecken eine neue Arbeitskopie (z. B. des neu erstellten Zweiges) erstellt wird, verändert der Befehl TortoiseSVN → Wechseln zu... Ihre bestehende Arbeitskopie so, dass diese genau wie der erstellte Zweig aussieht. Dabei werden nur die Unterschiede zwischen Ihrer bestehenden Arbeitskopie und dem Zweig des Projektarchivs übertragen, was sich natürlich günstig auf die Netzwerkauslastung und Ihre Geduld auswirkt. :-)

Es gibt mehrere Möglichkeiten, mit Ihrer neuen Verzweigung oder Markierung weiterzuarbeiten. Sie können:

Abbildung 4.52. Der Wechseln-Zu-Dialog

Obwohl Subversion keine Unterscheidung zwischen tags und branches macht, werden sie normalerweise unterschiedlich genutzt.

Abbildung 4.53. Der Assistent - Revisionsbereich wählen

Im Feld Von: geben Sie die URL des Zweiges an, der die Änderungen enthält, die Sie mit der Arbeitskopie zusammenführen möchten. Sie können auch auf ... klicken, um den gewünschten Zweig zu finden. Wenn Sie bereits Änderungen aus diesem Zweig zusammengeführt haben, finden Sie den Namen in der Liste der bereits benutzten URLs.

Wenn sie von einem umbenannten oder gelöschten Zweig zusammenführen möchten, müssen Sie zu einer Revision zurückgehen, in der dieser Zweig noch existierte. In diesem Fall müssen Sie die entsprechende Revision als fixe Revision im Bereich der zusammenzuführenden Revisionen angeben (siehe unten). Andernfalls wird das Zusammenführen fehlschlagen, wenn der Pfad in der HEAD-Revision nicht gefunden wird.

Geben Sie den zusammenzuführenden Revisionsbereich in das Feld Revisionsbereich ein. Das kann eine einzelne Revision, eine durch Kommata getrennte Liste von Revisionen, ein durch Bindestrich getrennter Revisionsbereich oder eine Kombination aus allem sein.

Wenn Sie eine fixe Revision für das Zusammenführen benötigen, geben Sie diese am Ende der Revisionen an, z. B.5-7,10@3. In diesem Beispiel werden die Revisionen 6,5,7 und 10 zusammengeführt, wobei 3 die fixe Revision darstellt.

Der einfachste Weg, um den Revisionsbereich zu wählen, ist ein Klick auf Zeige Log. Dies zeigt Ihnen die letzten Änderungen inklusive der Logmeldungen an. Wenn Sie nur die Änderungen einer einzelnen Revision benötigen, wählen Sie die gewünschte Revision. Wenn Sie einen Revisionsbereich benötigen, wählen Sie diesen mit gedrückter Umschalt-Taste aus. Klicken Sie auf OK und die Liste der zusammenzuführenden Revisionsnummern wird für Sie ausgefüllt.

Wenn Sie bereits übertragene Änderungen rückgängig machen wollen, erreichen Sie das, indem Sie den gewünschten Revisionsbereich Rückwärts zusammenführen. Dadurch werden die Änderungen dieses Revisionsbereichs aus Ihrer Arbeitskopie entfernt.

Wenn Sie bereits Änderungen aus diesem Zweig zusammengeführt haben, so haben Sie hoffentlich auch in der Logmeldung notiert, welche Revisionen das waren. In diesem Fall können Sie einfach mit Hilfe der Zeige Log Schaltfläche nachschauen. Verwenden Sie die Endrevision des letzten Zusammenführens als Startrevision der geplanten Aktion. Wenn Sie zum Beispiel zuletzt die Revisionen 37 bis 39 mit Ihrer Arbeitskopie zusammengeführt haben, sollte die Startrevision für die aktuelle Aktion 40 sein.

Neuere Versionen von Subversion protokollieren die bisher durchgeführten Datenintegrationen mit. Deshalb müssen Sie sich nicht merken, welche Revisionen Sie bereits zusammengeführt haben. Wenn Sie den Revisionsbereich leer lassen, werden alle bisher noch nicht integrierten Revisionen ausgewählt. Lesen Sie in „Verfolgung der Datenintegration“, wie das funktioniert.

Wenn die zusammengeführten Revisionen aufgezeichnet wurden, zeigt der Log-Dialog bereits zusammengeführte Revisionen und Revisionen, die vor dem gemeinsamen Vorfahren liegen, d. h., bevor der Zweig angelegt wurde, ausgegraut an. Die Option Nicht zusammenführbare Revisionen ausblenden erlaubt Ihnen, diese Revisionen vollständig herauszufiltern, sodass Sie nur die Revisionen sehen, die zusammengeführt werden können.

Wenn außer Ihnen noch andere Personen Daten in das Projektarchiv übertragen, seien Sie vorsichtig bei der Verwendung der HEAD-Revision. Diese entspricht eventuell nicht der Revision, die Sie erwarten, weil seit Ihrer letzten Aktualisierung jemand anderes Daten übertragen haben könnte.

Wenn Sie den Revisionsbereich leer lassen oder die Option Alle Revisionen markiert haben, wird Subversion alle bisher noch nicht zusammengeführten Revisionen verwenden. Dies wird als Reintegrieren bzw. automatisches Zusammenführen bezeichnet.

Um einen Zweig wieder eingliedern zu können, müssen einige Bedingungen erfüllt sein. Zunächst muss der Server die Verfolgung der Datenintegration unterstützen. Die Tiefe der Arbeitskopie muss unendlich sein (keine spärliche Arbeitskopie) und sie darf weder lokale Änderungen noch Objekte auf einer anderen URL oder einer anderen Revision als HEAD enthalten. Alle Änderungen am Stamm während der Entwicklung des Zweiges müssen in den Zweig übertragen worden sein (oder als übertragen markiert worden sein). Der Bereich der zusammenzuführenden Revisionen wird dann automatisch berechnet.

Klicken Sie auf Weiter und gehen Sie zu „Optionen beim Zusammenführen“.

Abbildung 4.54. Der Assistent - Zusammenführen von Bäumen

Um mit dieser Methode einen Funktionszweig mit dem Stamm zusammenzuführen, müssen Sie den Assistenten aus einer Arbeitskopie des Stamms starten.

Im Von:-Feld geben Sie die URL des Stammes (trunk) an. Dies mag Ihnen jetzt vielleicht falsch vorkommen, aber bedenken Sie, dass der Stamm der Ausgangspunkt ist, von dem aus Sie die Änderungen des Funktionszweiges zusammenführen möchten. Sie können auch auf ... klicken, um die URL besser zu finden.

Im Bis:-Feld geben Sie die vollständige URL des Zweiges an.

Sowohl im Feld Von Revision als auch im Feld Bis Revision geben Sie die letzte Revision an, in der die beiden Zweige synchron waren. Wenn Sie sicher sind, dass niemand anders seit Ihrer letzten Synchronisation eine Übertragung gemacht hat, können Sie in beiden Feldern die HEAD-Revision angeben. Falls jedoch in der Zwischenzeit die Möglichkeit einer Übertragung besteht, geben Sie die letzte Revision Ihrer Synchronisation an.

Sie können auch auf Zeige Log klicken, um die Revision zu wählen.

Auf dieser Seite des Assistenten können Sie weitere Optionen angeben, bevor Sie das Zusammenführen starten. In den meisten Fällen können Sie die Standardeinstellungen verwenden.

Sie können die Tiefe für das Zusammenführen festlegen, das heißt, wie weit das Zusammenführen in Ihre Arbeitskopie herabsteigen soll. Die Tiefendefinitionen sind in „Rekursionstiefe“ beschrieben. Die Vorgabe ist Arbeitskopie, was den aktuell eingestellten Wert verwendet und meistens korrekt sein wird.

Meistens möchten Sie, dass die Historie der Dateien berücksichtigt wird, sodass Änderungen relativ zu einem gemeinsamen Vorgänger zusammengeführt werden. Manchmal möchten Sie aber auch Dateien zusammenführen, zwischen denen eine Beziehung besteht - allerdings nicht in Ihrem Projektarchiv. Sie haben zum Beispiel Versionen 1 und 2 einer externen Bibliothek in zwei verschiedene Verzeichnisse importiert. Obwohl zwischen diesen ein logischer Zusammenhang besteht, weiß Subversion nichts davon, weil es nur die separat importierten Dateibäume sieht. Wenn Sie versuchen, die Unterschiede zwischen den beiden Versionen zusammenzuführen, sehen Sie ein vollständiges Entfernen gefolgt von einem vollständigen Hinzufügen. Damit Subversion nur pfadbasierte Differenzen anstelle von vergangenheitsbasierten Differenzen erzeugt, wählen Sie die Option Vorfahren ignorieren. Weitere Informationen zu diesem Thema finden Sie im Subversion-Buch in Die Abstammung berücksichtigen oder ignorieren.

Sie können festlegen, wie Änderungen an Zeilenumbrüchen und Leerzeichen behandelt werden sollen. Diese Optionen sind in „Zeilenende- und Leerzeichenoptionen“ beschrieben. Die Vorgabe ist, dass alle Zeilenenden- und Leerzeichenänderungen als echte zusammenzuführende Änderungen behandelt werden.

Die Option Zusammenführen erzwingen dient dazu, Baumkonflikte zu vermeiden, wenn durch ein eingehendes Löschen eine veränderte oder nicht versionierte lokale Datei betroffen ist. Wenn dadurch die Datei gelöscht wird, kann sie nicht im Ursprungszustand wiederhergestellt werden, weshalb die Option standardmäßig deaktiviert ist.

Wenn Sie Ihre Datenintegrationsschritte verfolgen und eine Revision als zusammengeführt markieren wollen, ohne die Daten wirklich zusammenzuführen, aktivieren Sie die Option Zusammenführen nur aufzeichnen. Es gibt mehrere Gründe, dies zu tun. Zum Beispiel könnten die zusammenzuführenden Änderungen zu komplex für den Algorithmus sein, sodass Sie die Daten von Hand integrieren und die Revisionen als zusammengeführt markieren, damit die Änderungsverfolgung darüber informiert ist. Oder Sie möchten verhindern, dass eine bestimmte Revision zusammengeführt werden kann. Clients, die die Verfolgung der Datenintegration bereits beherrschen, werden diese Revision dann überspringen.

Nun, da alles vorbereitet ist, müssen Sie nur noch auf Zusammenführen klicken. Wenn Sie eine Vorschau der Ergebnisse wünschen, können Sie einen Trockenlauf durchführen, der das Zusammenführen lediglich simuliert und die Arbeitskopie nicht verändert. Eine Liste der veränderten Dateien und der eventuell resultierenden Konflikte wird angezeigt. Da die Protokollierung der Datenintegration das Zusammenführen weiter verkompliziert, gibt es kein sicheres Verfahren, im Vorhinein festzustellen, wo Konflikte auftreten. Dadurch kann es vorkommen, dass beim Trockenlauf als konfliktbehaftet markierte Dateien sich in Wirklichkeit problemlos zusammenführen lassen.

Der Fortschrittsdialog zeigt nun jeden Schritt des Zusammenführens mit den betroffenen Revisionen an. Eventuell wird hier eine Revision mehr als von Ihnen erwartet angezeigt. So wird zum Beispiel, wenn Sie die Revision 123 zusammenführen, im Fortschrittsdialog „Zusammenführen von Revisionen 122 bis 123“ angezeigt. Das Zusammenführen ist mit dem Vergleichen verwandt. Der Prozess erzeugt eine Liste von Änderungen zwischen zwei Punkten im Projektarchiv und wendet diese Änderungen auf Ihre Arbeitskopie an. Der Fortschrittsdialog zeigt lediglich den Start- und Endpunkt der Differenzbildung an.

Das Zusammenführen ist nun beendet. Es ist eine gute Idee, wenn Sie sich das Ergebnis anschauen und prüfen, ob es Ihren Erwartungen entspricht. Datenintegration ist normalerweise eine komplizierte Sache. Konflikte können auftreten, wenn der Zweig sich zu weit vom Stamm entfernt hat.

Bei Subversion-Clients vor Version 1.5 müssen Informationen über zusammengeführte Revisionen von Hand protokolliert werden. Wenn Sie die Änderungen überprüft haben und diese nun übertragen möchten, beachten Sie, dass die Logmeldung dieser Übertragung immer die bereits zusammengeführten Revisionsnummern enthalten sollte. Wenn Sie später erneut Revisionen zusammenführen möchten/müssen, werden Sie froh sein zu wissen, was alles Sie bereits zusammengeführt haben und was nicht. Denn wenn Sie eine Revision ein weiteres Mal zusammenführen, würde dies zwingend zu einem Konflikt führen. Für genauere Informationen lesen Sie bitte Best Practices for Merging im Subversion-Buch.

Wenn Ihr Server und alle Clients unter Subversion 1.5 oder neuer laufen, wird die Protokollierung der Datenintegration sämtliche zusammengeführten Revisionen aufzeichnen und verhindern, dass eine Revision mehr als einmal integriert wird. Das vereinfacht Ihre Arbeit ungemein, da sie nun jedes Mal den gesamten Revisionsbereich wählen können und sichergestellt ist, dass nur neue Revisionen wirklich zusammengeführt werden.

Das Verwalten von Zweigen ist wichtig. Wenn Sie Ihren Zweig stets mit dem Stamm synchron halten wollen, stellen Sie sicher, dass Sie Änderungen häufig zusammenführen, damit Stamm und Zweig nicht zu weit auseinanderdriften. Wie bereits erklärt, sollten Sie wiederholtes Zusammenführen der gleichen Änderungen vermeiden.

Mit Subversion 1.5 wurden Möglichkeiten zur Verfolgung der Datenintegration eingeführt. Wenn Sie Änderungen von einem Baum in einem anderen zusammenführen, werden die entsprechenden Revisionsnummern gespeichert. Diese Information kann für weitere Zwecke herangezogen werden.

Die zusammengeführten Revisionen und Pfade werden durch den Subversion-Client beim Zusammenführen in der Eigenschaft svn:mergeinfo abgespeichert. Sobald die Änderungen übertragen wurden, speichert der Server sie in einer Datenbank. Wenn jetzt Logdaten, Annotierungen oder Zusammenführen angefordert werden, kann der Server entsprechend reagieren. Damit das System korrekt arbeitet, müssen Sie sicherstellen, dass der Server, das Projektarchiv und alle Clients aktualisiert werden. Ältere Clients füllen die svn:mergeinfo nicht aus und ältere Server beantworten die Anfragen neuerer Clients nicht.

Lesen Sie mehr über die Verfolgung der Datenintegration in Subversions Merge tracking documentation.

Zusammenführen geht nicht immer glatt. Manchmal gibt es einen Konflikt, der aufgelöst werden muss. TortoiseSVN hilft Ihnen mit dem Konfliktdialog bei diesem Vorgang.

Abbildung 4.55. Der Zusammenführen-Konfliktdialog

Es ist wahrscheinlich, dass einige der Änderungen reibungslos zusammengeführt wurden, während andere lokale Änderungen mit Änderungen in Konflikt stehen, die bereits im Projektarchiv festgeschrieben wurden. Alle Änderungen, die zusammengeführt werden können, werden zusammengeführt. Das Dialogfeld "Konflikt zusammenführen" bietet Ihnen verschiedene Möglichkeiten, mit den konfliktbehafteten Zeilen umzugehen.

Für normale Konflikte, die vom Inhalt der Datei oder ihrer Eigenschaften ausgelöst werden, zeigt der Dialog Schaltflächen, die es erlauben zu wählen, welche der konfliktbehafteten Teile behalten oder verworfen werden sollen.

Wenn es einen Baumkonflikt gibt, siehe „Baumkonflikte“ bezüglich der verschiedenen Arten von Baumkonflikten und wie und warum sie auftreten können.

Um Baumkonflikte nach dem Zusammenführen aufzulösen, wird ein Dialog mit verschiedenen Optionen zum Lösen des Konflikts angezeigt.

Abbildung 4.56. Der Dialog zum Zusammenführen von Baumkonflikten

Weil es unterschiedliche Möglichkeiten gibt, Baumkonflikte zu lösen, zeigt der Dialog abhängig vom konkreten Konflikt unterschiedliche Schaltflächen. Der Text der Schaltflächen und Tooltipps erklärt, was die jeweilige Schaltfläche tut, um den Konflikt zu lösen. Wenn Sie unsicher sind, brechen Sie entweder den Dialog ab oder Sie benutzen die Schaltfläche später, um den Konflikt später zu lösen.

Wenn Sie eine neue Funktion in einem separaten Zweig entwickeln, ist es eine gute Idee, sich rechtzeitig eine Richtlinie zu überlegen, wie diese Funktion in die Hauptentwicklungslinie zurückintegriert wird. Wenn gleichzeitig in trunk weiter entwickelt wird, können die Unterschiede mit der Zeit bedeutend werden und die Rückintegration zu einem Alptraum machen.

Falls die Funktion relativ einfach ist und keine längere Zeit in Anspruch nehmen wird, können Sie den einfachen Ansatz wählen und auf dem Zweig solange separat entwickeln, bis die Funktion komplett ist und dann zurück integrieren. Im Assistenten wäre dies eine einfache Einen Revisionsbereich zusammenführen-Aktion, mit dem Revisionsbereich des Zweiges als Parameter.

Wenn die Entwicklung länger dauern wird und Sie Änderungen in trunk berücksichtigen müssen, sollten Sie den Zweig synchron halten. Das bedeutet, dass Sie periodisch Änderungen an trunk in den Zweig integrieren, sodass der Zweig alle Änderungen an trunk plus die neue Funktion enthält. Beim Synchronisationsvorgang verwenden Sie Einen Revisionsbereich zusammenführen. Sobald die Funktion komplett ist, können Sie die Änderungen entweder per Einen Zweig wieder eingliedern oder Zwei verschiedene Bäume zurück integrieren.

Eine andere (schnelle) Methode, um Änderungen vom Stamm in den Entwicklerzweig zu übertragen, ist TortoiseSVN → Alles zusammenführen... aus dem erweiterten Kontextmenü. Halten Sie die Umschalt-Taste gedrückt, während Sie einen Rechtsklick auf die Datei machen.

Abbildung 4.57. Der Alles-Zusammenführen-Dialog

Dieser Dialog ist sehr einfach. Sie müssen lediglich die in „Optionen beim Zusammenführen“ beschriebenen Optionen einstellen. Der Rest wird mit Hilfe der protokollierten Integration automatisch von TortoiseSVN erledigt.

In der Grundeinstellung sind keine Objekte gesperrt und jeder, der die entsprechende Berechtigung hat, kann seine Änderungen in das Projektarchiv übertragen. Andere werden Ihre Arbeitskopien regelmäßig aktualisieren und Änderungen im Projektarchiv werden mit den lokalen Änderungen zusammengeführt.

Wenn Sie für eine Datei Eine Sperre holen, können nur Sie Änderungen an dieser Datei übertragen. Übertragungen von anderen werden solange verhindert, bis Sie die Sperre wieder freigeben. Eine gesperrte Datei kann in keiner Weise im Projektarchiv verändert, umbenannt oder gelöscht werden. Dies ist nur dem Eigner der Sperre möglich.

Andere Anwender werden nicht unbedingt wissen, dass Sie eine Datei gesperrt haben. Wenn sie nicht regelmäßig den Sperrstatus überprüfen, werden sie es frühestens merken, wenn ihre Übertragung fehlschlägt, was in den meisten Fällen nicht sehr nützlich ist. Damit es einfacher ist, Sperren zu verwalten, gibt es die neue Eigenschaft svn:needs-lock von Subversion. Wenn diese Eigenschaft (auf einen beliebigen Wert) gesetzt ist, wird beim Auschecken oder Aktualisieren die Datei in der Arbeitskopie mit einem Schreibschutz versehen, es sei denn, die Arbeitskopie besitzt die Sperre für die Datei. Dies dient als Warnung, dass Sie die Datei nicht bearbeiten sollen, bevor Sie nicht die Sperre für die Datei besitzen. Dateien unter Versionskontrolle, die mit Schreibschutz versehen sind, erhalten von TortoiseSVN ein überlagertes Symbol, das anzeigt, dass Sie erst eine Sperre holen müssen, bevor Sie die Datei bearbeiten.

Sperren gehören sowohl zu einer Arbeitskopie als auch zu einer Person. Wenn Sie mehrere Arbeitskopien desselben Projekts (bei der Arbeit, daheim) haben, können Sie eine Datei nur in einer dieser Arbeitskopien sperren.

Wenn einer Ihrer Kollegen eine Datei sperrt und in Urlaub geht, ohne die Sperre vorher freizugeben, was dann? Subversion bietet Ihnen eine Möglichkeit, Sperren auszuhebeln. Eine Sperre freizugeben, die jemand anders besitzt, wird auch Sperre aufbrechen genannt. Sich eine Sperre zu holen, die jemand anders besitzt, wird auch Sperre stehlen genannt. Selbstverständlich sollten Sie dies nicht leichtfertig tun, wenn Sie sich weiterhin mit Ihren Kollegen gut stellen wollen.

Sperren werden im Projektarchiv verwaltet und eine Sperrmarke wird zusätzlich in Ihrer Arbeitskopie angelegt. Wenn es einen Unterschied zwischen diesen Werte gibt, weil zum Beispiel jemand eine Sperre aufgebrochen hat, wird die lokale Sperrmarke ungültig. Der Sperrstatus im Projektarchiv ist stets maßgeblich.

Markieren Sie die Datei(en) in Ihrer Arbeitskopie, für die Sie eine Sperre erhalten möchten und wählen Sie TortoiseSVN → Sperre holen....

Abbildung 4.58. Der Sperren-Dialog

Ein Dialog erscheint, in dem Sie einen Sperrkommentar eingeben können, damit andere wissen, warum Sie die Datei für sich reservieren. Der Kommentar ist optional und wird derzeit nur bei svnserve-basierten Projektarchiven genutzt. Wenn (und nur wenn) Sie eine Sperre von jemand anderem stehlen wollen, aktivieren Sie die Option Sperren stehlen, bevor Sie auf OK klicken.

Sie können die Projekteigenschaft tsvn:logtemplatelock setzen, um den Anwendern eine Schablone zum Erfassen der Sperrmeldung anzubieten. Lesen Sie in „Projekt-Einstellungen“ nach, wie Eigenschaften gesetzt werden.

Wenn Sie einen Ordner markieren und TortoiseSVN → Sperre Holen... aufrufen, wird der Sperr-Dialog mit jeder Datei in jedem zum Sperren ausgewählten Unterordner geöffnet. Wenn Sie wirklich eine ganze Ordnerstruktur sperren wollen, ist das der richtige Weg, es zu erreichen. Sie können sich damit allerdings bei Ihren Kollegen sehr unbeliebt machen, wenn Sie diese aus dem gesamten Projekt aussperren ...

Um sicherzustellen, dass Sie nicht vergessen, Sperren freizugeben, werden gesperrte Dateien im Übertragen-Dialog angezeigt und sind standardmäßig gewählt. Wenn Sie die Übertragung durchführen, werden die Sperren der markierten Dateien freigegeben, auch wenn die Dateien selbst sich nicht geändert haben. Wenn Sie die Dateisperren nicht freigeben wollen, können Sie die entsprechenden Dateien abwählen, vorausgesetzt, dass sie nicht modifiziert sind. Wenn Sie die Sperre für veränderte Dateien behalten wollen, müssen Sie vor der Übertragung die Option Sperren behalten aktivieren.

Um eine Sperre von Hand freizugeben, markieren Sie die gewünschten Datei(en) in Ihrer Arbeitskopie und wählen Sie TortoiseSVN → Sperre freigeben. TortoiseSVN wird das Projektarchiv kontaktieren und die Sperren dort freigeben. Sie können diesen Befehl auch für einen Ordner aufrufen, um alle Sperren rekursiv freizugeben.

Abbildung 4.59. Der Dialog „Prüfe auf Änderungen“

Um zu sehen, welche Sperren Sie oder andere Personen besitzen, können Sie TortoiseSVN → Prüfe auf Änderungen... aufrufen. Lokale Sperren werden sofort angezeigt. Damit Sie sehen können, welche Sperren von anderen gehalten werden und um festzustellen, ob Ihre Sperren aufgebrochen oder gestohlen wurden, müssen Sie Projektarchiv prüfen wählen.

Aus dem Kontextmenü dieses Dialogs heraus können Sie Sperren holen oder freigeben und auch Sperren von anderen stehlen oder aufbrechen.

Wie bereits erwähnt, ist der einfachste Weg, Sperren zu verwenden, die Eigenschaft svn:needs-lock auf Dateien zu setzen. Lesen Sie „Projekt-Einstellungen“, um zu erfahren, wie man Eigenschaften setzt. Dateien mit dieser Eigenschaft werden beim Aktualisieren und Auschecken stets mit einem Schreibschutz versehen, wenn die Arbeitskopie keine Sperre für die Datei besitzt.

Als Erinnerung zeigt TortoiseSVN dieses Symbol dafür an.

Wenn Sie ein Entwicklungsverfahren nutzen, das stets Dateisperren erfordert, ist es einfacher, die Subversion-Eigenschaft auto-props zu nutzen, um die Dateieigenschaften automatisch zu setzen, sobald Sie Dateien zum Projektarchiv hinzufügen. Lesen Sie „Eigenschaften automatisch setzen“ für weitere Information.

Wenn Sie ein neues Projektarchiv mit Subversion 1.2 anlegen, werden vier Schablonen für Aktionsskripte im hooks-Verzeichnis des Projektarchivs angelegt. Diese Aktionsskripte werden aufgerufen, bevor und nachdem eine Sperre geholt bzw. freigegeben wird.

Es ist eine gute Idee, ein post-lock- und ein post-unlock-Aktionsskript auf dem Server zu installieren, die eine Benachrichtigungs-E-Mail verschicken. Mit solch einem Skript können alle betroffenen Personen darüber informiert werden, wenn eine Datei gesperrt wurde. Sie finden das Beispielskript hooks/post-lock.tmpl in Ihrem Projektarchiv.

Vielleicht möchten Sie mit Aktionsskripten auch verhindern, dass jemand Sperren stiehlt oder aufbricht oder Sie möchten diese Möglichkeit auf Administratoren beschränken. Sie können mit einem Skript auch den Eigner der Sperre per E-Mail darüber informieren, wenn seine Sperre gestohlen wurde.

Lesen Sie „Serverseitige Aktionsskripte“ für weitere Informationen.

Zunächst müssen Sie Ihre Änderungen selbstverständlich selber testen. Statt den übergeordneten Ordner zum Projektarchiv zu TortoiseSVN → Übertragen..., wählen Sie TortoiseSVN → Patch erzeugen...

Abbildung 4.60. Der „Erzeuge Patch“-Dialog

Sie können nun die Dateien auswählen, die in den Patch aufgenommen werden sollen, genau wie bei einer vollständigen Übertragung. Dadurch wird eine einzige Datei erzeugt, die eine Zusammenfassung aller Änderungen enthält, die Sie seit der letzten Aktualisierung an den ausgewählten Dateien aus dem Projektarchiv vorgenommen haben.

Die Spalten in diesem Dialog können, genau wie im Auf Änderungen prüfen-Dialog, angepasst werden. Lesen Sie in „Prüfe auf Änderungen“ nach, wie das geht.

Durch Klicken auf die Schaltfläche Optionen können Sie festlegen, wie der Patch erstellt wird. Sie können z. B. angeben, dass Änderungen bei Zeilenenden oder Leerzeichen nicht in die endgültige Patch-Datei eingeschlossen werden sollen.

Sie können separate Patches für die verschiedenen Änderungen an den Dateien erzeugen. Wenn Sie jedoch eine Patchdatei erstellen, dann weitere Änderungen an denselben Dateien vornehmen und eine weitere Patchdatei erstellen, wird die zweite Patchdatei beide Sätze von Änderungen enthalten.

Speichern Sie die Datei unter einem Namen Ihrer Wahl. Patchdateien können jede beliebige Dateiendung haben. Eine Konvention ist jedoch, .patch dafür zu verwenden. Nun sind Sie soweit. Sie können Ihre Patchdatei an die Entwickler schicken.

Sie können den Patch auch in der Zwischenablage statt einer Datei speichern, zum Beispiel, weil Sie den Patch per E-Mail zur Begutachtung weiterschicken wollen. Auch wenn sie zwei Arbeitskopien auf einem Rechner haben und gezielt Änderungen von einer in die andere übertragen wollen, ist ein Patch in der Zwischenablage der bequemste Weg.

Wenn Sie es vorziehen, können Sie eine Patchdatei innerhalb des Übertragen- oder des Auf Änderungen prüfen-Dialogs erstellen. Wählen Sie einfach die Dateien und erzeugen Sie per Kontextmenü einen Patch für diese Dateien. Wenn Sie die Optionen verändern wollen, halten Sie die Umschalt-Taste während des Rechtsklicks gedrückt.

Patchdateien werden stets innerhalb Ihrer Arbeitskopie angewendet. Dies muss innerhalb desselben Ordners durchgeführt werden, in dem die Patchdatei erstellt wurde. Wenn Sie nicht genau wissen, welcher Ordner das war, schauen Sie in die erste Zeile der Patchdatei. Wenn z. B. die erste bearbeitete Datei doc/source/deutsch/kapitel1.xml hieß und die erste Zeile in der Patchdatei Index: deutsch/kapitel1.xml lautet, dann müssen Sie den Patch auf den Ordner doc/source/ anwenden. Wenn Sie den Patch in der richtigen Arbeitskopie, aber nicht im richtigen Ordner anwenden, wird TortoiseSVN das bemerken und den Pfad vorschlagen, den es für richtig hält.

Um den Patch anwenden zu können, benötigen Sie zumindest Lesezugriff auf das Projektarchiv. Das Programm zum Zusammenführen (Patchen) der Daten muss eventuell auf dieses zurückgreifen, um die Änderungen auf die Revision im Projektarchiv zurückzuführen, auf der sie basieren.

Vom Kontextmenü des betroffenen Ordners aus wählen Sie TortoiseSVN → Patch anwenden... Dies öffnet einen Dateidialog von TortoiseMerge, in dem sie die anzuwendende Patchdatei auswählen können. Standardmäßig werden nur .patch-Dateien angezeigt, aber sie können auch „Alle Dateien“ auswählen. Wenn Sie einen Patch in der Zwischenablage gespeichert haben, können Sie Aus Zwischenablage öffnen... im Datei Öffnen-Dialog aufrufen. Beachten Sie bitte, dass diese Option nur zur Verfügung steht, wenn Sie den Patch aus dem Dialog TortoiseSVN → Erzeuge Patch... heraus in die Zwischenablage kopiert haben. Wenn Sie einen Patch auf andere Art in die Zwischenablage kopieren, erscheint die Schaltfläche nicht.

Wenn die Patchdatei die Erweiterung .patch oder .diff hat, können Sie mit einem Rechtsklick auf die Datei direkt TortoiseSVN → Patch anwenden... wählen. In diesem Fall werden Sie gebeten, eine Arbeitskopie anzugeben.

Dies sind zwei verschiedene Wege, um das gleiche Ziel zu erreichen. Mit der ersten Methode geben Sie die Arbeitskopie vor und suchen die Patchdatei. Mit der zweiten Methode geben Sie die Patchdatei vor und suchen die Arbeitskopie.

Sobald Sie eine Datei gewählt haben, wird TortoiseMerge gestartet, um die Änderungen in Ihrer Arbeitskopie zusammenzuführen. Ein kleines Fenster listet die Dateien auf, die geändert wurden. Doppelklicken Sie nacheinander auf jede einzelne, überprüfen Sie die Änderungen und speichern Sie die zusammengeführten Dateien.

Die Patchdatei wurde nun in Ihrer Arbeitskopie angewendet, sodass die Veränderungen nun zum Projektarchiv übertragen werden müssen, um anderen Projektteilnehmern zur Verfügung zu stehen.

Abbildung 4.61. Der Annotieren-Dialog

Wenn Sie nur an den Änderungen in neueren Revisionen interessiert sind, können Sie die Revision festlegen, bei der das Annotieren beginnen soll. Wenn Sie jede Revision annotieren wollen, setzen Sie diesen Wert auf 1.

Standardmäßig wird die annotierte Datei in TortoiseBlame angezeigt, wobei die verschiedenen Revisionen hervorgehoben werden, um die Lesbarkeit zu erleichtern. Wenn Sie die annotierte Datei bearbeiten oder ausdrucken möchten, aktivieren Sie Betrachte Annotierungen im Texteditor.

Sie können festlegen, wie Änderungen an Zeilenumbrüchen und Leerzeichen behandelt werden sollen. Diese Optionen sind in „Zeilenende- und Leerzeichenoptionen“ beschrieben. Die Vorgabe ist, dass alle Zeilenende- und Leerzeichenänderungen als echte Änderungen behandelt werden. Wenn Sie solche Änderungen ignorieren und den Originalautor finden wollen, können Sie hier die entsprechende Option wählen.

Sie können sich, wenn gewünscht, auch die Informationen über zusammengeführte Revisionen anzeigen lassen. Diese Funktion benötigt wesentlich mehr Zeit, um die Daten vom Server abzurufen. Wenn Zeilen aus einer anderen Quelle integriert wurden, wird beim Annotieren die Revision angezeigt, in der die Änderung im Original vorgenommen wurde, sowie die Revision beim Zusammenführen in diese Datei.

Sobald Sie auf OK klicken, berechnet TortoiseSVN die Annotierungen für diese Datei. Sobald der Prozess abgeschlossen ist, wird das Ergebnis in eine temporäre Datei geschrieben und Sie können das Ergebnis betrachten.

Abbildung 4.62. TortoiseBlame

TortoiseBlame, das zusammen mit TortoiseSVN installiert wird, macht eine solche Annotierung leichter lesbar. Wenn Sie mit dem Mauszeiger über eine Zeile in der linken Spalte fahren, werden alle Zeilen, die in derselben Revision geändert wurden, mit einer dunkleren Farbe dargestellt. Zeilen von anderen Revisionen, aber demselben Autor, werden mit einem helleren Hintergrund dargestellt. Die Einfärbung funktioniert eventuell nicht optimal, wenn Sie Ihren Monitor auf nur 256 Farben eingestellt haben.

Wenn Sie auf eine Zeile Linksklicken, werden alle Zeilen derselben Revision markiert und Zeilen von anderen Revisionen, aber demselben Autor, werden in einer anderen Farbe dargestellt. Diese Markierung bleibt bestehen, sodass Sie den Mauszeiger bewegen können, ohne die Einfärbung zu verlieren. Klicken Sie nochmals auf diese Revision, um die Markierung wieder aufzuheben.

Die Revisionskommentare (Logmeldungen) werden in einem Hinweistext angezeigt, wenn sich die Maus über der Informationsspalte befindet. Wenn Sie diese Logmeldung in die Zwischenablage kopieren wollen, benutzen Sie dazu das Kontextmenü, das bei einem Rechtsklick auf die Informationsspalte erscheint.

Sie können innerhalb der Annotierungen suchen, indem Sie Bearbeiten → Suchen... aufrufen. Diese Funktion erlaubt Ihnen, nach Revisionsnummern, Autoren und dem Inhalt der Datei selbst zu suchen. Logmeldungen werden nicht durchsucht. Für diese Funktion steht der Log-Dialog zur Verfügung.

Sie können auch mittels Bearbeiten → Gehe zu Zeile... in eine bestimmte Zeile der Datei springen.

Wenn sich die Maus über den Informationsspalten im Annotieren-Fenster befindet, steht ein Kontextmenü zur Verfügung, das den Vergleich von Revisionen und die Untersuchung der Historie erleichtert, wobei die Revisionsnummer der Zeile unter der Maus als Referenz verwendet wird. Kontextmenü → Vorherige Revision annotieren erzeugt eine Annotierung derselben Datei unter Verwendung der vorherigen Revisionsnummer als Obergrenze. Dies zeigt Ihnen den Zustand der Datei an, kurz bevor die Zeile, die Sie gerade betrachten, geändert wurde. Kontextmenü → Zeige Änderungen startet das Vergleichsprogramm mit den Änderungen der Revision. Kontextmenü → Zeige Log startet den Log-Dialog in der gewählten Revision.

Wenn Sie leichter erkennen möchten, wo die ältesten und die neuesten Änderungen sind, wählen Sie Ansicht → Farbcodierung für Alter der Zeilen. Dann werden neue Zeilen in rot, ältere Zeilen in blau mit einem Farbgradienten hinterlegt. Die Standardfarben sind recht hell, können aber in den TortoiseBlame-Einstellungen geändert werden.

Wenn Sie die Änderungsverfolgung verwenden und die Zusatzinformation beim Annotieren angefordert haben, werden zusammengeführte Zeilen leicht unterschiedlich angezeigt. Wenn eine Zeile als Ergebnis des Zusammenführens mit einem anderen Pfad geändert wurde, zeigt TortoiseBlame die Revision und den Autor der letzten Änderung in der Originaldatei statt der Revision an, in der die Daten zusammengeführt wurden. Die entsprechenden Zeilen werden durch Kursivschrift hervorgehoben. Die Revision, in der die Änderungen zusammengeführt wurden, wird im Hinweistext angezeigt, sobald Sie mit der Maus über die Infospalten fahren. Wenn Sie nicht möchten, dass zusammengeführte Zeilen so angezeigt werden, deaktivieren Sie die Option Zusammenführen-Info einschließen, wenn Sie das Annotieren starten.

Wenn Sie die Pfade sehen wollen, die beim Zusammenführen beteiligt waren, wählen Sie Ansicht → Zusammengeführte Pfade. Dies zeigt den Pfad, in dem die Zeile zuletzt geändert wurde, mit Ausnahme von Änderungen, die sich aus einer Zusammenführung ergeben.

Die Revisionsnummer beim Annotieren repräsentiert die letzte Revision, bei der sich der Inhalt der Zeile geändert hat. Wenn die Datei als Kopie einer anderen Datei erstellt wurde, entspricht die Revision der letzten Änderung in der Originaldatei und nicht der Revision, in der die Datei kopiert wurde. Das gleiche Verhalten gilt auch für die Pfade, die beim Zusammenführen beteiligt waren. Der Pfad zeigt den Speicherort des Projektarchivs an, an dem die letzte Änderung an dieser Zeile vorgenommen wurde.

Die Einstellungen für TortoiseBlame können Sie überTortoiseSVN → Einstellungen auf dem Karteireiter TortoiseBlame anpassen. Siehe „TortoiseBlame-Einstellungen“.

Eine der Einschränkungen beim Annotieren ist, dass der Bericht nur die Datei in einer bestimmten Revision sowie die Personen anzeigt, die die letzten Änderungen an den Zeilen vorgenommen haben. Manchmal möchten Sie sehen, was genau durch wen geändert wurde. Dazu steht ein Kontextmenü zur Verfügung, mit dessen Hilfe Sie sich die Änderungen in einer bestimmten Revision anzeigen lassen können. Wenn Sie jedoch die Änderungen und die Annotierungen gleichzeitig sehen wollen, benötigen Sie eine Kombination dieser Berichte.

Der Log-Dialog bietet Ihnen mehrere Möglichkeiten dazu.

Jeder Knoten des Revisionsgraphen entspricht einer Revision im Projektarchiv, in dem sich etwas in dem von Ihnen betrachteten Baum geändert hat. Verschiedene Knotentypen können anhand ihrer Form und Farbe unterschieden werden. Die Formen sind fest vorgegeben, die Farben können über TortoiseSVN → Einstellungen geändert werden.

Beachten Sie, dass in der Standardansicht der Graph nur die Punkte zeigt, an denen Elemente hinzugefügt, kopiert oder gelöscht wurden. Alle Revisionen eines Projektes anzuzeigen würde in nicht-trivialen Fällen einen riesigen Graphen erzeugen. Wenn Sie wirklich alle Revisionen sehen wollen, können Sie dies über einen Schalter in der Werkzeugleiste oder im Menü Ansicht aktivieren.

Die Standardansicht (Gruppierung aus) platziert die Knoten so, dass die vertikale Position strikt der Revisionsreihenfolge entspricht, sodass Sie einen Hinweis auf die Abfolge der Ereignisse haben. Befinden sich zwei Knoten in derselben Spalte, ist die Reihenfolge offensichtlich. Bei benachbarten Spalten ist der Versatz viel kleiner und die Reihenfolge weniger offensichtlich, da nicht darauf geachtet werden muss, dass die Knoten sich nicht überlappen. Solche Optimierungen sind nötig, um komplexe Graphen auf eine vertretbare Größe zu reduzieren. Bitte beachten Sie, dass diese Ordnung die Kante des Knotens auf der älteren Seite als Referenz verwendet, d. h., die untere Kante des Knotens, wenn der Graph mit dem ältesten Knoten unten angezeigt wird. Die Referenzkante ist wichtig, weil die Formen der Knoten nicht alle dieselbe Höhe haben.

Da ein Revisionsgraph häufig sehr komplex ist, stehen einige Funktionen zur Verfügung, mit denen Sie die Ansicht an Ihre Wünsche anpassen können. Diese stehen im Menü Ansicht sowie in der Menüleiste zur Verfügung.

Um die Navigation durch einen großen Graphen zu vereinfachen, steht das Übersichtsfenster zur Verfügung. Darin wird der vollständige Graph sowie der aktuelle Ausschnitt hervorgehoben dargestellt. Sie können den aktuellen Ausschnitt verschieben, um den angezeigten Bereich zu verändern.

Das Datum, der Autor und die Logmeldung der Revision werden in einem Hinweistext angezeigt, sobald die Maus über ein Element bewegt wird.

Wenn Sie mit Strg-Linksklick zwei Revisionen markieren, können Sie sich über das Kontextmenü die Unterschiede zwischen diesen Revisionen anzeigen lassen. Sie können wählen, ob Sie die Unterschiede am Anfang oder am Ende der Zweige, sprich den HEAD-Revisionen, vergleichen wollen.

Sie können sich die Unterschiede im Standard-Diff-Format anzeigen lassen, das alle Unterschiede in einer einzelnen Datei mit minimalem Kontext zeigt. Wenn Sie Kontextmenü → Revisionen vergleichen wählen, wird Ihnen eine Liste der geänderten Dateien angezeigt. Mit einem Doppelklick auf einen Dateinamen werden beide Revisionen geholt und in Ihrem Diff-Betrachter angezeigt.

Mit einem Rechtsklick auf eine Revision können Sie sich per Kontextmenü → Zeige Log die Historie anzeigen lassen.

Sie können die Änderungen der gewählten Revisionen auch in einer anderen Arbeitskopie zusammenführen. Ein Ordnerauswahldialog ermöglicht es Ihnen, eine andere Arbeitskopie als Ziel zu wählen, aber danach gibt es weder einen Bestätigungsdialog noch eine Möglichkeit für einen Testlauf. Es ist eine gute Idee, Änderungen in einer unmodifizierten Arbeitskopie zusammenzuführen, sodass Sie diese stets rückgängig machen können, wenn etwas nicht klappt! Dies ist eine nützliche Funktion, wenn Sie bestimmte Revisionen von einem Zweig in einen anderen übertragen wollen.

Wenn Sie den Server auf neue Informationen überprüfen wollen, können Sie die Sicht einfach per F5 aktualisieren. Falls Sie den Log-Puffer verwenden (standardmäßig aktiv), wird das Projektarchiv auf neue Übertragungen abgefragt und nur diese werden geholt. Wenn der Log-Puffer offline war, wird gleichzeitig versucht, ihn wieder online zu schalten.

Falls Sie den Log-Puffer verwenden und denken, dass sich der Inhalt oder der Autor einer Logmeldung geändert haben, sollten Sie den Log-Dialog aufrufen, um darüber die gewünschten Meldungen zu aktualisieren. Da der Revisionsgraph von der Wurzel des Projektarchivs ausgeht, müssten wir den gesamten Log-Puffer ungültig machen und erneut aufbauen, was sehr viel Zeit in Anspruch nehmen kann.

Es kann schwierig sein, in einem großen Baum zu navigieren. Eventuell möchten Sie Teile ausblenden oder den Graphen in einen Wald aus kleineren Bäumen aufspalten. Wenn Sie mit der Maus über den Punkt fahren, an dem ein Verweis einen Knoten betritt oder verlässt, sehen Sie eine oder mehrere Schaltflächen mit den entsprechenden Funktionen.

Klicken Sie auf die Minus-Schaltfläche, um den angehängten Teilbaum zusammenzuklappen.

Klicken Sie auf die Plus-Schaltfläche, um den Baum aufzuklappen. Wenn ein Baum zusammengeklappt wird, bleibt diese Schaltfläche sichtbar, um den verborgenen Teilbaum anzuzeigen.

Klicken Sie auf die Kreuz-Schaltfläche, um den angehängten Teilbaum abzuspalten und als separaten Baum im Graphen anzuzeigen.

Klicken Sie auf die Kreis-Schaltfläche, um einen abgespaltenen Teilbaum wieder einzuhängen. Wenn ein Teilbaum abgespalten wurde, bleibt diese Schaltfläche sichtbar, um anzuzeigen, dass es einen separaten Teilbaum gibt.

Klicken Sie auf den Hintergrund des Graphen, um das Kontextmenü aufzurufen, dass die Funktionen Alle aufklappen und Alle verbinden bietet. Wenn noch kein Zweig zugeklappt oder aufgetrennt wurde, wird das Kontextmenü nicht angezeigt.

Wenn Sie eine Arbeitskopie in einen normalen Ordner zurück konvertieren wollen, müssen Sie nur das .svn-Verzeichnis aus der Basis der Arbeitskopie löschen.

Alternativ können Sie den Ordner auf sich selbst exportieren. Im Windows Explorer ziehen Sie dazu die Basis der Arbeitskopie aus dem Dateibereich in den Ordnerbereich. TortoiseSVN erkennt diesen Spezialfall und fragt, ob die Arbeitskopie nicht mehr versioniert sein soll. Wenn Sie mit Ja antworten, wird das Steuerverzeichnis entfernt und Sie erhalten eine normale, nicht versionierte Verzeichnisstruktur.

Sie können ein Fehlerverfolgungssystem Ihrer Wahl in TortoiseSVN einbinden. Dafür müssen Sie ein paar Subversion-Eigenschaften definieren, die mit bugtraq: beginnen. Diese Eigenschaften müssen auf Ordner gesetzt werden: („Projekt-Einstellungen“)

Abbildung 4.67. Der Dialog Bugtraq-Eigenschaften

Wenn Sie eine der Bugtraq-Eigenschaften bearbeiten, wird ein spezieller Editor verwendet, um die Eingabe zu erleichtern.

Es gibt zwei verschiedene Wege, um TortoiseSVN mit einem Fehlerverfolgungssystem zu verbinden. Ein Weg basiert auf einfachen Zeichenketten, der andere basiert auf Regulären Ausdrücken. Die Eigenschaften, die von beiden Methoden benutzt werden sind:

Wenn sowohl die Eigenschaft bugtraq:message als auch bugtraq:logregex gesetzt ist, erhält logregex Vorrang.

Manche tsvn:-Eigenschaften erfordern einen true/false-Wert. TortoiseSVN versteht auch yes als Synonym für true und no als Synonym für false.