FIN - Find String in Files
		==========================

			Users' Guide
			============

 FIN  is  a  small program that will search a given set of files for a
 particular  string,  producing  a  report  of  all occurrences of the
 string.


 The command format is :-

		FIN Output-filespec=Input-filespec/SE:string

 The  string  specified  must  match  the  one  required  in  terms of
 upper/lower  case,  and  may not contain things like spaces or colons
 (which CSI will object to).

 FIN is only a very simple (and quick) method of file searching. A far
 more    comprehensive    method,    allowing    multiple  input  file
 specifications and multiple search strings, exists as the MUN program
 SEARCH.  SEARCH  is  however much slower than FIN, and should only be
 used when detail is required.

 FIN may produce the following error messages:-

 1.  FIN - I/O ERROR ON @ FILE

     You  specified  an indirect command file on the command line, but
     FIN encountered an error when reading the commandfile.

 2.  FIN - OPEN ERROR ON @ FILE

     You  specified  an indirect command file on the command line, but
     FIN cannot access the commandfile.

 3.  FIN - MAX @ FILE DEPTH EXCEEDED

     You  had more than one level of indirection in your command files
     - which is illegal.

 4.  FIN - SYNTAX ERROR FOR @ FILE

     You specified an @ on the commandline, but the following filename
     had a syntax error.

 5.  FIN - UNKNOWN COMMAND ERROR

     FIN encountered a command error that it could not diagnose further.

 6.  FIN - SYNTAX ERROR

     The commandline to FIN contained a syntax error.