TOPIC:  FIND40

DATE :	10 OCT 83

FROM :	IRV HOFF


     FIND40 locates strings of characters in a file, then displays the
entire line(s) that string was found.  It can be used with wildcards to
look through numerous files automatically, searching for a particular
combination of characters.  It is especially useful with MAST.CAT or
MAST.LST catalog programs to see what disk(s) a program might be on.
It would show how many copies of that file were available, permitting
"housecleaning" of extra programs.  It is most convenient to use when
updating newer versions of files, to erase those no longer needed that
have similar names.  This program is adapted from one originally written
by Ward Christensen.  It has some advantages over using a normal editor
"search" since it displays each line, rather than merely stopping each
time the combination appears.  (Some editors would not conveniently al-
low hard copy printing of "search" results.)

     You will likely wish to keep the FIND40.LBR on an archive file,
then rename to FIND.COM on your catalog and utility disks to simplify
typing the name.  Examples:

 1)	B>FIND
 2)	B>FIND ?
 3)	B>FIND HELLO.ASM
 4)	B>FIND MAST.LST MODEM
 5)	B>FIND MAST.CAT _MODEM
 6)	B>FIND MAST.CAT MOD|BYE
 7)	B>FIND *.ASM HELLO
 8)	B>FIND HELLO.DOC MDM712[N]   or [N  or  [n]  or  [n
 9)	B>FIND MAST.LST MDM7 ^P      (control-P to operate printer)

 	1)  Displays a short instruction guide, "built in"
	2)  Same as 1)
	3)  Prompts for a string to find.  If string is in lower-case it
		will display lines only with the same lower-case chars.
		If string is upper-case, will show all lines having the
		string, whether upper-case or lower-case.
	4)  Typical use of the program.  Display all lines with the
		sequential characters MODEM or modem.
	5)  Using the "_" (underline) character fakes a tab key.  Just
		those lines with "TAB MODEM" or "TAB modem" are shown.
	6)  Using the "|" (vertical bar) character permits concurrent
		search/display of several strings of characters.  In
		this case, all line containing either MOD or BYE (or
		same strings in lower case) will be displayed.
	7)  Wildcards may be used.  In this case, the name of each file
		is printed as it is being searched.
	8)  If [N] is included, line numbers will be added.  This is
		similar to using PIP.COM and including the [N] option,
		except the line numbers shown here are those containing
		the requested string.  This could be quite useful under
		some circumstances where a file might contain line num-
		bers, allowing a direct cross-check.  Some assemblers
		add line numbers, and some LIST.COM programs do also.
	9)  Turns the printer on to make a quitck hard copy of results.