summaryrefslogtreecommitdiffstats
path: root/doc/en/index.docbook
blob: 3b5fda36a3e98b91f90acf888686ef78691c57a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
    <!ENTITY app "tdeio-locate">
    <!ENTITY app_date "2005-09-15"> <!-- (YYYY-MM-DD) -->
    <!ENTITY app_version"> <!-- (V.MM.LL) -->
    <!ENTITY tdeio-locate "<application>&app;</application>">
    <!ENTITY kappname "<application>&app; &app_version;</application>"><!-- Do *not* replace kappname-->

    <!ENTITY my_email "tobivollebregt@gmail.com">

    <!ENTITY package "kde-module"><!-- tdebase, tdeadmin, etc -->
    <!ENTITY % addindex "IGNORE">
    <!ENTITY % English "INCLUDE"><!-- change language only here -->


    <!-- Do not define any other entities; instead, use the entities
         from kde-genent.entities and $LANG/user.entities. -->
]>


<book lang="&language;">


<bookinfo>
<title>&kappname; Handbook</title>

<authorgroup>
<author>
<firstname>Tobi</firstname>
<othername></othername>
<surname>Vollebregt</surname>
<affiliation>
<address><email>&my_email;</email></address>
</affiliation>
</author>
<author>
<firstname>Armin</firstname>
<othername></othername>
<surname>Straub</surname>
<affiliation>
<address><email>linux@arminstraub.de</email></address>
</affiliation>
</author>
<author>
<firstname>Michael</firstname>
<othername></othername>
<surname>Schuerig</surname>
<affiliation>
<address><email>michael@schuerig.de</email></address>
</affiliation>
</author>
</authorgroup>

<copyright>
<year>2005</year>
<holder>Tobi Vollebregt</holder>
</copyright>
<copyright>
<year>2005</year>
<holder>Armin Straub</holder>
</copyright>
<copyright>
<year>2002</year>
<holder>Michael Schuerig</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>&app_date;</date>
<releaseinfo>&app_version;</releaseinfo>

<abstract>
<para>
&tdeio-locate; is a KDE I/O Slave for the locate command.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>tdeio-locate</keyword>
<keyword>tdeio_locate</keyword>
<keyword>kiolocate</keyword>
<keyword>locate</keyword>
<keyword>slocate</keyword>
<keyword>tdeio-slave</keyword>
<keyword>tdeio_slave</keyword>
<keyword>tdeioslave</keyword>
<keyword>search</keyword>
</keywordset>

</bookinfo>



<chapter id="introduction">
<title>Introduction</title>

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->

<para>
&tdeio-locate; is a KDE I/O Slave for the locate command.
</para>
<para>
    This means that you can use &tdeio-locate; by simply typing in konquerors address box. You can e.g. type <command>locate:index.html</command> to find all files that contain "index.html" in their name.
</para>
<para>
There's even more: You can use &tdeio-locate; in all TDE applications that accept URLs.
</para>
<para>
To find out more about &tdeio-locate; and to look for new versions, you should take a look at <ulink url="http://arminstraub.de">arminstraub.de</ulink>.
</para>
</chapter>


<chapter id="using-tdeio-locate">
<title>How to use this?</title>

<para>
    You can use &tdeio-locate; mostly as you use locate. Instead of typing <command>locate pattern</command> at a command prompt, you start the search with &tdeio-locate; directly in konqueror. You just enter <command>locate:pattern</command> as the address.
</para>
<para>
    By default, a search <command>locate:pattern</command> is case insensitive if the pattern is lowercase. If the pattern is mixed- or uppercase the search is case sensitive. This default behaviour can be overridden.
</para>
<para>
	<emphasis>Hint:</emphasis> Type <command>locater:config</command> in the konqueror address bar to show the configuration dialog. Likewise, <command>locater:help</command> shows this help document.
</para>

<sect1 id="tdeio-locate-patterns">
<title>How to write patterns</title>

<para>
<itemizedlist>
	<listitem><para>Regular wildcard characters may be used in the patterns passed to &tdeio-locate;: A star (*) matches any string with nonzero length, a question mark (?) matches a single character, and a character list ([abc-z]) matches the characters in the list. A character list can be inverted by putting a caret after the first square bracket ([^abc-z]).</para></listitem>
    <listitem><para>Every plus (+) in a search is used just as a star (*) is. Instead of <command>locate:*.html</command> you may also type <command>locate:+.html</command>. This is because you can't use the star in konqueror. In other apps both ways are supported.</para></listitem>
    <listitem><para>Should you need to use a plus in your search you have to escape it with a backslash. Instead of <command>locate:g++</command> you have to use <command>locate:g\+\+</command>.</para></listitem>
    <listitem><para>Furthermore you can't use a slash as the last character of your query. O.k. you can, but KDE will ignore it. In such a case you can quote your pattern: Write <command>locate:"servicemenus/"</command> rather than <command>locate:servicemenus/</command>.</para></listitem>
    <listitem><para>A search as e.g. <command>locate:~/*.doc</command> works as you might expect. This means that <command>~/</command> and <command>~user/</command> are expanded correctly at the beginning of the pattern.</para></listitem>
	<listitem><para>You may add a filtering pattern after the first pattern, e.g. <command>locate:fish home</command> results in all files whose path contains fish AND home.</para></listitem>
	<listitem><para>A filtering pattern may be inverted by prefixing it with an exclamation mark. E.g. <command>locate:fish !home</command> results in all files whose path contains fish AND NOT home.</para></listitem>
	<listitem><para>Any number of filtering patterns may be used.</para></listitem>
	<listitem><para>With <command>locate:</command> wildcard matching is performed with all patterns. If you're a regular expression guru, you might want to use <command>rlocate:</command>, which enables regexp matching for all filtering patterns (that is: all patterns except the first one).</para></listitem>
</itemizedlist>
</para>

</sect1>

<sect1 id="tdeio-locate-screenshot">
<title>Take a look at &tdeio-locate;</title>

<para>
<screenshot>
    <screeninfo>Here's a screenshot of &tdeio-locate;</screeninfo>
    <mediaobject>
        <imageobject>
            <imagedata fileref="screenshot.png" format="PNG"/>
        </imageobject>
        <textobject>
            <phrase>Screenshot</phrase>
        </textobject>
    </mediaobject>
</screenshot>
</para>

</sect1>

</chapter>

<chapter id="license">

<title>License</title>

&underFDL;               <!-- FDL: do not remove -->
&underGPL;           <!-- GPL License -->

<para>
Also, I'd like to thank Google for their <ulink url="http://code.google.com/summerofcode.html">Summer Of Code Program</ulink> and Jonathan Riddell for being my mentor!
</para>

</chapter>

&documentation.index;
</book>