summaryrefslogtreecommitdiffstats
path: root/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-en_GB/docs/tdebase/kfind/index.docbook')
-rw-r--r--tde-i18n-en_GB/docs/tdebase/kfind/index.docbook473
1 files changed, 473 insertions, 0 deletions
diff --git a/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook b/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook
new file mode 100644
index 00000000000..85fe5d4a78c
--- /dev/null
+++ b/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook
@@ -0,0 +1,473 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+"dtd/kdex.dtd" [
+ <!ENTITY kappname "&kfind;">
+ <!ENTITY package "tdebase">
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % British-English "INCLUDE"
+>
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title
+>The &kfind; Handbook</title>
+
+<authorgroup>
+<author
+>&Dirk.Doerflinger; &Dirk.Doerflinger.mail;</author>
+
+<othercredit role="translator"
+><firstname
+>John</firstname
+><surname
+>Knight</surname
+><affiliation
+><address
+><email
+>anarchist_tomato@herzeleid.net</email
+></address
+></affiliation
+><contrib
+>Conversion to British English</contrib
+></othercredit
+>
+
+</authorgroup>
+
+<copyright>
+<year
+>2001</year>
+<holder
+>&Dirk.Doerflinger;</holder>
+</copyright>
+
+<legalnotice
+>&FDLNotice;</legalnotice>
+
+<date
+>2004-04-11</date>
+<releaseinfo
+>1.20.01</releaseinfo>
+
+<abstract>
+<para
+>&kfind; is &kde;'s file find utility. </para>
+</abstract>
+
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>tdeutils</keyword>
+<keyword
+>kfind</keyword>
+<keyword
+>find</keyword>
+<keyword
+>search</keyword>
+</keywordset>
+</bookinfo>
+
+<chapter id="introduction">
+<title
+>Introduction</title>
+
+<para
+>&kfind; is the &kde; file find utility. </para>
+
+<sect1 id="starting">
+<title
+>Launching &kfind;</title>
+
+<para
+>The Find Files tool is a useful method of searching for specific files on your computer, or for searching for files that match a pattern. An example of this could include searching for files of a particular type or with certain letters in the filename. You can load this utility by clicking on <guimenuitem
+>Find Files</guimenuitem
+>. This will launch &kfind;. </para>
+
+</sect1>
+</chapter>
+
+<chapter id="kfind">
+<title
+>Finding Files</title>
+
+<sect1 id="name-tab">
+<title
+>The Name/Location Tab</title>
+
+<para
+>When starting &kfind;, you will see a quite simple window. Type in the name of the file you are searching in the textbox labelled <guilabel
+>Named:</guilabel
+>. Choose a folder where you want to search by typing it in the field <guilabel
+>Look in:</guilabel
+> or by clicking <guibutton
+>Browse...</guibutton
+> and press <keycap
+>Enter</keycap
+> or click <guibutton
+>Find</guibutton
+>. If <guilabel
+>Include subfolders</guilabel
+> is checked all subfolders starting from your chosen folder will be searched too. The results will be displayed in the box below. </para>
+
+<para
+>You can use the following wildcards: </para>
+
+<variablelist>
+<varlistentry>
+<term
+>The Asterisk <quote
+><keycap
+>*</keycap
+></quote
+></term>
+<listitem>
+<para
+>The asterisk stands for any number of missing characters (even zero), that means &eg; searching for <userinput
+>marc*</userinput
+> may find the files <filename
+>marc</filename
+>, <filename
+>marc.png</filename
+> and <filename
+> marc_must_not_read_this.kwd</filename
+>. <userinput
+>mar*.kwd</userinput
+> may find <filename
+>marketplace.kwd</filename
+> and <filename
+>marc_must_not_read_this.kwd</filename
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>The Question Mark <quote
+><keycap
+>?</keycap
+></quote
+></term>
+<listitem>
+<para
+>In contrast to the asterisk, the question mark stands for exactly one character, so <userinput
+>mar?</userinput
+> will find <filename
+>marc</filename
+>, but <userinput
+>marc?</userinput
+> will not find anything, as our files are called <filename
+>marc</filename
+> and <filename
+>marc.png</filename
+>. You can put as many question marks in the term as you want, it will find exactly that number of characters. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<para
+>Of course you can combine those two wildcard symbols in a search term. </para>
+
+</sect1>
+
+<sect1 id="kfind-date-range">
+<title
+>The Contents Tab</title>
+
+<variablelist>
+<varlistentry>
+<term
+><guilabel
+>File type</guilabel
+></term>
+<listitem>
+<para
+>Here you can specify the type of file you are searching for. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guilabel
+>Containing text</guilabel
+></term>
+<listitem>
+<para
+>Type in the word or phrase the files you are searching for must contain. Note: If you do this in a large folder or checked <guilabel
+>Include subfolders</guilabel
+> in the <guilabel
+>Name/Location</guilabel
+> tab, this may take a long time. </para>
+
+<note>
+<para
+>This option will <emphasis
+>not</emphasis
+> work for all files listed under <guilabel
+>File type</guilabel
+>. Only the following file types are supported: <itemizedlist>
+<listitem
+><para
+>Text files, &eg; source code and <filename
+>README</filename
+> files</para
+></listitem>
+<listitem
+><para
+>KWord &gt;= 1.2</para
+></listitem>
+<listitem
+><para
+>KPresenter &gt;= 1.2</para
+></listitem>
+<listitem
+><para
+>KSpread &gt;= 1.2</para
+></listitem>
+<listitem
+><para
+>OpenOffice.org Writer</para
+></listitem>
+<listitem
+><para
+>OpenOffice.org Impress</para
+></listitem>
+<listitem
+><para
+>OpenOffice.org Calc</para
+></listitem>
+</itemizedlist>
+
+</para>
+</note>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guilabel
+>Case sensitive</guilabel
+></term>
+<listitem>
+<para
+>If you enable this option, &kfind; will only find files with the exact case matching, &eg; <userinput
+>MARC</userinput
+> will only match <quote
+>MARC</quote
+>, not <quote
+>Marc</quote
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guilabel
+>Regular expression</guilabel
+></term>
+<listitem
+><para
+>If you have installed the &kregexpeditor; tool from the tdeutils package, you will have this additional option. Enabling it will allow you to search for a <firstterm
+>regexp</firstterm
+> or regular expression. A regexp is a way to specify conditions for your search, and they can be very complex, and equally they can be very powerful. If you are unfamiliar with regular expressions, you can choose <guilabel
+>Edit Regular Expression</guilabel
+> to open &kregexpeditor;. This tool allows you to construct your set of conditions graphically, and then generates the expression for you.</para>
+
+<para
+>&kregexpeditor; is a very useful tool, and can be used from within many &kde; applications other than &kfind;. You can find more information from within its own help file.</para>
+</listitem>
+</varlistentry>
+
+<!-- TODO: "Search metainfo sections" -->
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="kfind-advanced">
+<title
+>The Properties Tab</title>
+
+<para
+>Here you can refine your search. These are the special refinements you can choose: </para>
+
+<variablelist>
+
+<varlistentry>
+<term
+><guilabel
+>Find all files created or modified</guilabel
+></term>
+<listitem>
+<para
+>Here you can either enter two dates, between which the files were created or modified, or specify a time period. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guilabel
+>File size is</guilabel
+></term>
+<listitem>
+<para
+>Here you can specify if the file has to be at least or as most as big as the size you entered in the following box. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guilabel
+>Files owned by user, Files owned by group</guilabel
+></term>
+<listitem>
+<para
+>Here you can specify user and group names. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+</chapter>
+
+<chapter id="credits">
+
+<title
+>Credits and Licence</title>
+
+<para
+>&kfind; </para>
+
+<para
+>Program copyright: </para>
+
+<itemizedlist>
+<title
+>Developers</title>
+<listitem>
+<para
+>Martin Hartig</para>
+</listitem>
+
+<listitem>
+<para
+>Stephan Kulow <email
+>coolo@kde.org</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Mario Weilguni <email
+>mweilguni@sime.com</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Alex Zepeda <email
+>jazepeda@pacbell.net</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Miroslav FlĂ­dr <email
+>flidr@kky.zcu.cz</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Harri Porten <email
+>porten@kde.org</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Dima Rogozin <email
+>dima@mercury.co.il</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Carsten Pfeiffer <email
+>pfeiffer@kde.org</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Hans Petter Bieker <email
+>bieker@kde.org</email
+></para>
+</listitem>
+
+<listitem>
+<para
+>Waldo Bastian <email
+>bastian@kde.org</email
+></para>
+</listitem>
+
+</itemizedlist>
+
+<para
+>Documentation copyright 2001 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para
+>
+
+<para
+>Conversion to British English: John Knight <email
+>anarchist_tomato@herzeleid.net</email
+></para
+>
+&underFDL; &underBSDLicense; </chapter>
+
+<appendix id="installation">
+<title
+>Installation</title>
+
+<sect1 id="getting-kfind">
+<title
+>How to obtain &kfind;</title>
+&install.intro.documentation; </sect1>
+
+<sect1 id="requirements">
+<title
+>Requirements</title>
+
+<para
+>In order to successfully use &kfind;, you need &kde; 3.x. </para>
+
+</sect1>
+
+<sect1 id="compilation">
+<title
+>Compilation and Installation</title>
+&install.compile.documentation; </sect1>
+
+</appendix>
+
+&documentation.index;
+
+</book>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+
+// vim:ts=0:sw=2:tw=78:noet
+-->