From 1d3e19e0a4fabc9c12ff0662b0447fa1e4b67e58 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Sat, 27 Aug 2022 14:52:00 +0200 Subject: Move the documentation from tdeio-locate to tdeioslave/locate. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- doc/en/tdeioslave/locate/index.docbook | 185 ++++++++++++++++++++++++++++++++ doc/en/tdeioslave/locate/screenshot.png | Bin 0 -> 22602 bytes 2 files changed, 185 insertions(+) create mode 100644 doc/en/tdeioslave/locate/index.docbook create mode 100644 doc/en/tdeioslave/locate/screenshot.png (limited to 'doc/en/tdeioslave') diff --git a/doc/en/tdeioslave/locate/index.docbook b/doc/en/tdeioslave/locate/index.docbook new file mode 100644 index 0000000..723a557 --- /dev/null +++ b/doc/en/tdeioslave/locate/index.docbook @@ -0,0 +1,185 @@ + + + + + &app;"> + &app;"> + + + + + + + + + +]> + + + + + + +&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; + + + +&tdeio-locate; is a KDE I/O Slave for the locate command. + + + + +KDE +tdeio-locate +tdeio_locate +kiolocate +locate +slocate +tdeio-slave +tdeio_slave +tdeioslave +search + + + + + + + +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; + + diff --git a/doc/en/tdeioslave/locate/screenshot.png b/doc/en/tdeioslave/locate/screenshot.png new file mode 100644 index 0000000..330565c Binary files /dev/null and b/doc/en/tdeioslave/locate/screenshot.png differ -- cgit v1.2.1