<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY caitoo "<application>caitoo</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="de">
<bookinfo>
<title>Das Caitoo Handbuch</title>
<authorgroup>
<author>
<surname>Matej Koss &lt;koss@napri.sk&gt;
Deutsche Übersetzung : Jorfen &lt;jorfen@topmail.de&gt;</surname>
</author>
</authorgroup>
<date>Version 0.6.4, 26 June 1999</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Dieses Handbuch beschreibt Caitoo in der Version 0.6.4</para>
<para>Handbuch zu Caitoo</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>Caitoo</keyword>
<keyword>Download</keyword>
</keywordset>
</bookinfo>

<chapter id="einfhrung">
<title>Einführung</title>

<para>Caitoo ( vorher bekannt als KGet ) ist ein  Download-Manager ähnlich 
Go!zilla(tm) oder GetRight Download(tm).</para>

<para>Caitoo hält alle Ihre Downloads in einer Liste fest  und unterstützt 
Drag&amp;Drop von KDE-Applikationen und Netscape.
Damit ist es möglich, daß Sie URL's von KFM oder Netscape in das Programmfenster von Caitoo ziehen können.
Die Datenübertragung wird in der Liste registriert und Sie haben die Möglichkeit, diese einfach in der 
Liste zu verwalten (hinzufügen, löschen, stoppen, fortsetzen, nach hinten verschieben).
Das Statusfenster zeigt die Größe jeder Datenübertragung, den Fortschritt in Prozent, die Geschwindigkeit 
jeder Datenübertragung und die geschätzte Zeit bis zur Beendigung der Übertragung.</para>

<para>Caitoo verwendet wie KFM libkio und kioslaves. Dies ermöglicht die Verwendung von 
vielen fortschrittlichen Eigenschaften, wie die  <link linkend="resuming">Fortsetzung</link> von 
FTP- und HTTP-Übertragungen, Setzen einer maximalen Zeit bei Leseoperationen usw.  </para>

<para> 
Sie können angeben, wie oft bei einer Datenübertragung versucht werden soll zu wiederholen, 
die Datenübertragung zu einer bestimmten Zeit ausführen lassen oder eine Übertragung einfach der Liste 
hinzufügen, ohne dass die Übertragung sofort gestartet wird. Caitoo unterstützt 
ebenfalls <link linkend="queueing">das Einreihen von Übertragungen</link>. Übertragungslisten können in eine 
Datei exportiert und importiert werden und automatisch in bestimmten Zeitintervallen 
gespeichert werden. Weitere Funktionen : automatisches Trennen der Verbindung, automatisches 
Beenden von Caitoo, automatisches Einfügen von URLs und den Experten-Modus für erfahrene Benutzer.</para>

<para>Caitoo kann Ihre Internetverbindung überwachen und dementsprechend Übertragungen starten und beenden.</para>

<para>Ich hoffe, daß Sie Caitoo nützlich finden werden,</para>

<para><literal remap="tt">Matt Koss</literal></para>

<para><ulink url="mailto:koss@napri.sk">koss@napri.sk</ulink></para>
</chapter>

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

<sect1 id="woher-bekommt-man-caitoo">
<title>Woher bekommt man Caitoo?</title>

<para>Caitoo kann von der Caitoo Homepage 
<ulink url="http://devel-home.kde.org/~caitoo">http://devel-home.kde.org/~caitoo</ulink>  
oder von
<ulink url="ftp://ftp.kde.org/pub/kde/unstable/apps/Internet">ftp://ftp.kde.org/pub/kde/unstable/apps/network</ulink>,
, der KDE-FTP-Seite bezogen werden.</para>
</sect1>

<sect1 id="vorraussetzungen">
<title>Vorraussetzungen</title>

<para>Um Caitoo erfolgreich zu kompilieren benötigen Sie die KDE1.1-Bibliotheken. Diese können auf 
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink> gefunden werden.</para>

<para>Sie benötigen außerdem die QT-Bibliothek in der Version 1.42 oder höher.</para>

<para>Außerdem wird noch ein fortgeschrittener Compiler wie egcs oder gcc2.8 gebraucht.</para>

<para>Benutzer der KDE-Distribution von SuSE6.1 müssen die Quellen von kdelibs neu kompilieren, da die 
vorkompilierten kdelibs keine kdebug Makros enthalten.</para>
</sect1>

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

<para>Um Caitoo zu kompilieren und zu Installieren führen Sie folgende Befehle im Stammverzeichnis 
von Caitoo aus : </para>

<para><screen> 
&gt; ./configure
&gt; make
&gt; make install
</screen>
</para>

<para>Stellen Sie außerdem sicher, daß die Umgebungsvariablen KDEDIR und QTDIR korrekt gesetzt sind, bevor Sie 
anfangen zu kompilieren !</para>

<para>Caitoo verwendet <literal remap="tt">autoconf</literal> und es sollten keine Probleme bei der Kompilation auftreten. 
Falls es dennoch unerwartet zu Problemem kommen sollte, wenden Sie sich bitte an den Autor des Programms.</para>
</sect1>
</chapter>

<chapter id="mit-caitoo-arbeiten">
<title>Mit Caitoo arbeiten</title>

<sect1 id="datenbertragung-starten">
<title>Datenübertragung starten</title>

<sect2 id="dragdrop">
<title>Drag&amp;Drop</title>

<para>Sie können URLs von KDE-Anwendungen wie KFM oder KMail oder von Netscape in das Fenster von Caitoo ziehen. 
Danach wählen Sie das Verzeichnis und den Dateinamen zum Speichern.</para>
</sect2>

<sect2 id="eine-datenbertragung-von-hand-ffnen">
<title>Eine Datenübertragung von Hand öffnen</title>

<para>Sie können eine Datenübertragung vom Menü aus oder über die Tastenkombination Ctrl-o oder Ctrl-v öffnen.
Ctrl-v ist besonders nützlich wenn sich eine URL in der Zwischenablage befindet und/oder Sie einen Browser 
verwenden, der nicht das KDE Drag&amp;Drop-Protokoll beherscht. In dem Fall kopieren Sie die URL einfach in 
die Zwischenablage und drücken die Tastenkombination Ctrl-v oder den entsprechenden Eintrag im Menü. 
Caitoo öffnet einen Dialog, in dem sie die URL editieren können.</para>
</sect2>

<sect2 id="eine-url-beim-start-oder-whrend-des-betriebs">
<title>Eine URL beim Start oder während des Betriebs übergeben</title>

<para>Sie können Caitoo beim Start eine URL als Komandozeilenargument übergeben :
<screen>&gt; caitoo eine_url
</screen>
</para>

<para>Auf die gleiche Weise können Sie Caitoo eine URL übergeben wenn es schon gestartet wurde. Es wird keine 
neue Instanz von Caitoo gestartet, sondern die übergebene URL der Datenübertragungsliste hinzugefügt.</para>

<para>Mit Caitoo kommt außerdem ein Shellskript namens <emphasis remap="bf">caitooclient</emphasis>.
Dieses Skript ruft Caitoo mit Kommandozeilenargumenten auf, die dem Skript übergeben wurden und leitet die 
Standard-Ausgabe und Fehlerausgabe nach <literal remap="tt">/dev/null</literal>.
Dies kann nützlich sein, wenn Caitoo von einen anderen Programm gestartet wird.</para>
</sect2>
</sect1>

<sect1 id="bertragungsmodi">
<title>Übertragungsmodi</title>

<para>    
Datenübertragungen befinden sich immer in einem von drei möglichen Modi:</para>

<sect2 id="eingereiht">
<title>Eingereiht</title>

<para>Die Übertragung wurde eingereiht. Das heißt, Caitoo startet den Transfer sobald es möglich ist. 
Weitere Details sind unter <link linkend="queueing">Einreihen</link> nachzulesen.</para>
</sect2>

<sect2 id="nach-zeitplan">
<title>nach Zeitplan</title>

<para>Die Übertragung wird nach Zeitplan begonnen. Caitoo prüft jede Minute, ob es eine Übertragung starten soll 
und berücksichtigt dabei die maximale Anzahl von offenen Übertragungen. Die Zeit wird unter 
<link linkend="transferConfigDlg">Übertragung konfigurieren</link> eingestellt.</para>
</sect2>

<sect2 id="verzgert">
<title>Verzögert</title>

<para>Die Übertragung wird nur der Liste hinzugefügt, ohne dass sie gestartet wird. Um die Übertragung zu 
starten, muss ihr Modus geändert werden oder Sie starten sie per Hand.</para>

<para>Dies ist nützlich wenn Sie offline arbeiten. Setzen sie <emphasis remap="bf">Neue Übertragung als Verzögert hinzufügen</emphasis> 
in den <link linkend="erweitert">Einstellungen</link>.</para>

<para>Benutzen Sie diese Funktionen wenn Sie Probleme mit Ihrer Verbindung zum Server haben und die Dateien 
später herunterladen wollen.</para>
</sect2>
</sect1>

<sect1 id="weitere-funktionen">
<title>Weitere Funktionen</title>

<sect2 id="queueing">
<title>Einreihen</title>

<para>Einreihen bedeutet, dass Sie die Anzahl maximal offener Übertragungen setzen. Caitoo wird versuchen, 
ihre Vorgaben einzuhalten. Natürlich können Sie jederzeit weitere Übertragungen von Hand öffnen.</para>

<para> 
Das bedeutet nicht, dass Sie nicht mehr als die angegebene Anzahl von Datenübertragungen in Caitoo 
registrieren lassen können!</para>

<para> 
Caitoo kontrolliert alle registrierten Übertragungen und öffnet sie wenn es nötig ist. Benutzen Sie 
Einreihen wenn Sie eine schlechte Verbindung zum Internet haben oder einfach nur ein langsames Modem wie 
ich :-)</para>

<para>Auch können Sie mit dieser Option verhindern, dass ihre Übertragungen andernfalls die komplette 
Netzbandbreite in Beschlag nehmen.</para>
</sect2>

<sect2 id="resuming">
<title>Fortsetzen von Übertragungen</title>

<para>Caitoo unterstützt das Fortsetzen von abgebrochenen Übertragungen, was eine Funktion der meisten 
FTP-Server ist und auch im HTTP 1.1 Protokoll beschrieben wird.
Wenn Sie eine Datei herunterladen, und bei 75&percnt; ein Fehler auftaucht, brauchen Sie nicht mehr die 
komplette Datei herunterzuladen, sondern nur die Übertragung neu in Caitoo eintragen und Sie fangen 
an der Position an herunterzuladen, wo Sie aufgehört haben. </para>

<para>Leider unterstützt nicht jeder Server das Fortsetzen. Caitoo prüft dies vorher nach und zeigt diese 
Information in der Übertragungsliste an. </para>

<para>Das Fortsetzen von HTTP-Übertragungen ist ein Sonderfall. Bitte sehen Sie diese Funktion vorerst als 
experimentell an und verlassen Sie sich nicht allzusehr darauf.</para>
</sect2>

<sect2 id="expertmode">
<title>Experten Modus</title>

<para>Der Experten Modus wird für erfahrene Benutzer empfohlen. Caitoo wird in diesen Modus den Benutzer 
nicht auffordern, Aktionen zu bestätigen.</para>

<para>Dies trifft auf das Löschen von Übertragungen, Einfügeoperationen und den Speicherort zu.</para>

<para>Wenn ein Fehler während des Startens oder in einer Übertragungen auftritt, zeigt Caitoo Ihnen 
nicht die Fehlermeldung, sondern setzt die Übertragung auf Wiederholung. Dies ist sinnvoll wenn 
Caitoo automatisiert arbeiten soll.</para>

<para> 
In diesem Zusammenhang sind die Funktionen <emphasis remap="bf">Automatisches Trennen der Verbindung</emphasis> und 
<emphasis remap="bf">Automatisches Beenden von Caitoo</emphasis> ebenfalls sinnvoll.</para>
</sect2>
</sect1>

<sect1 id="caitoo-tastaturbelegung">
<title>Caitoo Tastaturbelegung</title>

<para>Caitoo kennt folgende Tastenkombinationen :</para>

<para><variablelist>
<varlistentry>
<term><literal remap="tt">Ctrl-o</literal></term>
<listitem>
<para>Öffnet eine neue Übertragung.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal remap="tt">Ctrl-v</literal></term>
<listitem>
<para>Öffnet eine neue Übertragung und holt die URL von der Zwischenablage.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal remap="tt">Ctrl-q</literal></term>
<listitem>
<para>Beendet Caitoo.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="screenfundamentals">
<title>Bildschirmelemente</title>

<sect1 id="bertragungsliste">
<title>Übertragungsliste</title>

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

<para>Der Hauptteil von Caitoo ist die Übertragungsliste, in der alle Übertragungen registriert werden. 
Jede Übertragung nimmt eine Zeile in Anspruch, die jeweils in mehrere Felder unterteilt ist:</para>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">S</emphasis> - Der Status wird hier durch ein Symbol repräsentiert</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Lokaler Dateiname</emphasis> - Der Name, unter dem die Datei gespeichert wird</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Frt.</emphasis> - Zeigt an, ob die Übertraung fortgesetzt werden kann</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Anzahl</emphasis> - Bearbeitete Dateien / Gesamtanzahl Dateien</para>
</listitem>
<listitem>
<para><emphasis remap="bf">&percnt;</emphasis> - Fortschritt in Prozent</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Gesamt</emphasis> - Gesamtgröße ( rekursiv gezählt im Falle von Verzeichnissen)</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Geschw.</emphasis> - momentane Übertragungsgeschwindigkeit</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Zeit</emphasis> - Zeit bis zur Beendigung der Übertragung</para>
</listitem>
<listitem>
<para><emphasis remap="bf">URL</emphasis> - URL der Übertragung</para>
</listitem>
</itemizedlist>
</para>

<para>Um Aktionen auf eine Übertragung anzuwenden, muss diese mit der linken Maustaste ausgewählt werden. 
Die mittlere Maustaste wählt sie wieder ab.</para>

<para>Mit der rechten Maustaste öffnen Sie ein Menu, mit dem Sie mehrere Aktionen durchführen können. 
Sie können eine Übertragung an den Anfang oder an das Ende der Liste bewegen. 
Z.B. können Sie eine langsame Datenübertragung anhalten und an das Ende bewegen. 
Sie wird dann zuletzt gestartet.</para>

<para>Der Menüeintrag <emphasis remap="bf">Kopiere URL in die Zwischenablage</emphasis> kopiert die URL der gewählten Übertragung 
in die Zwischenablage. Dies ist nützlich wenn Sie eine Übertragung mit einen ähnlichen Namen 
starten wollen (Rechtsklick auf den Transfer, URL kopieren, Ctrl-v und den Namen editieren).</para>

<para>Der Menüeintrag <emphasis remap="bf">Übertragung konfigurieren</emphasis> läßt Sie die Übertragung konfigurieren. Sehen 
Sie dazu auch <link linkend="transferConfigDlg">Übertragung konfigurieren</link>.</para>

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

<sect1 id="werkzeugleiste">
<title>Werkzeugleiste</title>

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

<para>Die Werkzeugleiste enthält Knöpfe für alle Aktionen, die auf eine ausgewählte Übertragung angewendet 
werden können. Nicht alle sind zu jeder Zeit verfügbar. Z.B. können sie keinen pausierten Transfer 
nochmal pausieren. Die Knöpfe sind entsprechend ihrer Funktionen angeordnet.</para>

<para>Im linken Teil befinden sich die Knöpfe für grundlegende Aktionen. Diese sind: <emphasis remap="bf">fortsetzen</emphasis>, 
<emphasis remap="bf">pausieren</emphasis>, <emphasis remap="bf">löschen</emphasis> und <emphasis remap="bf">neu starten</emphasis>. Die Funktionsweise dieser Knöpfe sollte 
schon bekannt sein.</para>

<para>Der <emphasis remap="bf">neu starten</emphasis>-Knopf wurde als Bequemlichkeit hinzugefügt. Er macht nichts anderes als den 
Transfer zu pausieren und dann fortzusetzen. </para>

<para>Im mittleren Teil befinden sich die Knöpfe, um die Übertragungsmodi einzustellen: 
<emphasis remap="bf">eingereiht</emphasis>, <emphasis remap="bf">nach Zeitplan</emphasis>, und <emphasis remap="bf">verzögert</emphasis>. Diese Knöpfe zeigen außerdem 
gleichzeitig den Status der angewählten Übertragung an. Nur jeweils einer der drei Knöpfe 
kann eingeschaltet sein.</para>

<para>Der dritte Teil enthält zwei Knöpfe: <emphasis remap="bf">Einstellungen</emphasis>, um schnell die Einstellungen zu öffnen 
und <emphasis remap="bf">Neuen Transfer öffnen (URL von der Zwischablage holen)</emphasis>.</para>

<para>Der vierte Teil enthält fünf globale Knöpfe: <emphasis remap="bf">Experten Modus</emphasis>, <emphasis remap="bf">Benutze vorheriges Verzeichnis</emphasis>,
<emphasis remap="bf">automatisch Verbindung trennen</emphasis>, <emphasis remap="bf">automatisch Beenden</emphasis>, und 
<emphasis remap="bf">automatisch von der Zwischenablage einfügen</emphasis>.</para>

<para>Der Knopf ganz rechts ist dafür da, Caitoo in die Kontrolleiste einzubinden.
Sehen Sie dazu auch <link linkend="dockWidget">In die Kontrolleiste einbinden</link>.</para>
</sect1>

<sect1 id="statusleiste">
<title>Statusleiste</title>

<para>Die Statusleiste zeigt alle wichtigen Nachrichten an, z.B. wenn eine Übertragung fortgesetzt 
oder wiederholt wird.</para>

<para>Sie enthält außerdem einige wichtige Felder:
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Übertragungen</emphasis> - Anzahl der Übertragungen, die in der Liste sind</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Dateien</emphasis> - Anzahl der Dateien, die noch heruntergeladen werden müssen</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Größe</emphasis> - Gesamtgröße der Dateien</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Zeit</emphasis> - Die Zeit, die bis zur Beendigung aller Übertragungen verbleibt</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Geschw.</emphasis> - Gesamtgeschwinigkeit</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="hauptmen">
<title>Hauptmenü</title>

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

<para><variablelist>
<varlistentry>
<term>Übertragung öffnen</term>
<listitem>
<para>Fragt nach der URL der Übertragung.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Übertragung öffnen (URL von der Zwischenablage holen)</term>
<listitem>
<para>Öffnet eine Übertragung und holt die URL von der Zwischenablage.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>exportiere Übertragungsliste</term>
<listitem>
<para>Exportiert die Übertragungsliste in eine Datei.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>importiere Übertragungsliste</term>
<listitem>
<para>Lädt eine Übertragungsliste.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Beenden</term>
<listitem>
<para>Beendet Caitoo.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="optionen">
<title>Optionen</title>

<para><variablelist>
<varlistentry>
<term>Statusleiste anzeigen</term>
<listitem>
<para>Damit können Sie die Statusleiste anzeigen lassen oder verstecken.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Animationen anzeigen</term>
<listitem>
<para>Damit können Sie Animationen ein- und ausschalten.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Benutze Klänge</term>
<listitem>
<para>Damit können Sie das Abspielen von Klängen ein- und ausschalten.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Einstellungen</term>
<listitem>
<para>Öffnet den Einstellungen-Dialog. Details lesen Sie <link linkend="preferences">hier</link>.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

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

<para><variablelist>
<varlistentry>
<term>Inhalt</term>
<listitem>
<para>Öffnet die Hilfe zu Caitoo.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Über... </term>
<listitem>
<para>Zeigt wichtige Informationen zu Caitoo.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>

<sect1 id="transferconfigdlg">
<title>Übertragung konfigurieren</title>

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

<para>Über diesen Dialog können Sie den Übertragungsmodus und den Zeitgeber einstellen. Außerdem zeigt er 
Ihnen die Quell- und Ziel-URL.</para>

<para>Dieser Dialog wird außerdem geöffnet wenn Sie den Übertragungsmodus auf Zeitplan stellen und sie die 
Zeitgeber einstellen.</para>
</sect1>

<sect1 id="individueller-fortschritt">
<title>Individueller Fortschritt</title>

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

<para>Wenn die auf eine Übertragung in der Liste doppelklicken, wird dieser Dialog geöffnet. Er erlaubt es 
Ihnen den individuellen Fortschritt der Übertragung in einem eigenen Fenster zu beobachten. </para>

<para><emphasis remap="bf">Achtung !!!</emphasis></para>

<para>Wenn Sie auf Abbrechen drücken wird nicht nur das Fenster geschlossen, sondern auch die komplette 
Übertragung beendet.</para>
</sect1>

<sect1 id="dockwidget">
<title>In die Kontrolleiste einbinden</title>

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

<para>Wenn Sie diese Option anwählen wird Caitoo in die Kontrolleiste eingebunden. Danach wird Caitoo durch 
ein Symbol in der Kontrolleiste repräsentiert.</para>

<para>Sie können eine URL auch in dieses Symbol ziehen.</para>

<para>In dem Symbol wird außerdem der Fortschritt der ersten drei Übertragungen angezeigt.</para>

<para>Ein Rechtsklick auf das Symbol öffnet ein Menü, in dem Sie Caitoo wieder von der Kontrolleiste 
lösen lassen oder Caitoo beenden können.</para>
</sect1>

<sect1 id="droptarget">
<title>Drop Target</title>

<para><graphic fileref="drop1.png"></graphic>
<graphic fileref="drop2.png"></graphic>
<graphic fileref="drop3.png"></graphic></para>

<para>Press <emphasis remap="bf">Drop target</emphasis> on the toolbar to change Caitoo main window into the 
little shaped window. This little window will be always on the top of all 
windows. You can use it for drag&amp;drop of URL's. As <emphasis remap="bf">Dock widget</emphasis>, it 
also shows progress of running transfers.</para>

<para>Three different icons show status of transfer. Open hand means that no transfer is currently in progress. Grabbing hand means that some transfer is running. And finally, finger pointing down means that we are offline. The same icons, only smaller are shown in the dock widget.</para>

<para>Please note, that the only way how the drop target can be moved around on the screen is by holding down the left mouse button while the Alt key is pressed.</para>

<para>Right mouse button click opens a popup menu, where you can set this window to 
be sticky or not, open preferences dialog or quit application.</para>
</sect1>

<sect1 id="log-fenster">
<title>Log-Fenster</title>

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

<para>Das Log-enster zeigt die Nachrichten aller Teile von Caitoo an. Sie können es von der 
Werkzeugleiste oder vom Hauptmenü aus öffnen.</para>

<para>Alle Informationen werden außerdem in  /.kde/share/appls/caitoo/logs gespeichert. </para>
</sect1>
</chapter>

<chapter id="preferences">
<title>Einstellungen</title>

<para> Über <emphasis remap="bf">Einstellungen</emphasis> wird es ihnen ermöglicht, viele Teile von Caitoo ihren 
Wünschen entsprechend einzustellen.</para>

<sect1 id="verbindung">
<title>Verbindung</title>

<sect2 id="wiederherstellen-der-verbindung">
<title><emphasis>Wiederherstellen der Verbindung</emphasis></title>

<para><variablelist>
<varlistentry>
<term>Bei Login-Problem oder Zeitüberschreitung</term>
<listitem>
<para>Wenn Caitoo sich an einen Server nicht anmelden kann, stoppt Caitoo die Übertragung und 
wiederholt sie später. Dazu können sie einstellen nach wie vielen Minuten und wie oft Caitoo 
versuchen soll, die Übertragung zu starten.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Bei Verbingungsabbruch</term>
<listitem>
<para>Wenn plötzlich die Verbindung abbrechen sollte, pausiert Caitoo alle Übertragungn und setzt sie 
bei Wiederherstellung der Verbindung wieder fort (nur die, die auch fortgesetzt werden können).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Automatisch Fortsetzen</term>
<listitem>
<para>Wenn diese Option gesetzt ist, wird Caitoo alle Übertragungen automatisch fortsetzen und nicht 
mehr nachfragen ob das Ziel überschrieben oder fortgesetzt werden soll. 
Wenn die Übertragung nicht fortgesetzt werden kann, fragt Caitoo trotzdem nach.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="zeitberschreitungen">
<title><emphasis>Zeitüberschreitungen</emphasis></title>

<para>Dies sind die Intervalle, die Caitoo veranlassen, Übertragungen zu pausieren und fortzusetzen, 
nachdem eine zeitlang keine Daten angekommen sind. Der zweite Wert ist für die Übertragungen die 
nicht fortgesetzt werden können. Natürlich sollte dieser Wert größer als der erste Wert sein.</para>
</sect2>

<sect2 id="art-der-verbindung">
<title><emphasis>Art der Verbindung</emphasis></title>

<para>Hier können Sie einstellen was Sie für eine Verbindung zum Internet haben. Caitoo entscheidet 
entsprechend ob der Offline-Modus automatisch aktiviert wird oder nicht. Diese Funktion ist für 
Benutzer einer nicht-dauerhaften Verbindung zum Internet besonders interessant.</para>

<para>Um diese Funktion erfolgreich nutzen zu können, müssen Sie wissen, über welches Netzwerk-Interface 
ihre Internet-Verbindung läuft.</para>

<para>Wenn Sie sicher sind, dass sie immer verbunden sind, können sie <emphasis remap="bf">dauerhaft</emphasis> auswählen. 
Caitoo wird nicht mehr prüfen, ob eine Verbindung besteht, sondern einfach davon ausgehen, 
dass dies der Fall ist. Sie können den Offline-Modus jedoch jederzeit manuell anwählen.</para>

<para>Benutzer einer anderen Verbindungsart möchten mit Sicherheit eine andere Wahl treffen. 
Wenn Sie nicht wissen, über welches Interface ihre Internetverbindung läuft, benutzen Sie <emphasis remap="bf">ifconfig</emphasis>.</para>

<para>Ein Beispiel :
<screen>lo        Link encap:Local Loopback
          inet addr:127.0.0.1  Bcast:127.255.255.255  Mask:255.0.0.0
          UP BROADCAST LOOPBACK RUNNING  MTU:3584  Metric:1
          RX packets:128 errors:0 dropped:0 overruns:0
          TX packets:128 errors:0 dropped:0 overruns:0./configure
</screen>
</para>

<para>Sie können sehen, dass die ersten beiden Buchstaben <emphasis remap="bf">lo</emphasis> sind. Das ist die Abkürzung für das 
loopback-Interface, welches auf fast allen System immer zu finden ist. 
Die Ausgabe von <emphasis remap="bf">ifconfig</emphasis> wird höchstwahrscheinlich so wie oben aussehen wenn Sie nicht 
mit den Internet verbunden sind. Wenn Sie verbunden sind, sollte ein weiterer Eintrag, welcher mit 
<emphasis remap="bf">ppp0</emphasis> oder <emphasis remap="bf">sl1</emphasis> anfängt, zu finden sein. Diese beiden Einträge stehen für das 
PPP-Interface 0 oder SLIP-Interface 1. Nun sollten Sie wissen, was für eine Verbindung Sie zum 
Internet haben und tragen diese entsprechend ein.</para>

<para><variablelist>
<varlistentry>
<term>Offline-Modus</term>
<listitem>
<para>Schalten Sie diese Option ein, wenn Caitoo im Offline-Modus betrieben werden soll. In diesem Modus 
können sie die Übertragungsliste mit Übertragungen füllen, ohne dass tatsächlich eine 
Übertragung gestartet wird. Dies ist nützlich, wenn Sie offline arbeiten, aber schon 
Übertragungen eintragen wollen.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>

<sect1 id="proxies">
<title>Proxies</title>

<para>Wenn Sie über einen Proxy zum Internet verbunden werden, schalten Sie diese Optionen ein.</para>

<para><emphasis remap="bf">Proxy benutzen</emphasis>.</para>

<para>Geben Sie den Proxy-Server und den Port ein.</para>

<para>Im Feld <emphasis remap="bf">keinen Proxy für</emphasis> geben Sie die Server ein, für die kein Proxy verwendet werden soll. </para>

<para>Bitte beachten Sie, daß die Benutzung von FTP-Proxies noch nicht funktioniert und HTTP-Proxies sich noch im experimentellen Stadium befinden.</para>
</sect1>

<sect1 id="automatisierung">
<title>Automatisierung</title>

<para><variablelist>
<varlistentry>
<term>Übetragungsliste automatisch speichern</term>
<listitem>
<para>Dies ist das Intervall, nach dem die Übertragungsliste automatisch gespeichert wird.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Automatisch Verbindung trennen</term>
<listitem>
<para>Wenn diese Option aktiviert ist, trennt Caitoo automatisch die Verbindung zum Internet, wenn 
alle eingereihten Übertragungen beendet sind. Diese Option ignoriert Übertragungen nach Zeitplan. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Kommando zum Trennen der Verbindung</term>
<listitem>
<para>Geben Sie hier das Kommando an, daß Sie zum Trennen der Verbindung benötigen. Voreinstellung ist 
"kppp -k", was eine Verbindung via kppp beendet. Eine andere Alternative wäre z.B. "killall pppd". </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Automatisch beenden</term>
<listitem>
<para>Wenn diese Option gesetzt ist, wird Caitoo sich beenden, wenn alle Übertragungen beendet sind. 
Dieses mal werden Übertragungen nach Zeitplan mit berücksichtigt.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Automatisches Einfügen von der Zwischenablage</term>
<listitem>
<para>Wenn diese Option aktiviert ist, fügt Caitoo automatisch alle URLs von der Zwischenablage ein, 
wenn nach der URL gefragt wird.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="einschrnkungen">
<title>Einschränkungen</title>

<para><variablelist>
<varlistentry>
<term>Maximale Anzahl offener Übertragungen</term>
<listitem>
<para>Caitoo wird nicht mehr als die hier angegeben Zahl an Übertragungen automatisch öffnen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Übertragung starten, wenn Netzbandbreite mehr als</term>
<listitem>
<para>Wird noch nicht unterstützt.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Halte die Bandbreite einer Übertragung bei</term>
<listitem>
<para>Wird noch nicht unterstützt.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="erweitert">
<title>Erweitert</title>

<para><variablelist>
<varlistentry>
<term>Neue Übertragungen einfügen als</term>
<listitem>
<para>Hier können Sie wählen, ob neue Übertragungen als <emphasis>eingereiht</emphasis> oder <emphasis>verzögert</emphasis> 
eingetragen werden sollen. Letzteres wird empfohlen, wenn Sie offline arbeiten. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Show download windows</term>
<listitem>
<para>If this is set, Caitoo will open progress windows for started transfer. You 
can even choose to start it iconified. This option is good if you e.g. want 
to watch the progress of some transfer without opening the main window. 
Iconified window will show progress in the task bar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Unvollständige Übertragungen markieren</term>
<listitem>
<para>Wenn diese Option gesetzt ist, erweitert Caitoo den Dateinamen einer Datei um <emphasis>.part</emphasis>. 
Wenn die Übertragung beendet ist, entfernt Caitoo die Erweiterung wieder. Auf diese Weise 
wissen Sie sofort, ob die Datei erfolgreich übertragen wurde ode nicht.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Nach Übertragung Datei von der Übertragungsliste entfernen</term>
<listitem>
<para>Wenn diese Option ausgeschaltet wird, bleiben beendete Übertragungen in Liste. Dies ist nützlich, 
wenn Sie Statistiken über Übertragungen führen wollen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Hole Dateigrößen</term>
<listitem>
<para>Mit dieser Option holt Caitoo zuerst die Dateigröße einer Übertragung und 
zeigt sie in der Übertragungsliste an.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Experten-Modus</term>
<listitem>
<para>Dieser Modus ist für erfahrene Benutzer. Weitere Details <link linkend="expertMode">hier</link>.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="verzeichnisse">
<title>Verzeichnisse</title>

<para>In dieser Sektion können sie Standart-Verzeichnisse für bestimmte Dateierweiterungen einstellen. 
Jede Zeile der Liste besteht aus einem Paar:
<emphasis>Dateierweiterung</emphasis> und <emphasis>Verzeichniss</emphasis>.</para>

<para>Die Knöpfe erlauben es Ihnen, Dateierweiterungen hinzuzufügen, zu löschen und zu verändern.</para>

<para>Außerdem dürfen Sie bei der Eingabe Wildcards verweden.</para>

<para>Wenn eine neue Übertragung gestartet wird, vergleicht Caitoo die Dateiendung mit der 
Eintragung in der Liste. Caitoo geht die Liste der Reihe nach durch, also sollten globale 
Einträge wie * am Ende der Liste stehen.</para>

<para>Wenn Caitoo keine Entprechung in der Liste findet, verwendet Caitoo das momentane Verzeichniss.</para>

<para>Der Knopf <emphasis remap="bf">Zuletztes benutztes Verzeichnis verwenden</emphasis> in der Werkzeugleiste kann benutzt werden, 
um diese  Funktion temporär ausser Kraft zu setzen. Caitoo wird dann alle Übertragungen im 
zuletzt verwendeten Verzeichniss ablegen.</para>
</sect1>

<sect1 id="system">
<title>System</title>

<para><variablelist>
<varlistentry>
<term>Klänge benutzen</term>
<listitem>
<para>Wenn diese Option eingeschaltet ist, spielt Caitoo bei folgenden
Ereignissen Klänge ab:
<itemizedlist>
<listitem>
<para>Eine Übertragung wurde der Übertragungsliste hinzugefügt</para>
</listitem>
<listitem>
<para>Eine Übertragung wurde gestartet</para>
</listitem>
<listitem>
<para>Eine Übertragung wurde beendet</para>
</listitem>
<listitem>
<para>Alle Übertragungen wurden beendet</para>
</listitem>
</itemizedlist>
</para>
<para>      
Auf diese Weise benachrichtigt Sie Caitoo 
This way you do not have to watch the Caitoo window ( you can leave it docked 
into panel, so that it does not take any place on the screen )
and Caitoo will notify you when transfers are added / started / finished.
If you cannot use sound - leave this option disabled. Caitoo comes with four 
default sounds for these events.
If you don't like supplied sounds, you can of course change them. Choose 
sound for change in the combo box, change it by pressing <emphasis remap="bf">Change</emphasis> button 
and test it with <emphasis remap="bf">Test</emphasis> button.
In order to use sound you have to start kaudioserver first. It comes with KDE 
distribution and normally it is already started from startkde script.
You can toggle this option also from the main menu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Animationen verwenden</term>
<listitem>
<para>Wenn diese Option aktiviert ist, animiert Caitoo die Symbole in der Übertragungsliste und, 
wenn Caitoo in die Kontrolleiste eingebunden wird, aktiviert die Symbolanzeige.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Fenster-Stil</term>
<listitem>
<para>Here you can set, how will Caitoo appear on the screen. It can be either as a 
normal window, dock widget or drop target. See 
<link linkend="screenFundamentals">Screen fundamentals</link> for more details on each type.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Windows 9x Andockstil</term>
<listitem>
<para>This toggle is for selecting between two styles of docking or drop target.</para>
<para>When it is on, dock widget or drop target behave like in Windows 9x. When you 
click on them, they will undock / change into the normal Caitoo window.</para>
<para>The second way is the same as it was in the former versions of Caitoo. Clicking on dock widget 
or drop target will show / hide normal Caitoo window, while still being docked or shown as drop target.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Zeichensätze</term>
<listitem>
<para>Benutzen Sie diesen Dialog, um den gewünschten Zeichensatz auszuwählen, den Caitoo verwenden soll.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="fragen-und-antworten">
<title>Fragen und Antworten</title>

<para><itemizedlist>
<listitem>
<para>Warum sollte ich Caitoo verwenden und nicht nur kfm ?</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">Why should I use Caitoo and not just kfm ?</emphasis></para>

<para>  
If you use to download only one file at a time, kfm is probably enough for you
( if you do not need resuming ). Caitoo is utility for people who want to 
download many files and do not want to look at many progress dialogs.</para>

<para> 
Caitoo is independent from kfm. This means that when kfm dumps core ( though 
it doesn't happen too often since KDE 1.0 ), Caitoo still works and transfers 
files.</para>

<para> 
However, Caitoo is intended to closely cooperate with kfm as it uses KDE drag 
and drop. Use kfm to browse web and when you see something that you need - 
just drag it onto Caitoo window and browse away. You do not have to remember 
the URL of the file anymore - Caitoo will take care of it. And when Caitoo 
can't connect - you can still leave transfer on the list and try to connect 
later.</para>

<para> 
Another thing is queueing. You can set number of transfers and then use Caitoo
as before. Caitoo will only start specified number of transfers, and keep 
others queued. Later, when first transfers finish, Caitoo will start queued 
ones.</para>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para><screen>Caitoo is Copyright 1998-1999 by Matej Koss,
                              koss@napri.sk

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.     
</screen>
</para>

<sect1 id="thanks">
<title>Thanks</title>

<para>Thanks to the guys who wrote programs GetRight Download and Go!zilla ( for 
Windoze ) - sorry, but I don't know your names - which gave me the idea for 
this program, even if I didn't use any code from them.</para>

<para>Thanks to many users, who have contribute their bug reports / fixes and 
requests for new features to me.</para>

<para>Thanks to the authors of <ulink url="http://www.kde.org">KDE</ulink>, wonderful desktop 
environment.</para>

<para>Thanks to the <ulink url="http://www.troll.no">Trolls</ulink> for Qt, a great library.</para>
</sect1>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
