<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kbear "KBear">
  <!ENTITY kappname "&kbear;">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Application-Variable Entities V2.0//EN" "entities/kde-prologue.entities">
]>
<book lang = "&language;">
<bookinfo>
<title>The &kbear; Handbook</title>
<authorgroup>
<author>
<firstname>Bj&ouml;rn</firstname>
<surname>Sahlstr&ouml;m</surname>
<affiliation>
<address>
<email>kbjorn@users.sourceforge.net</email>
</address>
</affiliation>
</author>
<author>
<firstname>Peter</firstname>
<surname>Sw&auml;rd</surname>
<affiliation>
<address>
<email>tocool@telia.com</email>
</address>
</affiliation>
</author>
</authorgroup>
<copyright>
<year>2000</year>
<year>2001</year>
<year>2002</year>
<holder>Bj&ouml;rn Sahlstr&ouml;m</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>Sun Dec 01 13:00:00 CEST 2002</date>
<releaseinfo>0.9</releaseinfo>
<abstract>
<para>&kbear; is a graphical ftp client with ability to connect to multiple hosts simultanously.</para>
<para>This Handbook describes &kbear; Version 2.1</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Networking</keyword>
<keyword>KBear</keyword>
<keyword>ftp</keyword>
<keyword>Internet</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Introduction</title>
<para>The &kbear; Team welcomes you to &kbear;, a user-friendly ftp client for the 
K Desktop Environment. Our goal has been to give you an easy to use ftp client.
</para>
<para>
Before you getting started, we suggest that you read through the <link linkend="getting-started">
Getting Started</link> section first so that your setup goes smoothly.
</para>
<para>&kbear;'s homepage is at <ulink url="http://kbear.sourceforge.net">http://kbear.sourceforge.net</ulink>
</para>
<para>
Feel free to come with suggestions to make it better at <email>kbjorn@users.sourceforge.net</email>.
</para>
</chapter>
<chapter id="getting-started">
<title>Getting Started</title>
<para>This is a short introduction to &kbear; and its usage so you can
start working with it right away. For more in-depth information see the
<link linkend="using-kbear">Using &kbear;</link> and 
<link linkend="using-sitemanager">Using The Sitemanager</link> sections. Note that
&kbear;'s installation is described in <link linkend="installation">the
appendix</link>.
</para>
<sect1 id="start-kbear">
<title>Starting &kbear;</title>
<para>
You can start &kbear; from the <guimenu>K menu</guimenu> or from the
command line. Note that there can only be one instance of &kbear;, if you try to start &kbear; 
and it's already running, the command line options will only be passed to the running instance.
</para>

<sect2 id="starting-from-the-menu">
<title>From the Menu</title>
<para>
Open the &kde; program menu by clicking on the
<guiicon>big K</guiicon> icon on the toolbar at the bottom left of your
screen. This will raise the <guimenu>program menu</guimenu>. Move your
cursor up the menu to the <guimenu>Internet</guimenu> menu item. A list
of available applications will appear. Choose <guimenuitem>&kbear;</guimenuitem>.
</para>
</sect2>

<sect2 id="starting-from-the-command-line">
<title>From the Command Line</title>
<para>
You can start &kbear; by typing its name on the command line. If you give
an URL, as in the example below, it will open that URL if possible. You can even give a space separated list of URL:s.
</para>
<informalexample>
<screen>
<prompt>%</prompt><userinput><command>kbear</command> <option><replaceable>ftp://ftp.kde.org/pub/kde</replaceable></option></userinput>
</screen>
</informalexample>
</sect2>
<sect2 id="first-start">
<title>First start</title>
<para>
Invoking &kbear; for the first time will start the Setup Wizard. It consists of four sections:
<guilabel>View Settings</guilabel>, <guilabel>Window Settings</guilabel>,
<guilabel>Miscellaneous</guilabel>, and <guilabel>Firewall Settings</guilabel>.
</para>
<para>
These sections can also be found in the menu 
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kbear;</guimenuitem></menuchoice>. 
The settings in these sections are fairly straightforward and most users can skip 
it right away and use the default settings. There is one exception though: users who are behind a 
firewall may need to setup this in the page <link linkend="firewall-settings">Firewall Settings</link>.
</para>
</sect2>
</sect1>

<sect1 id="working-with-kbear">
<title>Working with &kbear;</title>
<para>
Working with &kbear; is easy, but if you run into any problem 
just hit the 'whats this button', which is the small question mark in the upper right corner of 
the window. Then move the mouse cursor to the area you have questions about, and click again. 
A help message will then appear at the cursor position.
</para>
<para>
When the application is started for the first time you will have one visible child view. This child view shows your local file system. 
By default it contains your home directory. Most other ftp clients has a splitted view where the local file system is shown on one side, 
and the remote file system on the other side. &kbear;, on the other hand, can open an unlimited number of remote sites 
(your system is the only limit). Therefore, each site is opened in a separate child view, including the local file system. 
</para>
<para>
You can now connect to a remote host, either from the <menuchoice><guimenu>Sitemanager</guimenu></menuchoice> menu 
or from the Sitemanager dialog. If you want to add your own sites to the Sitemanager or want more information on how 
to use it, see the <link linkend="using-sitemanager">Using The Sitemanager</link> section for instructions how to do this. 
If you have used earlier version of &kbear; your old Sitemanager will be automatically imported. 
</para>
<para>
Once you have opened a remote site you can copy and move files and folders to or from your local filesystem. 
Just select the files/folders you want to transfer and drag them to the destination view, and drop them. The transfer will
start directly and the transfer view will show up, unless you set it not to, and show the progress of your transfer.
</para>
</sect1>
</chapter>

<chapter id="using-kbear">
<title>Using &kbear;</title>
<sect1 id="open-connection">
<title>Open a connection</title>
<para>
There are four ways to connect to a remote site. 
<itemizedlist>
<listitem>
<para>
The <menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu>FTP</guimenu><guimenuitem>Quick Connect</guimenuitem></menuchoice> command, also available in the toolbar. 
</para>
</listitem>
<listitem>
<para>
The Sitemanager that's available from the toolbar.
</para>
</listitem>
<listitem>
<para>
The <menuchoice><guimenu>Sitemanager</guimenu></menuchoice> menu. 
</para>
</listitem>
<listitem>
<para>
The <menuchoice><guimenu>FTP</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice> menu.
</para>
</listitem>
</itemizedlist>
</para>

<sect2 id="quick-connect">
<title>The Quick Connect dialog</title>
<para>
The <guilabel>Quick Connect</guilabel> is available either from the menu command  
<menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu>FTP</guimenu><guimenuitem>Quick Connect</guimenuitem>
</menuchoice> or from the toolbar. This dialog allows you to connect to a host even if it's not in the SiteManager. 
Here you first have to add the name of the host you want to connect to, just the name without protocol. Like 
<userinput>ftp.kde.org or 127.0.0.1</userinput>. You then have to select what protocol to use. 
When you select a protocol KBear tries to set the correct default port for that protocol, according to your system settings. 
If you don't want to use the default port, you can change it to the port number you want to use. 
Unless you want to use anonymous login you also has to an enter user name and a password for the specified site. 
Finally set the start path for the remote host and click the <guilabel>Connect</guilabel> button.  
</para>
<para>
From this dialog you can also choose to add the site automatically to the Sitemanager.
</para>
</sect2>

<sect2 id="sitemanager">
<title>The SiteManager</title>
<para>To connect from the Sitemanager, just select one of the sites 
in the tree view to the left, and then click on the <guilabel>Connect</guilabel> button.
</para>
<para>
For more information on how to use the Sitemanager, see the chapter <link linkend="using-sitemanager">Using the Sitemanager</link>.
</para>
</sect2>

<sect2 id="sitemanager-menu">
<title>The SiteManager menu</title>
<para>
The <menuchoice><guimenu>SiteManager</guimenu></menuchoice> menu contains the whole 
Sitemanager database in a menu tree. Just select one of the sites from the menu to open it.
</para>
</sect2>

<sect2 id="open-recent-menu">
<title>The Open Recent menu</title>
<para>
Here you have a list of the ten most recent visited connections from the Sitemanager. Just select one of the 
options and the specified site will be opened. If the site has been removed from the Sitemanager you will 
be warned about this and the site will also be romoved from the 
<menuchoice><guimenu>FTP</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice> menu.  
</para>
</sect2>

</sect1>

<sect1 id="transfer-files">
<title>Copy or move files and folders</title>
<para>
Once you have opened a remote site, you can start to transfer files and folders. &kbear; is capable of transfering files, 
not just to or from your local filesystem, but also between two remote hosts. Transfering files in &kbear; is easy. 
You will here get a short desciption of the two different ways to start a transfer in &kbear;: 
<quote>drag and drop</quote> and <quote>cut and paste</quote>.
</para>

<sect2 id="drag-and-drop">
<title>Drag and drop</title>
<para>
First you have to select the file(s) and/or folder(s) you want to transfer. By holding the <keycap>Ctrl</keycap> key 
pressed you can select several items. When you have selected all items you want to transfer, just 
press the left mouse button and hold it down. You will notice that the mouse cursor will change shape as soon as you 
start to move the mouse, indicating that you're dragging some items.Now move the mouse cursor to the view that 
holds the destination for your transfer, and release the mouse button. When you release the mouse button a small popup menu 
will show up, asking you to select wether you want to <guilabel>copy</guilabel> or <guilabel>move</guilabel> the file(s). 
Once you have selected the method, the transfer will start and an item will be shown in the 
<link linkend="transfer-view">transfer view</link>, displaying the status and progress of your transfer.
</para>
<tip>
<para>
By using the keyboard you can start the transfer directly without selecting transfer type in the popup menu. 
If you hold the <keycap>Ctrl</keycap> key pressed when you drop the item(s) 
a <guilabel>copy</guilabel> operation will start. If you hold the <keycap>Ctrl</keycap> and <keycap>Shift</keycap> 
keys pressed when you drop the items, a <guilabel>move</guilabel> operation will start.
</para>
<para>
If you hold the dragged item over a folder a little while the folder will be opened. 
This way you can work your way down in the directory tree, while still dragging the item, until you reach the position 
where you want to drop it.
</para>
</tip>
</sect2>

<sect2 id="cut-and-paste">
<title>Cut and paste</title>
<para>
As with <quote>drag and drop</quote> you first have to select the file(s) and/or folder(s) you want to transfer. 
Once you have done this you have to decide wether you want to <guilabel>copy</guilabel> or 
<guilabel>move</guilabel> the items. By selecting the menu option 
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice> or 
pressing the key combination <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> you select 
to <guilabel>copy</guilabel> the selected item(s). By selecting the menu option 
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem></menuchoice> or 
pressing the key combination <keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo> you select 
to <guilabel>move</guilabel> the selected item(s). Then activate the destination view and select the menu option 
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> or 
press the key combination <keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>. The transfer 
will now start and an item will be shown in the <link linkend="transfer-view">transfer view</link>, 
displaying the status and progress of your transfer.
</para>
<note>
<para>
You can also <guilabel>copy</guilabel> and <guilabel>move</guilabel> file(s) and folder(s) to or from 
Konqueror, and probably some other KDE applications.
</para>
</note>
</sect2>

</sect1>

<sect1 id="synch-dirs">
<title>Synchronizing directories</title>
<para>
This tool is meant to make it easier for you to synchronize a local directory with a remote directory. This can
be usefull, for example, for web sites. In order to use this tool you must first open the site that contains the directory
you want to synchronize. This is due to the fact that the tool is site dependent.
</para>

<sect2 id="new-synch-dirs">
<title>Add a new directory to synchronize</title>
<para>
To create a new synchronization go to the directory you want to synchronize on the remote server.
Then select the menu option <menuchoice><guimenu>Synchronize</guimenu><guimenuitem>Synchronize current directory</guimenuitem></menuchoice>.
You will now be asked to select the local directory to synchronize against. When this is done the synchronization tool will open.
</para>
</sect2>

<sect2 id="existing-synch-dirs">
<title>Open an existing synchronization.</title>
<para>
In the bottom of the <menuchoice><guimenu>Synchronize</guimenu></menuchoice> menu you will see all existing synchronizations
for the current site. Just select one and the synchronization tool will open.
</para>
</sect2>

<sect2 id="working-with-synch-dirs">
<title>Working with the Synchronizing tool.</title>
<para>
Once the synchronizing tool is opened and has finished loading the directories you will see
that the view consist of two directory trees, your local directory to the left and the remote directory to the right.
Some files are marked with different colors. These are the files that are different in the two directories.
By default files that exists in both directories but are differnet are marked in red. Files that exist on the local
filesystem but are missing on the remote are marked in green. Files that exist on the remote system but
are missing on your local filesystem are marked in blue. These colors can be changed in the
<link linkend="configuring-synch-dirs">Configuring the Synchronizing tool</link> dialog.
Between these directory views there are four buttons. The two double arrrow buttons at the top let you do
a complete synchronization. The first button from the top updates the remote directory with the local as reference.
If the file/directory exist in the local directory it's copied to the remote, if it's missing in the local directory it
will be deleted in the remote. Next button from the top work in the same way but it updates the local directory with the
remote as reference.
The next two single arrow buttons are disabled by default but will be enabled as soon as you select a file.
The right arrow updates the selected remote file. If the selected file is missing in the local directory it will be deleted in
the remote. The left button works in the same way but the other way around.
</para>
</sect2>

<sect2 id="configuring-synch-dirs">
<title>Configuring the Synchronizing tool.</title>
<para>
To open this dialog select the menu option <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Synchronize...</guimenuitem></menuchoice>.
The first options let you select how the tool should compare files: by comparing their modification time
or by comparing size and permissions. Next option let you set the time difference between the remote filesystem and your local filesystem.
For example if you save the same file on both the remote and local filesystem at the same time ( don't ask me how ;-) ), and the remote file
show the time 14:26 and the local 12:26 then set the time difference to +2. This way the files will not be marked as
different even if the actual time stamp is different.
In the color settings you can select the colors to display differences. You can then also set if you want the tool to warn before
files/directories are deleted. 

</para>
</sect2>

</sect1>

<sect1 id="Additional-views">
<title>Additional views</title>
<para>
Except for the child views, &kbear; has two other types of views: the transfer view and the log view. 
</para>
<sect2 id="transfer-view">
<title>Transfer view</title>
<para>
The transfer view will show itself as soon as you start a transfer and will continously show status and progress of all transfers. 
It consists of a so called tab view and will show a tab for each site that has active transfers. 
As soon as the transfers for a specific site has finished the tab will be removed. When the last tab is removed 
the view will hide itself again.
</para>
<tip>
<para>
If you click with the right mouse button on an active item in the transfer view a popup menu will show up with the option cancel. 
This way you can stop an active transfer. If the item is queued the popup menu will show the option start instead, so you 
can start a queued transfer.
</para>
</tip>
</sect2>

<sect2 id="log-view">
<title>Log view</title>
<para>
The log view will show itself as soon as you open a remote site and it will continously show log information. 
It consists of a so called tab view and will show a tab for each open remote site. As soon as you close a site its tab will 
be removed and when the last tab is removed the view will hide itself again.
</para>
<tip>
<para>
If you click with the right mouse button in a log page a small popup menu will show. Here you can select to mark all lines 
and copy the log contents into a document for example. You can also select to save the complete log content to a file.
</para>
</tip>
<note>
<para>
&kbear; is only capable to produce complete log information for the ftp protocol.
</para>
</note> 
</sect2>
</sect1>
</chapter>

<chapter id="using-sitemanager">
<title>Using The Sitemanager</title>
<sect1 id="using-sitemanager-general">
<title>General information</title>
<para>
The Sitemanager is your personal site library. By default it contains some useful ftp sites, but you can add, remove and re-arrange 
the contents after your own needs. The Sitemanager is a so called plugin, a component that, even if it's plugged into the main window, 
live it's own life, independent from the main application. This makes it possible for the Sitemanager to also plug into Konqueror. 
</para>
<para>
The Sitemanager dialog consists of a treeview to left containing the whole site database with all its goups and subgroups. Groups 
are shown as directories and sites are shown as files in the tree view. If you select a site in the treeview, 
the information of the selected site will be shown to the right. Once a site is selected you just has to click the 
<guilabel>Connect</guilabel> button to connect to it. You can also connect by double clicking the site.
</para>
<para>
Once in a while it happends that the Sitemanager contents doesn't show up. You can then reload the contents with th reload 
button below the treeview.
</para>
<sect2 id="earlier-versions">
<title>Earlier versions</title>
<para>
If you have used older versions of &kbear; you may have a personalized Sitemanager already. This old version is 
<keycap>not</keycap> compatible with the new one. But don't worry, you don't have to re-type all your sites, 
instead you can use the import filter system to import your old Sitemanager, see the  
<link linkend="import-sites">How to import bookmarks files</link> section.
</para>
</sect2>

<sect2 id="database">
<title>The Database</title>
<para>
Since the Sitemanager can plug into both &kbear; and Konqueror there is a big chance that there will be more than one 
Sitemanager running at the same time. Therefore is the management of the database moved into an external daemon 
like application that the Sitemanager communicates with. This application is automatically started and stopped by 
the Sitemanager. By default it show a small icon in the system tray (an open book with a small bear inside). 
This icon can be hidden from within the Sitemanager dialog.
</para>
</sect2>

<sect2 id="sitemanageri-konqueror">
<title>The Sitemanager in Konqueror</title>
<para>
As mentioned before the Sitemanager also plugs into Konqueror. Here you can use it in the same way as from within &kbear;. 
If you have several Sitemanager dialogs open at the same time they will always be synchronized with each other. So if you 
make changes in one of them the changes will directly take effect in all other open Sitemanagers. 
Even &kbear;:s Firewall settings work in Konqueror.
</para>
<para>
There is one issue though: it might happend that all settings in the Sitemanager may not work within Konqueror, 
especially the advanced site options. Normally they will, but if you make any changes these may not take effect until 
you restart Konqueror.
</para>
</sect2>
</sect1>

<sect1 id="using-sitemanager-change">
<title>Changing contents in the Sitemanager</title>

<sect2 id="names-in-sitemanager">
<title>Site and Group names in the Sitemanager</title>
<para>
Each site or group name has to be unique within the group. This means that if you have a group, all it's children need 
to have unique names. For example: lets say you have a group named <emphasis>group1</emphasis>. Then you can't have 
two sites with the same name if they both have <emphasis>group1</emphasis> as parent. The name can exist in other groups 
or in subgroups though. This is not a practical problem though since the database will rename the site or group if the name 
already exist. If you save a site with the name <emphasis>myname</emphasis> and the name already exist it will be renamed 
to <emphasis>myname (2)</emphasis>. If <emphasis>myname (2)</emphasis> already exist it will be 
<emphasis>myname (3)</emphasis> and so on.
</para>

</sect2>

<sect2 id="create-site">
<title>How to create a new site</title>
<para>
First thing to do is to decide where in the site tree you want the site to be saved. To do this just select a group in the 
tree view, the site will then become a child of the selected group when saved. If you select a site the saved site will become 
a child of the same group as the selected site. If no site or group is selected the saved site will be saved as a root level site. 
</para>
<para>
Once you have decided where you want the site to be saved, you can start to enter the information needed: 
<variablelist>
<varlistentry>
<term><guilabel>Label</guilabel></term>
<listitem>
<para>
Here you need to enter a name for the site, see 
<link linkend="names-in-sitemanager">section above about names in the Sitemanager</link>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Host name</guilabel></term>
<listitem>
<para>
Here you need to enter the name of the host to connect to, just the name without protocol, like: 
<userinput>ftp.kde.org</userinput> or <userinput>127.0.0.1</userinput>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Protocol</guilabel></term>
<listitem>
<para>
Here you have to select what protocol you want to use when connecting to the host. The number available 
protocols depends on your system. When you select a protocol &kbear; automatically try to detect the default 
port for the selected protocol.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Port</guilabel></term>
<listitem>
<para>
Here you can select the port you want to use when connecting to the host. Normally you don't have to change this.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Anonymous</guilabel></term>
<listitem>
<para>
If you're connecting to an anonymous server you can check this option.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Advanced...</guilabel></term>
<listitem>
<para>
See <link linkend="advanced-settings">Advanced Settings</link> section below.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>User name</guilabel></term>
<listitem>
<para>
If you need to specify a user name to log in to the host, you can do so here.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Password</guilabel></term>
<listitem>
<para>
If you need to specify a password to login to the host, you can do so here.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Local path</guilabel></term>
<listitem>
<para>
By default &kbear; sets the path in the local filesystem view to your home directory when connecting to a host. 
If you want it to set another path, specify this here.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Remote path</guilabel></term>
<listitem>
<para>
Set the initial directory for the remote host here.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Description</guilabel></term>
<listitem>
<para>
Here you can specify a short description for the site (fully optional).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="create-group">
<title>How to create a new group</title>
<para>
As when creating a new site you first have to select where in the site tree you want to add the site by selecting an existing group. 
Then just click on the <guilabel>New Group</guilabel>  button. A small dialog will appear where you can specify the name 
for the new group. About names in the Sitemanager see <link linkend="names-in-sitemanager">above section about names</link>.
</para>
</sect2>

<sect2 id="move-site">
<title>How to move a site or group</title>
<para>
If you want to move a site or a group to another position in the site tree then do like this: Click on the item you want to move 
and hold the mouse button down. Then drag the item to the position where you want it, still with the mouse button pressed, 
until you reach the position where you want to place it. Release the mouse button and the item will be moved.  Note that 
when dropping the item it may not showup exactly where you dropped it since the treeview sorts it's items. It will still 
be at the same level though.
<tip>
<para>
If you hold the dragged item over a group a little while the group will be opened. 
This way you can work your way down in the tree, while still dragging the item, until you reach the position 
where you want to drop it.
</para>
</tip>
</para>

</sect2>

<sect2 id="rename-site">
<title>How to rename a site or group</title>
<para>
If you want to rename a site or group just right click with the mouse at the item you want to rename. A small menu with the
option <guilabel>Rename</guilabel> appears. Select this option and you will now be able to rename the site or group. When
you're done just push the <keycap>Enter</keycap> key.
</para>
</sect2>

<sect2 id="remove-site">
<title>How to remove a site or group</title>
<para>
To remove a site or group just select the site or group you want to remove and push the <guilabel>Remove</guilabel> button.
</para>
</sect2>

<sect2 id="import-sites">
<title>How to import bookmarks files</title>
<para>
The Sitemanager has a flexible system to import bookmark files from other ftp clients as well as for the old Sitemanager. When 
you first run this version &kbear; will automatically import the old Sitemanager file, but it can also be manually imported later.
If you want to import a bookmark file just click on the <guilabel>Import...</guilabel> button in the Sitemanager. A small 
dialog will open, showing all available import filters to the left. Select the filter that you want to use and click the 
<guilabel>Import</guilabel> button. A fileselect dialog will now appear, asking you to specify the file to import. 
</para>
</sect2>

<sect2 id="advanced-settings">
<title>Advanced Settings</title>
<para>
In most cases the default settings will let you connect to, and work against, a remote host. There are some hosts that 
require special settings though. If you encounter any problems trying to connect to, or work against, a specific host, 
these settings may help you to solve these problems. 
<note>
<para>
You will here get a brief description about the settings on this page. If you're interested in more information about the FTP protocol, 
see <ulink url="http://www.rfc.net/">http://www.rfc.net/</ulink>. This information can be quite hard to read though, and there 
are probably other information available on the Internet that's easier to understand.
</para>
</note>
</para>

<sect3 id="disable-PASV">
<title>Disable Passive mode, Extended Passive mode</title>
<para>
By default &kbear; uses so called Passive mode, <command>PASV</command>. 
This command requests the server to <quote>listen</quote> on a data port which is not its default data 
port and to wait for a connection rather than initiate one itself.
If you disable this option &kbear; will use the <command>PORT</command> instead. This command sets 
the data port to be used in data connection.
<note>
<para>
Using <command>PASV</command> will work in nearly all cases since &kbear; falls back in <command>PORT</command> 
mode if <command>PASV</command> fails.
</para>
</note>
</para>
</sect3>

<sect3 id="no-list-A">
<title>Don't send <command>list -a</command></title>
<para>
Here you can specify if you don't want to send <command>list -a</command> to the server to retreive a directory listing. 
In some cases this can be useful since there are some servers that don't understand <command>list -a</command>. On 
the other hand, if you don't send <command>list -a</command>, you can't retreive hidden Unix files.
</para>
</sect3>

<sect3 id="no-part-extension">
<title>Use .part extension</title>
<para>
KDE can add .part to the file name during transfers to indicate that the transfer is partially done. This can cause trouble on a server 
where you don't have permissions to rename files. If you don't want to use the .part extension, uncheck this option.
</para>
</sect3>

<sect3 id="turn-off-log">
<title>Turn off log</title>
<para>
If you don't want &kbear; to produce log information for this site, check this option. Producing log information can 
reduce transfer speed so if you notice this, check this option.
</para>
</sect3>

<sect3 id="queue-transfers">
<title>Queue transfers</title>
<para>
Here you can override the global queue option from the <link linkend="misc-settings">settings dialog</link>. If the global 
option is set to not queue transfers, you can override this for this specific site. This can be useful since some servers 
only allow a single connection from a specific host. 
</para>
</sect3>

<sect3 id="use-single-connection">
<title>Use a single connection</title>
<para>
If you check this option &kbear; will use a single connection for all filesystem oprations, even transfers. This will lead to 
that, for example, a listing operation will be blocked until a delete operation is finished. This can be useful since some servers 
only allow a single connection from a specific host.
<note>
<para>
The GUI will be disabled for the actual site during transfers if this option is checked. This is because you can only do one thing at the time.
</para>
</note> 
</para>
</sect3>

<sect3 id="transfer-mode">
<title>Transfer mode</title>
<para>
Here you can specify how you want files to be transfered when using the ftp protocol. <command>Binary</command> will 
work in 99% of the transfers. Some files, like some perl scripts will be damaged this way though. Therefore you can 
specify to transfer files in <command>ASCII</command> mode instead.
</para>
</sect3>

<sect3 id="reconnect-automatically">
<title>Reconnect automatically</title>
<para>
Here you can specify if you want &kbear; to try to reconnect automatically if connection fails. You can also specify 
the time to elapse between attempts and how many times it should try to reconnect.
</para>
</sect3>

</sect2>
</sect1>
</chapter>

<chapter id="configure-kbear">
<title>Configure &kbear;</title>
<sect1 id="view-settings">
<title>View Settings</title>
<para>
The settings in the <guilabel>View Settings</guilabel> page let you select 
what parts of the GUI you want to be visible. Here you can hide/show toolbars, statusbar etc. 
</para>
<variablelist>
<varlistentry>
<term><guilabel>Default view settings</guilabel></term>
<listitem>
<para>
In this first section you can select what kind of directory listing you want, detailed or icon mode. 
The thumbnails give you a preview of how they look.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Default visible settings</guilabel></term>
<listitem>
<para>
Here you can select what GUI parts of the MainWindow you want to be visible. 
In the subarea <guilabel>Child Views</guilabel> you can also select visible parts of the child views.
This can be usefull if you have a low resolution screen, so the child views occupy less screen space. 
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
The last option on this page: 
<guilabel>Save settings used when closing the application</guilabel> means that all settings 
that are in use when closing the application will be saved and used as default at next startup.
</para>
</sect1> 

<sect1 id="window-settings">
<title>Window Settings</title>
<para>
The settings in the <guilabel>Window Settings</guilabel> page let you select 
one of the different window modes that &kbear; can operate in.
</para>
<variablelist>
<varlistentry>
<term><guilabel>TopLevel/ChildFrame mode</guilabel></term>
<listitem>
<para>
In this first section you can select between three different window modes:
<guilabel>TopLevel mode</guilabel>, <guilabel>ChildFrame mode</guilabel> and
<guilabel>TabPage mode</guilabel>.
</para>
<itemizedlist>
<listitem>
<para>
<guilabel>TopLevel mode</guilabel> means that all child views are detached from the MainWindow 
and are displayed as toplevel windows.
</para>
</listitem>
<listitem>
<para>
<guilabel>ChildFrame mode</guilabel> means that all child views are attached to the MainWindow 
and are displayed within the MainWindow.
</para>
</listitem>
<listitem>
<para>
<guilabel>TabPage mode</guilabel> means that all child views are attached to the MainWindow 
and are displayed as TabWindow within the MainWindow.
</para>
</listitem>
</itemizedlist>
<para>
The last option, <guilabel>Remember window positions...</guilabel>, let you select if the positions of the 
child views should be saved and reused.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Set default ChidFrame mode</guilabel></term>
<listitem>
<para>
Here you can select how the child views should be arranged when in ChildFrame mode and also if they should be arranged automatically.
</para>
</listitem>
</varlistentry>
</variablelist> 
</sect1>

<sect1 id="misc-settings">
<title>Miscellaneous Settings</title>
<para>
The settings in the <guilabel>Miscellaneous Settings</guilabel> page let you setup 
the following:
</para>
<itemizedlist>
<listitem>
<para>
<guilabel>Show system tray icon</guilabel> - Check this if you want the system tray icon to be visible. 
This give the opportunity to minimize the Application to just this icon. This can be useful for 
very long downloads. When moving the mouse over the system tray icon a popup will show 
the number of active and queued transfers.
</para>
</listitem>
<listitem>
<para>
<guilabel>On active transfers...</guilabel> - Check this option if you want the application 
to ask for confirmation before exiting if there are active or queued transfers.
</para>
</listitem>
<listitem>
<para>
<guilabel>Run 'Tip of today'...</guilabel> - Check this option if you want the 
'Tip of today' dialog to run on startup. 
</para>
</listitem>
<listitem>
<para>
<guilabel>Queue transfers</guilabel> - Check this option if you want to queue the transfers. 
This means that there will always be only one active transfer at a time. 
The transfers will show up in the transfer view as queued though. 
</para>
</listitem>
<listitem>
<para>
<guilabel>Email adress</guilabel> - Here you can set the email adress you want to use for login at anonymous servers.
</para>
</listitem>
<listitem>
<para>
<guilabel>Preview mode</guilabel> - When you click on a file &kbear; tries to find an embeddable 
part that can show the selected file. Here you can select if you want the file to be opened in ReadOnly- or 
ReadWrite- mode, or if you want to be asked everytime.
</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="firewall-settings">
<title>Firewall Settings</title>
<para>
If you are behind a Firewall you may need to specify how to connect and login. If you're <keycap>not</keycap> behind a Firewall, 
just make sure that the <guilabel>Firewall type</guilabel> is set to <guilabel>No firewall</guilabel>. 
</para>
<sect2 id="setup-firewall">
<title>How to setup the Firewall</title>
<para>
First you have to set username, password etc. for the Firewall, note: you don't have to set all fields, just the ones you need. 
In the combobox <guilabel>Firewall type</guilabel> you have seven predefined Firewall types, one of these should work for 
most users. If not, or if you encounter any problem logging in, there is a last type: <guilabel>Special</guilabel>. 
If you choose this type you can specify your own login macro in the edit box below. 
</para>
<para>We take an example, lets say you need to login like this:</para>
<screen width="40">
<userinput>USER fwuser</userinput>
<userinput>PASS fwpass</userinput>
<userinput>USER user@host:port</userinput>
<userinput>PASS pass</userinput>
</screen>
<para>Then you have to create a macro like this:</para>
<screen width="40">
<userinput>USER %fu</userinput>
<userinput>PASS %fp</userinput>
<userinput>USER %hu@%hh:%ho</userinput>
<userinput>PASS %hp</userinput>
</screen>
<para>
Note that each line will become a command sent to the Firewall host. 
If you don't know how to connect, then you can always experiment with all likely and non-likely combinations.
</para>
<para>
Note that these settings only apply to the ftp protocol, &kbear; has no internal Firewall support for other protocols. 
For those you have to fall back to KDE:s own proxy settings.
</para>
</sect2>
</sect1>

</chapter>

<chapter id="menu-entries">
<title>Menu Entries</title>
<sect1 id="ftpmenu">
<title>The FTP Menu</title>
<para>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>N</keycap>
</keycombo>
</shortcut>
<guimenu>FTP</guimenu>
<guimenuitem>Quick connect</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Creates a new connection, this is an alternative for connecting from the Sitemanager.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>W</keycap>
</keycombo>
</shortcut>
<guimenu>FTP</guimenu>
<guimenuitem>Close connection</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Close the connection for the active child view.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>FTP</guimenu>
<guisubmenu>Open Recent</guisubmenu>
</menuchoice>
</term>
<listitem>
<para>
Open a submenu with the ten most recent used connections from the <link linkend="using-sitemanager">SiteManager</link>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>FTP</guimenu>
<guimenuitem>Clear recent</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Clears the Open Recent menu.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>Q</keycap>
</keycombo>
</shortcut>
<guimenu>FTP</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Quits &kbear;</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="editmenu">
<title>The Edit Menu</title>
<para>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>X</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Cut out the selected items in the active child view to the clipboard</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>C</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Copy the selected items in the active view to the clipboard</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>V</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Paste the contents in the clipboard into the active view</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>A</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Select All</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Selects all items in the active view.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Deselect</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Deselects all items in the active view.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Invert Selection</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Inverts the selection in the active view.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>F</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Find</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a dialog where you can specify a search text to search for in the active view. You can use all kinds of wildcards here.</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="viewmenu">
<title>The View Menu</title>
<para>
<variablelist>

<varlistentry>
<term>
<menuchoice>
<guimenu>View</guimenu>
<guisubmenu>Show</guisubmenu>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a sub menu where you can select what you want to be visible in the active view.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Sorting</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a sub menu where you can select how you want the active view to be sorted.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycap>F5</keycap>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Reload</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Reload current directory in the active view.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Stop</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Stop loading in the active view.</action>
</para>
</listitem>
</varlistentry>

</variablelist>
</para>
</sect1> 

<sect1 id="synchmenu">
<title>The Synchronize Menu</title>
<para>
<variablelist>

<varlistentry>
<term>
<menuchoice>
<guimenu>Synchronize</guimenu>
<guimenuitem>Synchronize current directory</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open the synchronize tool for current directory. If the synchronization doesn't exist, it's created.</action>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<guimenu>Synchronize</guimenu>
<guimenuitem>Clear list</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Clears the list of existing synchronizations for this site.</action>
</para>
</listitem>
</varlistentry>

</variablelist>
</para>
</sect1>

<sect1 id="sitemanagermenu">
<title>The SiteManager Menu</title>
<para>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu>SiteManager</guimenu>
<guimenuitem>Reload</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Reloads the Sitemanager contents.</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
The rest of this menu is a reflection of the Sitemanager database.
</para>
</sect1>

<sect1 id="toolsmenu">
<title>Tools Menu</title>
<para>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Show Toolbar</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the Tools Toolbar.</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
The rest of this menu can be personalized with the 
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Tools</guimenuitem></menuchoice> menu option.
 
</para>
</sect1>

<sect1 id="settingsmenu">
<title>The Settings Menu</title>
<para>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Main Toolbar</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the main toolbar</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Help Toolbar</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the help toolbar</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Statusbar</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the Statusbar</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Taskbar</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the Taskbar, this is the toolbar containing buttons associated to the child views.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Transfer View</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the Transfer View (only visible when there are active/queued transfers)</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Log View</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/Hide the Log View ( only visible when there are open remote sites)</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Your Local Filesystem</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Show/hide the Local Filesystem View</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Child View Parts</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a submenu where you can show/hide toolbar, statusbar etc. in the child views.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Shotcuts</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a dialog where you can personalize key shortcuts for different actions.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a dialog where you can configure the toolbars.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure &kbear;</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open the Settings dialog for &kbear;.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Tools</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a dialog where you personalize the Tools toolbar.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Run Wizard...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Starts the &kbear; Setup Wizard.</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="windowmenu">
<title>The Window Menu</title>
<para>
<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu>Window</guimenu>
<guimenuitem>Close</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Close the active child view</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Window</guimenu>
<guimenuitem>Close All</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Close all  child views</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Window</guimenu>
<guimenuitem>Minimize All</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Minimize all child views</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Window</guimenu>
<guimenuitem>MDI Mode...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a sub menu where you can choose what view mode you want &kbear; to use.</action>
</para>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>Shift</keycap>
<keycap>F5</keycap>
</keycombo>
</shortcut>
<guimenu>Window</guimenu>
<guisubmenu>MDI Mode...</guisubmenu>
<guimenuitem>Toplevel mode</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Switch to TopLevel Mode. This means that all child views are detached from the MainWindow.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>Shift</keycap>
<keycap>F6</keycap>
</keycombo>
</shortcut>
<guimenu>Window</guimenu>
<guisubmenu>MDI Mode...</guisubmenu>
<guimenuitem>Childframe mode</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Switch to ChildFrame Mode. This means that all child views are attached to the MainWindow 
and are displayed within the MainWindow.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>Shift</keycap>
<keycap>F7</keycap>
</keycombo>
</shortcut>
<guimenu>Window</guimenu>
<guisubmenu>MDI Mode...</guisubmenu>
<guimenuitem>Tab Page mode</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Switch to Tab Page Mode. This means that all child views are attached to the MainWindow 
and are displayed as tabwindows within the MainWindow.
</action>
</para>
</listitem>
</varlistentry>
</variablelist>

</listitem>

</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Window</guimenu>
<guisubmenu>Tile...</guisubmenu>
</menuchoice>
</term>
<listitem>
<para>
<action>Open a sub menu where you can choose how the child views should be organized when in ChildFrame mode.</action>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Window</guimenu>
<guimenuitem>Dock/Undock...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Open a sub menu containing the names of all child views. 
If the view you select are docked to the MainFrame it will become undocked and vice versa.
</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="credits">
<title>Credits and License</title>
<para>
&kbear; Program copyright 2000, 2001, 2002 by the &kbear; developer team.
</para>
<variablelist>
<title>The &kbear; team:</title>
<varlistentry>
<term>Bj&ouml;rn Sahlstr&ouml;m <email>kbjorn@users.sourceforge.net</email></term>
<listitem><para>Project Manager &amp; Principal Developer</para></listitem>
</varlistentry>
<varlistentry>
<term>Peter Sw&auml;rd <email>tocool@telia.com</email></term>
<listitem><para>Developer</para></listitem>
</varlistentry>
</variablelist>


<para>
Documentation copyright 2000, 2001, 2002 Bj&ouml;rn Sahlstr&ouml;m <email>kbjorn@users.sourceforge.net</email>
</para>
<para>
This document has been translated by: 
<!-- Translators have to change this -->
<!-- start changes  -->
Peter Sw&auml;rd <email>tocool@telia.com</email>
<!-- end changes  -->
</para>

&underFDL;               <!-- FDL: do not remove -->

&underGPL;        	 <!-- GPL License -->

</chapter>
<appendix id="installation">
<title>Installation</title>
<sect1 id="installing-kbear">
<title>How to obtain and install &kbear;</title>
<sect2 id="getting-kbear">
<title>How to obtain &kbear;</title>
<para>
&kbear; can be found at <ulink url="http://kbear.sourceforge.net/">http://kbear.sourceforge.net/</ulink>, the
main web site of the &kbear; project, or at the main <ulink url="ftp://ftp.kde.org/">KDE</ulink> site. 
It can also be found at any of these <ulink url="http://www.kde.org/mirrors.html">KDE mirror sites.</ulink>
</para>
</sect2>
<sect2 id="requirements">
<title>Requirements</title>
<para>
In order to successfully use &kbear; you need KDE 3.x.x  to be installed. Note that &kbear; will compile and run with 
KDE 3.0 and 3.0.1, but there are some bugs in these releases that can affect &kbear; in some situations. 
Therefore its recommended to use KDE 3.0.2 or later. The package you need is kdelibs. 
If you want to compile &kbear; from sources you also need to install the *-devel-* package. 
If you want to use other protocols than ftp you also need to install kdebase, unless you have separately 
installed kioslaves like, for example, the fish kioslave. 
</para>
<para>
All required libraries can be found on the main <ulink url="http://ftp.kde.org">KDE</ulink> site.
</para>
</sect2>
<sect2 id="compilation">
<title>Compilation and installation</title>
<para>
In order to compile and install &kbear; on your system, type the following in the base directory of the &kbear; distribution:
</para>
<informalexample>
<screen>
<prompt>%</prompt><userinput><command>./configure</command></userinput>
<prompt>%</prompt><userinput><command>make</command></userinput>
<prompt>%</prompt><userinput><command>make install</command> (as root)</userinput>
</screen>
</informalexample>
<para>
Since &kbear; uses autoconf and automake you should have no trouble compiling it. 
Should you run into problems please report them to the author at <ulink url="mailto:kbjorn@users.sourceforge.net"> kbjorn@users.sourceforge.net</ulink>
</para>
</sect2>
</sect1>
</appendix>

&documentation.index;

</book>

<!--
Local Variables:
mode: sgml
sgml-namecase-general: t
sgml-namecase-entity: nil
sgml-general-insert-case: lower
sgml-minimize-attributes: nil
sgml-omittag: nil
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
