<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kdiff "<application>kdiff</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="de">
<bookinfo>
<title>Das KDiff-Handbuch</title>
<authorgroup>
<author>
<firstname>Matthis</firstname>
<surname>Hipp</surname>
<affiliation><address><email><ulink url="mailto:hipp@braunschweig.netsurf.de">hipp@braunschweig.netsurf.de</ulink></email></address></affiliation>
</author>
</authorgroup>
<abstract>
<para>Dies ist das Handbuch zu KDiff</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
</keywordset>
<releaseinfo>Version 0.7</releaseinfo>
<date>vom 21. Juni 1998</date>
</bookinfo>

<chapter id="einleitung">
<title>Einleitung</title>

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

<para>Nachdem die linke und die rechte Datei geladen wurde kann das
diff-Programm
ausgef&uuml;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 &uuml;ber die farbliche Bedeutung:</para>

<para><variablelist>
<varlistentry>
<term>wei&szlig;</term>
<listitem>
<para>keine Differenz</para>
</listitem>
</varlistentry>
<varlistentry>
<term>gr&uuml;n</term>
<listitem>
<para>die Zeilen sind unterschiedlich</para>
</listitem>
</varlistentry>
<varlistentry>
<term>rot</term>
<listitem>
<para>die rechte Zeile wurde hinzugef&uuml;gt bzw. die linke gel&ouml;scht</para>
</listitem>
</varlistentry>
<varlistentry>
<term>blau</term>
<listitem>
<para>die linke Zeile wurde hinzugef&uuml;gt bzw. die rechte gel&ouml;scht</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para><emphasis>Beispiel Bildschirmabzug</emphasis>
wird <link linkend="konfiguration">hier</link> dargestellt.</para>
</chapter>

<chapter id="installation">
<title>Installation</title>

<sect1 id="voraussetzungen">
<title>Voraussetzungen</title>

<para>KDiff ist eine Utility-Application f&uuml;r das KDE Projekt  
<ulink url="http://www.kde.org">http://www.kde.org</ulink>.
KDiff kann auf der Haupt-FTP-Site
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>
gefunden werden. Damit KDiff erfolgreich &uuml;bersetzt werden kann, werden
au&szlig;erdem noch die neuesten KDE-Bibliotheken ben&ouml;tig. Alle erforderlichen
Bibliotheken wie KDiff k&ouml;nnen hier <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink> herunter geladen werden.</para>
</sect1>

<sect1 id="kompilation-und-installation">
<title>Kompilation und Installation</title>

<para>Um KDiff zu &uuml;bersetzen und anschliessend zu installieren, sollten
folgende Kommandos im Verzeichnis von KDiff eingegeben werden:</para>

<para><screen>% ./configure
% make
% make install
</screen>
</para>
</sect1>

<sect1 id="konfiguration">
<title>Konfiguration</title>

<para>Alle Konfigurationsm&ouml;glichkeiten werden in der Applikation angeboten.</para>
</sect1>
</chapter>

<chapter id="bildschirm">
<title>Bildschirm</title>

<para><graphic fileref="kdiff.png"></graphic></para>

<sect1 id="menubar">
<title>Menubar</title>

<para><graphic fileref="menu.png"></graphic></para>

<sect2 id="datei">
<title>Datei</title>

<para><variablelist>
<varlistentry>
<term>links &ouml;ffnen</term>
<listitem>
<para>&Ouml;ffnet die linke Datei, welche der 1. Parameter zum diff-Programm ist</para>
</listitem>
</varlistentry>
<varlistentry>
<term>rechts &ouml;ffnen</term>
<listitem>
<para>&Ouml;ffnet die rechte Datei, welche der 2. Parameter
zum diff-Programm ist</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Beenden</term>
<listitem>
<para>Beendet die KDiff-Applikation</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="title-differenz">
<title>Title Differenz</title>

<para><variablelist>
<varlistentry>
<term>Ausf&uuml;hren</term>
<listitem>
<para>Nach dem Laden der linken und
rechten Datei mu&szlig; mit "Ausf&uuml;hren" das diff-Programm gestartet werden</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Vorherige</term>
<listitem>
<para>Zeigt die vorherige Differenz im Anzeigebereich an</para>
</listitem>
</varlistentry>
<varlistentry>
<term>N&auml;chste</term>
<listitem>
<para>Zeigt die n&auml;chste Differenz im Anzeigebereich an</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="einstellungen">
<title>Einstellungen</title>

<para><variablelist>
<varlistentry>
<term>Schriftart</term>
<listitem>
<para>Erm&ouml;glicht dem Benutzer, die Schriftart
f&uuml;r den Anzeigebereich festzulegen</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Farben</term>
<listitem>
<para>&Ouml;ffnet einen
Dialog, in dem der Benutzer die verschieden Hintergrundfarben  
ausw&auml;hlen kann</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Zeilennummern anzeigen</term>
<listitem>
<para>Zeigt die Zeilennummern im Anzeigebereich
an</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Einstellungen speichern</term>
<listitem>
<para>Speichert die aktuellen Einstellung in
der Appl.-Konfigdatei</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="hilfe">
<title>Hilfe</title>

<para><variablelist>
<varlistentry>
<term>Inhalt</term>
<listitem>
<para>Startet das KDE-Hilfesystem</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&Uuml;ber</term>
<listitem>
<para>Blendet einen Dialog auf, in dem Angaben zur Version und zum Autor stehen</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>

<sect1 id="toolbar">
<title>Toolbar</title>

<para><graphic fileref="toolbar.png"></graphic></para>

<para>Die Toolbar enth&auml;lt Kn&ouml;pfe f&uuml;r schnellen Funktionszugriff. 
Im Augenblick sind folgende Kn&ouml;pfe enthalten</para>

<para><itemizedlist>
<listitem>
<para>links &ouml;ffnen</para>
</listitem>
<listitem>
<para>rechts &ouml;ffnen</para>
</listitem>
<listitem>
<para>Ausf&uuml;hren</para>
</listitem>
<listitem>
<para>Vorherige</para>
</listitem>
<listitem>
<para>N&auml;chste</para>
</listitem>
</itemizedlist>
</para>

<para>F&uuml;r eine ausf&uuml;hrliche Beschreibung sei hier  auf die <link linkend="menubar">Menubar</link> verwiesen.</para>
</sect1>

<sect1 id="anzeigebereich">
<title>Anzeigebereich</title>

<para>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&uuml;hrt wurde. Die Dateien k&ouml;nnen
mittels drag von kfm auf den entsprechenden Bereich ge"drop"t werden. Die
Datei entsprechend ihrer drop-Seite geladen.</para>

</sect1>

<sect1 id="statusbar">
<title>Statusbar</title>

<para><graphic fileref="statusbar.png"></graphic></para>

<para>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.</para>
</sect1>
</chapter>

<chapter id="dialoge">
<title>Dialoge</title>

<sect1 id="schrift">
<title>Schrift</title>

<para>Dies ist der Standard-Schriften-Auswahldialog.</para>

<para><graphic fileref="fontdialog.png"></graphic></para>
</sect1>

<sect1 id="farben">
<title>Farben</title>

<para>Der Farbauswahldialog hat drei Kn&ouml;pfe f&uuml;r die Farbauswahl. Mit
dem ersten Knopf wird die Farbe f&uuml;r links hinzugef&uuml;gte Zeilen
w&auml;hlen. Der zweite Knopf bestimmt die Farbe f&uuml;r links gel&ouml;schte
Zeilen. Und der letzte Knopf bestimmt die Hintergrundfarbe von ge&auml;nderten
Zeilen.</para>

<para><graphic fileref="colordialog.png"></graphic></para>
</sect1>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
