<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY caitoo "<application>caitoo</application>">
]>

<book lang="en">
<bookinfo>
<title>The Caitoo Handbook</title>
<authorgroup>
<author>
<firstname>Matej</firstname>
<surname>Koss</surname>
<affiliation>
<address><email>koss@napri.sk</email></address>
</affiliation>
</author>
</authorgroup>
<date>20/05/1999</date>
<releaseinfo>0.06.04</releaseinfo>
<abstract>
<para>This Handbook describes Caitoo Version 0.6.4</para>
</abstract>
<keywordset>
<keyword>caitoo</keyword>
<keyword>kget</keyword>
<keyword>download</keyword>
<keyword>resuming</keyword>
<keyword>queueing</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>Caitoo ( formerly known as KGet ) is a download manager similar to 
Go!zilla(tm) or GetRight Download(tm).</para>

<para>It keeps all your downloads in one dialog. Program supports drag & drop 
from KDE applications or Netscape.
You can easily drop url's from kfm or Netscape onto main window or onto 
docking window.
Transfer will register on the list and you can simply organize them 
( add, delete, stop, resume, move around on the list). 
Status window shows size of each transfer, current progress in percents, 
current transfer speed and estimated time to finishing of transfer.</para>

<para>Caitoo, as well as kfm is utilizing libkio and kioslaves. This allows using 
of many sophisticated features like <link linkend="resuming">resuming</link> of ftp 
and http transfers, setting timeouts for read operations etc.</para>

<para> 
Users can set retry count for transfer, schedule it for later start or simply 
add transfers to the list without starting them. Caitoo also supports 
<link linkend="queueing">queueing</link>. Transfer list can be exported to / imported from 
file, and this list can be set to autosave every X minutes. Other features include 
auto-disconnecting, auto-shutdown, auto-paste and also expert mode for experienced 
users.</para>

<para>Caitoo can automatically check you Internet connection and start/stop transfers accordingly.</para>

<para>I hope you will find Caitoo useful,</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="howtoobtaincaitoo">
<title>How to obtain Caitoo</title>

<para>Caitoo can be found on 
<ulink url="http://devel-home.kde.org/~caitoo">http://devel-home.kde.org/~caitoo</ulink>, 
Caitoo's home page, or at
<ulink url="ftp://ftp.kde.org/pub/kde/unstable/apps/Internet">ftp://ftp.kde.org/pub/kde/unstable/apps/network</ulink>,
the main ftp site of the KDE project.</para>
</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>In order to successfully compile Caitoo, you need KDE 1.1 libraries 
( can be found on <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink> ).</para>
</sect1>

<sect1 id="compilationandinstallation">
<title>Compilation and installation</title>

<para>In order to compile and install Caitoo on your system, execute the 
following commands in the base  directory of the Caitoo distribution:</para>

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

<para>Caitoo uses <literal remap="tt">autoconf</literal> package and you should have not trouble 
compiling it.
Should you run into problems please report them to the author of program.</para>

<para>Please note, that Caitoo requires an advanced compiler like egcs or gcc2.8.</para>
</sect1>
</chapter>

<chapter id="workingwithcaitoo">
<title>Working with Caitoo</title>

<sect1 id="startingtransfer">
<title>Starting Transfer</title>

<sect2 id="draganddrop">
<title>Drag and Drop</title>

<para>You can drag URL's from KDE applications ( like kfm or kmail ) or from Netscape 
into the Caitoo main or dock window. Then you choose directory and filename, 
under which you want to save it.</para>
</sect2>

<sect2 id="openingtransferbyhand">
<title>Opening transfer by hand</title>

<para>You can open transfer from menu or by keyboard shortcuts Ctrl-o or Ctrl-v.
Ctrl-v is especially useful if you use a WWW Browser which does not support 
KDE drag and drop protocol.
Copy the URL to the clipboard, then use Ctrl-v in Caitoo 
( or simply press a toolbar button <emphasis remap="bf">Paste transfer</emphasis> ).
Caitoo will then open a dialog with pasted URL, which you can edit.</para>
</sect2>

<sect2 id="passingurlonstartuporinrun-time">
<title>Passing URL on startup or in run-time</title>

<para>You can pass URL to Caitoo as an argument on startup :
<screen>&gt; caitoo some_url
</screen>
</para>

<para>The same approach works when Caitoo is already running. Instead of starting 
another copy of Caitoo, it will add argument ( URL ) as a new transfer.</para>

<para>With a distribution comes also a little shell script called 
<emphasis remap="bf">caitooclient</emphasis>. This script does nothing else then invoking Caitoo 
with arguments and redirecting standard output and errors to <literal remap="tt">/dev/null</literal>. 
This might be useful when calling Caitoo from some external programs.</para>
</sect2>
</sect1>

<sect1 id="transfermodes">
<title>Transfer modes</title>

<para>    
Transfer is always in one of the three transfer modes :</para>

<sect2 id="queued">
<title>Queued</title>

<para>Transfer is in a queue, which means that it's ready to be started whenever 
it's possible. For better explanation see <link linkend="queueing">Queueing</link>.</para>
</sect2>

<sect2 id="scheduled">
<title>Scheduled</title>

<para>Transfer is scheduled to be started at some later time. Caitoo checks every 
minute whether there is some transfer that should be started. It takes into 
account the maximum number of allowed transfers. Transfer time is set in 
<link linkend="transferConfigDlg">Transfer Configure Dialog</link>.</para>
</sect2>

<sect2 id="delayed">
<title>Delayed</title>

<para>Transfer is simply added to the list. Caitoo will not try to start it. 
You have to start it by hand, or change it's mode to queued or scheduled.</para>

<para>This is useful if you work offline, then you can set <emphasis remap="bf">Add new transfer as 
delayed</emphasis> in a <link linkend="addNew">preferences dialog</link>.</para>

<para>Use this feature if you have problems with connecting to server or slow 
connection and want to download files later.</para>
</sect2>
</sect1>

<sect1 id="otherfeatures">
<title>Other features</title>

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

<para>Queueing means that you can set maximum number of transfers that are running 
simultaneously. Caitoo tries to keep this number. Of course that you can at 
any time start the transfer by hand.</para>

<para> 
This does NOT mean that you cannot drag more files into Caitoo then this 
number !</para>

<para> 
Caitoo keeps record of all registered transfers and opens them when needed. 
Use queuing when you have bad connection to Internet or slow modem like me :-)</para>

<para>It is useful also when you do not want to take all network bandwidth you 
can, but rather download file after file.</para>
</sect2>

<sect2 id="resuming">
<title>Resuming</title>

<para>Caitoo supports resuming, which is a feature supported by most of ftp servers 
and is present in HTTP 1.1 protocol. If you download some big file and after 
75&percnt; of download connection error occurs, you do not have to start all over 
again, but simply register this transfer again and it will continue in the 
place where it stopped ( Caitoo will append to an existing file and not 
overwrite it ).</para>

<para>However, this feature does not work for all ftp and http servers. Caitoo will 
check, whether server supports this feature, and will show this infomation in 
the listbox. Later, if you need to stop the transfer, you can easily decide, 
whether it is a good idea.</para>

<para>HTTP resuming is somewhat special. Please consider it to be experimental and 
don't rely on it too much.</para>
</sect2>

<sect2 id="expertmode">
<title>Expert mode</title>

<para>Expert mode is recommended for experienced users. Generally, when expert mode 
is on, Caitoo will not ask user to confirm operations.</para>

<para>This applies to deleting of transfer, confirming paste operations and save 
locations.</para>

<para>If some error occurs while starting transfer or while transfering, Caitoo will 
not show you the error message, but it will set transfer for retry without 
asking. This is very useful, if you drag many files into Caitoo and leave to 
do some other work. Caitoo will download files and when it can't connect, it 
will continue without asking.</para>

<para> 
It could be useful to use expert mode together with auto-disconnect / 
auto-shutdown mode. Drag files into Caitoo, turn on the expert mode, turn on 
auto-disconnect / auto-shutdown mode and leave.</para>
</sect2>
</sect1>

<sect1 id="caitookeybindings">
<title>Caitoo Key Bindings</title>

<para>Caitoo honors the following key bindings.</para>

<para><variablelist>
<varlistentry>
<term><literal remap="tt">Ctrl-o</literal></term>
<listitem>
<para>Open a new transfer</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal remap="tt">Ctrl-v</literal></term>
<listitem>
<para>Paste in URL for transfer</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal remap="tt">Ctrl-q</literal></term>
<listitem>
<para>Exit program.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="screenfundamentals">
<title>Screen Fundamentals</title>

<sect1 id="transferlist">
<title>Transfer List</title>

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

<para>Main part of Caitoo window is listbox, where all transfers get registered.
Each transfer is represented by one line in this listbox. Every line is 
divided into several fields :</para>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">S</emphasis> - Status icon representing current status of transfer</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Local filename</emphasis> - Name under which the file will be saved</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Res.</emphasis> - Indicator, whether this transfer can be resumed</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Count</emphasis> - Number of files as a ratio of processed files / total 
count of files</para>
</listitem>
<listitem>
<para><emphasis remap="bf">&percnt;</emphasis> - Already processed size</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Total</emphasis> - Total size ( counted recursively in case of directories )</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Speed</emphasis> - Current speed</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Rem. Time</emphasis> - Remaining time to the end of transfer</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Address (URL)</emphasis> - Source URL of this transfer</para>
</listitem>
</itemizedlist>
</para>

<para>In order to do any operation on registered transfer, this has to be selected 
by clicking on it with left mouse button. Use middle mouse button to unselect 
it.</para>

<para>Pressing right mouse button on transfer opens a menu with some operations. 
You can move transfer to the end or beginning of the list. You can e.g. 
select a transfer that is running very slowly, pause it and move it to the 
end of the list. This file will start download as the last one. This is also 
a simple way of organizing transfers on the list.</para>

<para>Menu item <emphasis remap="bf">Copy URL to clipboard</emphasis> will copy source URL of the transfer 
into the clipboard. This is useful if you have registered transfer and want 
to download something with a similar name ( right-click on transfer, copy URL 
to clipboard, press <emphasis remap="bf">Paste</emphasis> button and edit the name in the window).</para>

<para>Menu item <emphasis remap="bf">Configure transfer</emphasis> will open transfer configure dialog. See 
<link linkend="transferConfigDlg">Transfer Configure Dialog</link>.</para>

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

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

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

<para>Toolbar contains buttons for all operations which can be applied on selected 
transfer. Not all are enabled at all times. For example you cannot pause 
already paused transfer. These buttons are grouped together according to their
functions.</para>

<para>Left part contains buttons for basic operations. These are <emphasis remap="bf">Resume</emphasis>, 
<emphasis remap="bf">Pause</emphasis>, <emphasis remap="bf">Delete</emphasis> and <emphasis remap="bf">Pause all</emphasis> buttons. Their functions 
should be already obvious. </para>

<para>In the middle part there are three mode toggle buttons : <emphasis remap="bf">Queued</emphasis>, 
<emphasis remap="bf">Scheduled</emphasis> and <emphasis remap="bf">Delayed</emphasis>. They show the current transfer mode for 
selected transfer. Use them to quickly change the transfer mode. These buttons
are like radio buttons, only one can be selected.</para>

<para>Third part contains two buttons : <emphasis remap="bf">Preferences</emphasis>, for quick opening of 
preferences dialog and <emphasis remap="bf">Paste transfer</emphasis> for pasting of the URL into the 
Caitoo.</para>

<para>Fourth part contains five global toggle buttons : <emphasis remap="bf">Expert mode</emphasis>, 
<emphasis remap="bf">Use last directory</emphasis>, <emphasis remap="bf">Auto-disconnect mode</emphasis>, <emphasis remap="bf">Auto-shutdown mode</emphasis> and <emphasis remap="bf">Auto-paste mode</emphasis>.</para>

<para>The right most toolbar button is for docking. It's a toggle button. When you 
turn it on, Caitoo will dock into the panel. See 
<link linkend="dockWidget">Dock Widget</link>.</para>
</sect1>

<sect1 id="statusbar">
<title>Status bar</title>

<para>Status bar displays all important messages concerning transfer, like when 
some transfer is resumed or set to retry.</para>

<para>It also contains several fields :
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Transfers</emphasis> - total number of transfers that are in a listbox</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Files</emphasis> - total number of files that remain to transfer</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Size</emphasis> - total size of all files that remain to transfer</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Time</emphasis> - time that remains to finish transfering of all files</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Speed</emphasis> - total speed of transfering</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="mainmenu">
<title>Main Menu</title>

<sect2 id="file">
<title>File</title>

<para><variablelist>
<varlistentry>
<term>Open Transfer</term>
<listitem>
<para>Prompts for an URL of the new transfer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Paste Transfer</term>
<listitem>
<para>Paste a transfer from the clipboard into a Caitoo. You can for example 
paste here URL from Netscape.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Export Transfer List</term>
<listitem>
<para>Allows to write transfer list into the file. Later you can import it or you 
can copy this list into another computer and do your downloads there.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Import Transfer List</term>
<listitem>
<para>Allows to read transfer list from the file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Quit</term>
<listitem>
<para>Quits the Caitoo.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="options">
<title>Options</title>

<para><variablelist>
<varlistentry>
<term>Show Status Bar</term>
<listitem>
<para>Allows the user to have the status bar displayed or hidden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Use Animation</term>
<listitem>
<para>Allows the user to stop or start animation of the status icons and dock widget.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Use Sound</term>
<listitem>
<para>Allows the user to enable / disable sounds.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Preferences</term>
<listitem>
<para>Brings up the Preferences Dialog. See <link linkend="preferences">Preferences</link></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="help">
<title>Help</title>

<para><variablelist>
<varlistentry>
<term>Contents</term>
<listitem>
<para>Invokes the KDE help system with the Caitoo help pages displayed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>About </term>
<listitem>
<para>Displays essential information about Caitoo.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>

<sect1 id="transferconfigdlg">
<title>Transfer Configure Dialog</title>

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

<para>This dialog can be used to set the transfer mode and timer. It shows the 
source and destination URL's.</para>

<para>It is opened also when you set transfer mode to scheduled and you need to set 
the timer.</para>
</sect1>

<sect1 id="individualprogressdialog">
<title>Individual Progress Dialog</title>

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

<para>When you double-click on some transfer in the listbox, an individual progress 
dialog will open. Sometimes you want to keep the Caitoo docked, but still you 
want to watch the progress of some important transfer. You can e.g. iconify 
this small progress dialog and watch the progress in the taskbar.</para>

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

<para>Pressing the <emphasis remap="bf">Cancel</emphasis> button will not only close the progress dialog, 
but cancel the whole transfer !</para>
</sect1>

<sect1 id="dockwidget">
<title>Dock Widget</title>

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

<para>Press <emphasis remap="bf">Dock window</emphasis> on the toolbar to dock Caitoo. After this, Caitoo 
will be represented on the screen by the small dock widget in the panel.</para>

<para>You can drag URL's on this widget without keeping the main Caitoo window 
opened.</para>

<para>Dock widget is also an indicator of running transfers. When there are some 
currently running transfers, this widget shows a bar chart for first three 
running transfers.</para>

<para>Right mouse button click opens a popup menu, where you can undock widget or 
quit application.</para>
</sect1>

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

<para><graphic fileref="drop.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, but for first four running transfers.</para>

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

<sect1 id="logwindow">
<title>Log Window</title>

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

<para>Log window shows messages from all events that happen in Caitoo. You can open 
it by pressing <emphasis remap="bf">Log window</emphasis> button on toolbar, or selecting it from main 
menu.</para>
</sect1>
</chapter>

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

<para> When you press <emphasis remap="bf">Preferences</emphasis> button in the toolbar or choose same item from the main menu, this dialog will open and allow you to set various Caitoo options.</para>

<sect1 id="connection">
<title>Connection</title>

<sect2 id="reconnecting">
<title><emphasis>Reconnecting</emphasis></title>

<para><variablelist>
<varlistentry>
<term>On login or timeout error</term>
<listitem>
<para>If Caitoo can't login into the server, it will stop attempting and schedule 
it for retrying after some time. For this you have to set interval - 
<emphasis remap="bf">reconnect after X minutes</emphasis> and <emphasis remap="bf">number of retries</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>On broken connection</term>
<listitem>
<para>If some connection error occurs while downloading, Caitoo will automatically 
pause all affected transfers ( because of error ) and resume them again ( 
well not all, only those which can resume, others are only paused ).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Automatically resume</term>
<listitem>
<para>When this is set, Caitoo will resume transfers without asking ( normally it 
would open dialog asking whether overwrite or resume ). If transfer cannot be 
resumed, dialog will appear anyway.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="timeouts">
<title><emphasis>Timeouts</emphasis></title>

<para>These are the intervals, after which when no data arrives, Caitoo will pause 
transfer and resume it again. The second value is meant for transfers which 
cannot resume. Of course that this value should be bigger then the first one.</para>
</sect2>

<sect2 id="typeofconnection">
<title><emphasis>Type of connection</emphasis></title>

<para>Here you can set what type of connection to Internet you have. This is needed,
so that Caitoo can automatically activate / disactivate Offline mode. This 
feature will be probably most useful for users with dial-up connection.</para>

<para>For successful use of this function, you need to now the network interface 
that is used for your Internet connection.</para>

<para>If you are sure, that you are always online, you can select <emphasis remap="bf">Permanent</emphasis> 
in the combo box. With this choice, Caitoo will not check for the connection, 
but rather assume that you are always online. However, you can still activate 
offline mode manually ( see below ).</para>

<para>Users with other types of connection might want to set select something else. 
Easy way of finding out what kind of interface is your network using is an 
utility <emphasis remap="bf">ifconfig</emphasis>.</para>

<para>Simple output in the shell might look like this :
<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>You can see that first two letters are <emphasis remap="bf">lo</emphasis>. This is short for loopback 
interface, which is always running on most systems. The output will probably 
look like this when you are disconnected from Internet. After connecting to 
Internet, you might see also another entry, which starts e.g with <emphasis remap="bf">ppp0</emphasis> 
or <emphasis remap="bf">sl1</emphasis>. These two stand for PPP interface number 0 or SLIP interface 
number 1. Now you would now, what your connection interface is, and you can 
set it in the combo box.</para>

<para><variablelist>
<varlistentry>
<term>Offline mode</term>
<listitem>
<para>Turn this on when you want Caitoo to be in offline mode. In this mode, you can
use Caitoo to create lists of transfers, while actually not downloading 
anything. It's useful when you are browsing stuff offline, but still want to 
create transfer list. There is also a toolbar button for quick access to this 
function.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>

<sect1 id="proxy">
<title>Proxy</title>

<para>If you need to connect to Internet via proxy, you can turn on option 
<emphasis remap="bf">Use Proxy</emphasis>.</para>

<para>Type in your proxy server and desired port.</para>

<para>In <emphasis remap="bf">No proxy for</emphasis> line specify servers, for which you don't want to use 
proxy.</para>

<para>Please note that ftp proxy doesn't work yet and also http proxy is only 
experimental and might not work always as expected.</para>
</sect1>

<sect1 id="automation">
<title>Automation</title>

<para><variablelist>
<varlistentry>
<term>Auto save file list</term>
<listitem>
<para>This is interval after which the transfer list gets saved into the config file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Auto disconnect</term>
<listitem>
<para>If this is set, Caitoo will automatically disconnect from Internet when all 
queued transfers are finished. It doesn't care about scheduled transfer. 
However, when you schedule transfer, you probably have other type of 
connection then PPP link and you don't need this option.
This option can be toggled more easily from the toolbar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Disconnect command</term>
<listitem>
<para>Specify here a command for disconnecting from internet. Preset is "kppp -k" , 
which will stop running kppp. You can of course use anything else, e.g. 
"killall pppd".</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Auto shutdown</term>
<listitem>
<para>If this is set, Caitoo will automatically quit when all transfers are 
finished. This time it cares about scheduled transfer. If there is anything 
scheduled, Caitoo won't quit.
This option can be toggled more easily from the toolbar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Auto paste</term>
<listitem>
<para>If this is set, Caitoo will automatically paste URL's from clipboard. There 
will be no need to press <emphasis remap="bf">Paste</emphasis> button, just copy some URL into the 
clipboard and it will be pasted automatically.
This option can be toggled more easily from the toolbar.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="limits">
<title>Limits</title>

<para><variablelist>
<varlistentry>
<term>Maximum number of opened connections</term>
<listitem>
<para>Caitoo will keep this number of simultaneously downloading files. This means 
that Caitoo will not download more then this number of files in the same time.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Start transfer only if network bandwidth is more then</term>
<listitem>
<para>This feature is not yet supported.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Keep the maximum bandwidth taken by transfer at</term>
<listitem>
<para>This feature is not yet supported.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="addnew">
<title>Advanced</title>

<para><variablelist>
<varlistentry>
<term>Add new transfers as</term>
<listitem>
<para>You can choose whether the new transfers should be added as <emphasis>queued</emphasis> and 
thus automatically started, or as <emphasis>delayed</emphasis>, which is better when working
offline.</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>Mark partial downloads</term>
<listitem>
<para>When this is set, Caitoo will add a special extension <emphasis>.part</emphasis> to all 
downloading files. Caitoo will remove the extension after the successful 
download. This way you know whether the file was downloaded OK or not.
This option is set on by default.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Remove the file from the list after success</term>
<listitem>
<para>Turn this option off, if you want finished transfers to stay in the list. 
They will have a special status icon. This is needed if you want to do some 
statistics about downloaded files.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Get file sizes</term>
<listitem>
<para>When turned on, Caitoo will for all added transfers get their sizes first and 
display them in the list. This way you will know the size of the file before 
downloading it.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Expert mode</term>
<listitem>
<para>This mode is for experienced users. For explanation see 
<link linkend="expertMode">Expert mode</link>.
This mode can be toggled more easily from the toolbar.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="directories">
<title>Directories</title>

<para>In this section you can setup default directories for different file 
extensions. Each line in the list contains a pair : 
<emphasis>file extension</emphasis> and <emphasis>directory</emphasis>.</para>

<para>Buttons allow you to add, delete and change entries in the list.</para>

<para>You can use wildcards in the the extension field to specify various file types.</para>

<para>When the new transfer is added, the file extension is compared to the entries 
in this list. Caitoo keeps the order, so put more global entries ( like * ) to 
the end of the list.</para>

<para>When Caitoo doesn't find the matching extension, it will use the current 
directory.</para>

<para>Toolbar button <emphasis remap="bf">Use last directory</emphasis> can be used to temporarily disable 
the directory settings. When it is set, Caitoo will put the file into the 
directory used for the last transfer added.</para>
</sect1>

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

<para><variablelist>
<varlistentry>
<term>Use Sounds</term>
<listitem>
<para>If this is set, Caitoo will play sounds when one of the four events occur :
<itemizedlist>
<listitem>
<para>transfer was added to the list</para>
</listitem>
<listitem>
<para>transfer has started</para>
</listitem>
<listitem>
<para>transfer has finished</para>
</listitem>
<listitem>
<para>all transfers have finished</para>
</listitem>
</itemizedlist>
</para>
<para>      
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>Use Animation</term>
<listitem>
<para>If this is set, Caitoo will animate status icons in the listbox and also use 
animation in the  docked widget.
You can toggle this option also from the main menu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Window Style</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 Style of docking</term>
<listitem>
<para>This toggle is for selecting beteen two styles of docking / 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>Other way is like it was in former version of Caitoo. Clicking on dock widget 
or drop target will show / hide normal Caitoo window.</para>
<para></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Font</term>
<listitem>
<para>Use font dialog to set your favourite font for a listbox.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="caitoovskfm">
<title>Questions and answers</title>

<para><itemizedlist>
<listitem>
<para><link linkend="caitooVSkfm">Why should I use Caitoo and not just kfm ?</link></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>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
