<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE> The KFind Documentation: Installation</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="kfind finfd">
<META NAME="description" CONTENT="Documentation for kfind">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000" > 
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.gif" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>

 
<P ALIGN="RIGHT">

<A HREF="index-3.html">Next</A>
<A HREF="index-1.html">Previous</A>
<A HREF="index.html#toc2">Table of Contents</A>
</P>
<H3><A NAME="s2">2. Installation</A></H3>

<P>
<P>
<H3><A NAME="ss2.1">2.1 How to obtain KFind</A>
</H3>

<P>KFind is a core application of the KDE project 
<A HREF="http://www.kde.org">http://www.kde.org</A>.  KFind can be found on 
<A HREF="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</A>, the main ftp site of the KDE
project.
<P>
<H3><A NAME="ss2.2">2.2 Requirements</A>
</H3>

<P>In order to successfully compile KFind, you need the latest versions
of <CODE> libkdecore</CODE> and <CODE> libkfm</CODE>. All required libraries
as well as KFind itself can be found on 
<A HREF="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</A>.
<P>
<H3><A NAME="ss2.3">2.3 Compilation and installation</A>
</H3>

<P><B>Kfind</B> is normally an integrated part of a KDE release and therefore
will be automatically installed with other KDE applications in the normal
course of KDE installation.
<P>In order to compile and install KFind on your system, type the
following in the base directory of the KFind distribution:
<BLOCKQUOTE><CODE>
<PRE>
 
% ./configure 
% make 
% make install 
</PRE>
</CODE></BLOCKQUOTE>
<P>Since KFind uses <CODE>autoconf</CODE> you should have not trouble
compiling it.  Should you run into problems please report them to the
<B>KDE</B> mailing lists.
<P>
<H3><A NAME="ss2.4">2.4 Configuration</A>
</H3>

<P>Configuration is normally performed by means of the Preferences dialog;
see the user section of this manual for more details. A technical description
of <B>kfind</B> configuration follows for interested parties.
<P>
<P><B>Kfind</B> reads from configuration parameters from a configuration
file (normally <CODE>~/.kfindrc</CODE>).
<P>This file contains information about saving search results, available
archivers and other configuration parameters; these parameters can be edited
from the <CODE>Kfind</CODE> <B>Preferences</B> dialog. 
<P>
<P><B>General information:</B> the resource file consists of sections.
Each section is started by a header title in square braces
e.g.<CODE>[Saving]</CODE>
<P>
<P>Information following the header relates to a specific aspect of
<CODE>Kfind</CODE> operation.
<P>
<P><B>Saving configuration:</B> The confiuration file holds the filename
and format of the file to be used for saving search results. This parameter
is stored within the .<I>kfindrc</I> file in entry <CODE>[Saving] </CODE>as
follows:
<BLOCKQUOTE><CODE>
<PRE>
[Saving]
Format=HTML
Filename=/root/result.html
</PRE>
</CODE></BLOCKQUOTE>

Where <CODE>Format</CODE> entry can have values <CODE>HTML </CODE>or <CODE>Plain Text</CODE>.
<P>
<P><B>Archiver configuration:</B> Archivers available for <CODE>kfind </CODE>are
specified in <I>.kfindrc</I> entry <CODE>[Archiver Types]</CODE> as follows:
<BLOCKQUOTE><CODE>
<PRE>
[Archiver Types]
Archivers=tar;zip;zoo;
</PRE>
</CODE></BLOCKQUOTE>
<P>And each archiver is detaily described by its own entry:
<BLOCKQUOTE><CODE>
<PRE>
[tar]
ExecOnCreate=tar cf %a -C %d %n
ExecOnUpdate=tar uf %a -C %d %n
Comment=Tar
</PRE>
</CODE></BLOCKQUOTE>
<P>The first line contains the command to be executed when creating a new
archive and the second is for updating existing archives. The third one
is the comment used for archiver description in <B>Preferences</B> dialog.
Variables may be used in these commands, and are denoted by a leading %
sign.
<P>The following is a list of legal command line variables:
<P>
<P><CODE>%a</CODE> The complete name of the archive
<P>
<P><CODE>%f</CODE> The normal file name
<P>
<P><CODE>%d</CODE> The parent directory. If the given argument is a file (
not a directory ) then this will give you the directory this file is in.
<P>
<P><CODE>%n</CODE> The name of the file. If the given argument is a directory
then this is the name of this directory.
<P>
<P>
<P ALIGN="RIGHT">

<A HREF="index-3.html">Next</A>
<A HREF="index-1.html">Previous</A>
<A HREF="index.html#toc2">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>    
</FONT>

 
</BODY>
</HTML>
