<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook
and in the FDL itself on how to use it. -->
<legalnotice>&FDLNotice;</legalnotice>
<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (YYYY-MM-DD) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->
<date>2004-7-13</date>
<releaseinfo>0.4</releaseinfo>
<!-- Abstract about this handbook -->
<abstract>
<para>
&kasablanca; is an ftp client, written in c++, using the kde libraries. among its features are
currently encryption (auth tls) support, fxp, site bookmarks, and queued transfers.
</para>
</abstract>
<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
of your application, and a few relevant keywords. -->
<keywordset>
<keyword>KDE</keyword>
<keyword>kasablanca</keyword>
<keyword>nothing</keyword>
<keyword>nothing else</keyword>
</keywordset>
</bookinfo>
<!-- The contents of the documentation begin here. Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->
<chapter id="Helpusing-kasablanca">
<title>Using &kasablanca;</title>
<!-- This chapter should tell the user how to use your app. You should use as
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
your application. -->
<sect1 id="globalhelp">
<title>Global Settings</title>
<para>The settings which concern the behaviour of the whole application.</para>
<sect2>
<title>Skiplist</title>
<para>
Here you can enter a Regular Expression. Transfer items which match this Regular Expression are skipped. For example a value of "^\." excludes every entry beginning with "." from transfer.
</para>
</sect2>
<sect2>
<title>On queue finished</title>
<para>
This field can hold an executable and its arguments which will be run, when last item of in queue has finished transferring. For Example, on KDE desktops the entry "dcop ksmserver ksmserver logout 0 0 0" would shutdown the computer automatically.
</para>
</sect2>
<sect2>
<title>On file exists</title>
<para>
These Radio Buttons indicate how the application should proceed if a file to be transfered already exists on the destination. Usually the user is asked by the application how to proceed if this occurs, in case you aren't present during the transfer you can enable this feature.
</para>
</sect2>
<sect2>
<title>Priority List</title>
<para>
This Field contains a regular expression, which queues the items matching this regular expression before the items which don't. For example, ".sfv" would make the common checksum files with this fileending transfer first.
</para>
</sect2>
</sect1>
<sect1 id="ftphelp">
<title>Ftp Server Settings</title>
<para>The settings which can be applied to an ftp session are described here.</para>
<sect2>
<title>Name</title>
<para>
The ftp's name is entered here.
</para>
</sect2>
<sect2>
<title>Host:Port</title>
<para>
This information points to the the ftp server. HOST can either be a standard ip adress like 192.168.2.1 or a domain name. PORT is the port number on which the ftp server listens. In most cases this is 21. Both are seperated by a ":" character. A legit input would be "ftp.kde.org:21".
</para>
</sect2>
<sect2>
<title>Username</title>
<para>
The ftp Login Username. On open ftp servers you usually login using "anonymous".
</para>
</sect2>
<sect2>
<title>Password</title>
<para>
The user's password. Anonymous ftp servers ussually don't use passwords or accept passwords in the form of "user@emailaddress.com".
</para>
</sect2>
<sect2>
<title>Encryption</title>
<para>
There are 4 encryption levels available. Unencrypted leaves all traffic clear and without encryption. Most ftp servers allow only this mode. Level 1 encryption means that the traffic on the control connection is encrypted while data transfer remains clear. Level 2 is basically the same with the exception of directory information which is transfered on the data channel, but is encrypted too. Eventually Level 3 encrypts everything all communication and all data traffic.
</para>
</sect2>
<sect2>
<title>Mode</title>
<para>
The mode you are using for data transfer. This is quite important in case you're behind a firewall or a router. In these cases you depend on the passive mode, which makes the client connects to the ftp server for data transfer. Passive mode is the standard method today, while active mode is the old way to do data transfers, the client listens for the server to connect in active mode.
</para>
</sect2>
<sect2>
<title>Mode</title>
<para>
The mode you are using for data transfer. This is quite important in case you're behind a firewall or a router. In these cases you depend on the passive mode, which makes the client connects to the ftp server for data transfer. Passive mode is the standard method today, while active mode is the old way to do data transfers, the client listens for the server to connect in active mode.
</para>
</sect2>
<sect2>
<title>Default directory</title>
<para>
Here you can type in a path which kasablanca attempts to enter after login.
</para>
</sect2>
<sect2>
<title>Alternative fxp</title>
<para>
Some ftp servers have problems with either active or pasv mode, which is needed for fxp. Using alternative fxp might help in such cases.
</para>
</sect2>
<sect2>
<title>Correct pasv responses</title>
<para>
When ftp servers are behind a router (NAT) they sometimes send wrong pasv responses containing their local IP. This option changes the IP value in pasv responses to the IP you connected to (most likely the servers router).
</para>
</sect2>
</sect1>
</chapter>
<chapter id="credits">
<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->
<title>Credits and License</title>
<para>
&kasablanca;
</para>
<para>
Program copyright 2004 Magnus Kulke <email>sikor_sxe@radicalapproach.de</email>
