<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="de">

<bookinfo>
<title>Das KFind-Handbuch</title>

<authorgroup>
<author>
<firstname>Miroslav</firstname>
<surname>Fl&iacute;dr</surname>
<affiliation><address><email>flidr@kky.zcu.cz</email></address></affiliation>
</author>

<author>
<firstname>Martin</firstname>
<surname>Hartig</surname>
<affiliation><address><email>hartig@mathematik.uni-kl.de</email></address></affiliation>
</author>

<author>
<firstname>Mark</firstname>
<surname>Roberts</surname>
<affiliation><address><email>mar2@scigen.co.uk</email></address></affiliation>
</author>
</authorgroup>

<date>21/06/1998</date>
<releaseinfo>0.04.00</releaseinfo>
<abstract>
<para>Dieses Handbuch beschreibt die KFind-Version 0.4</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Kfind</keyword>
</keywordset>
</bookinfo>

<chapter id="Einfuehrung">
<title>Einf&uuml;hrung</title>

<para><emphasis remap="bf">KFind</emphasis> sucht im Dateisystem Dateien nach w&auml;hlbaren Kriterien.</para>

<para>H&auml;ufig sucht man eine Datei und kennt nur noch Bruchteile des
Dateinamens, aber kann sich beim besten Willen nicht mehr erinnern, wo
denn nun diese Datei gespeichert war. <emphasis remap="bf">KFind</emphasis> ist dann genau das
richtige Werkzeug daf&uuml;r. Nachdem die Datei(en) gefunden wurden,
k&ouml;nnen sie:</para>

<para><itemizedlist>
<listitem>
<para><literal remap="tt"> gesichert,</literal>
</para>
</listitem>
<listitem>
<para><literal remap="tt"> gel&ouml;scht,</literal>
</para>
</listitem>
<listitem>
<para><literal remap="tt"> die Eigenschaften ge&auml;ndert,</literal>
</para>
</listitem>
<listitem>
<para><literal remap="tt"> einem Archiv hinzugef&uuml;gt werden.</literal>
</para>
</listitem>
<listitem>
<para><literal remap="tt"> Oder es kann ein Fenster des Dateimanagers (<application>Kfm</application>) in
diesem Verzeichnis ge&ouml;ffnet werden.</literal>
</para>
</listitem>
</itemizedlist>
</para>

<para>Ich hoffe, Sie finden das Programm n&uuml;tzlich. Ich freue mich
&uuml;ber Verbesserungsvorschl&auml;ge und Kommentare.</para>

<para><literal remap="tt">Miroslav Fl&iacute;dr</literal> <ulink url="mailto:flidr@kky.zcu.cz">flidr@kky.zcu.cz</ulink>.</para>
</chapter>

<chapter id="Installation">
<title>Installation</title>

<sect1 id="wie-sie-kfind-bekommen">
<title>Wie Sie KFind bekommen</title>

<para><emphasis remap="bf">KFind</emphasis> ist Teil des KDE Projekts <ulink url="http://www.kde.org">http://www.kde.org</ulink>. Sie
finden <emphasis remap="bf">KFind</emphasis> auf <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, dem
haupts&auml;chlichen FTP-Bereich des KDE-Projekts. Dar&uuml;ber hinaus
wird das KDE-Projekt auf zahlreichen FTP-Servern gespiegelt.</para>
</sect1>

<sect1 id="anforderungen">
<title>Anforderungen</title>

<para>Um <emphasis remap="bf">KFind</emphasis> erfolgreich kompilieren zu k&ouml;nnen, ben&ouml;tigen Sie
mindestens die neuesten Versionen von <literal remap="tt"> libkdecore</literal> und <literal remap="tt">libkfm</literal>. Alle ben&ouml;tigten Programmbibliotheken, wie auch
<emphasis remap="bf">KFind</emphasis> selbst, finden Sie auf <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para>
</sect1>

<sect1 id="kompilierung-und-installation">
<title>Kompilierung und Installation</title>

<para><emphasis remap="bf">KFind</emphasis> ist &uuml;blicherweise ein integraler Bestandteil der
KDE-Versionen und wird daher automatisch mit anderen KDE-Anwendungen
installiert. Sofern Sie <emphasis remap="bf">KFind</emphasis> selbst kompilieren und installieren
wollen, erfolgt dies auf die &uuml;bliche Weise im Verzeichnis der
<emphasis remap="bf">KFind</emphasis> Quelldateien:</para>

<para><screen>% ./configure
% make
% make install
</screen>
</para>

<para><emphasis remap="bf">KFind</emphasis> benutzt <literal remap="tt">autoconf</literal>, daher sollten keine Probleme
auftreten. Sofern doch Fehlerhinweise erscheinen, berichten Sie diese
bitte an die <emphasis remap="bf">KDE</emphasis> Mailinglisten.</para>
</sect1>

<sect1 id="konfiguration">
<title>Konfiguration</title>

<para>Die Konfiguration erfolgt &uuml;blicherweise &uuml;ber den
Men&uuml;punkt <literal remap="tt">Einstellungen</literal>, vgl. den dortigen Hilfetext. F&uuml;r
weiter Interessierte nachfolgend eine technische Beschreibung der
Konfiguration:</para>

<para><emphasis remap="bf">KFind</emphasis> liest seine Konfigurationsparameter aus der entsprechenden
Datei (&uuml;blich <literal remap="tt">&tilde;/.kde/share/config/kfindrc</literal>).</para>

<para>Diese Datei enth&auml;lt Informationen &uuml;ber das Speichern von
Suchergebnissen, verf&uuml;gbaren Archivprogrammen und anderen
Parametern; diese Parameter k&ouml;nnen teilweise im <emphasis remap="bf">Kfind</emphasis>
<literal remap="tt">Einstellungen</literal>-Dialog ver&auml;ndert werden</para>

<para><emphasis remap="bf">Allgemeine Information:</emphasis> die Datei besteht aus Abschnitten. Jeder
Abschnitt beginnt mit einem Titel in eckigen Klammern z.B.:
<literal remap="tt">Saving&rsqb;</literal></para>

<para>Informationen nach dem Titel beeinflussen spezielle Aspekte des
<emphasis remap="bf">KFind</emphasis> Verhaltens.</para>

<para><emphasis remap="bf">Sicherungs-Konfiguration:</emphasis> Das Format und der Dateiname zur
Speicherung des Suchergebnisses werden festgelegt. Diese Parameter
werden folgenderma&szlig;en definiert:</para>

<para><screen>&lsqb;Saving&rsqb;
Format=HTML
Filename=/root/result.html
</screen>
</para>

<para>Das Format kann als <literal remap="tt">HTML </literal> oder <literal remap="tt">Plain Text</literal> definiert werden.</para>

<para><emphasis remap="bf">Archivierungs-Konfiguration:</emphasis> Archivierungsprogramme werden in
<emphasis remap="it">kfindrc</emphasis> unter <literal remap="tt">&lsqb;Archiver Types&rsqb;</literal> festgelegt:</para>

<para><screen>&lsqb;Archiver Types&rsqb;
Archivers=tar;zip;zoo;
</screen>
</para>

<para>Jedes Archivierungsprogramm wird mit einem eigenen Eintrag spezifiziert:</para>

<para><screen>&lsqb;tar&rsqb;
ExecOnCreate=tar cf %a -C %d %n
ExecOnUpdate=tar uf %a -C %d %n
Comment=Tar
</screen>
</para>

<para>Die erste Zeile enth&auml;lt das Kommando zum Anlegen eines neuen
Archivs und die zweite Zeile das Kommando zur Erg&auml;nzung eines
bestehenden Archivs. Die dritte Zeile enth&auml;lt den Kommentar zur
Beschreibung im <literal remap="tt">Einstellungen</literal> Dialog. Variablen k&ouml;nnen in den
Befehlen mit einem vorangehenden Prozentzeichen (&percnt;) benutzt werden.</para>

<para> Liste der erlaubten Variablen:</para>

<para><literal remap="tt">&percnt;a</literal> Der komplette Name des Archivs</para>

<para><literal remap="tt">&percnt;f</literal> Der normale Dateiname</para>

<para><literal remap="tt">&percnt;d</literal> Das &uuml;bergeordnete Verzeichnis. Ist das Argument eine Datei
(und kein Verzeichnis), dann wird das Verzeichnis benutzt, in dem sich
die Datei befindet.</para>

<para><literal remap="tt">&percnt;n</literal> Der Name der Datei. Ist das Argument ein Verzeichnis, dann ist
dies der Name des Verzeichnisses.</para>
</sect1>
</chapter>

<chapter id="DasProgrammfenster">
<title>Das Programmfenster</title>

<para>In diesem Abschnitt erfolgt eine kurze Beschreibung des <emphasis remap="bf">KFind</emphasis>
Programmfensters.</para>

<para>Das <emphasis remap="bf">KFind</emphasis> Fenster ist in drei Bereiche aufgeteilt: <literal remap="tt">Werkzeugleiste, Suchparameter-Dialog und Ergebnisanzeige</literal>.
Ergebnisanzeige und Teile der Werkzeugleiste sind erst nach erzielten
Suchergebnissen verf&uuml;gbar.</para>

<sect1 id="werkzeugeliste">
<title>Werkzeugleiste</title>

<para><variablelist>
<varlistentry>
<term>Suche starten</term>
<listitem>
<para>Startet eine neue Suche mit den Suchparametern aus
dem Parameter-Dialog.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Neue Suche</term>
<listitem>
<para>L&ouml;scht bisherige Suchergebnisse und startet mit
neuen Parametern.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Suche abbrechen</term>
<listitem>
<para>Beendet den aktuell laufenden Suchproze&szlig;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&Ouml;ffnen</term>
<listitem>
<para>l&auml;&szlig;t <emphasis remap="bf">Kfm</emphasis> die ausgew&auml;hlte Datei
mit dem daf&uuml;r vorgesehenen Programm starten.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Zum Archiv hinzuf&uuml;gen</term>
<listitem>
<para>F&uuml;gt die ausgew&auml;hlte Datei dem gew&auml;hlten Archiv hinzu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>L&ouml;schen</term>
<listitem>
<para>L&ouml;scht ausgew&auml;hlte Datei und aktualisiert
die <emphasis remap="bf">Kfm</emphasis>-Anzeige. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Eigenschaften</term>
<listitem>
<para>Zeigt die Eigenschaften der
ausgew&auml;hlten Datei.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&Ouml;ffnen des entsprechenden Verzeichnisses</term>
<listitem>
<para><emphasis remap="bf">Kfm</emphasis> &ouml;ffnet
das Verzeichnis, in dem sich die ausgew&auml;hlte Datei befindet.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Suchergebnisse speichern</term>
<listitem>
<para>Speichert die Suchergebnisse in der Datei
gem&auml;&szlig; <literal remap="tt">Einstellungen-&gt;Optionen</literal> Dialog.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Hilfe</term>
<listitem>
<para>Zeigt die <emphasis remap="bf">KFind</emphasis> Dokumentation.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Beenden</term>
<listitem>
<para>Beendet KFind.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="suchparameter-dialog">
<title>Suchparameter-Dialog</title>

<para>Dieser Dialog ist der Hauptteil von <emphasis remap="bf">KFind</emphasis>. Hier werden die
speziellen Parameter in drei m&ouml;glichen Gruppen f&uuml;r die Suche
festgelegt:</para>

<para><variablelist>
<varlistentry>
<term>Name und Pfad</term>
<listitem>
<para>Der Dialog gibt den  Dateinamen an, nach dem gesucht wird. Der Dateiname
wird in die Eingabebox eingegeben und kann folgende Jokerzeichen
beinhalten:</para>
<itemizedlist>
<listitem><para>? bedeutet beliebiges Zeichen</para></listitem>
<listitem><para>* bedeutet beliebige Zeichenfolge</para></listitem>
<listitem><para>&lsqb; &rsqb; Zeichen liegt innerhalb eines definierten Bereichs
z.B.
&lsqb;a-zA-Z0-9&rsqb;</para></listitem>
<listitem><para>\  Zeichen ist alphanumerisch oder ein Punkt</para></listitem>
</itemizedlist>
<para>Die Eingabebox erinnert sich an bisherige Eingaben. Der
Knopf <literal remap="tt">Ausw&auml;hlen</literal> dient zur Festlegung des Verzeichnisses, in
welchem die Suche startet. Ob Unterverzeichnisse in die Suche einbezogen
werden, legt das entsprechende Kontrollfeld fest.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&Auml;nderungsdatum</term>
<listitem>
<para>Dieser Dialog erlaubt die Eingrenzung der zu
suchenden Dateien nach Erstellungs- bzw. &Auml;nderungsdatum (auch
Zeitr&auml;ume).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Erweitert</term>
<listitem>
<para>Dieser Dialog erlaubt die Suche nach bestimmten
Dateitypen z.B. PostScript-Dokumenten, JPEG- oder WAV-Dateien.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="ergebnisanzeige">
<title>Ergebnisanzeige</title>

<para>Hier werden die Suchergebnisse dargestellt. Nach Anklicken einer Datei
k&ouml;nnen die Funktionen <literal remap="tt">&Ouml;ffnen, Zum Archiv hinzuf&uuml;gen,
L&ouml;schen, Eigenschaften oder &Ouml;ffnen des entsprechenden
Verzeichnisses</literal> genutzt werden. Doppelklicken f&uuml;hrt die Datei aus.</para>
</sect1>
</chapter>

<chapter id="DieMenuumlEintraumlge">
<title>Die Men&uuml;-Eintr&auml;ge</title>

<sect1 id="datei">
<title>Datei</title>

<para>Folgende Funktionen stehen hier bereit:</para>

<para><variablelist>
<varlistentry>
<term>&Ouml;ffnen</term>
<listitem>
<para>Diese Option &ouml;ffnet &uuml;ber <emphasis remap="bf">kfm</emphasis> die
ausgew&auml;hlte Datei mit den Standardeinstellungen, d.h.
Programmdateien werden ausgef&uuml;hrt, Textdateien in den Texteditor
geladen etc. Diese Aktion kann auch durch Doppelklick auf die Datei
veranla&szlig;t werden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Zum Archiv hinzuf&uuml;gen</term>
<listitem>
<para>F&uuml;gt die ausgew&auml;hlte Datei
dem gew&auml;hlten Archiv hinzu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>L&ouml;schen</term>
<listitem>
<para>L&ouml;scht die ausgew&auml;hlte Datei.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Eigenschaften</term>
<listitem>
<para>Anzeige und M&ouml;glichkeit der &Auml;nderung von
Eigenschaften der Datei.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&Ouml;ffnen des entsprechenden Verzeichnisses</term>
<listitem>
<para>&Ouml;ffnet das
Verzeichnis, welches die ausgew&auml;hlte Datei enth&auml;lt, in einem
Dateimanager-<emphasis remap="bf">(KFM)</emphasis>-Fenster</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Suchergebnisse speichern</term>
<listitem>
<para>Speichert die Liste der gefundenen
Dateien.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Beenden</term>
<listitem>
<para>Beendet <emphasis remap="bf">KFind</emphasis></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="bearbeiten">
<title>Bearbeiten</title>

<para>Die Eintr&auml;ge in diesem Men&uuml; sind deaktiviert.</para>
</sect1>

<sect1 id="einstellungen">
<title>Einstellungen</title>

<para>Aus diesem Men&uuml; wird der Einstellungsdialog aufgerufen. Hier wird
festgelegt, in welche Datei und mit welchem Format die Suchergebnisse
gespeichert werden. Auf der zweiten Karteikarte erscheinen die
Archivprogramme und verf&uuml;gbaren Dateitypen.</para>

<para><variablelist>
<varlistentry>
<term>Speichern</term>
<listitem>
<para>Hier wird die Datei zur Speicherung der Suchergebnisse
festgelegt. Standard ist <literal remap="tt">.kfind-results.html</literal> im Pers&ouml;nlichen
Verzeichnis. Sofern ein andere Datei gew&auml;hlt wird, kann das Format
f&uuml;r die gespeicherten Ergebnisse festgelegt werden. Aktuell stehen
hierzu <literal remap="tt">HTML</literal> bzw. <literal remap="tt">Textdatei (.txt)</literal> zur Verf&uuml;gung.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Archivprogramme</term>
<listitem>
<para>Anzeige der Archivprogramme und der zugeordneten
Dateitypen. Ebenfalls werden die Befehlsfolgen zur Erstellung bzw.
Erg&auml;nzung eines Archivs dargestellt. Bisher sind die
Anzeigefunktionen implementiert (&auml;ndern evtl. zuk&uuml;nftig).</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="hilfe">
<title>Hilfe</title>

<para>Informationen &uuml;ber <emphasis remap="bf">KFind</emphasis> und Zugang zur Dokumentation.</para>
</sect1>
</chapter>

<chapter id="Epilog">
<title>Epilog</title>

<sect1 id="autoren">
<title>Autoren</title>

<para><variablelist>
<varlistentry>
<term>Miroslav Fl&iacute;dr</term>
<listitem>
<para>Autor
<ulink url="mailto:flidr@kky.zcu.cz">Email: flidr@kky.zcu.cz</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Martin Hartig</term>
<listitem>
<para><ulink url="hartig@mathematik.uni-kl.de">Email: hartig@mathematik.uni-kl.de</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mark Roberts</term>
<listitem>
<para><ulink url="mailto:mar2@scigen.co.uk">Email: mar2@scigen.co.uk</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Eric Bischoff</term>
<listitem>
<para>Redaktion
<ulink url="mailto:ebisch@cybercable.tm.fr">Email: ebisch@cybercable.tm.fr</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Werner M&uuml;ller</term>
<listitem>
<para>Deutsche &Uuml;bersetzung
<ulink url="mailto:werner.mueller@okay.net">Email: werner.mueller@okay.net</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Thomas Diehl</term>
<listitem>
<para>Redaktion der deutschen &Uuml;bersetzung
<ulink url="mailto:th.diehl@gmx.net">Email: th.diehl@gmx.net</ulink></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
