RETRIEVER
---------
Retriever is designed to look through selected folders to find
keywords in IBasic programs with the extension of .iba and other 
words other than Keywords can be searched for as well.

The two menu options are for setting up a list of regular Folders
that you may wish to search in and also to set up a list of IBasic 
Keywords that are not so regularly used. Both lists are saved to 
disk and load into the program when started.

MENU FILE
-KEYWORDS

On clicking the Keywords Menu option the Manage Keywords List
Window is opened. Keywords in the Keyword file are entered into
the Keywords List.

A new Keyword can be typed into the New Keyword Edit Box and
entered into the list by clicking the Enter key or clicking on
the Add New Keyword Button.

Delete a Keyword by selecting it in the Keywords List and then
clicking the Delete Selected Keywords Button.

On Exiting the Window the contents of the Keywords List
are saved to disk.

-SEARCH FOLDERS

On clicking the Search Folders Menu option the Search Folder
Creator Window is opened.

Type in the Folder you wish to search in by typing the full
path into the Search Folder Edit Box. Click the Add Folder
Button and the new Folder for Searching in is added to the 
list.

BROWSE - The Browse button uses the FILREQUEST function in
IBasic to open the Save File Dialog. Navigate to the Folder
you wish to start the search from, select a file in the folder
and click the Open Button. The Path is then put into the
Search Folder Edit Box with the selected file removed. 

If you find there are no files in the folder you wish to 
search from, then select a sub folder and select a file 
in it. 

When the Path is placed into the Search Folder Edit Box 
simply delete the last Folder from the Path leaving the
original Path you wanted. Click the Add Folder Button.

To Delete an existing Folder in the Search Folder List 
select the one to delete in the list and click the Delete
Folder Button.

On Exiting the Window the contents of the Search Folder 
List are saved to disk.

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

RUNNING THE PROGRAM

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

When the program starts the above explained Keywords and Folder
Lists are loaded into the main window.


MAIN FOLDER TO START SEARCH -

To set the Folder to start a search from you can either type
in the path or select an existing path from the drop down
list.

TEXT TO SEARCH FOR -

To set the text to search for you may type it into this Edit
Box or select an item in the Search Words List.

If you type in a Keyword the Keyword List selection is
updated as you type in the keyword.

By double clicking a Keyword in the Keyword List the
Begin Search for the Keyword is automatically started.

BEGIN SEARCH -

Once a Folder to Search from and Text to Search for are entered
you then click the Begin Search Button and the program will
search through the Folder and its sub folders for all files
ending with an extension of .iba and when finding them will
use the INSTR function in IBasic to locate the Text to Search
for in the file. If the Keywords are found the File Name is
added to the List of Files Found List Box.

If the Begin Search  Button is clicked with NO Keyword to 
search for then ALL files in the Folders are found and
displayed in the List of Files Found list box.

CLICK ON A FILE IN THE LIST OF FILES FOUND LIST BOX

By clicking a file in the List of Files Found its path is
displayed at the bottom of the window in the grey panel. 
Also a Show Button is displayed.

If the file to be viewed in the List of Files Found List
Box is double clicked then the IBasic Editor is
automatically opened with that file.

SHOW BUTTON -

When a file in the List of Files Found List Box is selected
it can be viewed by clicking the Show Button. The IBasic
editor is opened and the file is opened in the Editor. Retriever
is minimised to the desktop.

TIP -

The Keyword searched for in the Retriever program has been 
copied to the Clipboard when the Show Button was clicked.

When moving into IBasic - click Edit Menu and Find Sub Menu.
Right Click in the Find Dialog Search String Edit Box and 
Paste the Keywords from the clipboard. This allows you to find
where Retriever found the Searched for Text in Retriever.

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

Re-activate Retriever by restoring it from the Desktop.

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