]>

# Das KDiff-Handbuch

Matthis
Hipp

    hipp@braunschweig.netsurf.de

Dies ist das Handbuch zu KDiff

KDE
Version 0.7
vom 21. Juni 1998

## Einleitung

KDiff ist ein ``Frontend'' zum diff-Program. Die Hauptaufgabe von KDiff ist die Visualisierung von Unterschieden in ASCII-Dateien.

Nachdem die linke und die rechte Datei geladen wurde kann das diff-Programm ausgeführt werden. Danach werden die beiden Dateien im Anzeigebereich des Applikationsfensters angezeigt. Durch verschiedene Hintergrundfarben wird die bedeutung der Differenzen verdeutlicht. Die folgende Tabelle gibt Auskunft über die farbliche Bedeutung:

weiß

  keine Differenz

grün

  die Zeilen sind unterschiedlich

rot

  die rechte Zeile wurde hinzugefügt bzw. die linke gelöscht

blau

  die linke Zeile wurde hinzugefügt bzw. die rechte gelöscht

Beispiel Bildschirmabzug wird hier dargestellt.

## Installation

### Voraussetzungen

KDiff ist eine Utility-Application für das KDE Projekt http://www.kde.org. KDiff kann auf der Haupt-FTP-Site ftp://ftp.kde.org/pub/kde/ gefunden werden. Damit KDiff erfolgreich übersetzt werden kann, werden außerdem noch die neuesten KDE-Bibliotheken benötig. Alle erforderlichen Bibliotheken wie KDiff können hier ftp://ftp.kde.org/pub/kde/ herunter geladen werden.

### Kompilation und Installation

Um KDiff zu übersetzen und anschliessend zu installieren, sollten folgende Kommandos im Verzeichnis von KDiff eingegeben werden:

    % ./configure
    % make
    % make install

### Konfiguration

Alle Konfigurationsmöglichkeiten werden in der Applikation angeboten.

## Bildschirm

### Menubar

#### Datei

links öffnen

  Öffnet die linke Datei, welche der 1. Parameter zum diff-Programm ist

rechts öffnen

  Öffnet die rechte Datei, welche der 2. Parameter zum diff-Programm ist

Beenden

  Beendet die KDiff-Applikation

#### Title Differenz

Ausführen

  Nach dem Laden der linken und rechten Datei muß mit "Ausführen" das diff-Programm gestartet werden

Vorherige

  Zeigt die vorherige Differenz im Anzeigebereich an

Nächste

  Zeigt die nächste Differenz im Anzeigebereich an

#### Einstellungen

Schriftart

  Ermöglicht dem Benutzer, die Schriftart für den Anzeigebereich festzulegen

Farben

  Öffnet einen Dialog, in dem der Benutzer die verschieden Hintergrundfarben auswählen kann

Zeilennummern anzeigen

  Zeigt die Zeilennummern im Anzeigebereich an

Einstellungen speichern

  Speichert die aktuellen Einstellung in der Appl.-Konfigdatei

#### Hilfe

Inhalt

  Startet das KDE-Hilfesystem

Über

  Blendet einen Dialog auf, in dem Angaben zur Version und zum Autor stehen

### Toolbar

Die Toolbar enthält Knöpfe für schnellen Funktionszugriff. Im Augenblick sind folgende Knöpfe enthalten

- links öffnen

- rechts öffnen

- Ausführen

- Vorherige

- Nächste

Für eine ausführliche Beschreibung sei hier auf die Menubar verwiesen.

### Anzeigebereich

Im Anzeigebereich gibt es zwei Hauptbereiche, den Linken und den Rechten. Im linken Bereich wird die linke Datei angezeigt und im rechten die Rechte, nachdem das Differenz-Programm ausgeführt wurde. Die Dateien können mittels drag von kfm auf den entsprechenden Bereich ge"drop"t werden. Die Datei entsprechend ihrer drop-Seite geladen.

### Statusbar

In der linken Seite der Satusbar werden Zustandsmeldungen angezeigt, im mittleren Feld wird die Fortgangsmeldung und im rechten Feld wird die Anzahl der Differenzen dargestellt.

## Dialoge

### Schrift

Dies ist der Standard-Schriften-Auswahldialog.

### Farben

Der Farbauswahldialog hat drei Knöpfe für die Farbauswahl. Mit dem ersten Knopf wird die Farbe für links hinzugefügte Zeilen wählen. Der zweite Knopf bestimmt die Farbe für links gelöschte Zeilen. Und der letzte Knopf bestimmt die Hintergrundfarbe von geänderten Zeilen.