!AMFSearch  1.00 (23-Jun-92)
============================
Text Searcher
=============
AMFSearch is a program that is designed to search for a given word or phrase
within a series of text files.These text files are loaded in to memory when
AMFSearch is originally loaded,so that there is no need for continuous disc
accessing whilst using AMFSearch.This makes AMFSearch particularly useful
when it searches commonly used reference texts,etc,as it can sit on the icon
bar without any windows needing to be opened until it is needed.

Starting
========
Initially,when you load AMFSearch from an original version,a window called
"Edit Files" will open.This is where you define the files that will be
searched by AMFSearch.AMFSearch can search a maximum of sixteen files,and
these are represented in this window by small text file icons.To the left of
each text file icon,you can enter a filename or you can drag a text file
from disc onto the filename icon.To the right of each icon is a real name
icon,this is where the real name of a text file is put.For example,the real
name "Letter to Solemnis" is far more legible than "adfs::Letters.$.L1>>S".
The real name will be used throughout AMFSearch in preference to the
filename.It should be realised that the filename can be relative,and can
contain reference to AMFSearch.For example,a file that is always to be
found within AMFSearch is "<AMFSearch$Dir>.!Run",and whereever AMFSearch is
copied to,that filename will still be valid,whereas "adfs::D.!AMFSearch.!Run"
is not.

Once you have added all the files you wish to have searched (if you can make
sense of the above instructions),click on Save.This will save the
information on these files,and will then attempt to reload AMFSearch,before
closing down the original version.For this reason,it will sometimes cause an
"Application needs 80k to start up" error,but you can reload AMFSearch
manually from disc should this happen.Remember that AMFSearch uses the
memory equivalent of the size that the files are,as well as 80k for the
program code.

Searching
=========
Once you have defined some files to search,every time you reload AMFSearch,
a different window will appear,namely the Files window.You can always click
on Edit in this window to define some more files,or to delete some
predefined ones.All the defined files will be shown in this window,with
their actual file name,their real name and their size.The small text file
icon to the left of each file can be clicked on - if it is shaded then that
file will not be searched.Click on Find to start a search,or click on a
text file filename to examine that file.

Another window,namely Find will appear.Enter your search string and press
return,or click on OK.Should the C icon be selected,the search made is case
sensitive,otherwise it is not.A window will appear,namely Found,containing
all the references to your search string within the searched files.A typical
entry is as follows:

=============================================================================
File:AMFSearch Instructions          (!Help)      L:7/51        F:4/18      
=============================================================================
AMFSearch is originally loaded,so that there is no need for continuous disc
accessing whilst using AMFSearch.This makes AMFSearch particularly useful
when it searches commonly used reference texts,etc,as it can sit on the icon
=============================================================================

"File:AMFSearch Instructions" is the real name of the file this search
string was found in,whereas (!Help) is the actual file name of the file.
L:7/51 shows that this find was found on the seventh line of the file,out of
a possible fifty one lines,and F:4/18 shows that it is the fourth find out
of eighteen.Clicking on this entry will open the original file from whence
it came,so that the context may be seen.

The search routine within AMFSearch is remarkably quick,mainly due to the
speed of the ARM chip.As an example of this,to find all 5000+ references to
the letter "A" (either case) within a 150k text document took just over ten
seconds.

Virus Checking
==============
AMFSearch employs an anti-virus checking routine,to keep itself from danger.
As a result,any files that are placed within AMFSearch,using the relative
filenames described above,or otherwise,will be rejected by AMFSearch.Thus,
should you wish to store files within AMFSearch,to distinguish them from
viri,create a directory called Data within AMFSearch,and place your files
within that directory.AMFSearch will realise that the directory is harmless,
and will load without complaint.

Versions
========
1.00 Original version.

Source
======
This version of AMFSearch was originally supplied as part of a software
package,namely the AMF the Doomwatcher Collection Part II.It should not be
distributed separately from this package,although it may be separated for
the personal use of the owner,so long as it is not passed on to others in
this form.

Copyright
=========
This version of AMFSearch is not Public Domain.It may be distributed as
Public Domain only by those who are licensed so to do,with the terms of this
license and the official distributor for this version to be found as part of
the general information supplied with this software collection.No part of
this software may be used in any other program,whether commercial or public
domain,without my prior written consent,though any files created by this
software are not bound by this condition.This software may not be
distributed for a profit,save that required to cover packaging and media
costs,nor may it be distributed by an unlicensed person or company.Copyright
() is retained by the author,who may be contacted at the address beneath.No
liability can be accepted by the author for any loss or damage arising from
use or misuse of this software.

Addresses
=========
Should you wish to contact the author of this software,make any constructive
comments or suggestions,report any errors or bugs,or make any donations (all
cheques being made payable to A.M.Flintham),write to the address beneath:

AMF the Doomwatcher,
  The Monastery of Doomwatcher Monks,
    50 Burlington Way,
      Mickleover,
        Derby.
          DE3 5BD
