# Das Handbuch zu &kdiff3;

Michael
Reeves

     reeves.87@gmail.com

Joachim
Eibl

     joachim.eibl at gmx.de

Thomas
Reitelbach

    tr@erdfunkstelle.de

Deutsche Übersetzung
2002-2007
Joachim Eibl
2017-2019
Michael Reeves
&FDLNotice;
2019-02-22
1.08.02

&kdiff3; ist ein Programm zum Anzeigen von Unterschieden und zum Zusammenführen von Dateien und Ordnern.

- vergleicht zwei oder drei Textdateien bzw. Ordner und führt sie zusammen,

- kann Unterschiede zeilenweise und sogar Zeichen für Zeichen anzeigen,

- hat eine Funktion zum automatischen Zusammenführen,

- enthält einen speziellen komfortablen Editor zum Auflösen von Konflikten beim Zusammenführen,

- ist mit Hilfe von KIO Netzwerktransparent,

- kann Unterschiede in Leerräumen oder Kommentaren besonders hervorheben oder ausblenden.

- unterstützt Unicode, UTF-8 und weitere Dateikodierungen.

- druckt Abweichungen,

- unterstützt Schlüsselwörter für Versionsverwaltung und Verlauf-Zusammenführung.

Dieses Dokument beschreibt &kdiff3; in der Version 1.8.

KDE
kdiff3
vergleichen
zusammenführen
CVS
dreifach-vergleichen
vergleichen
Dateien
Ordner
Versionskontrolle
Drei-Wege-Zusammenführen
Unterschiede innerhalb einer Zeile
synchronisieren
kpart
kio
netzwerktransparent
Editor
Leerraum
Kommentare

## Einführung

### Noch eine Oberfläche zu Diff?

Es gibt viele grafische Werkzeuge zum Vergleichen. Warum also &kdiff3;? Lassen Sie mich kurz erklären, warum ich das Programm geschrieben habe.

&kdiff3; wurde programmiert, weil ich eine sehr komplizierte Zusammenführung durchzuführen hatte. Zusammenführen wird dann nötig, wenn mehrere Personen an der gleichen Datei in einem Projekt arbeiten. Wenn das verwendete Werkzeug zum Zusammenführen nicht nur die geänderten Dateien (Branch genannt), sondern auch die Originale (Basis) zur Verfügung hat, kann das Zusammenführen gewissermaßen automatisiert werden. Das Programm wird dann automatisch die in der Branch gemachten Änderungen auswählen. Doch wenn mehrere Beitragende die gleichen Zeilen ändern, wird ein Konflikt erkannt. Solch ein Konflikt muss dann von Hand aufgelöst werden.

Die Zusammenführung war sehr kompliziert, weil einer der Beitragenden viele Änderungen vorgenommen und gleichzeitig an vielen Stellen die Einrückung korrigiert hatte. Ein weiterer Programmierer hatte in der gleichen Datei viel Text verändert. Das Ergebnis waren zahlreiche Konflikte beim Zusammenführen.

Das von mir benutzte Programm zeigte mir nur die geänderten Zeilen an, ich konnte aber nicht sehen, was genau sich innerhalb dieser Zeilen geändert hatte. Und es gab keinerlei Hinweise auf die Stellen, wo sich vielleicht nur die Einrückung geändert hatte. Das Zusammenführen dieser Änderungen war ein kleiner Albtraum.

Das war also der Beginn. Die erste Version von &kdiff3; konnte Unterschiede innerhalb einer Zeile und Änderungen an Leerräumen darstellen. Später wurden noch jede Menge weiterer nützlicher Funktionen hinzugefügt.

Wenn Sie zum Beispiel schnell Text vergleichen möchten, kopieren Sie ihn einfach in die Zwischenablage und fügen ihn in eines der Vergleichsfenster ein.

Eine Funktion die viel Arbeit machte, war das Vergleichen und Zusammenführen von Ordnern. Diese Funktion verwandelte &kdiff3; beinahe in einen vollwertigen Datei-Browser.

Ich hoffe, dass Sie viel Nutzen an &kdiff3; haben und wünsche Ihnen viel Freude!

Joachim Eibl (2003)

### Bildschirmfotos und Funktionen

Dieses Bildschirmfoto zeigt die Unterschiede zwischen zwei Textdateien

(Unter Verwendung einer frühen Version von &kdiff3;):

Auch 3-Wege-Zusammenführen wird vollständig unterstützt. Dies ist nützlich, wenn zwei Personen unabhängig voneinander an einem Quelltext arbeiten und Änderungen vornehmen. Die Originaldatei (die Basis) hilft &kdiff3; beim automatischen Auswählen der jeweils korrekten Änderungen. Der Zusammenführungs-Editor unter den Diff-Fenstern ermöglicht das Auflösen von Konflikten und zeigt gleichzeitig das zu erwartende Ergebnis an. In diesem Editor können Sie das Ergebnis sogar direkt bearbeiten. Das Bildschirmfoto zeigt drei Quell-Dateien beim Zusammenführen:

&kdiff3; hilft Ihnen auch beim Vergleichen und Zusammenführen kompletter Ordner. Dieses Bildschirmfoto zeigt &kdiff3; beim Ordnerzusammenführen:

### Weitere Funktionen

#### Zeilen- und sogar zeichenweises Darstellen von Unterschieden

&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.

#### Erkennen von Unterschieden in Leerräumen auf einen Blick

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.)

#### 3-Wege-Vergleichen

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.

#### Komfortables zusammenführen von zwei oder drei Dateien

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 zwischen den Knöpfen 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.

#### Und ...

- Schnelle Navigation über Knöpfe.

- Ein Mausklick in die Zusammenfassungs-Spalte gleicht alle Fenster ab, sodass alle die gleiche Stelle anzeigen.

- Kopieren Sie eine Auswahl aus irgendeinem Fenster einfach in das Ergebnisfenster.

- Die Übersichtsspalte zeigt an, wo sich Änderungen und Konflikte befinden.

- Die Farben sind an Ihre Bedürfnisse anpassbar.

- Die Größe von Unterfenstern ist veränderbar.

- Es gibt die Option, anstelle von Tabulatoren Leerzeichen einzufügen.

- Bequemes Öffnen von Dateien über einen Dialog oder über die Befehlszeile.

- Suchen (Strg-F) und Weitersuchen (F3) nach bestimmten Zeichenketten in allen Textfenstern.

- Anzeigen der Zeilennummer zu jeder Zeile.

- Einfügen aus der Zwischenablage oder das Ziehen von Text in ein Vergleichsfenster.

- Netzwerktransparenz durch KIO.

- &kdiff3; kann als Anzeigemodul in KDevelop 3 genutzt werden, um Unterschiede anzuzeigen.

- Zeilenumbruch für lange Zeilen

- Unterstützung für Unicode, UTF-8 und weitere Kodierungen.

- Unterstützung für Sprachen, die von rechts nach links geschrieben werden.

- ...

## Dateivergleichsmethode:

### Befehlszeilen-Optionen

#### Vergleichen von zwei Dateien:

    kdiff3 datei1 datei2

#### Zusammenführen von zwei Dateien:

    kdiff3 datei1 datei2 -m
       kdiff3 datei1 datei2 -o ausgabedatei

#### Vergleichen von drei Dateien:

    kdiff3 datei1 datei2 datei3

#### Zusammenführen von drei Dateien:

    kdiff3 datei1 datei2 datei3 -m
       kdiff3 datei1 datei2 datei3 -o ausgabedatei

Beachten Sie, dass datei1 als Basis für datei2 und datei3 verwendet wird.

#### Spezialfall: Dateien mit gleichem Namen

Wenn alle Dateien den gleichen Namen haben, aber in verschiedenen Ordnern liegen, dann können Sie sich die Tipparbeit erleichtern, indem Sie nur den Dateinamen der ersten Datei vollständig ausschreiben. Beispiel:

    kdiff3 Ordner1/Dateiname Ordner2 Ordner3

#### Befehlszeile zum Vergleichen bzw. Zusammenführen von Ordnern:

Das Vorgehen ist hier sehr ähnlich, doch nun geht es um Ordner.

    kdiff3 Ordner1 Ordner2
       kdiff3 Ordner1 Ordner2 -o Zielordner
       kdiff3 Ordner1 Ordner2 Ordner3
       kdiff3 Ordner1 Ordner2 Ordner3 -o Zielordner

Zum Vergleichen bzw. Zusammenführen von Ordnern lesen Sie bitte hier weiter.

#### Andere Befehlszeilen-Optionen

Mehr Informationen zu den Befehlszeilen-Optionen erhalten Sie mit diesem Befehl:

    kdiff3 --help

Beispielausgabe:

    kdiff3 --help
    Options:
      -m, --merge               Quellen zusammenführen.
      -b, --base file           Explizite Basisdatei. Für Kompatibilität mit anderen Programmen.
      -o, --output datei        Ausgabe-Datei. Impliziert -m. Z. B.: -o neueDatei.txt
      --out file                Ausgabe-Datei. (Für Kompatibilität mit anderen Programmen.)
      --auto                    Keine grafische Oberfläche, wenn alle Konflikte automatisch aufgelöst werden können. (Benötigt -o datei)
      --qall                    Konflikte nicht automatisch auflösen. (Aus Kompatibilitätsgründen.)
      --L1 alias1               Sichtbarer Namensersatz für Quelldatei 1 (Basis).
      --L2 alias2               Sichtbarer Namensersatz für Quelldatei 2.
      --L3 alias3               Sichtbarer Namensersatz für Quelldatei 3.
      -L, --fname alias         Alternativer sichtbarer Namensersatz. Für jede Quelldatei einmal angeben.
      --cs string               Eine Einstellung ändern. Je Einstellung verwendbar. z. B.: --cs „AutoAdvance=1“
      --confighelp             Liste aller Einstellungen und aktueller Werte anzeigen.
      --config file              Eine andere Einstellungsdatei verwenden.

Die Option `--cs` ermöglicht die Anpassung eines Konfigurationswertes, der ansonsten nur in einem Einrichtungsdialog geändert werden kann. Beachten Sie, das bei der Beendigung von &kdiff3; dieser geänderte Wert zusammen mit anderen Einstellungen gespeichert wird. Mit der Option `--confighelp` werden alle verfügbaren Einträge und deren aktuelle Werte angezeigt.

Mit `--config` können Sie eine andere Einrichtungsdatei vorgeben. Benutzen Sie &kdiff3; häufig mit verschiedenen unterschiedlichen Einstellungen, können Sie mit dieser Option leicht zwischen ihnen wechseln.

#### Ignorierbare Befehlszeilen-Optionen

&kdiff3; soll häufig mit einigen Versionsverwaltungssystemen verwendet werden. Wenn jedoch ein Versionsverwaltungssystem &kdiff3; mit Befehlszeilenparametern aufruft, die &kdiff3; nicht kennt und daher nicht verarbeiten kann, wird das Programm mit einem Fehler beendet. Diese Einstellung ermöglicht es, Befehlszeilenparameter anzugeben, die von &kdiff3; ignoriert werden sollen. Dies wird in der Hilfe wie folgt angezeigt:

    --foo                     Ignoriert. (Benutzerdefiniert.)

Ignorierbare Befehlszeilenoptionen:

  Eine Liste von Optionen, durch Semikolon ";" getrennt. Wird eine dieser Optionen auf der Befehlszeile benutzt, ignoriert &kdiff3; sie und startet ohne Fehlermeldung. Die Voreinstellung ist „u;query;html;abort“.

Wenn das nicht ausreicht, dann wird empfohlen, ein Shell-Skript zu schreiben, das die Optionen übersetzt.

### Dateiauswahl-Dialog

Weil mehrere Dateien auszuwählen sind, hat &kdiff3; einen besonderen Dialog zum Öffnen von Dateien:

Der Dateidialog ermöglicht die manuelle Eingabe von Dateinamen, die Auswahl über den Datei-Browser (Datei...) oder das Auswählen einer zuletzt geöffneten Datei aus dem Auswahlfeld. Der Dateidialog merkt sich Ihre Auswahl und zeigt sie beim nächsten Mal wieder an. Sie müssen keine dritte Datei angeben, wenn Sie den Eintrag für C leer lassen, wird die Analyse der Unterschiede mit zwei Dateien durchgeführt.

Über den Knopf Ordner... können Sie auch einen Ordner auswählen. Wenn Sie einen Ordner wählen, wird das Vergleichen bzw. Zusammenführen von Ordnern eingeleitet. Wenn für A eine Datei ausgewählt wird, für B und C jedoch ein Ordner, dann benutzt &kdiff3; den Dateinamen aus A in den beiden anderen Ordnern.

Wenn Zusammenführen angekreuzt ist, wird das Eingabefeld für Ziel aktiv und lässt sich bearbeiten. Es ist allerdings nicht unbedingt erforderlich, sofort eine Ausgabedatei festzulegen. Sie können diesen Schritt auch später beim Speichern erledigen.

Der Knopf Einrichten öffnet einen Dialog mit Einstellungen. Hier können Sie Optionen festlegen bevor Sie mit dem Vergleichen/Zusammenführen beginnen.

### Einfügen und Ablegen von Text

Manchmal möchte man nicht eine ganze Datei, sondern nur Teile eines Textes vergleichen. &kdiff3; ermöglicht Ihnen, Textteile aus der Zwischenablage in das aktive Vergleichsfenster einzufügen. Der Vergleich beginnt dann sofort. Im Dateidialog müssen Sie keine Dateien auswählen, Sie können den Dialog einfach mit dem Knopf Abbrechen schließen.

Sie können auch Ziehen und Ablegen benutzen: Ziehen Sie einfach eine Datei aus einem Dateiverwaltungsprogramm oder ausgewählten Text aus einem Editor und lassen Sie ihn über einem Vergleichsfenster fallen.

Welcher Gedanke steckt dahinter? Manchmal enthält eine Datei z. B. mehrere ähnliche Funktionen. Wenn Sie herausfinden möchten, wie ähnlich sich diese Funktionen sind, wäre das ein relativ großer Aufwand. Sie müssten erst zwei entsprechende Dateien erstellen, sie in &kdiff3; laden und diese dann vergleichen. Jetzt können Sie die relevanten Abschnitte einfach kopieren, einfügen und dann vergleichen.

Anmerkung: Zurzeit können Sie nichts aus &kdiff3; herausziehen. Nur das Fallenlassen von Text in ein Vergleichsfenster wird unterstützt.

Warnung: Einige Editoren interpretieren das Ziehen und Ablegen von Text in ein anderes Programm als Ausschneiden und Einfügen (anstelle von Kopieren und Einfügen). In einem solchen Fall könnten Ihre Originaldaten verloren gehen.

### Dateivergleiche und Interpretation der angezeigten Informationen in den Quellfenstern

#### Info-Zeile

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.

#### Farbgebung

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 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.

#### Zusammenfassungs-Spalte

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 Zeichenketten 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.

#### Übersichts-Spalte

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.

#### Zeilen manuell ausrichten

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 „Manuelle Ausrichtung hinzufügen“ (&Ctrl;Y) im Menü „Vergleichsansicht“. 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

#### Diff-Abschnitte manuell verbinden oder trennen

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 „Unterschied bei der Auswahlmarkierung trennen“ im Menü „Zusammenführung“. 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 „Markierte Unterschiede verbinden“ im Menü „Zusammenführen“.

### Zusammenführen und das editierbare Ergebnisfenster

Das Ergebnisfenster (unter den Vergleichsfenstern) hat auch eine Info-Zeile mit der Aufschrift Ausgabe:, dem Dateinamen und [Geändert] wenn Sie das Ergebnis bearbeitet haben. Üblicherweise enthält es durch das automatische Zusammenführen bereits Text, aber oft enthält es auch Konflikte.

Bis alle Konflikte aufgelöst sind, ist das Speichern deaktiviert. Benutzen Sie die Knöpfe Zu vorigem/nächstem gelösten/ungelösten Konflikt springen, um die noch verbleibenden Konflikte zu finden.

Wenn nur zwei Vergleichsfenster benutzt werden, ist jeder Unterschied gleichzeitig auch ein Konflikt, der manuell gelöst werden muss.

Bei drei Vergleichsfenstern wird die erste Datei als Basis verwendet, und die zweite und dritte Datei enthalten die Änderungen. Wenn eine Zeile nur in Datei B oder C geändert wurde, aber nicht in beiden, dann wird automatisch die richtige Änderung ausgewählt. Wenn B und C allerdings Änderungen in der gleichen Zeile enthalten, erkennt &kdiff3; einen manuell zu lösenden Konflikt. Wenn B und C identisch sind, sich aber von A unterscheiden, dann wird C als Quelle ausgewählt.

#### Die Zusammenfassungs-Spalte

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.

#### Einstellung der aktuellen Gruppe und Abgleich der Zusammenführungs- und Diff-Ansichtspositionen

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.

#### Auswahl der Eingabe A, B oder C für den aktuellen Konflikt und zur Bearbeitung

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 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.

#### Auswahl der Eingabe A, B oder C für alle Konflikte

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.

Hinweis: Wenn beim Auswählen der Quellen die Optionen Zahlen ignorieren oder C/C++ Kommentare ignorieren aktiviert sind, werden Änderungen in Zahlen oder Kommentaren auch wie Leerräume behandelt.

#### Automatische Zusammenführung von Schlüsselwörtern von Versionskontrollsystemen und dem Verlauf (Protokoll)

Viele Versionsverwaltungssysteme unterstützen Schlüsselwörter in der Datei wie "$Date$", "$Header$", "$Author$", "$Log$" &etc; 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“ 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 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:

    \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+.*

Dieser Ausdruck wurde in zwei Teile getrennt, da er sonst zu lang ist. Weitere Informationen über reguläre Ausdrücke finden Sie in der Trolltech-Dokumentation. 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 unter Zusammenführung-Einstellungen.

### Navigieren und Bearbeiten

Navigiert wird hauptsächlich mit den Bildlaufleisten und der Maus, aber Sie können dazu auch die Tastatur benutzen. Wenn Sie in eines der Fenster klicken, können Sie die Pfeiltasten links, rechts, hoch, runter, Bild auf, Bild ab, Pos1, Ende, Strg+Pos1 und Strg+Ende benutzen, so wie Sie es auch von anderen Programmen gewohnt sind. Die Übersichts-Spalte neben der vertikalen Bildlaufleiste kann durch hineinklicken auch zum Navigieren benutzt werden.

Außerdem können Sie das Mausrad zum hoch- und runterblättern benutzen.

Im Ausgabefenster können Sie auch die anderen Tasten zum Bearbeiten verwenden. Mit der Taste Einfg können Sie zwischen Einfüge- und Überschreibmodus wechseln. (Voreingestellt ist der Einfügemodus.)

Ein Klick mit der linken Maustaste in eine der Zusammenfassungs-Spalten gleicht die Ansicht aller Fenster auf den Anfang der jeweiligen Gruppe von Zeilen ab, wie bereits im Abschnitt Einstellung der aktuellen Gruppe und Abgleich der Zusammenführungs- und Diff-Ansichtspositionen erläutert wird.

Die Werkzeugleiste enthält neun Knöpfe zur Navigation, mit denen Sie zum aktuellen/ersten/letzten Unterschied, zum nächsten/vorigen Unterschied (Strg+Pfeil runter/Strg+Pfeil hoch), zum nächsten/vorigen Konflikt (Strg+Bild Auf/Strg-Bild ab) oder zum nächsten/vorigen ungelösten Konflikt springen können. Beachten Sie, dass &kdiff3; alle nicht automatisch gelösten Konflikte auch nach dem manuellen Lösen weiterhin als Konflikt betrachtet. Daher muss zwischen gelösten und ungelösten Konflikten unterschieden werden.

#### Automatisch weitergehen

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 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.

### Markieren, Kopieren und Einfügen

In den Vergleichsfenstern wird kein Cursor angezeigt, daher müssen Markierungen mit der Maus gemacht werden. Drücken Sie am Beginn der Markierung die linke Maustaste und halten Sie sie gedrückt, ziehen Sie die Maus dann bis zum Ende der Markierung und lassen Sie hier die Maustaste wieder los. Ein einzelnes Wort kann auch einfach durch einen Doppelklick darauf markiert werden. Im Ergebnisfenster können Sie zum Markieren auch die Tastatur benutzen. Drücken Sie dazu die Umschalt-Taste und verändern Sie die Markierung mit den Pfeiltasten.

Wenn die Auswahl den auf dem Bildschirm angezeigten Bereich überschreitet, schieben Sie den Mauszeiger über den Rand des Fensters. Dann blättert &kdiff3; in dieser Richtung.

Für eine sehr große Auswahl können Sie auch die Navigationstasten zusammen mit gedrückter Maustaste verwenden. Benutzen Sie zum Beispiel die Tasten „Bild ab“ und „Bild auf“, um schnell zu einer bestimmten Position zu gehen. Haben Sie die gewünschte Endposition erreicht, lassen Sie die Maustaste los.

Um den gesamten Text im aktuellen Fenster auszuwählen, benutzen Sie im Menü Bearbeiten Alles auswählen (Ctrl+A).

Um die Markierung in die Zwischenablage zu kopieren, müssen Sie den Knopf Kopieren (Strg+C oder Strg+Einfg) drücken. Es gibt auch die Option Auswahl automatisch kopieren. Wenn diese aktiviert ist, wird, was immer Sie markieren, automatisch in die Zwischenablage kopiert und das manuelle Kopieren entfällt. Seien Sie mit dieser Option aber vorsichtig, denn Sie könnten so den Inhalt der Zwischenablage versehentlich überschreiben.

„Ausschneiden“ (Strg-X oder Umschalt-Entf) kopiert in die Zwischenablage und löscht den markierten Text.

„Einfügen“ (Strg-V oder Umschalt-Einfg) fügt den Text aus der Zwischenablage an der aktuellen Cursor-Position ein bzw. ersetzt die aktuelle Markierung. Wenn Sie den Inhalt der Zwischenablage in eines der Diff-Eingabefenster fügen, wird er hier angezeigt und der Vergleich wird sofort wieder neu gestartet. Dies ist nützlich, wenn Sie einen beliebigen Text irgend woher mit einem anderen Text vergleichen möchten, ohne dafür zuerst Dateien zu erstellen.

### Speichern

Speichern ist erst möglich, wenn alle Konflikte gelöst sind. Falls die Datei bereits existiert und die Option Sicherungskopie erstellen aktiviert ist, dann erhält die bestehende Datei die Endung .orig. Wenn bereits eine .orig-Datei existiert, wird diese überschrieben. Wenn Sie einen weiteren Vergleich starten bzw. beenden und noch nicht gespeichert haben, dann fragt &kdiff3;, ob Sie Speichern, Abbrechen oder ohne zu speichern fortfahren möchten. (&kdiff3; fängt allerdings keine System-Signale ab. Wenn Sie &kdiff3; also mit dem Signal kill beenden, gehen Ihre nicht gespeicherten Daten verloren.)

Zeilenenden werden entsprechend dem zugrunde liegenden Betriebssystem gespeichert. Unix-Varianten verwenden ein Zeilenvorschub-Zeichen \n, und Win32-basierte Systeme benutzen Wagenrücklauf + Zeilenvorschub \r\n. &kdiff3; behält die Zeilenenden der Quelldateien nicht bei, darum sollten Sie &kdiff3; auch nicht mit Binärdateien verwenden.

### Suchen und Finden von Zeichenketten

Sie können in jedem Textfenster von &kdiff3; nach einer Zeichenkette suchen. Die Funktion Suchen... (Strg+F) im Menü Bearbeiten öffnet einen Dialog, in dem Sie die zu suchende Zeichenkette eingeben können. Eine Suche beginnt immer am Anfang. Mit der Funktion Weitersuchen (F3) können Sie zum nächsten Vorkommen der gesuchten Zeichenkette springen. Wenn Sie eine Suche über mehrere Fenster aktiviert haben, wird erst das erste Fenster vom Beginn bis zum Ende durchsucht, danach das nächste Fenster &etc;

### Drucken

&kdiff3; unterstützt das Drucken von Unterschieden für Textdateien. Mit der Aktion Drucken ... aus dem Menü Datei öffnen Sie einen Dialog, in dem der Drucker ausgewählt und weitere Einstellungen angepasst werden können.

Es gibt mehrere Möglichkeiten, den Druckbereich einzustellen. Da sich die Druckerdialoge auf den verschiedenen Betriebssystemen unterscheiden, ist das Verfahren zur Einstellung des Druckbereichs auch unterschiedlich.

Alles drucken

  Druckt alle Unterschiede

Aktuell:

  Druckt eine Seite, die mit der ersten sichtbaren Zeile des Fensters beginnt. Auf Systemen ohne diese Einstellung verwenden Sie dazu die Angabe von Zeile 10000 für das Drucken.

Auswahl:

  Wählen Sie vor dem Drucken Text mit der Maus wie für das Kopieren und Einfügen in einem der Diff-Eingabefenster, um die erste und letzte Zeile zu definieren. Ist kein Text in einem der Diff-Eingabefenster ausgewählt, ist diese Einstellung deaktiviert. Auf Systemen ohne diese Einstellung dann dies mit der Angabe einer Zeilennummer von 9999 erreicht werden.

Bereich:

  Bestimmt die erste und letzte Seite des Drucks.

Weitere wichtige Einstellungen zum Drucken können wie üblich ausgewählt werden:

- Schrift und Schriftgröße

- Zeilennummern anzeigen

- Zeilenumbruch

- Farben

- &etc;

Das Querformat wird für das Ausdrucken empfohlen.

### Optionen

Die Optionen und die Liste der zuletzt verwendeten Dateien wird beim Beenden automatisch gespeichert und beim nächsten Start wiederhergestellt. (Menü Einstellungen->&kdiff3; einrichten ...)

#### Schriftart

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.)

Kursivschrift bei Unterschieden:

  Wenn Sie diese Option aktivieren, werden Unterschiede in kursiver Schrift dargestellt. Wenn die gewählte Schrift diese Darstellung nicht unterstützt, passiert gar nichts.

#### Farben

Vordergrundfarbe:

  Üblicherweise Schwarz.

Hintergrundfarbe:

  Üblicherweise Weiß.

Hintergrundfarbe bei Unterschieden:

  Üblicherweise helles Grau.

Farbe für A:

  Üblicherweise dunkles Blau.

Farbe für B:

  Üblicherweise dunkles Grün.

Farbe für C:

  Üblicherweise dunkles Magenta.

Farbe für Konflikte:

  Üblicherweise Rot.

Hintergrundfarbe für aktuellen Bereich:

  Üblicherweise helles Gelb.

Hintergrundfarbe für Unterschiede im aktuellen Bereich:

  Üblicherweise dunkles Gelb.

Farbe für manuell ausgewählte Unterschiede:

  Üblicherweise Orange.

Farbe für neueste Datei in der Ordnervergleichsansicht:

  Üblicherweise Grün.

Farbe für älteste Datei in der Ordnervergleichsansicht:

  Üblicherweise Rot.

Farbe für mittelalte Datei in der Ordnervergleichsansicht:

  Üblicherweise dunkles Gelb.

Farbe für fehlende Datei in der Ordnervergleichsansicht:

  Üblicherweise Schwarz.

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.

#### Editoreinstellungen

Tabulator fügt Leerzeichen ein:

  Wenn diese Option aktiviert ist, wird beim Drücken der Tabulator-Taste die entsprechende Anzahl an Leerzeichen eingefügt. Ansonsten wird ein Tabulator-Zeichen eingefügt.

Tabulatorweite:

  Kann nach Ihren persönlichen Vorstellungen eingestellt werden. Voreingestellt ist 8.

Automatisch einrücken:

  Wenn Sie die Eingabetaste drücken, wird die Einrückung der vorangehenden Zeile automatisch auch für die nächste Zeile verwendet.

Auswahl automatisch kopieren:

  Wenn diese Option aktiviert ist, wird jede Auswahl automatisch in die Zwischenablage kopiert. Das manuelle Kopieren in die Zwischenablage entfällt dann.

Zeilenende-Kodierung:

  Sie können auswählen, welchen Zeilenende-Kodierung Sie zum Speichern bevorzugen. Der voreingestellte Wert ist die allgemein übliche Auswahl auf dem verwendeten Betriebssystem.

#### Diff-Optionen

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.

Zahlen ignorieren

  In der Voreinstellung ist diese Option deaktiviert. Im ersten Teil der Analyse werden Zahlen und zugehörige Zeichen ('0'-'9', '.', '-') ignoriert. Im Ergebnis werden die Unterschiede dennoch angezeigt, aber sie werden wie Leerräume behandelt.

C/C++-Kommentare ignorieren

  In der Voreinstellung ist diese Option deaktiviert. Änderungen in Kommentaren werden wie Änderungen in Leerräumen behandelt.

Unterschiede bei Groß- und Kleinschreibung ignorieren

  In der Voreinstellung ist diese Option deaktiviert. Unterschiede in einzelnen Zeichen (wie z. B. 'A' und 'a') werden wie Unterschiede in Leerräumen behandelt.

Vorverarbeitungsbefehl:

  Siehe nächster Abschnitt.

Vorverarbeitungsbefehl nur für Zeilenabgleich:

  Siehe nächster Abschnitt.

Aufwendig suchen (langsamer):

  Intensiv nach noch kleineren Unterschieden suchen. Die Option ist in der Voreinstellung aktiviert. Sie ist effektiv bei komplizierten und großen Dateien, aber langsam bei sehr großen Dateien.

#### Einstellungen für das Zusammenführen

Verzögerung für das automatische Weiterspringen (ms):

  In diesem Modus bestimmt diese Einstellung, wie lange das Ergebnis der Auswahl angezeigt wird, bevor zum nächsten ungelösten Konflikt weitergesprungen wird.

Leerraum-Autoauswahl bei 2 Dateien:

  Löst automatische alle Konflikte in Leerräumen, indem die gewählte Datei als Quelle benutzt wird. (Voreingestellt ist manuelle Auswahl.) Das ist nützlich, wenn Leerräume in vielen Dateien weniger wichtig sind. Wenn Sie dies nur von Zeit zu Zeit benötigen, dann nutzen Sie besser die Funktionen Für alle ungelösten Leerraum-Konflikte A/B/C wählen aus dem Menü Zusammenführen.Beachten Sie, dass die Automatische Auswahl auch Konflikte in Zahlen oder Kommentaren betrifft, wenn die Optionen Zahlen ignorieren oder C/C++-Kommentare ignorieren aktiviert sind.

Regulärer Ausdruck für automatische Zusammenführung:

  Regulärer Ausdruck für Zeilen, für die automatisch eine Quelle auswählen soll. Siehe auch Automatische Zusammenführung.

Zusammenführung über regulären Ausdruck beim Start einer Zusammenführung durchführen:

  Ist diese Einstellung aktiviert, benutzt &kdiff3; beim Zusammenführen einen Regulären Ausdruck für automatische Zusammenführung, wenn die Zusammenführung gestartet wird.

Regulärer Ausdruck für Verlauf-Start:

  Regulärer Ausdruck für die Startzeile des Versionsverwaltungs-Verlaufs. Normalerweise enthält diese Zeile das Schlüsselwort „$Log$“.Voreinstellung: „.*\$Log.*\$.*“

Regulärer Ausdruck für Verlauf-Eintrag-Startzeile:

  Ein Verlaufseintrag für eine Versionsverwaltung besteht aus mehreren Zeilen. Geben Sie einen regulären Ausdruck an, um die erste Zeile (ohne die voranstehenden Kommentarzeichen) zu erkennen. Verwenden Sie runde Klammern, um Sortierschlüssel zu gruppieren. Fehlen diese Angaben, nimmt &kdiff3; an, dass die Verlauf-Einträge durch Leerzeilen getrennt sind. Siehe auch Automatische Zusammenführung ....

Sortierte Verlauf-Zusammenführung:

  Sortierung der Verlauf-Einträge für Versionsverwaltungssystemen aktivieren

Sortierschlüsselreihenfolge für Verlauf-Eintragsstart:

  Jedes runde Klammer im regulären Ausdruck des Verlauf-Start-Eintrags gruppiert einen Schlüssel, der für die Sortierung verwendet werden kann. Geben Sie eine Liste der Schlüssel an (nummeriert in der Auftrittsreihenfolge, mit 1 beginnend), wobei das Komma als Trennzeichen verwendet wird. (z. B.: „4,5,6,1,2,3,7“). Wenn der Eintrag leer ist, wird keine Sortierung durchgeführt. Siehe auch Automatische Zusammenführung ....

Versionsverwaltungs-Verlauf beim Start einer Zusammenführung zusammenführen:

  Ist diese Einstellung aktiviert, benutzt &kdiff3; beim der automatischen Zusammenführung des Verlaufs die zuvor genannten Einstellungen, wenn die Zusammenführung gestartet wird.

Maximale Anzahl Verlauf-Einträge:

  &kdiff3; kürzt die Verlaufsliste auf die angegebene Anzahl von Einträgen. Verwenden Sie den Wert -1, die Voreinstellung, um das zu verhindern.

Testen Sie Ihre regulären Ausdrücke

  Mit diesem Knopf wird ein Dialog angezeigt, in dem Sie die oben genannten regulären Ausdrücke verbessern und testen können. Kopieren Sie die relevanten Zeilen aus Ihrer Datei in die Beispielzeile. Das Übereinstimmungsergebnis zeigt sofort an, ob der Ausdruck passt. Das Sortierschlüsselergebnis zeigt den verwendeten Schlüssel für die Sortierung der Verlaufszusammenführung.

Befehl bei irrelevanter Zusammenführung:

  Geben Sie einen eigenen Befehl ein, der aufgerufen wird, wenn &kdiff3; feststellt, dass beim Zusammenführen von drei Dateien die Datei B keine wesentlichen Daten beiträgt, die nicht auch schon in C enthalten sind. Dieser Befehl wird mit den drei Dateinamen als Parameter aufgerufen, Daten die auf „Regulärer Ausdruck für automatische Zusammenführung“ passen oder bereits im Verlauf enthalten sind, werden als unwesentlich betrachtet.

#### Ordnerzusammenführung

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:

Sicherungskopie erstellen (.orig):

  Wenn eine Datei gespeichert wird und bereits eine ältere Version existiert, dann wird der Originalversion das Suffix .orig angehängt. Wenn bereits eine solche Sicherungsdatei mit dem Suffix .orig existiert, wird diese ohne weitere Sicherung gelöscht.

#### Regional- und Spracheinstellungen

Sprache:

  Passt die Sprache der Benutzeroberfläche an. Das Ändern dieser Option betrifft nicht das aktuell laufende Programm. Sie müssen &kdiff3; beenden und neu starten, damit die Änderung aktiv wird. Diese Option ist in der Frameworks-Version von &kdiff3; nicht verfügbar.

Überall die gleiche Kodierung verwenden:

  Die folgenden Kodierungseinstellungen können für jeden Eintrag separat eingestellt werden. Wenn man diese Option aktiviert, wird für alle Einträge die obere Einstellung verwendet.

Lokale Kodierung:

  Über den Auswahlfeldern für die Kodierung erscheint ein kurzer Hinweis, was die lokale Kodierung ist. (Dies kann hier nicht geändert werden und hat für Sie rein informellen Charakter.)

Datei-Kodierung für A/B/C:

  Passen Sie die Datei-Kodierung für Quelldateien an. Dies beeinflusst, wie Sonderzeichen behandelt und interpretiert werden. Da die Kodierung für jede Datei einzeln einstellbar ist, können selbst Dateien mit unterschiedlicher Kodierung verglichen und zusammengeführt werden.

Dateikodierung für Zusammenführung und Speichern:

  Wenn Sie eine Datei bearbeitet haben, können Sie hier festlegen, welche Kodierung zum Speichern verwendet werden soll.

Dateikodierung für Vorverarbeitungs-Dateien:

  Wenn Sie Vorverarbeitungsbefehle definieren, könnten sie eventuell nicht mit Ihrem Codec funktionieren. (Z. B. könnten Ihre Dateien 16-Bit Unicode sein, aber der Vorverarbeitungsbefehl kann nur mit 8-Bit ASCII umgehen.) Mit dieser Option kann man die Kodierung der Ausgabe von Vorverarbeitungsbefehlen festlegen.

Rechts-nach-Links-Sprache:

  Einige Sprachen werden von Rechts nach Links geschrieben. Wenn diese Option aktiviert ist, zeigt &kdiff3; den Text in Vergleichs- und Zusammenführungs-Fenstern von Rechts nach Links an. Wenn Sie &kdiff3; mit der Option --reverse starten, wird das gesamte Layout der Programmoberfläche von Rechts nach Links angezeigt. (Dies ist eine Funktion von Qt.) Diese Dokumentation wurde unter der Annahme geschrieben, dass Rechts-nach-Links Sprache und umgedrehtes Layout abgeschaltet sind. Wenn Sie diese Optionen verwenden, müssen Sie also Referenzen auf Rechts und Links entsprechend umkehren.

#### Verschiedenes

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

Zeilennummern anzeigen:

  Sie können wählen, ob in den Quelldateien die Zeilennummern angezeigt werden sollen.

Leerzeichen und Tabulator-Zeichen in Unterschieden anzeigen:

  Manchmal sind sichtbare Leerzeichen und Tabulatoren störend. Sie können die Anzeige dieser Zeichen abschalten.

Leerräume anzeigen:

  Schalten Sie dies ab, um Hervorhebungen von Änderungen in Leerräumen in den Text- oder Übersichtsspalten zu unterdrücken. (Hinweis: Dies gilt auch für Änderungen in Zahlen oder Kommentaren, wenn die Optionen Zahlen ignorieren oder C/C++-Kommentare ignorieren aktiviert sind.)

Übersichts-Optionen:

  Dieses Auswahl ist nur verfügbar, wenn Sie drei Dateien vergleichen. Im normalen Modus werden alle Unterschiede in einer farblich kodierten Übersichts-Spalte angezeigt. Aber manchmal möchten Sie vielleicht nur die Unterschiede zwischen zwei von drei Dateien sehen. Nach Auswahl von A <-> B, A <-> C oder B <-> C wird neben der normalen noch eine zweite Übersichts-Spalte mit den benötigten Informationen angezeigt.

Zeilenumbruch für Vergleichsanzeige:

  Aktiviert den Zeilenumbruch in der Vergleichsanzeige, wenn die Länge einer Zeile die Breite des Fensters überschreitet.

Fenster A/B/C anzeigen:

  Manchmal möchte man den verfügbaren Platz auf dem Bildschirm lieber für lange Zeilen benutzen. Blenden Sie einfach die weniger wichtigen Fenster aus. Diese Option befindet sich im Menü Fenster.

Ausrichtung der Fensterteilung umschalten:

  Ordnet die Vergleichsfenster nebeneinander oder übereinander an. Dies kann auch zum Anzeigen von langen Zeilen nützlich sein. Diese Option befindet sich im Menü Fenster.

Aktuelle Datei zusammenführen:

  Manchmal betrachten Sie die Unterschiede und entscheiden sich dann unvermittelt, die Dateien zusammenzuführen. Aktuelle Datei zusammenführen im Menü Zusammenführen funktioniert auch dann, wenn Sie nur zwei Dateien vergleichen. Ein einfacher Klick startet die Zusammenführung und benutzt den Dateinamen der letzten Quelldatei als voreingestellten Namen für die Ausgabedatei. Wenn diese Funktion benutzt wird, um das Zusammenführen erneut zu starten, dann wird der Name der zuletzt benutzten Ausgabedatei beibehalten.

#### Kurzbefehle festlegen

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

### Vorverarbeitungsbefehle

&kdiff3; unterstützt zwei Vorverarbeitungsbefehle.

Vorverarbeitungsbefehl:

  Beim Lesen einer Datei wird sie zuerst diesem externen Befehl übergeben. In &kdiff3; wird dann die Ausgabe des Befehls sichtbar, und nicht die Datei selbst. Sie können Ihren eigenen Vorverarbeitungsbefehle schreiben, die genau Ihre Ansprüchen erfüllen. Sie können diese Funktion z. B. zum Herausschneiden störender Teile oder zum Korrigieren der Einrückung verwenden.

Vorverarbeitungsbefehl nur für Zeilenabgleich:

  Beim Lesen einer Datei wird sie zuerst diesem externen Befehl übergeben. Wenn auch ein normaler Vorverarbeitungsbefehl angegeben wurde (siehe oben), dann ist die Ausgabe des Befehls die Eingabe dieses Vorverarbeitungsbefehls. Die Ausgabe des Befehls wird nur beim Zeilenabgleich verwendet. Sie können Ihre eigenen Vorverarbeitungsbefehle schreiben, der genau Ihre Ansprüchen erfüllen. Jede Eingabe-Zeile muss eine zugehörige Ausgabe-Zeile haben.

Der Gedanke dahinter ist, dem Anwender mehr Flexibilität beim Einrichten der Diff-Ergebnisse zu ermöglichen. Doch dafür wird ein externes Programm benötigt, und die meisten Anwender möchten das nicht selbst programmieren. Die Gute Nachricht ist allerdings, dass in dem meisten Fällen `sed` oder `perl` vollkommen ausreichen.

Beispiel: Ein einfacher Testfall. Wie nehmen eine Datei a.txt (6 Zeilen):

          aa
          ba
          ca
          da
          ea
          fa

Und eine Datei b.txt (3 Zeilen):

          cg
          dg
          eg

Ohne Vorverarbeitung würden die folgenden Zeilen nebeneinander stehen:

          aa - cg
          ba - dg
          ca - eg
          da
          ea
          fa

Dies ist allerdings nicht das gewünschte Ergebnis, weil der erste Buchstabe die interessante Information darstellt. Um den Suchalgorythmus beim Abgleich zu unterstützen, ignorieren wir den zweiten Buchstaben. Dazu kann folgende Zeilen-Vorverarbeitung verwendet werden, der g durch a ersetzt:

       sed 's/g/a/'

Mit diesem Befehl würde das Ergebnis so aussehen:

          aa
          ba
          ca - cg
          da - dg
          ea - eg
          fa

Programmintern sieht der Vergleichsalgorythmus die Dateien erst nach dem Durchlauf de Zeilen-Vorverarbeitung, auf dem Bildschirm jedoch erscheinen die Dateien unverändert. (Die normale Vorverarbeitung würde auch die Daten auf dem Bildschirm ändern.)

#### `sed`-Grundlagen

Dieser Abschnitt führt Sie nur in einige sehr grundlegende Funktionen von `sed` ein. Weiterführende Informationen finden Sie unter info:/sed oder http://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`-Substitute-Befehl benutzt:

       sed 's/REGEXP/ERSATZ/SCHALTER'

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 Window `type` dazu benutzen. `sed` wird die Ersetzung in jeder Zeile der Datei durchführen.

    cat dateiname | sed optionen

#### Beispielanwendungen von `sed` in &kdiff3;

##### Ignorieren weiterer Kommentartypen

Zurzeit unterstützt &kdiff3; nur C/C++-Kommentare. Mit Hilfe des Vorverarbeitungsbefehl nur für Zeilenabgleich können Sie auf andere Kommentar-Arten unterstützen. Dafür wandeln Sie diese in C/C++-Kommentare um. Beispiel: Um Kommentare zu ignorieren, die mit # beginnen, würden Sie diese zu // umwandeln. Außerdem muss natürlich die Option C/C++-Kommentare ignorieren aktiviert sein damit dies etwas bewirkt. Ein passender Befehl für den Vorverarbeitungsbefehl nur für Zeilenabgleich wäre zum Beispiel:

       sed 's/#/\/\//'

Weil das Zeichen / für `sed` ein Sonderzeichen ist, muss jedem / ein \ vorangestellt werden. Manchmal wird dies benötigt, um einem Sonderzeichen die besondere Bedeutung zu entziehen. Die einfachen Anführungszeichen (') sind nur beim Testen auf der Befehlszeile wichtig, weil die Shell sonst versucht, einige Zeichen zu verarbeiten. In KDiff3 werden nur die Escape-Sequenzen wie '\"' und '\\' verarbeitet.

##### Diff ohne Beachtung der Groß-/ Kleinschreibung

Verwenden Sie diesen Vorverarbeitungsbefehl für Zeilenabgleich um die Eingabe in Großbuchstaben umzuwandeln:

       sed 's/\(.*\)/\U\1/'

Das .* ist ein regulärer Ausdruck, der auf jede Zeichenkette passt und in diesem Zusammenhang daher alle Zeichen in einer Zeile erfasst. Die \1 in der Ersetzungs-Zeichenkette bezieht sich auf den gefundenen Text im ersten Klammerpaar. Das \U wandelt den gefundenen Text in Großbuchstaben um.

##### Ignorieren von Schlüsselwörtern aus Versionskontrolle-Systemen

CVS und andere Versionskontrolle-Systeme verwenden einige Schlüsselwörter, um automatisch erzeugte Zeichenketten einzufügen (info:/cvs/Keyword substitution). Alle folgen demselben Muster $SCHLÜSSELWORT erzeugter Text$. Nun wird also ein Vorverarbeitungsbefehl für Zeilenabgleich benötigt, der den automatisch erzeugten Text entfernt:

       sed 's/\$\(Revision\|Author\|Log\|Header\|Date\).*\$/\$\1\$/'

Das \| trennt die möglichen Schlüsselwörter. Sie können die Liste nach Bedarf ändern. Das \ vor dem $ ist nötig, weil $ ein Sonderzeichen ist und Ende der Zeile bedeuten würde.

Während Sie mit `sed` experimentieren, beginnen Sie vielleicht, es zu verstehen und vielleicht mögen Sie diese regulären Ausdrücke sogar. Sie sind sehr nützlich weil es viele Programme gibt, die sehr ähnliche Dinge unterstützen.

##### Ignorieren von Zahlen

Das Ignorieren von Zahlen ist eigentlich eine bereits eingebaute Funktion in KDiff3. Aber sie ist gut als Beispiel für einen weiteren Vorverarbeitungsbefehl für Zeilenabgleich geeignet.

       sed 's/[0123456789.-]//g'

Jedes Zeichen zwischen '[' und ']' ist eine Übereinstimmung, und jede Übereinstimmung wird durch nichts ersetzt, also quasi gelöscht.

##### Ignorieren von bestimmten Spalten

Manchmal ist ein Text nach strengen Regeln formatiert und enthält Spalten, die Sie grundsätzlich ignorieren möchten, und andere Spalten, die Sie für die Analyse heranziehen möchten. Im folgenden Beispiel werden die ersten fünf Spalten (Zeichen) ignoriert, dann 10 Spalten beibehalten, dann wieder fünf Spalten ignoriert und der Rest der Zeile wird beibehalten.

       sed 's/.....\(..........\).....\(.*\)/\1\2/'

Jeder Punkt '.' passt auf genau ein Zeichen. Die \1 und \2 in der Ersetzungs-Zeichenkette beziehen sich auf den gefundenen Text im ersten und zweiten Klammerpaar und markieren so den beizubehaltenden Text.

##### Mehrere Ersetzungen kombinieren

Manchmal möchten Sie vielleicht mehrere Ersetzungen auf einmal durchführen. Dann können Sie das Semikolon „;“ benutzen, um die Ersetzungen voneinander zu trennen. Beispiel:

    echo abrakadabra | sed 's/a/o/g;s/\(.*\)/\U\1/'
       -> OBROKODOBRO

##### `perl` statt `sed` benutzen

Statt `sed` können Sie auch etwas anderes wie z. B. `perl` verwenden.

       perl -p -e 's/REGEXP/ERSETZUNG/SCHALTER'

Allerdings sind bei `perl` einige Details anders. Wo `sed` \( und \) benötigt, braucht `perl` nur noch ( und ) ohne das vorangestellte '\'. Beispiel:

    sed 's/\(.*\)/\U\1/'
       perl -p -e 's/(.*)/\U\1/'

#### Reihenfolge der Ausführung von Vorverarbeitungsbefehlen

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

- Normale Vorverarbeitungsbefehle,

- Vorverarbeitungsbefehl für Zeilenabgleich,

- Groß-/Kleinschreibung ignorieren (Umwandlung in Großbuchstaben),

- Erkennung von C/C++ Kommentaren,

- Zahlen ignorieren,

- Leerräume ignorieren

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.

#### Warnung

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 Leerräume anzeigen deaktiviert haben, dann sind die vom Zeilenabgleich-Vorverarbeitung entfernten Unterschiede ebenfalls unsichtbar. Wenn der Knopf Speichern während des Zusammenführens deaktiviert bleibt (durch nicht aufgelöste Konflikte), dann aktivieren Sie Leerräume anzeigen. Falls diese weniger wichtigen Unterschiede nicht zusammengeführt werden sollen, können Sie auch Für alle ungelöste Konflikte A/B/C wählen im Menü Zusammenführen auswählen.

## Mit &kdiff3; Ordner vergleichen und zusammenführen

### Einführung zum Ordnervergleich oder -zusammenführung

Oftmals müssen Programmierer in einem Ordner viele Dateien bearbeiten. Aus diesem Grund können Sie mit &kdiff3; komplette Ordner rekursiv vergleichen und zusammenführen.

Auch wenn das Vergleichen und Zusammenführen von ganzen Ordnern recht naheliegend und einleuchtend erscheint, gibt es einige Details, die Sie wissen sollten. Der wichtigste Punkt ist natürlich, dass sich jeder Durchlauf dieser Funktion gleich auf viele Dateien auswirkt. Wenn Sie keine Sicherungskopie der Originaldaten haben, könnte es schwer oder gar unmöglich werden, den Originalstand wiederherzustellen. Bevor Sie das Zusammenführen starten, sollten Sie also sicherstellen, dass Ihre Daten gesichert sind und das Sie alles rückgängig machen können. Ob Sie ein Archiv erstellen oder ein System zur Versionskontrolle benutzen, ist Ihre Entscheidung; selbst erfahrene Programmierer und Integratoren benötigen hin und wieder die alten Quelltexte. Bitte beachten Sie auch, dass selbst ich (der Autor von &kdiff3;) keine Garantie geben kann, dass das Programm fehlerlos ist. Entsprechend der GNU-GPL gibt es für dieses Programm KEINE GARANTIE. Also denken Sie daran:

> Irren ist menschlich, aber um etwas wirklich durcheinander zu bringen braucht man schon einen Computer ;-)

All diese Dinge kann &kdiff3; für Sie erledigen: &kdiff3; ...

- ... liest und vergleicht rekursiv zwei oder drei Ordner,

- ... behandelt symbolische Verknüpfungen besonders vorsichtig,

- ... lässt Sie Ihre Dateien per Mausklick durchsuchen,

- ... macht für jedes Objekt einen Vorschlag zum Zusammenführen; Sie können den Vorschlag vor dem Start anpassen,

- ... kann das Zusammenführen simulieren und zeigt die simulierten Änderungen an, ohne sie wirklich durchzuführen,

- ... führt letztendlich die Zusammenführung durch und lässt Sie (wenn nötig) eingreifen,

- ... führt ausgewählte Aktionen entweder mit allen (F7-Taste), oder nur mit den ausgewählten Objekten (F6-Taste) aus,

- ... setzt das Zusammenführen nach einem manuellen Eingriff fort (F7-Taste),

- ... erzeugt optional Sicherungskopien mit der Erweiterung.orig,

- ...

### Ordnervergleich oder -zusammenführung starten

Dies ist dem Vergleichen und Zusammenführen von einzelnen Dateien sehr ähnlich. Sie müssen nur Ordner auf der Befehlszeile oder im Dialog Datei öffnen angeben.

#### Vergleichen/Zusammenführen von zwei Ordnern:

    kdiff3 Ordner1 Ordner2
       kdiff3 Ordner1 Ordner2 -o Zielordner

Wenn kein Zielordner angegeben wurde, benutzt &kdiff3; Ordner2.

#### Vergleichen/Zusammenführen von drei Ordnern:

    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.)

### Angezeigte Informationen über Ordnerzusammenführung

Während dem Einlesen der Ordner informiert Sie ein kleines Nachrichtenfenster über den aktuellen Fortschritt. Wenn Sie das Scannen der Ordner abbrechen, werden nur die Dateien aufgelistet, die bis dahin verglichen wurden.

Wenn das Scannen der Ordner abgeschlossen ist, zeigt &kdiff3; ein Listenfenster mit den Ergebnissen auf der linken Seite, ...

... und den Details zu dem jeweils ausgewählten Objekt auf der rechten Seite:

#### Die Spalte Name

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 für links/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:

- Normale Datei

- Normaler Ordner (Ordner-Symbol)

- Verknüpfung zu einer Datei (Datei-Symbol mit einem Verknüpfungs-Pfeil)

- Verknüpfung auf einen Ordner (Ordner-Symbol mit einem Verknüpfungs-Pfeil)

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.

#### Die Spalten A/B/C und das Farbschema

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

- Schwarz: Dieser Eintrag existiert nicht in diesem Ordner.

- Grün: Neuester Eintrag.

- Gelb: Älter als grün, neuer als rot.

- Rot: Ältester Eintrag.

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.

#### Die Aktions-Spalte

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

- Drei-Ordner-Zusammenführen (A wird als die ältere Basis für die beiden anderen herangezogen).

- Zwei-Ordner-Zusammenführen.

- Zwei-Ordner-Abgleich-Modus (aktivieren Sie diesen Modus mit der Option Ordner abgleichen).

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

- ... alle drei Ordner identisch sind: Kopieren von C

- ... A und C identisch sind, aber nicht B: Kopieren von B (oder falls B nicht existiert, löschen des Ziels, falls es existiert)

- ... A und B identisch sind, aber nicht C: Kopieren von C (oder falls C nicht existiert, löschen des Ziels, falls es existiert)

- ... B und C identisch sind, aber nicht A: Kopieren von C (oder falls C nicht existiert, löschen des Ziels, falls es existiert)

- ... nur A existiert: Löschen des Ziels (falls es existiert)

- ... nur B existiert: Kopieren von B

- ... nur C existiert: Kopieren von C

- ... A, B und C nicht identisch sind: Zusammenführen

- ... A, B und C nicht den gleichen Dateityp haben (z. B. wenn A ein Ordner und B eine Datei ist): Fehler: Konflikt der Dateitypen. Solange solche fehlerhaften Objekte existieren, kann das Zusammenführen nicht gestartet werden.

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

- ... beide Ordner gleich sind: Kopieren von B

- ... A existiert, aber nicht B: Kopieren von A

- ... B existiert, aber nicht A: Kopieren von B

- ... A und B existieren aber nicht identisch sind: Zusammenführen

- ... A und B nicht den gleichen Dateityp haben (z. B. wenn A ein Ordner und B eine Datei ist): Fehler: Konflikt der Dateitypen. Solange solche fehlerhaften Objekte existieren, kann das Zusammenführen nicht gestartet werden.

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

- ... beide Ordner identisch sind: Es wird nichts unternommen.

- ... A existiert, aber nicht B: Kopieren von A nach B

- ... B existiert, aber nicht A: Kopieren von B nach A

- ... A und B existieren, aber nicht identisch sind: Zusammenführen und das Ergebnis in beiden Ordnern speichern. (Der Anwender sieht als sichtbaren Dateinamen für die Ausgabedatei nur B; direkt nach dem Zusammenführen kopiert &kdiff3; B nach A.)

- ... A und B nicht den gleichen Dateityp haben (z. B. wenn A ein Ordner und B eine Datei ist): Fehler: Konflikt der Dateitypen. Solange solche fehlerhaften Objekte existieren, kann das Zusammenführen nicht gestartet werden.

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.

#### Die Status-Spalte

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.

#### Die Statistik-Spalte

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.

#### Auswahl angezeigter Dateien

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

- Identische Dateien anzeigen: Dateien, die in allen Eingabeordnern gleich sind

- Unterschiedliche Dateien anzeigen: Dateien, die unterschiedlich und in zwei oder mehreren Ordnern vorhanden sind

- Dateien anzeigen, die nur in A existieren: Dateien, die in A, aber nicht in B oder C vorhanden sind.

- Dateien anzeigen, die nur in B existieren: Dateien, die in B, aber nicht in A oder C vorhanden sind.

- Dateien anzeigen, die nur in C existieren: Dateien, die in C, aber nicht in A oder B vorhanden sind.

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.

### Ordnerzusammenführung

Sie können entweder den gerade ausgewählten Eintrag (Datei oder Ordner) zusammenführen, oder alle Einträge auf einmal. Wenn Sie alle Zusammenführungsaktionen ausgewählt haben (auch in allen Unterordnern), können Sie das Zusammenführen starten.

Beachten Sie bitte: Wenn Sie keinen Zielordner angegeben haben, dann wird im Modus Drei-Ordner-Zusammenführen C als Ziel benutzt, beim Zwei-Ordner-Zusammenführen wird B als Ziel gewählt und beim Abgleichen wird A und/oder B als Ziel verwendet.

Wenn Sie einen Zielordner ausgewählt haben, prüfen Sie bitte nachher, ob alle Einträge die im Zielordner sein sollten, auch in der Ordnerstruktur angezeigt werden. Es gibt einige Optionen durch die bestimmte Einträge übersprungen werden könnten. Überprüfen Sie diese Optionen um unliebsame Überraschungen zu vermeiden:

- Unterordner einbeziehen: Wenn diese Option deaktiviert ist, werden keine Dateien in Unterordnern bearbeitet.

- Datei-Muster/Datei-Ausschlussmuster: Ein-/ und Ausschließen auf das Muster passender Einträge

- Versteckte Dateien und Ordner einbeziehen

- "Anzeige"-Optionen (Identische/Unterschiedliche Dateien anzeigen, Dateien anzeigen, die nur in A/B/C existieren)

Wenn Sie die Einstellungen ändern, um mehr Dateien anzuzeigen, müssen die Anzeige mit Ordner Neu einlesen aktualisieren. Die Grund dafür ist, dass &kdiff3; für diese auf Grund der Kriterien ausgeschlossenen Dateien keinen Vergleich ausführt, um schneller zu arbeiten. Wenn Sie die Muster für Dateien und Ordner geändert haben, wird die Dateiliste beim Schließen des Einstellungsdialogs sofort aktualisiert.

Beachten Sie, dass beim Schreiben in einen vollständig neuen Ordner normalerweise auch die identischen Dateien kopiert werden sollen.Aktivieren Sie dafür die Einstellung Identische Dateien anzeigen. Ist der Zielordner eines der Eingabefenster, so ist dies nicht erforderlich, da die Dateien bereits vorhanden sind.

Wenn Sie soweit zufrieden sind, ist der Rest einfach.

Um alle Einträge zusammenzuführen: Wählen Sie Ordnerzusammenführung starten/fortsetzen im Ordner oder drücken Sie F7 (das Tastenkürzel). Um nur den aktuellen Eintrag zusammenzuführen: Wählen Sie Aktion des aktuellen Elements ausführen oder drücken Sie F6.

Wenn durch widersprüchliche Dateitypen immer noch ungültige Zusammenführungsaktionen existieren, erscheint eine Meldung die auf die fehlerhaften Elemente hinweist. Sie können für sie dann eine gültige Aktion auswählen.

Wenn Sie alle Einträge zusammenführen, erscheint ein Dialogfenster mit den Optionen Start, Simulieren und Abbrechen.

- Wählen Sie Simulieren wenn Sie erst sehen möchten, was passiert, ohne das wirklich Änderungen vorgenommen werden. Sie erhalten dann eine ausführliche Liste aller Aktionen.

- Ansonsten klicken Sie auf Start, um das Zusammenführen wirklich zu beginnen.

&kdiff3; führt dann bestimmte Aktionen mit allen Einträgen durch. Wenn ein manueller Eingriff nötig ist (zusammenführen einer einzelnen Datei), dann öffnet sich ein Zusammenführen-Fenster (beachten Sie das Bildschirmfoto).

Wenn Sie mit dem manuellen Zusammenführen einer Datei fertig sind, wählen Sie erneut Ordnerzusammenführung starten/fortsetzen oder drücken Sie F7. Wenn Sie noch nicht gespeichert haben, erscheint ein entsprechender Dialog. Dann führt &kdiff3; seine Arbeit mit dem nächsten Eintrag fort.

Wenn &kdiff3; auf einen Fehler stösst, erscheint eine Nachricht und ausführliche Status-Informationen. Am Schluss der Liste sehen Sie einige Fehlermeldungen, die Ihnen helfen sollen, die Ursache des Problems auszumachen. Wenn Sie das Zusammenführen fortsetzen (F7-Taste), lässt &kdiff3; Ihnen die Wahl es erneut zu versuchen, oder den problematischen Eintrag zu überspringen. So haben Sie die Möglichkeit, eine andere Aktion für den Eintrag auszuwählen oder das Problem auf andere Weise zu lösen, bevor Sie mit dem Zusammenführen fortfahren.

&kdiff3; informiert Sie mit einem Nachrichten-Fenster, wenn das Zusammenführen abgeschlossen ist.

Falls einige Einträge individuell zusammengeführt wurden, merkt sich &kdiff3; diese Einträge in der aktuellen Sitzung und führt sie beim späteren Zusammenführen aller Einträge nicht nochmals zusammen. Selbst wenn hier das Zusammenführen übersprungen wurde oder nicht gespeichert wurde, werden diese Einträge als erledigt betrachtet. Nur wenn Sie die Zusammenführungsaktion ändern, werden diese Einträge erneut zusammengeführt.

### Optionen zum Vergleichen und Zusammenführen von Ordnern

Der Einrichtungsdialog von &kdiff3; (Menü Einstellungen->&kdiff3; einrichten ...) hat nun eine Seite namens Ordner mit diesen Optionen:

Unterordner einbeziehen:

  Stellen Sie ein, ob Ordner rekursiv durchsucht werden sollen.

Datei-Muster:

  Nur Dateien, die auf das angegebene Muster passen, werden im Elementbaum angezeigt. Es können mehrere Muster eingegeben werden. Trennen Sie die Muster mit einem Semikolon ;. Gültige Platzhalter sind:* und ?. (z. B. *.cpp;*.h). Die Voreinstellung ist *. Dieses Muster wird nicht für Ordner verwendet.

Datei-Ausschlussmuster:

  Dateien und Ordner, die diesem Muster entsprechen, werden nicht im Elementbaum angezeigt. Es kann mehr als ein Muster eingegeben werden, benutzen Sie das Semikolon ; als Trennzeichen . Gültige Platzhalter sind:* und ?. Voreinstellung ist *.orig;*.o;*.obj.

Ordner-Ausschlussmuster:

  Ordner, die diesem Muster entsprechen, werden nicht im Elementbaum angezeigt. Es kann mehr als ein Muster eingegeben werden, benutzen Sie das Semikolon ; als Trennzeichen . Gültige Platzhalter sind:* und ?. Voreinstellung ist CVS;deps;.svn.

.cvsignore verwenden:

  Ignoriert Dateien, die auch von CVS ignoriert werden würden. Viele automatisch erzeugte Dateien werden von CVS ignoriert. Der große Vorteil ist, dass dies für jeden Ordner mit einer lokalen .cvsignore-Datei eingestellt werden kann. (Weitere Informationen unter info:/cvs/cvsignore.)

Versteckte Dateien und Ordner einbeziehen:

  In einigen Dateisystemen haben Dateien ein Attribut Versteckt. In anderen Dateisystemen markiert ein vorangestellter Punkt . eine Datei als versteckt. Mit dieser Option können Sie festlegen, ob diese Dateien im Elementbaum angezeigt werden sollen oder nicht. Diese Option ist in der Voreinstellung eingeschaltet.

Datei-Verknüpfungen folgen:

  Bei Verknüpfungen auf Dateien: Wenn die Option abgeschaltet ist, werden symbolische Verknüpfungen verglichen. Wenn die Option eingeschaltet ist, werden die Dateien verglichen, auf die die Links zeigen. Dies ist in der Voreinstellung deaktiviert.

Ordner-Verknüpfungen folgen:

  Bei Verknüpfungen auf Ordner: Wenn die Option abgeschaltet ist, werden die symbolischen Verknüpfungen verglichen. Wenn die Option eingeschaltet ist, werden die Verknüpfungen wie normale Ordner behandelt und rekursiv durchsucht. Beachten Sie, dass &kdiff3; nicht auf mögliche Rekursionen prüft. Eine Verknüpfung auf einen Ordner, der eine Verknüpfung auf sich selbst enthält, führt zu einer Endlosschleife und &kdiff3; stürzt ab. Diese Option ist in der Voreinstellung abgeschaltet.

Groß-/Kleinschreibung bei Dateinamen:

  Unter Windows ist diese Einstellung standardmäßig deaktiviert und unter allen anderen Betriebssystemen aktiviert.

Dateivergleichsmethode:

  Binärvergleich:

    Dies ist die voreingestellte Vergleichsmethode.

  Vollständige Analyse:

    Führt eine vollständige Analyse jeder Datei durch und zeigt die Statistik-Spalten an. (Die Anzahl gelöster, ungelöster, Nicht-Leerraum-Konflikte.) Die vollständige Analyse ist langsamer als eine einfache binäre Analyse, und wesentlich langsamer, wenn sie auf Dateien angewendet wird, die keinen Text enthalten. Geben Sie ein entsprechendes Auschlussmuster ein.

  Änderungsdatum vertrauen (unsicher)

    Wenn Sie große Ordner über ein langsames Netzwerk vergleichen, geht es möglicherweise schneller, nur das Änderungsdatum und die Dateigröße zu vergleichen. Dieser Geschwindigkeitsvorteil kostet Sie allerdings ein gewisses Maß an Sicherheit. Bitte mit Vorsicht benutzen. Diese Option ist in der Voreinstellung abgeschaltet.

  Größe vertrauen (unsicher)

    Ähnlich wie Änderungsdatum vertrauen. Es findet kein echter Vergleich statt. Die Dateien werden als identisch betrachtet, wenn sie gleich groß sind. Das kann z. B. nützlich sein, wenn beim Kopieren das Änderungsdatum verlorengegangen ist. Bitte mit Vorsicht benutzen. Diese Option ist in der Voreinstellung abgeschaltet.

Ordner abgleichen:

  Aktiviert den Synchronisieren-Modus wenn zwei Ordner verglichen werden und kein Zielordner angegeben wurde. In diesem Modus werden die Vorschläge zum Zusammenführen so ausgewählt, dass nachher beide Ordner identisch sind. Auch die Ergebnisse vom Zusammenführen von Dateien werden in beiden Ordnern gespeichert. Diese Option ist in der Voreinstellung abgeschaltet.

Neuere Datei statt Zusammenführung auswählen (unsicher):

  Falls es Unterschiede gibt, wird statt des Zusammenführens das Kopieren der neueren Datei als Aktion vorgeschlagen. Dies wird als unsicher betrachtet, denn es wird das Wissen vorausgesetzt, dass die andere Datei nicht auch verändert wurde. Sie sollten dies in jedem Fall prüfen. Diese Option ist in der Voreinstellung abgeschaltet.

Sicherungskopie erstellen (.orig):

  Wenn eine Datei oder ein Ordner ersetzt oder gelöscht wird, dann wird die Originalversion umbenannt und erhält die Erweiterung .orig. Wenn eine alte Sicherungsdatei mit der Erweiterung .orig bereits existiert, so wird diese ohne weitere Sicherung gelöscht. Das betrifft auch das normale Zusammenführen einzelner Dateien, nicht nur das Zusammenführen ganzer Ordner. Diese Option ist in der Voreinstellung eingeschaltet.

### Weitere Funktionen im Fenster Ordnerzusammenführung

#### Ordner- & Textansicht teilen sich Hauptfenster

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 Ordner- Textansicht teilen sich Hauptfenster im Fenster-Menü abschalten und mittels Zwischen Ordner- & Textansicht umschalten zwischen den beiden Ansichten umschalten.

#### Vergleichen und Zusammenführen einer einzelnen Datei

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 Aktuelle Datei zusammenführen aus dem Menü 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

#### Vergleichen und Zusammenführen von Dateien mit verschiedenen Namen

Manchmal möchten Sie Dateien mit unterschiedlichen Namen vergleichen oder zusammenführen, &eg; 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 C klicken. 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 „Explizit ausgewählte Dateien vergleichen“ oder „Explizit ausgewählte Dateien zusammenführen“ aus dem Menü „Ordner“. Diese Einträge sind auch im Kontextmenü enthalten, das Sie mit Klicken der &RMBn; 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.

## Verschiedene Themen

### Netzwerktransparenz durch KIO-Eingabe-/Ausgabemodule

#### KIO-Ein-/Ausgabemodule

Die Frameworks-Bibliothek KIO unterstützt Netzwerktransparenz mit Hilfe von KIO-Ein-/Ausgabemodulen. &kdiff3; benutzt dies zum Einlesen von Dateien und Ordnern. Auf diese Weise können Sie Dateien und Ordner zum Öffnen angeben, die sich auf lokalen oder entfernten Rechnern befinden.

Beispiel:

    kdiff3 test.cpp  ftp://ftp.weitweg.org/test.cpp
       kdiff3 tar:/home/hacker/archiv.tar.gz/ordner ./ordner

Die erste Befehlszeile vergleicht eine lokale Datei mit einer Datei auf einem FTP-Server. Die zweite Befehlszeile vergleicht einen Ordner innerhalb eines komprimierten Archivs mit einem lokalen Ordner.

Weitere interessante KIO-Slaves sind:

- Dateien aus dem WWW (http:),

- Dateien von FTP (ftp:),

- Verschlüsselte Dateiübertragung (fish:, sftp:),

- Windows-Ressourcen (smb:),

- Lokale Dateien (file:),

Des weiteren wäre möglich (wenn auch weniger nützlich):

- Man-Pages (man:),

- Info-Seiten (info:),

#### Wie man eine URL schreibt

Eine URL hat eine andere Syntax als lokale Dateien und Ordner. Ein paar Dinge sollten Sie beachten:

- Ein Pfad kann relativ sein und . oder .. enthalten. Das ist mit URLs nicht möglich, diese sind immer absolut.

- Sonderzeichen müssen maskiert werden. (#->%23, Leerzeichen->%20, u.s.w.). Zum Beispiel hat eine Datei mit dem Namen /#foo# die URL file:/%23foo%23.

- Wenn eine URL nicht wie erwartet funktioniert, versuchen Sie erst mal, diese im Konqueror zu öffnen.

#### Fähigkeiten von KIO-Slaves

Netzwerktransparenz hat auch einen Nachteil: Nicht alle Ressourcen haben die gleichen Fähigkeiten.

Manchmal aufgrund des Dateisystems auf dem Server, manchmal durch das verwendete Protokoll. Es folgt eine kurze Liste der Einschränkungen:

- Teilweise werden keine Verknüpfungen unterstützt.

- Oder es kann nicht unterschieden werden, ob ein Verknüpfung auf eine Datei oder einen Ordner zeigt. Dann wird immer eine Datei als Verknüpfungsziel angenommen. (ftp:, sftp:).

- Die Dateigröße kann nicht immer ermittelt werden.

- Eingeschränkte Unterstützung für Berechtigungen.

- Es gibt keine Möglichkeit, Berechtigungen oder Veränderungsdatum zu bearbeiten. Daher weichen die Berechtigungen oder das Veränderungsdatum vom Original ab. Beachten Sie hierzu die Option Größe vertrauen. Dies ist nur bei lokalen Dateien möglich.

### &kdiff3; als KPart-Komponente benutzen

&kdiff3; ist ein KPart-Komponente. Zurzeit ist die KParts::ReadOnlyPart-Schnittstelle eingebaut.

Der hauptsächliche Verwendungszweck ist zurzeit als Unterschiede-Betrachter in KDevelop. KDevelop startet zuerst immer den eingebauten Unterschiede-Betrachter. Um &kdiff3; zu starten, drücken Sie die rechte Maustaste über dem Unterschiede-Betrachter und wählen dann In KDiff3Part anzeigen aus dem Kontextmenü.

Normalerweise benötigt &kdiff3; zwei vollständige Eingabedateien. Wenn es allerdings als KPart-Komponente benutzt wird, nimmt &kdiff3; an, dass die Eingabedatei eine Patch-Datei im „Unified“-Format ist. Dann entnimmt &kdiff3; die Namen der Originaldateien aus der Patch-Datei. Mindestens eine der beiden Dateien muss existieren. Dann startet &kdiff3; das Programm `patch` um die fehlende Datei wiederherzustellen.

Im &dolphin; können Sie auf eine Patch-Datei klicken und aus dem Kontextmenü Vorschau in-KDiff3Part auswählen. Beachten Sie bitte, dass das nicht funktioniert, wenn keine der Originaldateien existiert. Außerdem ist dies unzuverlässig, wenn sich die Originaldateien seit Erzeugung der Patch-Datei verändert haben.

Wenn &kdiff3; als KPart-Komponente ausgeführt wird, unterstützt es nur das Vergleichen von zwei Dateien, eine sehr kleine Werkzeugleiste und Menü. Das Zusammenführen oder das Vergleichen von Ordnern wird im KPart-Modus nicht unterstützt.

### &kdiff3; für Git Diff und Merge benutzen

&kdiff3; kann für Git Diff und Merge verwendet werden.

Fügen Sie dazu die folgenden Zeilen in Ihre Datei `gitconfig` ein:

    [diff]
            tool = kdiff3
    [difftool "kdiff3"]
            path = <path to kdiff3 binary in your system>
    [difftool]
            prompt = false
            keepBackup = false
            trustExitCode = false
    [merge]
            tool = kdiff3
    [mergetool]
            prompt = false
            keepBackup = false
            keepTemporaries = false
    [mergetool "kdiff3"]
            path = <path to kdiff3 binary in your system
    >

Um dann den Unterschied zwischen zwei Commits anzuzeigen, verwenden Sie `git difftool first_hash second_hash --tool=kdiff3 --cc some_file_in_the_git_tree`

Um einen Zweig mit &kdiff3; zusammenzuführen, verwenden Sie `git merge branch_name && git mergetool --tool=kdiff3`

Nach dem Auflösen von Konflikten beim Zusammenführen mit der normalen Vorgehensweise können Sie die Änderungen einspielen.

## Fragen und Antworten

&reporting.bugs; &updating.documentation;

Warum heißt das Programm &kdiff3;?

Werkzeuge mit dem Namen KDiff und KDiff2 (nun heißt es Kompare) gibt es bereits. Außerdem weist der Name KDiff3 bereits darauf hin, dass es zusammenführen kann wie das Programm diff3 aus der Diff-Tool-Sammlung.

Warum wurde KDiff3 unter der GPL lizenziert?

Ich verwende GPL-Programme schon sehr lange und habe viel gelernt, indem ich in die Quellen anderer Programme geschaut habe. Dies ist mein Dankeschön an alle Programmierer die diesen Weg gegangen sind oder ihn mal so gehen werden.

Einige Knöpfe und Funktionen fehlen. Was ist passiert?

Sie haben das Programm aus den Quellen kompiliert und dabei vermutlich nicht den richtigen Präfix für die Installation angegeben. In der Voreinstellung wird &kdiff3; in /usr/local installiert, aber dann können die Ressourcen für die Benutzerschnittstellen nicht gefunden werden (z. B. kdiff3ui.rc). In der README-Datei finden Sie nähere Informationen zum richtigen Präfix.

Häufig werden ähnliche, aber nicht identische Zeilen nebeneinander angezeigt, und manchmal nicht. Warum?

Wenn nur die Anzahl an Leerräumen unterschiedlich ist, werden diese Zeilen erstmal als identisch behandelt; wenn jedoch auch nur ein Nicht-Leerraum unterschiedlich ist, wird die Zeile als nicht identisch behandelt. Wenn ähnliche Zeilen nebeneinander angezeigt werden, ist das tatsächlich Zufall, kommt aber leider häufig vor. Siehe auch Zeilen manuell ausrichten.

Warum müssen alle Konflikte gelöst sein, bevor das Ergebnis gespeichert werden kann?

Der Editor merkt sich für jeden Unterschied in den Dateien wo er beginnt und wo er endet. Das ist nötig, um einen Konflikt einfach durch das Klicken in den Quelltext und Auswählen des Knopfes A/B/C lösen zu können. Diese wichtige Information geht allerdings verloren, wenn das Ergebnis einfach als Textdatei gespeichert wird und es ist zuviel Aufwand, extra ein eigenes Dateiformat zu entwerfen, das diese Informationen speichern könnte.

Wie kann ich die Ansichten für die Unterschiede und das Zusammenführen so abgleichen, dass in allen Ansichten die gleiche Textposition gezeigt wird?

Klicken Sie in die Zusammenfassungs-Spalte links neben dem Text, weitere Informationen dazu finden Sie in diesem Abschnitt.

Warum hat der Editor im Ergebnisfenster einer Zusammenführung keine Funktion Rückgängig?

Der Aufwand dafür war bisher zu groß. Sie können eine bestimmte Version immer durch das Auswählen einer Quelle A/B/C wiederherstellen. Um größere Mengen an Text zu bearbeiten, sollte ein anderer Editor verwendet werden.

Nach dem Entfernen von Text wird plötzlich <Keine Zeile in der Quelle> angezeigt und der Text lässt sich nicht löschen. Was bedeutet das und wie kann das entfernt werden?

Der Editor merkt sich für jeden gleichen und unterschiedlichen Abschnitt Anfang und Ende. <No src line> bedeutet, dass in diesem Abschnitt nichts mehr existiert, noch nicht mal mehr das Zeichen für den Zeilenvorschub. So etwas kann beim automatischen Zusammenführen oder beim Editieren passieren und ist kein Problem, denn der Text erscheint nicht in der gespeicherten Datei. Wenn Sie den Originaltext wiederherstellen möchten, klicken Sie in den Abschnitt und wählen die korrekte Quelle A/B/C aus.

Warum unterstützt &kdiff3; keine Syntax-Hervorhebung?

&kdiff3; benutzt bereits viele Farben zum Hervorheben von Unterschieden. Noch mehr Hervorhebung wäre verwirrend und verfehlt den Zweck. Benutzen Sie dafür bitte einen anderen Editor.

Kann ich &kdiff3; benutzen, um Dateien von OpenOffice.Org, Word, Excel, PDF-Dateien &etc; zu vergleichen?

Obwohl &kdiff3; jede beliebige Datei analysiert, wird das Ergebnis Sie wahrscheinlich nicht zufrieden stellen.

&kdiff3; wurde zum Vergleich von einfachen Textdateien entwickelt. OpenOffice, Word, Excel &etc; speichern viel mehr Informationen in den Dateien, zum Beispiel Schriften, Bilder, Seiten, Farben &etc; Diese Informationen kann &kdiff3; nicht verarbeiten. Daher zeigt &kdiff3; den Inhalt der Dateien als einfachen Text an. Diese Anzeige kann nicht lesbar sein oder zumindest seltsam aussehen.

Da heute viele Programme den Inhalt von Dokumenten in Dateien im XML-Format abspeichern, können diese Dateien auch als einfacher Text gelesen werden. Bei kleinen Änderungen kann &kdiff3; immer noch hilfreich sein.

Um nur den Text ohne eingebettete Objekte wie Bilder zu vergleichen, wählen Sie alles aus und kopieren dann den Text in die Zwischenablage. In &kdiff3; fügen Sie dann den Text in eins der Diff-Eingabefenster ein, siehe auch Auswahl, Kopieren und Einfügen.

Wo ist die Option Nur Unterschiede anzeigen für Ordner geblieben?

Es gibt jetzt mehrere Anzeige-Optionen im Menü Ordner. Deaktivieren Sie „Identische Dateien anzeigen“, das führt zum gleichen Ergebnis wie früher „Nur Unterschiede anzeigen“.

Wie kann ich eine große Auswahl im Diff-Eingabefenster erstellen, wenn das Blättern so lange dauert?

Starten Sie die Auswahl wie üblich durch Klicken und Halten der linken Maustaste. Benutzen Sie dann die Navigationstasten wie zum Beispiel „Bild ab“ oder „Bild auf“ und halten dabei die linke Maustaste gedrückt. Siehe auch Auswählen, Kopieren und Einfügen.

Wird Ihre Frage hier nicht beantwortet?

Bitte senden Sie mir Ihre Frage zu. Ich bin dankbar für jeden Kommentar.

## Danksagungen und Lizenz

&kdiff3; - Ein Programm zum Vergleichen und Zusammenführen von Dateien und Ordnern

Programm-Copyright 2002-2007 Joachim Eibl joachim.eibl at gmx.de

Viele gute Ideen und Fehlerberichte kamen von Kollegen und vielen Leuten aus dem Wild Wild Web. Vielen Dank!

Dokumentation Copyright © 2002-2007 Joachim Eibl joachim.eibl at gmx.de

Deutsche Übersetzung: Thomas Reitelbach tr@erdfunkstelle.de

&underFDL; &underGPL;

&documentation.index;