# &kbear; handboken

Björn
Sahlström

     kbjorn@users.sourceforge.net

Peter
Swärd

     tocool@telia.com

2000
2001
2002
Björn Sahlström
&FDLNotice;
Wen Jun 010 13:00:00 CEST 2002
0.8

&kbear; är en grafisk ftp klient med möjlighet att koppla upp sig mot flera värdar samtidigt.

Den här handboken beskriver &kbear; version 2.0

KDE
Networking
KBear
ftp
Internet

## Introduktion

&kbear; teamet välkomnar dig till &kbear;, en grafisk ftp klient för KDE. Vårt mål har varit att ge dig en ftp klient som är enkel att använda.

Innan du startar, föreslår vi att du läser igenom Att komma igång sektionen först, så dina inställningar går smärtfritt.

&kbear;'s hemsida finns på http://kbear.sourceforge.net

Känn dig fri att komma med förslag til att göra den bättre på kbjorn@users.sourceforge.net.

## Att komma igång

Det här är en kort introduktion till &kbear; och dess användning så du kan komma igång och arbeta med det på en gång. För mer djuplodande information se Att använda &kbear; och Att använda Sitemanagern sektionerna. Notera att &kbear;'s installation är beskriven i appendixet.

### Att starta &kbear;

Du kan starta &kbear; från K-menyn elleer från kommandoraden. Notera att det kan abra finnas en instans &kbear;, om du försöker starta &kbear; och programmet redan körs, kommer bara kommandorads alternativen att skickas till den redan startade instansen.

#### Från Menyn

Öppna &kde;:s program meny genom att klicka på den stora K ikonen på verktygsraden på botten av skärmen. Deta kommer att öppna program menyn. Flytta markören uppför menyn till Internet alternativet. En lista över alla tillgännnnnngliga program kommer att visas. Välj &kbear;.

#### Från kommandoraden.

Du kan starta &kbear; genom att skriva dess namn på kommandoreden. Om du ger en URL som argument, som i exemplet nedan, kommer dena att öppnas om det är möjligt. Du kan också ge en blankslags separerad lista av URL:s.

    %kbear ftp://ftp.kde.org/pub/kde

#### Första starten

Då du starta &kbear; för första gången kommer en inställnings 'Wizard' att startas. Den består av fyra sektioner: Vyinställningar, Fönsterinställningar, Blandade inställningar, och Brandväggsinställningar.

Dessa inställningar kan också hittas under menyn Inställningar Anpassa &kbear;. Inställningarna i dessa sektioner är ganska enkla och de flesta användare kan strunta i dem och använda de förinställda värdena.. Det finns ett undantag: användare som befinner sig bakom en brandvägg kan behöva ställa in dessa inställningar på sidan Brandväggsinställningar.

### Att arbeta med &kbear;

Att arbeta med &kbear; är enkelt, men om du skulle stöta på något problem klicka bara på 'vad är det här' knappen, som är det lilla fågetecknet i övre högra hörnet av fönstret. Flytta sedan muspekaren til det område du har frågor om , och klicka igen. Ett hjälpmeddelande kommer då att visas vi mus pekaren.

När programmet startas första gången kommer du att ha en synlig barnvy. Denna barnvy visar ditt lokala filsystem. Till att börja med innehåller det din hemkatalog. De flesta andra ftp klienter har en delad vy där det lokala filsystemet visas på den ena sidan och fjärrsystemet på den andra sidan. &kbear;, å andra sidan, kan visa ett obegränsat antal fjärrservrar (ditt eget system är den enda begränsningen). Därför öpppnas varje site i ett eget fönster, inklusive ditt eget filsystem.

Du kan nu ansluta till en fjärrserver, antingen från Sitemanager menyn eller från Sitemanager dialogen. Om du vill lägga till egna siter till Sitemanagern eller vill ha mer information om hur du använder den , se Att använda Sitemenagern sektionen för instruktionerom hur du gör detta. Om du har använt tidigare versioner av &kbear; kommer din gamla Sitemanager att importeras automatiskt.

När du väl har öppnat en fjärrserver kan du kopiera och flytta filer och kataloger till och ifrån ditt lokala filsystem. Välj bara de filer/kataloger du vill överföra och dra dem till målvyn, och släpp dem. Överföringen startar direkt och överföringsvyn visas, om du inte har ställt in så den inte ska visas, och visar nu hur överföringen går.

## Att använda &kbear;

### Öppna en anslutning

Det finns fyra sätt att ansluta till en fjärrserver.

- Kommandot Ctrl N FTP Snabbanslutning , också tillgängligt från verktygsraden.

- Sitemanagern som är tillgänglig från verktygsraden.

- Sitemanager menyn.

- FTP Öppna senaste menyn.

#### Snabbanslutnings dialogen

Snabbanslutning är tillgänglig antingen från meny kommandot Ctrl N FTP Snabbanslutning eller från verktygsraden. Denna dialog tillåter dig att ansluta till en värd även om den inte finns i Sitemanagern. Här måste du först ange namnet på värden du vill ansluta till, bara namnet utan protokoll. T.ex. `ftp.kde.org eller 127.0.0.1`. Du måste sedan välja vilket protokoll du vill använda.. När du väljer protokoll kommer &kbear; fösöka att automatiskt sätta korrekt förinställd port för det protokollet enligt dina system inställningar. Om du inte vill använda denna förinställda po rt går det bra att ändra till det portnummer du vill ha. Om du inte vill använda anonym inloggning, måste du också ange användarnamn och lösenord för den specificerade siten. Ange slutligen startkatalogen för fjärrservern och klicka på Anslut knappen.

Från den här dialogen kan du också ange om du vill att siten automatiskt ska läggas till i Sitemanagern.

#### Sitemanagern

För att anslluta från Sitemanagern, välj bara en site från trädvyn till vänster, och klicka på Anslut knappen.

För mer information om hur du använder Sitemanagern, se kapitlet Att använda Sitemanagern.

#### Sitemanager menyn

Menyn SiteManagern innehåller hela Sitemanager databasen i ett menyträd. Välj bara en av siterna från menyn för att öppna den.

#### Menyn Öppna senaste

Här har du en lista över de tio senast använda anslutningarna från Sitemanagern. Välj bara en av alternativen och den valda siten öppnas. Om siten har blivit borttagen från Sitemanagern kommer du att bli varnad om detta och siten kommer sedan att tas bort även från FTP Öppna Senaste menyn.

### Kopiera eller flytta filer och kataloger

När du väl har öppnat en fjärr site kan du börja överföra filer och kataloger. &kbear; kan överföra filer, inte bara till och från ditt lokala filsystem, utan också mellan två fjärrservrar. Att överföra filer i &kbear; är enkelt. Du kommer här att få en kort beskrivning av de två olika sätt att starta en överföring i &kbear;: dra och släpp och klipp och klistra.

#### Dra och släpp

First you have to select the file(s) and/or folder(s) you want to transfer. By holding the Ctrl 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 copy or move the file(s). Once you have selected the method, the transfer will start and an item will be shown in the transfer view, displaying the status and progress of your transfer.

By using the keyboard you can start the transfer directly without selecting transfer type in the popup menu. If you hold the Ctrl key pressed when you drop the item(s) a copy operation will start. If you hold the Ctrl and Shift keys pressed when you drop the items, a move operation will start.

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.

#### Klipp och klistra

As with drag and drop 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 copy or move the items. By selecting the menu option Edit Copy or pressing the key combination Ctrl C you select to copy the selected item(s). By selecting the menu option Edit Cut or pressing the key combination Ctrl X you select to move the selected item(s). Then activate the destination view and select the menu option Edit Paste or press the key combination Ctrl V. The transfer will now start and an item will be shown in the transfer view, displaying the status and progress of your transfer.

Du kan också kopiera och flytta fil(er) och katalog(er) till och från Konqueror, och troligen en del andra KDE program.

### Andra vyer

Förutom barnvyerna har &kbear; två andra typer av vyer: Överföringsvyn och Loggvyn.

#### Överföringsvyn

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.

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.

#### Loggvyn

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.

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.

&kbear; kan bara producera logginformation för ftp protokollet.

## Att använda Sitemanagern

### Generell information

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.

The Sitemanager dialog consists of a treeview to left containing the whole site database with all its goups and subgroups. Groups are shown as direcories 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 Connect button to connect to it. You can also connect by double clicking the site.

Til och ifrån händer det att innehållet i Sitemanagern inte visas. Du kan då ladda om den med uppdateringsknappen under trädvyn.

#### Tidigare versioner

If you have used older versions of &kbear; you may have a personalized Sitemanager already. This old version is not 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 How to import bookmarks files section.

#### Databasen

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.

#### Sitemanagern i Konqueror

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.

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.

### Ändra innehållet i Sitemanagern

#### Site- och grupp-namn i Sitemanagern

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 group1. Then you can't have two sites with the same name if they both have group1 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 myname and the name already exist it will be renamed to myname (2). If myname (2) already exist it will be myname (3) and so on.

#### Hur att skapa en ny Site

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.

När du väl bestämt var du vill att siten ska sparas kan du börja skriva in den infprmation som behövs:

Namn

  Här måste du ange ett anmn för siten, se sektionen ovan om namn i Sitemanagern.

Värdnamn

  Här måste du ange värden att ansluta till, bara namnet utan protokoll, t.ex: `ftp.kde.org` eller `127.0.0.1`.

Protokoll

  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.

Port

  Här kan välja vilken port du vill använda då du ansluter till värden. Normalt behöver du inte ändra denna.

Anonym

  Om du ansluter till en anonym server kan du bocka detta alternativ.

Avancerad...

  Se sektionenAdvancerade Inställningar nedan.

Användarnamn

  Om du måste ange ett användarnamn för att logga in på servern, kan du ange det här.

Lösenord

  Om du måste ange ett lösenord för att logga in på servern, kan du ange det här.

Lokal startkatalog

  By default &kbear; sets the path in the local filesystem view to your home directory when conecting to a host. If you want it to set another path, specify this here.

Startkatalog på Fjärrservern

  Ange startkatalogen för fjärrservern här.

Beskrivning

  Här kan du ange en kort beskrivning för siten (helt frivilligt)

#### Hur att skapa en ny grupp

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 New Group button. A small dialog will appear where you can specify the name for the new group. About names in the Sitemanager see above section about names.

#### Hur att flytta siter och grupper

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.

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.

#### Hur att ändra namn på en site eller grupp

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 Rename appears. Select this option and you will now be able to rename the site or group. When you're done just push the Enter key.

#### Hur att ta bort en site ller grupp

För att ta bort en site eller grupp, välj bara den site eller grupp du vill ta bort och kllicka på Ta bort knappen.

#### Hur att importera bokmärkesfiler

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 Import... 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 Import button. A fileselect dialog will now appear, asking you to specify the file to import.

#### Avancerade Inställningar

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.

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 http://www.rfc.net/. This information can be quite hard to read though, and there are probably other information available on the Internet that's easier to understand.

##### Stäng av Passivt läge, Utökad Passivt läge

By default &kbear; uses so called Passive mode, `PASV`. This command requests the server to listen 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 `PORT` instead. This command sets the data port to be used in data connection.

`PASV` fungerar i så gott som alla fall eftersom &kbear; faller tillbaka på `PORT` läge om `PASV` misslyckas.

##### Skicka inte `list -a`

Here you can specify if you don't want to send `list -a` to the server to retreive a directory listing. In some cases this can be useful since there are some servers that don't understand `list -a`. On the other hand, if you don't send `list -a`, you can't retreive hidden Unix files.

##### Använd .part extension

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.

##### Stäng av loggen

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.

##### Köa överföringar

Here you can override the global queue option from the settings dialog. 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.

##### Använd en enda anslutning

If you check this option &kbear; will use a single connection for all filesystem oprations (not 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.

##### Överföringsläge

Here you can specify how you want files to be transfered when using the ftp protocol. `Binary` 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 `ASCII` mode instead.

##### Återanslut automatiskt

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.

## Anpassa &kbear;

### Vyinställningar

The settings in the View Settings page let you select what parts of the GUI you want to be visible. Here you can hide/show toolbars, statusbar etc.

Förinställda vyinställningar

  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.

Förinställda synliga inställningar

  Here you can select what GUI parts of the MainWindow you want to be visible. In the subarea Child Views 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.

The last option on this page: Save settings used when closing the application means that all settings that are in use when closing the application will be saved and used as default at next startup.

### Fönsterinställningar

The settings in the Window Settings page let you select one of the different window modes that &kbear; can operate in.

Toppnivå/Barnvy läge

  I denna första sektion kan du välkja mellan tre olika fönsterlägen: Toppnivå läge, Barnvy läge och Tabbvy läge.

  - TopLevel mode means that all child views are detached from the MainWindow and are displayed as toplevel windows.

  - ChildFrame mode means that all child views are attached to the MainWindow and are displayed within the MainWindow.

  - TabPage mode means that all child views are attached to the MainWindow and are displayed as TabWindow within the MainWindow.

  The last option, Remember window positions..., let you select if the positions of the child views should be saved and reused.

Sätt förinställt Barnvy läge

  Here you can select how the child views should be arranged when in ChildFrame mode and also if they should be arraged automatically.

### Blandade inställningar

Inställningarna på sidan Blandade inställningar låter dig ställa in följande:

- Show system tray icon - 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 mose over the system tray icon a popup will show the number of active and queued transfers.

- On active transfers... - Check this option if you want the application to ask for confirmation before exiting if there are active or queued transfers.

- Run 'Tip of today'... - Check this option if you want the 'Tip of today' dialog to run on startup.

- Queue transfers - 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.

- Email adress - Here you can set the email adress you want to use for login at anonymous servers.

- Preview mode - 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.

### Brandväggsinställningar

If you are behind a Firewall you may need to specify how to connect and login. If you're not behind a Firewall, just make sure that the Firewall type is set to No firewall.

#### Hur att ställa in Brandväggen

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 Firewall type 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: Special. If you choose this type you can specify your own login macro in the edit box below.

Vi tar ett exempel, låt säga att du behöver logga in så här:

    USER fwuser
    PASS fwpass
    USER user@host:port
    PASS pass

Då kan du skapa ett makro som ser ut så här:

    USER %fu
    PASS %fp
    USER %hu@%hh:%ho
    PASS %hp

Notera att varje rad kommer att bli ett kommando som skickas till brandväggen. Om du inte vet hur du ska ansluta, kan du alltid experimentera med alla möjliga och omöjliga kombinationer.

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.

## Menyalternativ

### FTP menyn

Ctrl N FTP Snabbanslutning

  Creates a new connection, this is an alternative for connecting from the Sitemanager.

Ctrl W FTP Stäng anslutning

  Stänger anslutningen för den aktiva barnvyn

FTP Öppna senaste

  Öppanr en undermeny med de tio senast använda anslutningarna från SiteManagern.

FTP Rensa senaste

  Rensar 'Öppna senaste' menyn

Ctrl Q FTP Avsluta

  Avslutar &kbear;

### Redigera menyn

Ctrl X Redigera Klipp ut

  Cut out the selected items in the active child view to the clipboard

Ctrl C Redigera Kopiera

  Copy the selected items in the active view to the clipboard

Ctrl V Redigera Klista in

  Paste the contents in the clipboard into the active view

Ctrl A Redigera Markera alla

  Selects all items in the active view.

Redigera Avmarkera

  Deselects all items in the active view.

Redigera Invertera markering

  Inverterar markeringen i den aktiva vyn.

Ctrl F Redigera Sök

  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.

### Sitemanagermenyn

SiteManagern Uppdatera

  Uppdaterar inehållet i Sitemanagern.

Resten av denna meny är en speglling av innehållet i Sitemenager databasen.

### Verktygsmenyn

Verktyg Visa verktygsrad

  Visar/gömmer Verktygs-verktygsraden.

Resten av denna meny kan arrangeras efter eget önskemål genomInställningar Anpassa Verktyg meny alternativet.

### The Settings Menu

Settings Show Main Toolbar

  Show/Hide the main toolbar

Settings Show Help Toolbar

  Show/Hide the help toolbar

Settings Show Statusbar

  Show/Hide the Statusbar

Settings Show Taskbar

  Show/Hide the Taskbar, this is the toolbar containing buttons associated to the child views.

Settings Show Transfer View

  Show/Hide the Transfer View (only visible when there are active/queued transfers)

Settings Show Log View

  Show/Hide the Log View ( only visible when there are open remote sites)

Settings Show Your Local Filesystem

  Show/hide the Local Filesystem View

Settings Show Child View Parts

  Open a submenu where you can show/hide tollbar, statusbar etc. in the child views.

Inställningar Anpassa genvägar

  Open a dialog where you can personalize key shortcuts for different actions.

Inställningar Anpassa verktygsrader

  Open a dialog where you can configure the toolbars.

Inställningar Anpassa &kbear;

  Öppnar inställnings dialogen för &kbear;.

Inställningaar Anpassa Verktyg

  Open a dialog where you personalize the Tools toolbar.

Inställningar Kör Wizarden...

  Startar &kbear;:s inställnings wizard.

### Fönster menyn

Fönster Stäng

  Stänger den aktiva vyn.

Fönster Stäng alla

  Stänger alla vyer

Fönster Minimera Alla

  Minimize all child views

Window MDI Mode...

  Open a sub menu where you can choose what view mode you want &kbear; to use.

  F5 Window MDI Mode... Toplevel mode

    Switch to TopLevel Mode. This means that all child views are detached from the MainWindow.

  F6 Window MDI Mode... Childframe mode

    Switch to ChildFrame Mode. This means that all child views are attached to the MainWindow and are displayed within the MainWindow.

  F7 Window MDI Mode... Tab Page mode

    Switch to Tab Page Mode. This means that all child views are attached to the MainWindow and are displayed as tabwindows within the MainWindow.

Window Tile...

  Open a sub menu where you can choose how the child views should be organized when in ChildFrame mode.

Window Dock/Undock...

  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.

## Credits and License

&kbear; Program copyright 2000, 2001, 2002 by the &kbear; developer team.

### &kbear; teamet:

Björn Sahlström kbjorn@users.sourceforge.net

  Project Manager & Principal Developer

Peter Swärd tocool@telia.com

  Developer

Documentation copyright 2000, 2001, 2002 Björn Sahlström kbjorn@users.sourceforge.net

Det här dokumentet har översatts av Björn Sahlström kbjorn@users.sourceforge.net

&underFDL;

&underGPL;

## Installation

### How to obtain and install &kbear;

#### How to obtain &kbear;

&kbear; can be found at http://kbear.sourceforge.net/, the main web site of the &kbear; project, or at the main KDE site. It can also be found at any of these KDE mirror sites.

#### Requirements

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.

All required libraries can be found on the main KDE site.

#### Compilation and installation

In order to compile and install &kbear; on your system, type the following in the base directory of the &kbear; distribution:

    %./configure
    %make
    %make install (as root)

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 kbjorn@users.sourceforge.net

&documentation.index;