diff options
Diffstat (limited to 'tde-i18n-en_GB/docs/tdebase/kfind')
| -rw-r--r-- | tde-i18n-en_GB/docs/tdebase/kfind/index.docbook | 363 |
1 files changed, 79 insertions, 284 deletions
diff --git a/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook b/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook index 85fe5d4a78c..91682d60755 100644 --- a/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook +++ b/tde-i18n-en_GB/docs/tdebase/kfind/index.docbook @@ -4,241 +4,113 @@ <!ENTITY kappname "&kfind;"> <!ENTITY package "tdebase"> <!ENTITY % addindex "IGNORE"> - <!ENTITY % British-English "INCLUDE" -> + <!ENTITY % British-English "INCLUDE"> ]> <book lang="&language;"> <bookinfo> -<title ->The &kfind; Handbook</title> +<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 -> +<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> +<year>2001</year> +<holder>&Dirk.Doerflinger;</holder> </copyright> -<legalnotice ->&FDLNotice;</legalnotice> +<legalnotice>&FDLNotice;</legalnotice> -<date ->2004-04-11</date> -<releaseinfo ->1.20.01</releaseinfo> +<date>2004-04-11</date> +<releaseinfo>1.20.01</releaseinfo> <abstract> -<para ->&kfind; is &kde;'s file find utility. </para> +<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> +<keyword>KDE</keyword> +<keyword>tdeutils</keyword> +<keyword>kfind</keyword> +<keyword>find</keyword> +<keyword>search</keyword> </keywordset> </bookinfo> <chapter id="introduction"> -<title ->Introduction</title> +<title>Introduction</title> -<para ->&kfind; is the &kde; file find utility. </para> +<para>&kfind; is the &kde; file find utility. </para> <sect1 id="starting"> -<title ->Launching &kfind;</title> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<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> +<title>The Contents Tab</title> <variablelist> <varlistentry> -<term -><guilabel ->File type</guilabel -></term> +<term><guilabel>File type</guilabel></term> <listitem> -<para ->Here you can specify the type of file you are searching for. </para> +<para>Here you can specify the type of file you are searching for. </para> </listitem> </varlistentry> <varlistentry> -<term -><guilabel ->Containing text</guilabel -></term> +<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> +<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> +<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> @@ -248,37 +120,17 @@ </varlistentry> <varlistentry> -<term -><guilabel ->Case sensitive</guilabel -></term> +<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> +<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 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> +<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> @@ -289,44 +141,30 @@ </sect1> <sect1 id="kfind-advanced"> -<title ->The Properties Tab</title> +<title>The Properties Tab</title> -<para ->Here you can refine your search. These are the special refinements you can choose: </para> +<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> +<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> +<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> +<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> +<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> +<term><guilabel>Files owned by user, Files owned by group</guilabel></term> <listitem> -<para ->Here you can specify user and group names. </para> +<para>Here you can specify user and group names. </para> </listitem> </varlistentry> @@ -338,120 +176,77 @@ <chapter id="credits"> -<title ->Credits and Licence</title> +<title>Credits and Licence</title> -<para ->&kfind; </para> +<para>&kfind; </para> -<para ->Program copyright: </para> +<para>Program copyright: </para> <itemizedlist> -<title ->Developers</title> +<title>Developers</title> <listitem> -<para ->Martin Hartig</para> +<para>Martin Hartig</para> </listitem> <listitem> -<para ->Stephan Kulow <email ->coolo@kde.org</email -></para> +<para>Stephan Kulow <email>coolo@kde.org</email></para> </listitem> <listitem> -<para ->Mario Weilguni <email ->mweilguni@sime.com</email -></para> +<para>Mario Weilguni <email>mweilguni@sime.com</email></para> </listitem> <listitem> -<para ->Alex Zepeda <email ->jazepeda@pacbell.net</email -></para> +<para>Alex Zepeda <email>jazepeda@pacbell.net</email></para> </listitem> <listitem> -<para ->Miroslav Flídr <email ->flidr@kky.zcu.cz</email -></para> +<para>Miroslav Flídr <email>flidr@kky.zcu.cz</email></para> </listitem> <listitem> -<para ->Harri Porten <email ->porten@kde.org</email -></para> +<para>Harri Porten <email>porten@kde.org</email></para> </listitem> <listitem> -<para ->Dima Rogozin <email ->dima@mercury.co.il</email -></para> +<para>Dima Rogozin <email>dima@mercury.co.il</email></para> </listitem> <listitem> -<para ->Carsten Pfeiffer <email ->pfeiffer@kde.org</email -></para> +<para>Carsten Pfeiffer <email>pfeiffer@kde.org</email></para> </listitem> <listitem> -<para ->Hans Petter Bieker <email ->bieker@kde.org</email -></para> +<para>Hans Petter Bieker <email>bieker@kde.org</email></para> </listitem> <listitem> -<para ->Waldo Bastian <email ->bastian@kde.org</email -></para> +<para>Waldo Bastian <email>bastian@kde.org</email></para> </listitem> </itemizedlist> -<para ->Documentation copyright 2001 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para -> +<para>Documentation copyright 2001 &Dirk.Doerflinger; &Dirk.Doerflinger.mail;</para> -<para ->Conversion to British English: John Knight <email ->anarchist_tomato@herzeleid.net</email -></para -> +<para>Conversion to British English: John Knight <email>anarchist_tomato@herzeleid.net</email></para> &underFDL; &underBSDLicense; </chapter> <appendix id="installation"> -<title ->Installation</title> +<title>Installation</title> <sect1 id="getting-kfind"> -<title ->How to obtain &kfind;</title> +<title>How to obtain &kfind;</title> &install.intro.documentation; </sect1> <sect1 id="requirements"> -<title ->Requirements</title> +<title>Requirements</title> -<para ->In order to successfully use &kfind;, you need &kde; 3.x. </para> +<para>In order to successfully use &kfind;, you need &kde; 3.x. </para> </sect1> <sect1 id="compilation"> -<title ->Compilation and Installation</title> +<title>Compilation and Installation</title> &install.compile.documentation; </sect1> </appendix> |