------------------------------------
README.txt
------------------------------------

Version history:

Version 1.00.02
---------------

- loc /? and loc -h show the available locate options in the resultswindow
- loc /u and loc /U update the locate databases (info is provided in the statusbar when starting and when finished)
- Show all results mode added. It can be enabled/disabled in the Advanced Configuration. It's turned on by default

---------------

Requirements:

You need to have Locate32 installed! (see http://www.uku.fi/~jmhuttun/english/softwares.shtml)


This is a simple plugin for using Locate32 with FARRv2.
It is a very early version an is likely to contain some bugs.

The plugin is written in Delphi and the sourcecode is provided as framework for
making FARRv2 plugins with Delphi. I've tried to make the usage of the framework
as easy as possible.

NOTE: I am not a "real" Delphi developer (I program in java and other languages 90% of the time and haven't
touched Delphi for years, just started again a few weeks ago) so there might be some better ways to do things.
If anyone can point out any problems or give some tips it will be very much appreciated (see contact details below).

Usage:

loc <locate options> <file to search for>

For locate options execute "<locate32 installdir>\locate /?".

In the Advanced Configuration you can set the location where Locate32 is installed and the maximum
found files locate returns. NOTE: You can override the maximum found files if you use the -ln:<number> option!

This plugin was made mostly because I needed a "real" example to try out the Delphi
framework for FARR and some people asked about locate32 integration. Just make suggestions
on the donationcoder forum or mail me if I don't seem to respond there :)

Examples:

// Search for notepad in c:\windows, don't search subdirectories, extension has to be exe
loc -t exe -Rn -p c:\windows notepad

// Search for java with minimum creationdate 21 sept 2007 and extension pdf
loc -t pdf -lDc070921 java

// Search for v[a-z]deo, find only directories, treat as regular expression (-r), use path d:\  (-p d:\), don't look in subdirectories (-Rn)
// in my case this found d:\Video
loc -ld -r -p d:\ -Rn v[a-z]deo

Known Issues:

- If FARR is set to "force window on top" then the dialogs appear behind it

Contact:

name: Okke Tijhuis
email: okke@dcmembers.com

Thanks to:

- Andrey V. Sorokin for writing the excellent TRegExpr library for Delpi
Partial Copyright (c) 1999-2004 by Andrey V. Sorokin, anso@mail.ru, http://RegExpStudio.com
(http://www.regexpstudio.com/TRegExpr/TRegExpr.html)
- John W. Long for writing to following article http://www.delphi3000.com/articles/article_2112.asp about
reading commandline output into Delphi
