# &kappname; Handbook

## Introduction

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

This means that you can use &tdeio-locate; by simply typing in konquerors address box. You can e.g. type `locate:index.html` to find all files that contain "index.html" in their name.

There's even more: You can use &tdeio-locate; in all TDE applications that accept URLs.

To find out more about &tdeio-locate; and to look for new versions, you should take a look at arminstraub.de.

## How to use this?

You can use &tdeio-locate; mostly as you use locate. Instead of typing `locate pattern` at a command prompt, you start the search with &tdeio-locate; directly in konqueror. You just enter `locate:pattern` as the address.

By default, a search `locate:pattern` 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.

Hint: Type `locater:config` in the konqueror address bar to show the configuration dialog. Likewise, `locater:help` shows this help document.

### How to write patterns

- 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]).

- Every plus (+) in a search is used just as a star (*) is. Instead of `locate:*.html` you may also type `locate:+.html`. This is because you can't use the star in konqueror. In other apps both ways are supported.

- Should you need to use a plus in your search you have to escape it with a backslash. Instead of `locate:g++` you have to use `locate:g\+\+`.

- 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 `locate:"servicemenus/"` rather than `locate:servicemenus/`.

- A search as e.g. `locate:~/*.doc` works as you might expect. This means that `~/` and `~user/` are expanded correctly at the beginning of the pattern.

- You may add a filtering pattern after the first pattern, e.g. `locate:fish home` results in all files whose path contains fish AND home.

- A filtering pattern may be inverted by prefixing it with an exclamation mark. E.g. `locate:fish !home` results in all files whose path contains fish AND NOT home.

- Any number of filtering patterns may be used.

- With `locate:` wildcard matching is performed with all patterns. If you're a regular expression guru, you might want to use `rlocate:`, which enables regexp matching for all filtering patterns (that is: all patterns except the first one).

### Take a look at &tdeio-locate;

Here's a screenshot of &tdeio-locate; Screenshot

## License

&underFDL; &underGPL;

Also, I'd like to thank Google for their Summer Of Code Program and Jonathan Riddell for being my mentor!

&documentation.index;