From 630b7196d93786595546565329160ff26332704b Mon Sep 17 00:00:00 2001 From: tpearson Date: Fri, 12 Feb 2010 18:09:55 +0000 Subject: Added KDE3 version of kio-locate git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kio-locate@1089224 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/en/index.docbook | 185 ++++++++++++++++++++++++++++++++++++++++++++++++++ doc/en/screenshot.png | Bin 0 -> 26739 bytes 2 files changed, 185 insertions(+) create mode 100644 doc/en/index.docbook create mode 100644 doc/en/screenshot.png (limited to 'doc') diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..bde0bc6 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,185 @@ + + + + + &app;"> + &app; &app_version;"> + + + + + + + + + +]> + + + + + + +&kappname; Handbook + + + +Tobi + +Vollebregt + +
&my_email;
+ + + +Armin + +Straub + +
linux@arminstraub.de
+ + + +Michael + +Schuerig + +
michael@schuerig.de
+ + + + + +2005 +Tobi Vollebregt + + +2005 +Armin Straub + + +2002 +Michael Schuerig + +&FDLNotice; + +&app_date; +&app_version; + + + +&kio-locate; is a KDE I/O Slave for the locate command. + + + + +KDE +kio-locate +kio_locate +kiolocate +locate +slocate +kio-slave +kio_slave +kioslave +search + + + + + + + +Introduction + + + + +&kio-locate; is a KDE I/O Slave for the locate command. + + + This means that you can use &kio-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 &kio-locate; in all KDE applications that accept URLs. + + +To find out more about &kio-locate; and to look for new versions, you should take a look at arminstraub.de. + + + + + +How to use this? + + + You can use &kio-locate; mostly as you use locate. Instead of typing locate pattern at a command prompt, you start the search with &kio-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 &kio-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 &kio-locate; + + + + Here's a screenshot of &kio-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; + + diff --git a/doc/en/screenshot.png b/doc/en/screenshot.png new file mode 100644 index 0000000..efd4129 Binary files /dev/null and b/doc/en/screenshot.png differ -- cgit v1.2.1