# The KArchie Handbook

Jörg
Habenicht

    j.habenicht@europemail

June 9th 1998

This Handbook describes KArchie

The KArchie Handbook

KDE
KArchie
archie

## Introduction

I'm proud to introduce you to introduce you `KArchie`, the prospero client for the K Desktop Environment. This piece of software shall give you easy search and access to files stored in the anonymous FTP directories in the world wide internet. Please send bug reports to j.habenicht@europemail.com

`Jörg Habenicht`

## Installation

### How to obtain KArchie

KArchie is a part of the KDE project http://www.kde.org. It can be found on ftp://ftp.kde.org/pub/kde/, the main ftp site of the KDE project, in the kdenonbeta snapshots. Please consider using your nearest mirror ftp site to get the load away from the server.

### Compilation and installation

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

    % ./configure
    % make
    % make install

Since KArchie uses `autoconf` you should have not trouble compiling it. Should you run into problems, please report them to my email address j.habenicht@europemail.com .

## Getting KArchie started

This section gives you a small introduction to the first usage of KArchie. More information can be obtained in the Features section.

### First view

After starting the programm, you will see the main window with a single line editor, the empty file list, where the results will be stored, and the file view with a more detailed discription of the currently selected file.

### Start query

To start an initial query, simply type in the name of the programm you are searching in the `Search Term` field and press `ENTER`. In the statusbar below you see the programm status changing to `query running` and the number of retries or hits increasing.

### Query results

If your search has been successfull, you see a full list of files and a detailed file description in the description field below. You may now select a file in a FTP server near to your host and open the server directory with menu `File->OpenDir` or download the file to your computer with menu `File->Download..`

## Features and Details

### Configuring

#### Archiehost

The menu item `Settings->Archieserver` selects the server to query for. Please consider the netload and select the nearest servers to you.

TIP: If you want to add a new server supporting archie service, edit in the karchierc file in section &lsqb;HostConfig] the Hosts= line.

#### Searchmode

The searchmode gives you the possibility to select the sort of searchstring you have. If for example you are shure to have the right filename then you may select exact.

#### Nicelevel

### Advanced Configuring

#### Timeout

The timeout value represents the time in seconds karchie waits for incoming data. If your working on a slow modem line or a heavy traffic network, rising the value may give you less query aborts.

#### Retries

The retries value is the level above whitch karchie aborts the query. Rise this value, if you want to query up to infinite times for your results.

### Drag and Drop

`!! to be implemented !!` You can drag and drop files right away from the file list to the KDE desktop, initialising a file download.

### Keyboard

KArchie will be keyboard controllable. The menu is usable as usual with ALT keys and Cursor keys. ALT-T or the TAB key selects the `Search Term` label, ENTER starts a filename query.

### more..

`!! to be implemented !!` Clicking with the right mouse button on the file list selects the file under the mouse pointer and opens a menu similar to the file menu. You may then select for file download or opening the server directory.

## Frequently Asked Questions and answers

Please send me some, because I have none :)

## Authors and recend versions

Archie was developed out of the prospero service, a service to give one a remote directory structure. With this directory service, the archie client looked for the queried filename. A graphical widget for X11 was developed with xarchie. I wanted to add some usefull features like session management, nice GUI and the use of KDE-kfm and got karchie. Please look at the README's for further information. I haven't written the email adresses for archie and xarchie here, because I don't wont to bother them with my bugs.

### archie

Programmatic Prospero interface to Archie. The prospero distribution is written by Clifford Neuman and the archie client by Brendan Kehoe

### xarchie

written by George Ferguson

### karchie

Old archie, new interface: karchie from Jörg Habenicht `j.habenicht@europemail.com`