You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
474 lines
8.8 KiB
474 lines
8.8 KiB
<?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 "kdebase">
|
|
<!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
|
|
>kdeutils</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 ⪚ 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, ⪚ source code and <filename
|
|
>README</filename
|
|
> files</para
|
|
></listitem>
|
|
<listitem
|
|
><para
|
|
>KWord >= 1.2</para
|
|
></listitem>
|
|
<listitem
|
|
><para
|
|
>KPresenter >= 1.2</para
|
|
></listitem>
|
|
<listitem
|
|
><para
|
|
>KSpread >= 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, ⪚ <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 kdeutils 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
|
|
-->
|