TortoiseMerge ist ein freies Open-Source-Programm. Sie können damit Unterschiede in Textdateien zeigen, diese Unterschiede zusammenführen und auch Standard-Diff-Dateien, sogenannte Patchdateien, auf Ihre Arbeitskopie anwenden.

Wenn Sie mit Textdateien, z. B. Quelltexten ihrer bevorzugten Programmiersprache oder HTML-/XML-Dateien Ihrer Dokumentation oder Webseite arbeiten, werden Sie öfters in eine Situation kommen, in der Sie verschiedene Versionen von solchen Dateien vergleichen möchten. Manchmal erhalten Sie eine veränderte Datei von jemand anderem, manchmal möchten Sie einfach nachsehen, was Sie an einer Datei schon alles geändert haben.

Wenn Sie mit einem Versionskontrollsystem arbeiten (z. B. Subversion), dann werden Sie manchmal einen Konflikt erhalten, wenn Sie Ihre Arbeitskopie aktualisieren. Dies passiert, wenn jemand anders die gleichen Stellen der Datei geändert hat wie Sie. Dann müssen Sie diesen Konflikt von Hand wieder auflösen. TortoiseMerge hilft Ihnen dabei.

Das folgende Diagramm zeigt die Beziehung zwischen den verschiedenen Dateien bei einem Konflikt:

Abbildung 1.1. Dateikonflikt

Während der Arbeit an TortoiseSVN war es jedes Mal sehr aufwendig, wenn jemand uns Patches mit Fehlerkorrekturen oder Erweiterungen zugeschickt hat, diese Patches auch einzubinden. Häufig waren die Patches veraltet und konnten mit dem Kommandozeilenprogramm https://unxutils.sourceforge.net/ nicht appliziert werden, da wir an den Dateien arbeiteten und diese manchmal bereits geändert waren.

Das war auch der Hauptgrund, weshalb TortoiseSVN keinen Befehl TortoiseSVN → Erstelle Patch implementiert hatte: Wir wollten statt der Patchdateien lieber die ganzen Dateien von den Anwendern haben, weil es für uns einfacher war, Änderungen auf diese Weise zum Projekt hinzuzufügen.

Also haben wir viel Zeit damit verbracht, das Internet nach einem guten grafischen Tool abzusuchen, das Patchdateien zu Projekten hinzufügen konnte. Aber alles, was wir fanden, war, dass ein solches Programm nicht existierte. Um eine lange Geschichte zu einem Ende zu bringen: Wir haben dann beschlossen, dass wir eben selbst eines schreiben müssen, wenn niemand ein solches Tool anbietet. So entstand TortoiseMerge.

Da TortoiseSVN schon die Subversion-Bibliothek benutzt, die gute Vergleichsfunktionen enthält, war es nur natürlich, dieselbe Funktionsbibliothek anstelle von GNU Diff für TortoiseMerge zu nutzen.

Mit Subversion 1.7 wurde der Befehl svn patch eingeführt, um einen Patch auf eine Arbeitskopie anzuwenden. TortoiseMerge verwendet nun dieselben Funktionen wie Subversion, um Unterschiede im Verhalten zu vermeiden.

In diesem Modus vergleichen Sie zwei Dateien. Die links angezeigte Datei stellt das Original dar (manchmal auch als Deren bezeichnet) und die rechte Datei die geänderte (manchmal auch als Meine bezeichnet).

Sie können einfache zeilenbasierte Änderungen an der Datei im rechten Bereich vornehmen, darunter:

Sie können die Datei im rechten Bereich wie in einem Texteditor bearbeiten. Solche Zeilen werden durch einen Stift gekennzeichnet. Beachten Sie bitte, dass Sie, wenn Sie Zeilen- oder Blockoperationen vornehmen, diese zuerst - vor manuellen Änderungen - durchführen. Für TortoiseMerge wird es sonst unmöglich, die Beziehungen zu den Originaldateien aufrecht zu erhalten.

Dies wird manchmal als Dreiwegevergleich bezeichnet und wird in drei Bereichen angezeigt. Tatsächlich sind aber vier Dateien involviert. Die nicht angezeigte Datei ist die gemeinsame Basis, der letzte Vorgänger der beiden, sich in Konflikt befindenden Dateien. Die Beziehungen zwischen den drei Dateien stellen sich wie folgt dar:

Abbildung 2.1. Dateikonflikt

Die Basis-Datei entspricht der ältesten Version einer Datei, von der aus Sie und die Anderen Änderungen vorgenommen haben. Meine entspricht dabei der Basisdatei mit allen Änderungen, die Sie selbst vorgenommen haben und wird im rechten Bereich angezeigt. Deren entspricht der Basisdatei mit allen Änderungen, die die Anderen gemacht haben und wird im linken Bereich angezeigt. Der untere Bereich enthält die Ausgabedatei. In dieser werden die Konflikte aufgelöst.

Im Dreiwegevergleich, können Sie Blöcke aus Meiner oder Deren Datei oder aus beiden verwenden. Nur gehen in diesem Fall die Änderungen in die Zieldatei, die im unteren Bereich angezeigt wird.

Ein Patchdatei ist eine Subversion-Standard-Diff-Datei, die Informationen über Änderungen an einem Satz von Dateien enthält. Der Patch kann von einem anderen Entwickler stammen, sodass Sie seine Änderungen anwenden, überprüfen und gegebenenfalls in das Projektarchiv übertragen können. Die Patchdatei kann auch intern durch TortoiseSVN beim Vergleich zweier Ordner generiert werden. Dies geschieht zum Beispiel, wenn Sie eine Revision im Projektarchiv mit der Arbeitskopie oder auch zwei Revisionen im Projektarchiv oder zwei verschiedene Pfade im Projektarchiv miteinander vergleichen.

In jedem Fall wird TortoiseMerge ein kleines Fenster mit den vom Patch betroffenen Dateien anzeigen. Durch einen Doppelklick auf eine der Dateien wird die Ausgangsrevision geholt und die Änderungen werden angewendet. Im linken Bereich wird die Originaldatei und im rechten die veränderte Datei angezeigt.

Sie können die Datei im rechten Bereich genauso wie im Vergleichsmodus bearbeiten.

TortoiseSVN besitzt drei verschiedene Ansichten: mit einem, zwei oder drei Bereichen. Die Ein-/Zweifensteransicht dient zum Betrachten von Änderungen und die Dreifensteransicht zum Auflösen von Konflikten.

Anzeigen / Zusammenführen

Abbildung 3.1. Vergleich übereinander in einem Bereich

Abbildung 3.2. Vergleich nebeneinander mit zwei Bereichen

Die Zweifensteransicht bietet einige Möglichkeiten, die in der Einfensteransicht nicht zur Verfügung stehen:

• Unterschiede innerhalb einer Zeile werden in verschiedenen Farben angezeigt. Hinzugefügte Zeichen werden in einer helleren Farbe dargestellt, aber sie können selbstverständlich die verwendeten Farben einstellen. Gelöschte Abschnitte werden durch eine dunkelbraune senkrechte Linie angezeigt.

• Die Reorganisation von Quellcode führt häufig zu größeren Änderungen an Leerzeichen (Leerzeichen, Tabulatoren, Leerzeilen) ohne tatsächliche Änderungen am Programmcode. Zum Beispiel spalten Sie eine sehr lange Zeile in mehrere kurze Zeilen auf oder lassen einen automatischen Quellcodeformatierer über den Programmcode laufen.

  Solche Änderungen werden durch einen weißen Kreis am linken Rand der Bereiche dargestellt. Wenn Sie einen Kreis sehen, wissen Sie sofort, dass keine echte Codeänderung vorliegt und Sie den Block nicht genauer untersuchen müssen.

• Manuelles Bearbeiten der rechten Datei ist in der Zweifensteransicht möglich. Änderungen werden durch ein Stiftsymbol gekennzeichnet. Manuelles Bearbeiten der linken Datei ist nur möglich, wenn die Schaltfläche Bearbeiten aktivieren bei aktiver linker Seite gedrückt wurde.

Für den Fall, dass Sie drei Dateien zusammenführen möchten, zeigt TortoiseMerge Ihnen diese in drei Bereichen an. Die gleiche Ansicht wird auch für das Auflösen von Konflikten verwendet.

Abbildung 3.3. Zusammenführen mit drei Bereichen

Der linke Bereich zeigt Ihnen die Unterschiede zwischen Deren Datei und der Basis-Datei, während der rechte Bereich die Unterschiede zwischen Meiner Datei und der Basis-Datei darstellt. Der untere Bereich zeigt Ihnen das Ergebnis des Zusammenführens der drei Dateien inklusive möglicher Konflikte.

Wenn Sie mit der Maus über die Titelzeile jedes Bereichs fahren, wird Ihnen der Name der jeweiligen Datei in einem Hinweistext angezeigt.

Manuelles Bearbeiten der linken Datei ist nur möglich, wenn die Schaltfläche Bearbeiten aktivieren bei aktiver linker Seite gedrückt wurde.

Patches anwenden

Nachdem TortoiseMerge die Patchdatei eingelesen hat, wird ein kleines Dialogfenster mit allen Dateien, die durch den Patch geändert würden, angezeigt.

Abbildung 3.4. Patchliste

Wenn der Dateiname schwarz ist, kann der Patch ohne Probleme übernommen werden, weil die Zieldatei dem in der Patchdatei angegebenen Stand entspricht. Ist der Dateiname hingegen rot, dann kann der Patch nicht direkt übernommen werden, da die Zieldatei schon anderweitig geändert wurde.

Das Patchdateifenster hat ein Kontextmenü, das Ihnen eine Vorschau der Änderungen an der aktuellen Datei ermöglicht (Anwenden, ohne zu speichern) sowie die Anwendung und Speicherung der Änderungen für die ausgewählte Datei oder auf alle Dateien in der Liste ermöglicht. Ein Doppelklick startet die Vorschau.

Abhängig von Ihren Einstellungen, sehen Sie entweder eine Werkzeugleiste oder ein Band mit vielen Schaltflächen. Die Schaltflächen besitzen alle einen HInweistext, der ihre Funktion erläutert, sobald Sie mit der Maus darüber fahren.

Am linken Rand ist eine Navigationsleiste. Diese liefert einen schnellen Überblick, wo sich Änderungen in der Datei befinden. Die Leiste hat drei Spalten. Die linke Spalte entspricht dem linken Bereich, die rechte Spalte dem rechten Bereich, die mittlere Spalte, falls angezeigt, dem unteren Bereich. In der Einfensteransicht wird nur die linke Spalte benutzt. Die Navigationsleiste kann auch als Bildlaufleiste benutzt werden, wobei sich dann alle drei Bereiche synchron verschieben.

Wenn Sie auf ein Wort doppelklicken, wird jedes Vorkommen des Wortes im gesamten Dokument hervorgehoben, sowohl in den Fenstern als auch in der Navigationsleiste. Doppelklicken Sie erneut auf das Wort, um die Markierung zu entfernen.

Wenn Sie am linken Rand klicken oder wenn Sie innerhalb einer Zeile dreifach klicken, wird die gesamte Zeile ausgewählt.

Unterhalb des Fensters befindet sich die Statusleiste. Diese zeigt die Anzahl der in Deren und Meine hinzugefügten oder gelöschten Zeilen sowie die Anzahl der verbleibenden Konflikte.

Die Statusleiste enthält auch Kombinationsfeld-Steuerelemente, die festlegen, wie die Dateien behandelt werden sollen:

In geänderten Zeilen wird die Art der Änderung durch ein Symbol angezeigt.

Eine Zeile wurde hinzugefügt.

Eine Zeile wurde entfernt.

Eine Änderung wurde durch das Zurücksetzen einer Zeile auf ihren Ursprungszustand zurückgenommen.

Diese Zeile enthält nur Änderungen in Leerzeichen. Falls mehrere aufeinanderfolgende Zeilen markiert sind, wurde eventuell ein Absatz neu umgebrochen.

Eine Zeile wurde manuell in TortoiseSVN geändert.

Diese Zeile enthält einen Konflikt.

Diese Zeile enthält einen Konflikt, der aufgrund der Vergleichsoptionen für Zeilenende oder Leerzeichen nicht sichtbar ist.

Diese Zeile wurde an eine andere Stelle verschoben.

TortoiseMerge zeigt Ihnen nicht nur die Unterschiede zwischen Dateien an, sondern lässt Sie diese Änderungen auch übernehmen und Konflikte lösen.

Wenn Sie in der Zweifensteransicht sind, dann können nur Sie die Datei im rechten Bereich (Meiner Version) ändern. Um Unterschiede aus der linken Datei (Deren) in die rechte zu übernehmen, machen Sie einen Rechtsklick auf die unterschiedliche Zeile und wählen Sie den gewünschten Befehl aus dem Kontextmenü aus.

Manchmal benötigen Sie beide Textblöcke. Das Kontextmenü bietet Ihnen die entsprechenden Funktionen Kontextmenü → Verwende beide Blöcke (diesen zuerst) und Kontextmenü → Verwende beide Blöcke (diesen zuletzt) an.

Sie können die Ausgabedatei wie in einem Texteditor bearbeiten. Solche Zeilen werden durch einen Stift gekennzeichnet. Wenn Sie Zeilen- oder Blockoperationen vornehmen, müssen Sie diese zuerst - vor manuellen Änderungen - durchführen, da es für TortoiseMerge sonst unmöglich wird, die Beziehungen zu den Originaldateien aufrecht zu erhalten.

Wenn Sie einen Dreiwegevergleich durchführen (auch Zusammenführen- oder Konfliktansicht genannt), können Sie nur die Ergebnisdatei im unteren Bereich bearbeiten. Wie auch in der Zweifensteransicht können Sie durch einen Rechtsklick auf Zeilen im Konflikt ein Kontextmenü anzeigen lassen und dann auswählen, wie Sie den Konflikt auflösen möchten. Sie können damit den rechten oder linken Block auswählen, aber auch beide Blöcke entweder „Meiner vor Deren“ oder „Deren vor Meinem“ in die Zieldatei übernehmen.

Manchmal wird in Subversion ein Dateikonflikt angezeigt, es sind jedoch keine Unterschiede sichtbar, wenn Sie die Datei in TortoiseMerge betrachten. Das kann an Ihren Einstellungen für den Vergleich von Leerzeichen oder Zeilenumbrüchen liegen. Falls Sie beschlossen haben, solche Änderungen zu ignorieren, werden die entsprechenden Zeilen durch das Symbol Konflikt Ignoriert gekennzeichnet. Um den Konflikt aufzulösen, müssen Sie trotzdem eine der beiden Varianten auswählen.

Wenn Sie TortoiseMerge ohne Kommandozeilenbefehle starten, dann müssen Sie die Dateien mit Datei → Öffnen von Hand öffnen.

Abbildung 3.5. Der Öffnen-Dialog

Als erstes müssen Sie entscheiden, ob Sie Dateien vergleichen / zusammenführen oder eine Patchdatei anwenden möchten. Je nachdem, was Sie wählen, werden die entsprechenden Schaltflächen und Eingabefelder aktiviert.