KDiff3 zeigt die exakten Unterschiede an und bedient sich dazu der Möglichkeiten heutiger Farbmonitore. Wenn Sie häufig Quelltexte überprüfen müssen, werden Sie diese Funktion mögen.

Unterschiede in Leerräumen und Tabulatoren werden sichtbar dargestellt. Wenn sich Zeilen nur in einer gewissen Anzahl an Leerräumen unterscheiden, kann man das auf einen Blick an der Zusammenfassung in der Spalte an der linken Seite sehen. (Kein Ärger mehr, wenn Jemand die Einrückung ändert.)

Man kann drei Dateien analysieren und sehen, wo sie sich unterscheiden.

Das linke/mittlere/rechte Fenster hat den Namen A/B/C und ist entsprechend blau/grün/magenta eingefärbt.

Wenn eine Datei gleich ist, und die andere sich in einer Zeile unterscheidet, dann zeigt die Farbe an, welche Datei unterschiedlich ist. Rote Farbe bedeutet, dass beide sich Dateien unterscheiden.

Mit KDiff3 kann man zwei oder drei Dateien zusammenführen. Dabei führt KDiff3 so viel wie möglich automatisch zusammen. Das Ergebnis wird in einem editierbaren Fenster angezeigt, dort können die meisten Konflikte schon mit einem einfachen Mausklick gelöst werden: Wählen Sie Knöpfe ... in den Fenstern A/ B/C, um die zu benutzende Quelle auszuwählen. Sie können auch mehr als eine Quelle wählen. Weil das Fenster im Grunde ein Editor ist, können hier selbst Konflikte, die eine weitere Bearbeitung erfordern, einfach aufgelöst werden. Sie benötigen dazu keine weiteren Hilfsmittel.

Im oberen Teil jedes Textfensters befindet sich die Info-Zeile. Die Info-Zeile der Quellfenster enthält die Zeichen A, B oder C, den Dateinamen und die Zeilennummer der ersten sichtbaren Zeile im Fenster. Beachten Sie, dass Fenster C optional ist. Jede Info-Zeile hat eine unterschiedliche Farbe.

Wenn Sie eine andere Datei im Auswahldialog gewählt oder nach Eingabe des Dateinamens die Eingabetaste gedrückt haben, wird die neue Datei geladen und mit den bereits geöffneten Dateien verglichen.

Den drei Quellfenstern sind die Buchstaben A, B und C zugeordnet. A hat die Farbe Blau, B die Farbe Grün und C ist magenta. (Diese Voreinstellungen können über das Menü Einstellungen geändert werden.)

Wenn ein Unterschied erkannt wird, sieht man an der Farbe, welche Datei sich unterscheidet. Wenn sich beide Dateien unterscheiden, ist die voreingestellte Farbe dafür Rot. (Farbe für Konflikte im Abschnitt Farbe in den Einstellungen). Das Farbschema ist besonders nützlich, wenn Sie drei Dateien vergleichen. Das ist im nächsten Abschnitt (Zusammenführen) gut zu sehen.

Links neben dem Text befindet sich die Zusammenfassungs-Spalte. Wenn Unterschiede gefunden wurden, zeigt die Spalte die entsprechende Farbe an. Bei Unterschieden in Leerräumen wird die Farbe gerastert angezeigt. Bei einigen Programmiersprachen wo Leerräume nicht so wichtig sind, ist es nützlich, nur die relevanten Änderungen zu sehen. (Bei C/C++ z. B. sind Leerräume nur in Zeichenfolgen und Kommentaren, für die Vorverarbeitung und in wenigen, seltenen Einzelfällen relevant.)

Die vertikale Linie, die die Zusammenfassungs-Spalte vom Text trennt, wird an den Stellen unterbrochen, wo die jeweilige Quelldatei keine Zeilen hat. Wenn der Zeilenumbruch aktiviert ist, wird die Linie an umgebrochenen Zeilen gepunktet dargestellt.

An der rechten Seite befindet sich eine Übersichts-Spalte, direkt links neben der vertikalen Bildlaufleiste. Sie zeigt eine komprimierte Zusammenfassung des gesamten Fenster A. Alle Unterschiede und Konflikte sind hier auf einen Blick erkennbar. Wenn nur zwei Quellfenster genutzt werden, dann erscheinen alle Unterschiede rot, denn dann ist jeder Unterschied gleichzeitig auch ein Konflikt. Der aktuell sichtbare Bereich der Quelltexte wird durch ein schwarzes Rechteck umrandet. Bei sehr langen Quelldateien mit mehr Zeilen als die Übersichts-Spalte in Pixeln anzeigen kann, teilen sich mehrere Zeilen jeweils eine Zeile in der Übersichts-Spalte. Ein Konflikt hat gegenüber einfacher Unterschiede die höchste Priorität. Unterschiede wiederum haben eine höhere Priorität als „keine Änderungen“. So gehen keine Konflikte oder Unterschiede verloren. Durch einen Klick in die Übersichts-Spalte wird der zugehörige Text angezeigt.

Manchmal platziert der Algorithmus die falschen Zeilen nebeneinander. Oder Sie möchten einen Textteil mit einem Text an einer völlig anderen Position in der anderen Datei vergleichen. In solchen Situationen können Sie mit KDiff3 bestimmte Zeilen ausrichten. Markieren Sie den Text wie für das Kopieren und Einfügen in der ersten Vergleichsansicht und wählen dann Vergleichsansicht → Manuelle Ausrichtung hinzufügen (Strg+Y). Eine orangefarbene Leiste wird dann in der Zusammenfassungsspalte angezeigt. Wiederholen Sie diesen Schritt für die zweite und gegebenenfalls dritte Vergleichsansicht. KDiff3 berechnet die Unterschiede bei jedem Schritt sofort neu und richtet die ausgewählten Zeilen aus. Dann passen einige vorher passenden Zeilen möglicherweise nicht mehr.

Zurzeit unterstützt das Zusammenführen noch nicht die manuelle Ausrichtung der Zeilen von Unterschieden

In einigen Fällen zeigt KDiff3 zu viele oder zu wenige Diff-Abschnitte an. Dann können Sie vorhandene Abschnitt zusammenführen oder aufteilen.

Um neue Abschnitte hinzuzufügen, wählen Sie zuerst Text in den zusammengehörigen Zeilen in einem der Eingabefenster wie für das Kopieren in die Zwischenablage. Wählen Sie dann im Menü Zusammenführung → Unterschied bei der Auswahlmarkierung trennen. Die Trennung erfolgt oberhalb der ersten und unterhalb der letzten Zeile des ausgewählten Texts. Wenn Sie nur einen Abschnitt hinzufügen möchten, wählen Sie Text am Beginn einer anderen Abschnittsteilung.

Um Zeilen in einem der Eingabefenster zu verbinden, wählen Sie die zu verbindenden Zeilen aus. Sie können auch mehrere Abschnitte auf einmal verbinden. Wählen Sie dann Zusammenführen → Markierte Unterschiede verbinden.

Das Ergebnisfenster hat auch eine Zusammenfassungs-Spalte an der linken Seite. Sie zeigt entweder den Buchstaben des Vergleichsfensters an von dem eine Zeile stammt, oder sie ist leer, wenn alle drei Quellen an der Stelle identisch sind. Konflikte werden mit einem roten Fragezeichen „?“ und dem Text <Zusammenführungskonflikt> dargestellt. Weil das zeilenweise Auflösen von Konflikten sehr lange dauern würde, werden Zeilen mit gleichem Unterschied und Charakteristika gruppiert. Konflikte mit Leerräume- und Konflikte mit Nicht-Leerräumen Zeichen werden getrennt dargestellt, um das Zusammenführen von Dateien mit vielen Änderungen von Einrückungen zu vereinfachen.

Durch einen Klick mit der linken Maustaste in die Zusammenfassungs-Spalte in einem der Fenster wird die erste zu der Zeile gehörende Gruppe in allen Fenstern angezeigt. Diese Gruppe wird dann die „aktuelle Gruppe“. Sie wird mit der Farbe Hintergrundfarbe für aktuellen Bereich hervorgehoben und jeweils zur Linken erscheint ein schwarzer Balken.

In der Werkzeugleiste unter der Menüleiste sind drei Knöpfe zur Auswahl der Eingabe mit den Buchstaben A, B und C enthalten. Klicken Sie auf diese Knöpfe, um Zeilen einzufügen oder bereits eingefügte Zeilen der entsprechenden Quelle zu löschen. Um Zeilen in mehreren Eingabefenstern auszuwählen, klicken Sie auf die zugehörigen Knöpfe in der gewünschten Reihenfolge. Wenn Sie die Zeilen aus „B“ vor den Zeilen auf „A“ anzeigen möchten, klicken Sie zuerst auf „B“ und dann auf „A“.

Wenn Sie die Einstellung Automatisch zu nächstem ungelösten Konflikt weiterspringen im Abschnitt Automatisch weitergehen verwenden, sollten Sie das abschalten, ehe Sie Zeilen aus mehreren Eingabefenstern wählen oder wenn Sie die Zeilen nach Ihrer Auswahl bearbeiten möchten. Ansonsten springt KDiff3 zum ersten Konflikt nach der Auswahl der ersten Eingabe.

Es ist oft hilfreich, die Ausgabe der Zusammenführung zu bearbeiten. In der Zusammenfassungsspalte wird das Zeichen „m“ für jede manuell geänderte Zeile angezeigt. Wenn zum Beispiel die Unterschiede in einer Weise ausgerichtet sind, das die Auswahl der Eingaben zu keinen befriedigenden Ergebnissen führen, dann markieren Sie den gewünschten Text und nutzen Kopieren und Einfügen, um ihn in die Ausgabe der Zusammenfassung einzufügen.

Manchmal bleibt durch das automatische Zusammenführen oder durch manuelles Bearbeiten keine weitere Zeile mehr in der Gruppe übrig; dann wird in diesen Zeilen der Text <Keine Zeile in der Quelle> angezeigt. Das ist nur ein Platzhalter für den Fall, dass Sie Ihre Meinung ändern und vielleicht doch wieder eine andere Quelle wählen. Dieser Text erscheint weder in der endgültigen gespeicherten Datei, noch in einer Markierung die Sie vielleicht kopieren und woanders einfügen.

Der Text <Zusammenführungskonflikt> erscheint allerdings in der Zwischenablage, wenn Sie solchen Text aus dem Ergebnisfenster kopieren. Gehen Sie vorsichtig mit dieser Funktion um.

Das normale Zusammenführen startet mit dem automatischen Lösen einfacher Konflikte. Das Menü Zusammenführen enthält einige häufig verwendete Funktionen. Wenn Sie bei den meisten Konflikten die gleiche Quelle auswählen müssen, können Sie z. B. überall A, B oder C auswählen. Die gleiche Möglichkeit gibt es auch für die noch verbleibenden ungelösten Konflikte oder sogar für die noch verbleibenden ungelösten Konflikte in Leerräumen. Wenn Sie solche Entscheidungen nicht zusammengefasst für eine Gruppe, sondern sogar für jeden einzelnen Unterschied im Detail treffen möchten, dann wählen Sie Alle Unterschiede zu Konflikten machen. Sie können wieder zur automatischen Auswahl von KDiff3 zurück, indem Sie Automatisch einfache Konflikte lösen wählen. KDiff3 startet das Zusammenführen dann erneut. KDiff3 fragt nach, bevor Ihre eventuell gemachten Änderungen verloren gehen.

Viele Versionsverwaltungssysteme unterstützen Schlüsselwörter in der Datei wie z. B. "$Date$", "$Header$", "$Author$", "$Log$" usw. Beim Einspielen ändert das Versionsverwaltungssystem (VCS) diese Zeilen. "$Date$" wird zum Beispiel zu "$Date: 2005/03/22 18:45:01 $". Da diesen Zeile in jeder Version der Datei verschieden ist, würde ein manueller Eingriff beim Zusammenführen nötig sein.

KDiff3 bietet ein automatisches Zusammenführen für diese Einträge. Bei einfachen Zeilen, auf die die Einstellung Regulärer Ausdruck für automatische Zusammenführung in allen Eingabedateien zutrifft, wählt KDiff3 die Zeile aus B oder - wenn verfügbar - aus C. Außerdem ist es erforderlich, dass die betreffenden Zeilen im Vergleich enthalten sind und die vorherige Zeile keinen Konflikt enthält. Dieses automatische Zusammenführen kann entweder sofort nach dem Beginn einer Zusammenführung mit Zusammenführung über regulären Ausdruck beim Start einer Zusammenführung durchführen oder später mit Zusammenführung über regulären Ausdruck starten aus dem Menü Zusammenführen ausgeführt werden.

Automatisches Zusammenführen für den Verlauf oder Protokoll von Versionsverwaltungssystemen wird ebenfalls unterstützt. Das automatische Zusammenführen des Verlaufs kann entweder durch die Aktivierung von Versionsverwaltungs-Verlauf beim Start einer Zusammenführung zusammenführen im Einrichtungsdialog oder später durch Verlauf-Konflikte automatisch auflösen aus dem Menü Zusammenführen gestartet werden.

Normalerweise beginnt das Protokoll des Versionsverlaufs mit dem Schlüsselwort „$Log$“. Dies muss zur Einstellung Regulärer Ausdruck für Verlauf-Start passen. KDiff3 erkennt, welche der folgenden Zeilen im Verlaufsprotokoll enthalten sind, indem die die Zeichen vor „$Log$“ analysiert werden. Wenn diese Zeichen auch in den folgenden Zeilen erscheinen, werden Sie auch als Teil des Protokolls betrachtet.

Beim jedem Einspielen schreibt das Versionsverwaltungssystem eine eindeutige Zeile mit Informationen über Version, Datum und Zeit und danach den Kommentar des Benutzers. Diese Zeilen bilden einen Verlaufseintrag. Dieser Verlaufsabschnitt wird mit jedem Einspielen größer und die neueren Einträge werden oben nach der Verlaufsprotokollzeile eingefügt.

Wenn bei gleichzeitiger Entwicklung zwei oder mehr Entwickler einen Zweig (Branch) der Datei einspielen, enthält der Zusammenführungsverlauf mehrere Einträge, die als Konflikt beim Zusammenführen der Zweige erscheint. Das dieses Zusammenführen sehr langweilig ist , unterstützt KDiff3 zwei verschiedene Strategien: Einfügen der Verlaufsinformationen beider Entwickler am Anfang oder Sortierung durch einen benutzerdefinierten Schlüssel.

Die Methode nur alle Einträge einzufügen, ist einfacher einzurichten. KDiff3 benötigt nur eine Methode, um die zu einem Verlaufseintrag gehörenden Zeilen zu erkennen. Die meisten Versionsverwaltungssysteme fügen nach jedem Verlaufseintrag eine Leerzeile ein. Gibt es keinen anderen Leerzeilen, ist dies Kriterium für KDiff3 ausreichend. Löschen Sie den Text für Regulärer Ausdruck für Verlauf-Eintrag-Startzeile im Abschnitt Zusammenführung des Einrichtungsdialogs an. Ist das Kriterium für eine Leerzeile nicht ausreichend, können Sie einen regulären Ausdruck für den Beginn des Verlaufseintrags angeben.

Beachten Sie, dass KDiff3 doppelte Einträge im Verlauf entfernt. Wenn ein Eintrag mehrfach im Verlauf einer Eingabedatei vorkommt, bleibt in der Ausgabe nur ein Eintrag übrig.

Möchten Sie den Verlauf sortieren, müssen Sie den Schlüssel dazu angeben. Verwenden Sie Klammern, um Teile von Regulärer Ausdruck für Verlauf-Eintrag-Startzeile zu gruppieren, um diesen Ausdruck später zum Sortieren zu verwenden. Geben Sie dann für Sortierschlüsselreihenfolge für Verlauf-Eintragsstart eine durch Komma getrennte Liste von Zahlen mit der Position der Gruppen im regulären Ausdruck.

Da es nicht so einfach ist, sofort richtige Ausdrücke zu schreiben, können Sie die regulären Ausdrücke und Schlüsselgenerierung in einem dafür vorgesehenen Dialog verbessern und testen, indem Sie den Knopf Testen Sie Ihre regulären Ausdrücke drücken.

Beispiel: Angenommen ein Verlauf sieht so aus:

/**************************************************************************
** HISTORY:    $Log: \toms_merge_main_view\MyApplication\src\complexalgorithm.cpp $
**
**     \main\integration_branch_12   2 Apr 2001 10:45:41   tom
**  Merged branch simon_branch_15.
**
**     \main\henry_bugfix_branch_7\1   30 Mar 2001 19:22:05   henry
**  Improved the speed for subroutine convertToMesh().
**  Fixed crash.
**************************************************************************/

Der Verlauf beginnt mit der Startzeile, auf die der reguläre Ausdruck ".*\$Log.*\$.*" zutrifft. Dann folgen die Einträge.

Die Zeile mit dem Schlüsselwort „$Log$“ beginnt mit zwei „*“ und danach ein Leerzeichen. KDiff3 verwendet den ersten Text ohne Leerzeichen als „Startkommentar“ und nimmt an, dass der Verlauf mit der ersten Zeile ohne diesen Startkommentar endet. In diesem Beispiel enthält die letzte Zeile auch zwei Zeichen „*“ am Anfang, aber dann folgen weitere „*“ statt eines Leerzeichens. Daher endet der Verlauf mit dieser Zeile.

Ist eine Sortierung des Verlaufs nicht erforderlich, kann ein regulärer Ausdruck für die Startzeile des Verlaufseintrags zum Beispiel so aussehen. Dieser Ausdruck wurde in zwei Teile getrennt, da er sonst zu lang ist.

\s*\\main\\\S+\s+[0-9]+ (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 [0-9][0-9][0-9][0-9] [0-9][0-9]:[0-9][0-9]:[0-9][0-9]\s+.*

Weitere Informationen über reguläre Ausdrücke finden Sie in der Dokumentation zu regulären Ausdrücken. Beachten Sie, dass das klein geschriebene „\s“ auf jedes Leerraumzeichen und das groß geschriebene "\S" auf jedes Nicht-Leerraumzeichen passt. In diesem Beispiel enthält der Beginn des Verlaufseintrags zuerst die Versionsinformation mit „\\main\\\S+“, das Datum aus Tag „[0-9]+“, Monat „(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)“ und Jahr „[0-9][0-9][0-9][0-9]“, die Zeit „[0-9][0-9]:[0-9][0-9]:[0-9][0-9]“ und schließlich den Benutzernamen des Entwicklers „.*“.

Beachten Sie, dass die Startkommentar-Zeichen, in diesem Beispiel "**" bereits durch KDiff3 vor der Suchen nach Übereinstimmung entfernt werden. Daher beginnt der reguläre Ausdruck mit einem oder Leerraumzeichen mit "\s*". Da Kommentarzeichen in jeder Datei je nach verwendeter Programmiersprache verschieden sein können, werden die Startkommentar-Zeichen von KDiff3 entfernt und sollten nicht im regulären Ausdruck angegeben werden.

Wenn Sie den Verlauf sortiert haben möchten, muss dazu ein Sortierschlüssel berechnet werden. Dazu müssen die maßgebenden Teile im regulären Ausdruck durch Klammern gruppiert werden. Die zusätzlichen Klammer können im Verlaufseintrag verbleiben, wenn die Sortierung abgeschaltet ist.

\s*\\main\\(\S+)\s+([0-9]+) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 ([0-9][0-9][0-9][0-9]) ([0-9][0-9]:[0-9][0-9]:[0-9][0-9])\s+(.*)

Die Klammern enthalten jetzt: 1. Versionsinformation, 2. Tag, 3. Monat, 4. Jahr, 5. Zeit, 6. Name. Wenn Sie jedoch nach Datum und Zeit sortieren möchten, muss zuerst ein Schlüssel mit den Elementen in einer anderen Reihenfolge konstruiert werden. Zuerst das Jahr, dann Monat, Tag, Zeit, Versionsinformation und Name. Daher muss als Sortierschlüssel "4,3,2,5,1,6" angegeben werden.

Da Monatsnamen nicht zur Sortierung geeignet sind, weil dabei „Apr“ zuerst käme, ermittelt KDiff3 die Reihenfolge der angegebenen Monatsnamen und benutzt dies dann. In diesem Fall wird „Apr“ die Zahl „04“ zugeordnet. Eine Zahl wird in einen Wert mit vier Dezimalstellen mit vorangestellten Nullen für die Sortierung. Schließlich ergibt sich als Sortierschlüssel für die Startzeile des ersten Verlaufseintrags:

2001 04 0002 10:45:41 integration_branch_12   tom

Weitere Informationen finden Sie im Abschnitt Zusammenführungs-Einstellungen.

Es gibt auch einen Knopf Automatisch zum nächsten ungelösten Konflikt weiterspringen. Wenn Sie dies aktivieren, wird KDiff3 nach der ersten Auswahl der Quelle automatisch zum nächsten ungelösten Konflikt weiterspringen und ihn lösen. Das ist hilfreich, wenn Sie immer nur eine Quelle wählen möchten. Wenn Sie beide Quellen brauchen, oder das Ergebnis nach der Auswahl noch bearbeiten möchten, dann sollten Sie diese Funktion ausschalten. Bevor KDiff3 zum nächsten ungelösten Konflikt weiterspringt, wird das Ergebnis der Auswahl für eine kurze Zeit angezeigt. Die Verzögerungszeit kann im Abschnitt Vergleich und Zusammenführung in den Einstellungen bestimmt werden: Geben Sie für Verzögerung für das automatische Weiterspringen (ms) einen Wert zwischen 0 und 2000 Millisekunden an. Tipp: Wenn Sie sich viele Mausklicks sparen möchten, dann benutzen Sie eine kurze Verzögerungszeit und die Tastenkürzel Strg+1/2/3 zum Auswählen der Quellen A/B/C.

Wählen Sie eine Schrift mit fester Breite. (Auf einigen Systemen stellt der Dialog auch Schriften mit variabler Breite zur Auswahl, Sie sollten diese aber nicht benutzen.)

Die Änderung der Farbe für den Ordnervergleich wird erst beim Start des nächsten Ordnervergleichs wirksam.

An Systemen mit nur 16 oder 256 Farben könnten einige Farben nicht in ihrer reinen Form verfügbar sein sondern würden gerastert dargestellt werden. An diesen Systemen stellt der Knopf Voreinstellungen > automatisch eine ungerasterte Farbe ein.

Beim Vergleichen von Dateien versucht KDiff3 zuerst, alle vollständig identischen Zeilen in den Quelldateien zu finden. Nur bei diesem ersten Schritt können Leerräume ignoriert werden. Der zweite Schritt vergleicht jede Zeile. In diesem Schritt werden Leerräume nicht ignoriert. Auch beim Zusammenführen werden Leerräume nicht ignoriert.

Diese Optionen werden im Kapitel zum Einlesen von Ordnern und Durchführen einer Zusammenführung behandelt. Schauen Sie für Details unter Dokumentation zum Ordnervergleich und Zusammenführung nach.

Es gibt hier dennoch eine Option die auch beim Speichern von einzelnen Dateien relevant ist:

Diese Optionen und Aktionen sind in den Menüs oder den Werkzeugleisten zu finden.

Zurzeit unterstützt nur die Frameworks-Version benutzerdefinierbare Kurzbefehle (Menü Einstellungen → Kurzbefehle festlegen ...)

Dieser Abschnitt führt Sie nur in einige sehr grundlegende Funktionen von sed ein. Weiterführende Informationen finden Sie unter info:/sed oder https://www.gnu.org/software/sed/manual/html_mono/sed.html. Eine vorkompilierte Version für Windows® finden Sie unter http://unxutils.sourceforge.net. Beachten Sie, dass die folgenden Beispiele voraussetzen, dass der Befehl sed sich in einem Ordner in der PATH-Variable befindet. Falls das nicht der Fall sein sollte, müssen Sie den vollständigen Pfad zu sed angeben.

In diesem Kontext wird nur der sed-Ersetzungs-Befehl benutzt:

sed 's/REGEXP/REPLACEMENT/FLAGS'

Bevor Sie in KDiff3 einen neuen Befehl benutzen, sollten Sie ihn zuerst in der Konsole testen. Hier kann der echo-Befehl sehr hilfreich sein. Beispiel:

echo abrakadabra | sed 's/a/o/'
   -> obrakadabra

Dieses Beispiel zeigt einen einfachen sed-Befehl, der das erste Vorkommen von „a“ durch „o“ ersetzt. Wenn Sie alle Vorkommen ersetzen möchten, müssen Sie den Schalter „g“ benutzen:

echo abrakadabra | sed 's/a/o/g'
   -> obrokodobro

Das „|“-Symbol ist der Pipe-Befehl, er übergibt die Ausgabe des ersten Befehls an die Eingabe des folgenden Befehls. Wenn Sie Ihren sed-Befehl mit einer längeren Datei testen möchten, dann können Sie unter UNIX® cat und unter Windows® type dazu benutzen. sed wird die Ersetzung in jeder Zeile der Datei durchführen.

cat dateiname | sed optionen

Die Daten werden durch interne und externe Vorverarbeitungsbefehle in dieser Reihenfolge durchgeschleust:

Die Daten nach der normalen Vorverarbeitung werden für die Anzeige und zum Zusammenführen beibehalten. Die weiteren Operationen verändern nur die Daten, die der Zeilenabgleich-Algorithmus „sieht“.

Beachten Sie: In seltenen Fällen wenn Sie einen normalen Vorverarbeitungsbefehlverwenden, sieht der Zeilenabgleich-Vorverarbeitung die Ausgabe der normalen Vorverarbeitung als Eingabe.

Die Vorverarbeitungsbefehle sind sehr nützlich, aber wie bei jeder Funktion, die Text verändert oder Unterschiede ausblendet, können Sie versehentlich bestimmte Unterschiede nicht bemerken und im schlimmsten Fall wichtige Daten zerstören.

Beim Zusammenführen werden Sie daher von KDiff3 gewarnt, falls ein Vorverarbeitungsbefehl benutzt wurde. Sie werden gefragt, ob dieser deaktiviert werden soll oder nicht. Sie werden allerdings nicht gewarnt, wenn ein Vorverarbeitungsbefehl für den Zeilenabgleich benutzt wird. Das Zusammenführen ist nicht abgeschlossen bevor nicht alle Konflikte aufgelöst wurden. Falls Sie Unterschiedsansicht → Leerräume anzeigen deaktivihaben, dann sind die vom Vorverarbeitungsbefehl nur für Zeilenabgleich entfernten Unterschiede ebenfalls unsichtbar. Wenn der Knopf Speichern während des Zusammenführens deaktiviert bleibt (durch nicht aufgelöste Konflikte), dann aktivieren Sie Unterschiedsansicht → Leerräume anzeigen. Falls diese weniger wichtigen Unterschiede nicht zusammengeführt werden sollen, können Sie auch Zusammenführen → Für alle ungelösten Leerraum-Konflikte A/B/C wählen im Menü auswählen.

kdiff3 Ordner1 Ordner2
   kdiff3 Ordner1 Ordner2 -o Zielordner

Wenn kein Zielordner angegeben wurde, benutzt KDiff3 Ordner2.

kdiff3 Ordner1 Ordner2 Ordner3
   kdiff3 Ordner1 Ordner2 Ordner3 -o Zielordner

Wenn drei Ordner zusammengeführt werden, dann wird Ordner1 als Basis benutzt. Wenn kein Zielordner angegeben wurde, verwendet KDiff3 Ordner3 als Zielordner.

Beachten Sie, dass nur der Vergleich von Ordnern automatisch startet, nicht das Zusammenführen. Um das Zusammenführen zu starten, müssen Sie den entsprechenden Menüeintrag auswählen oder die F7-Taste drücken. (Weitere Details folgen.)

Jede Datei und jeder Ordner, die beim Verarbeiten gefunden wurde, wird hier in einem Baum dargestellt. Sie können ein Objekt mit einem einfachen Mausklick auswählen.

Die Ordnerstruktur wird normalerweise zusammengeklappt dargestellt. Sie können einen Ordner aufklappen, indem Sie auf das „+“/„-“ klicken, oder auf das Objekt doppelklicken oder indem Sie die Pfeiltasten Pfeil links/Pfeil rechts benutzen. Das Menü Ordner enthält zwei Funktionen Alle Unterordner einklappen und Alle Unterordner aufklappen mit denen Sie alle Ordner auf- bzw. zuklappen können.

Wenn Sie auf eine Datei doppelklicken, wird der Dateivergleich gestartet und es erscheint ein Vergleichsfenster.

Das Symbol in der Spalte „Name“ spiegelt den Dateityp im ersten Ordner (A) wieder. Diese Typen sind möglich:

Wenn der Dateityp in den anderen Ordnern unterschiedlich ist, dann ist dies in den Spalten A/B/C und in dem Detailfenster zu dem ausgewählten Objekt sichtbar. In einem solchen Fall kann die Zusammenführungsaktion nicht automatisch gewählt werden. Wenn das Zusammenführen gestartet wird, werden Sie über Probleme dieser Art nochmals informiert.

Wie in dem obigen Bild zu sehen ist, werden in den Spalten A/B/C die Farben Rot, Grün, Gelb und Schwarz verwendet.

Bei identischen Einträgen ist die Farbe allerdings auch identisch, auch wenn das Alter der Einträge unterschiedlich ist.

Ordner werden als identisch betrachtet, wenn ihr gesamter Inhalt identisch ist. Dann haben auch Ordner die gleiche Farbe. Bei Ordnern ist das Alter unerheblich für seine Farbe.

Die Idee zu diesem Farbschema basiert auf dirdiff. Die Farben spiegeln die Farben eines Blattes wieder, welches erst grün ist, dann gelb wird und später, wenn es alt ist, rot wird.

Nach dem Vergleichen der Ordner schlägt KDiff3 eine Zusammenführungsaktion vor. Dieser Vorschlag wird in der Aktions-Spalte angezeigt. Sie können den Vorschlag ändern, indem Sie auf den entsprechenden Eintrag klicken. Daraufhin erscheint ein kleines Menü, in dem Sie eine Aktion auswählen können. Die häufigsten Aktionen können Sie auch mit der Tastatur auswählen. Strg+1/2/3/4/Entf wählt entsprechend A/B/C/Zusammenführen/Löschen aus. Die Aktion wird dann während des Zusammenführens ausgeführt. Welche Aktionen möglich sind, hängt von dem Eintrag und dem aktuellen Zusammenführungs-Modus ab. Mögliche Zusammenführungs-Modi sind

Beim Zusammenführen von drei Ordnern sind diese Aktions-Vorschläge möglich: Wenn für ein Objekt...

Beim Zusammenführen von zwei Ordnern sind diese Aktions-Vorschläge möglich: Wenn für ein Objekt...

Der Modus zum Abgleich ist aktiv, wenn nur zwei Ordner und kein expliziter Zielordner angegeben wurden und wenn Ordner abgleichen aktiv ist. Dann wählt KDiff3 die nötige Aktion aus, damit nachher beide Ordner identisch sind. Wenn für einen Eintrag ...

Wenn zwei Ordner zusammengeführt werden und die Option Neuere Datei statt Zusammenführung auswählen (unsicher) aktiviert ist, dann untersucht KDiff3 das Datum der Dateien und schlägt die neuere Datei zum Kopieren vor. Wenn die Dateien unterschiedlich sind, aber das gleiche Datum aufweisen, dann erscheint eine Fehlermeldung „Fehler: Gleiches Datum, aber unterschiedliche Dateien.“. Solange solche Fehler nicht beseitigt sind, kann das Zusammenführen der Ordner nicht gestartet werden.

Während des Zusammenführens wird eine Datei nach der anderen abgearbeitet. Sie Status-Spalte zeigt Fertig an, wenn das Zusammenführen erfolgreich war, und entsprechend andere Meldungen, wenn etwas Unerwartetes auftrat. Wenn das Zusammenführen abgeschlossen ist, sollten Sie eine letzte Überprüfung vornehmen und nachsehen, ob der Status aller Einträge in Ordnung ist.

Wenn im Einrichtungsdialog die Dateivergleichsmethode Vollständige Analyse gewählt ist, wird KDiff3 weitere Spalten anzeigen. Diese enthalten die Anzahl ungelöster, gelöster, Nicht-Leerraum- und Leerraum-Konflikte. Die Spalte für gelöste Konflikte wird nur angezeigt, wenn drei Ordner verglichen oder zusammengeführt werden.

Mehrere Einstellungen beeinflussen, welche Dateien hier angezeigt werden. Einige dieser Optionen finden Sie im Einrichtungsdialog. Das Menü Ordner enthält folgende Aktionen:

Aktivieren Sie nur die Anzeige-Optionen für die Einträge, die aufgeführt werden sollen. Wenn Sie zum Beispiel nur alle Einträge zeigen möchten, die entweder nur in A oder B vorhanden sind, müssen Sie Dateien anzeigen, die nur in A existieren und Dateien anzeigen, die nur in B existieren aktivieren und alle anderen Einstellungen (Identische Dateien anzeigen, Unterschiedliche Dateien anzeigen, Dateien anzeigen, die nur in C existieren) ausschalten. Die Anzeige wird bei diesen Änderungen sofort aktualisiert.

Diese Einstellungen treffen auch mit einer Ausnahme für Ordner zu. Das Abschalten von Unterschiedliche Dateien anzeigen blendet keine vollständigen Ordner aus. Dies funktioniert nur für die Dateien in Ordnern.

Beachten Sie, das von diesen Einstellungen nur die Auswahl von Identische Dateien anzeigen beim Beenden gespeichert wird und daher beim nächsten Start wieder auf den gleichen Wert gesetzt ist. Alle anderen Einstellungen sind beim Start von KDiff3 aktiviert.

Normalerweise bleibt die Ansicht der Ordner-Zusammenführen während der Zusammenführung einzelner Dateien sichtbar. Sie können den Fensterteiler mit der Maus verschieben. Wenn Sie das nicht wollen, können Sie die Option mit Ordner → Ordner- & Textansicht teilen sich Hauptfenster abschalten und mittels Ordner → Zwischen Ordner- & Textansicht umschalten zwischen den beiden Ansichten umschalten.

Wahrscheinlich bevorzugen Sie, eine Datei einfach mittels Doppelklick zu vergleichen. Dennoch gibt es im Menü Ordner auch einen entsprechenden Menüeintrag. Sie können eine einzelne Datei auch direkt zusammenführen, ohne erst die Ordnerzusammenführen starten zu müssen. Dazu benutzen Sie die Funktion Zusammenführen → Aktuelle Datei zusammenführen . Sobald Sie das Ergebnis speichern, wird der Status auf „Erledigt“ gesetzt und die Datei wird nicht nochmals zusammengeführt, wenn Sie das Ordnerzusammenführen starten.

Dieser Status geht allerdings verloren, wenn Sie den Ordner erneut einlesen: Menü Ordner → Neu einlesen

Manchmal möchten Sie Dateien mit unterschiedlichen Namen vergleichen oder zusammenführen, z. B. die aktuelle Datei und eine Sicherungsdatei im selben Ordner.

Wählen Sie die Dateien, indem Sie auf das Symbol in der Spalte A, B oder Cklicken. Die erste ausgewählte Datei wird mit A und die zweite und dritte mit B und C gekennzeichnet, unabhängig von der Spalte, in der sie sich befinden. Nur bis zu drei Dateien können auf diese Art ausgewählt werden.

Wählen Sie dann Ordner → Explizit ausgewählte Dateien vergleichen oder Ordner → Explizit ausgewählte Dateien zusammenführen. Diese Einträge sind auch im Kontextmenü enthalten, das Sie mit Klicken der rechten Maustaste auf die zuletzt ausgewählte Datei öffnen können.

Der Vergleich oder die Zusammenführung einer Datei erfolgt im gleichen Fenster. Wird diese Methode auf Ordner angewendet, wird ein neues Fenster geöffnet.