------------------------------------------------------------------------ ExternalSearch - v1.0.0.0 (July 17th, 2007) by Ehtyar Holmes Copyleft 2007 - No rights reserved. ------------------------------------------------------------------------ * This plug-in is designed to facilitate, in a very basic way, integration of external applications with the searching capabilities of FARR. It is designed with programmers in mind to allow for quick and painless integration. With it, you can instruct FARR to perform searches on your application's behalf with a string you specify, via the FARRT library (yes this name is a joke). * The plug-in comes as follows: - ExternalSearch containing the ExternalSearch FARR plug-in and its source. - FARRT containing the dll which can be used to interface with FARR in order to perform searches. - ExternalSearchTest containing a demonstration program showing how to use the FARRT dll to interface with FARR. NOTE: If you wish to make use of this demonstration program, you will need to copy the FARRT dll to the same directory. NOTE: The plug-in does not come with any project files of any kind, as I do not use an IDE. If you wish to build this plug-in yourself, you will need to create project files for use with your IDE, I cannot and will not help you with this. * The FARRT dll exports a single function, FarrSearch, which takes a single parameter, a search string: BOOL FarrSearch(LPSTR lpSearchString). The function will return TRUE (1) on a successful search, and FALSE (0) on an unsuccessful search (usually indicating FARR is not running. FarrSearch uses the cdecl ("C") calling convention (caller is responsible for popping arguments off the stack. * There are no options whatsoever for this plug-in as of version 1.0.0.0. If you don't wish to use it, you may remove it from your plug-in directory. * I (Ehtyar) am not responsible for providing any kind of support in regards to the use of the FARRT library. I am, however, responsible for the official maintenance of the ExternalSearch plug-in, and any bug reports can be filed in the plug-ins forum thread at http://www.donationcoder.com/. * EXTERNALSEARCH IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE. * Requirements | The FindAndRunRobot version 2.0 and above. * Restraints | ExternalSearch is not unicode compatible, nor is FARR itself. * Description | Allows basic integration of third-party applications with the FindAndRunRobot by Mouser at http://www.donationcoder.com/Software/Mouser/findrun/index.html. * The lack of copyright is intentional, as i have no qualms about you using/modifying the source code for the benefit of FindAndRun users or yourself. Please feel free to use the source code instead of the FARRT library, it was created only for ease of use. * Thanks: Mouse Man: For the awesomeness that is FARR, and his invaluable help in the creation of this plug-in hamradio: For his permission to bootleg his readme.