Download Searcher V1.35 05/30/93

-----------------------------------------------------------------
What it does 
-----------------------------------------------------------------
  I wrote this program to help me locate files in the various 
bulletin board file lists that I have. You can enter (or pick) 
files to scan and enter a string and the program will attempt 
to locate files with the string in the name or description. If 
you double click on a description line in the big window, the 
program attempts to extract the file name to the smaller file 
window in the upper right corner of the program window. When 
you are finished searching for file names, click the Clipboard 
button and the contents of the small window will be copied into 
the clipboard. If this is done while you are connected to a BBS 
via a WINDOWS comm program, you can generally select a command 
for batch download and then do an Edit Paste or press Shift 
Insert to paste the filenames so that they may be downloaded. 
The exact procedures for this will be determined by both the 
BBS that you call and the comm program that you are using.

  As the program searches, the name of the file that it is 
currently working on is displayed in the title bar and the 
progress through the file is displayed on the bargraph at the 
bottom of the program window.    
-----------------------------------------------------------------
Installation 
-----------------------------------------------------------------

  This program, as far as I know, requires WINDOWS 3.1. It also 
requires that you have the Arial and MS SansSerif fonts 
installed. If you did a normal WINDOWS installation, then these 
files are already installed. 

  To install this program, either run the included setup     
program under Windows or do the installation manually. Manual 
installation is performed by copying the SEARCHER.EXE File to a 
directory of your choice. You will also have to copy the 
VBRUN200.DLL,CMDIALOG.VBX and GAUGE.VBX files into the WINDOWS 
system directory. Then add the program to a program manager 
group of your choice.

This program is composed of the following files:

SEARCHER.EXE 	located (by default) in C:\SEARCHER.
SEARCHER.TXT    located (by default) in C:\SEARCHER.
ATP-SW.INI 	located in the WINDOWS directory.
VBRUN200.DLL	located in the WINDOWS/SYSTEM directory.
CMDIALOG.VBX	located in the WINDOWS/SYSTEM directory.
GAUGE.VBX	located in the WINDOWS/SYSTEM directory.
SEARCHER.GRP	located in the WINDOWS directory
File_ID.DIZ	This is a suggested BBS file description 
		when uploading this program to other BBS's
		Some BBS's will automatically extract this 
		description file.

The program will generate ATP-SW.INI in the WINDOWS directory 
when it is run for the first time. VBRUN200.DLL may already be 
installed on your system by other programs.


-----------------------------------------------------------------
How to contact me
-----------------------------------------------------------------

I will be uploading any new versions of this program to USER to 
USER in Dallas, TX. The phone numbers for this BBS are 
214-492-6565 or 214-492-5695. If you have any comments about 
this program then leave me a message there (Fidonet 1:124/6300) 
or write me a letter or leave me mail in the FidoNet Windows 
conference. I can also be contacted through Prodigy or 
Compuserve. See below for the addresses.


-----------------------------------------------------------------
Changes
-----------------------------------------------------------------

version 1.1

 1. note no file matches in the list
 2. improve memory check
 3. ding when search complete
 4. add note about limits to docs
 5. allow browse to have manual name entry
 6. don't print/save lines with no file name
 7. have search string be initial tab stop and be selected if possible
 8. supress display of initial form till sizing complete
 9. make help window wider
 10. If clipbox empty then don'd do anything, disable clipbox button ?
 11. if enter pressed goto start
 12. cascade multiple instances if possible

version 1.2

1. added user font selection for found list
2. added remember window size
3. added multiple pattern search
4. changed search routine to go back to print line with file name if multiline
   file description.
5. Added ability to display multiline file names in found list window.
6. Added search status to title bar.
7. Added total # matches to title bar.
8. Fixed not printing first match.
9. Added file save for found list window.
10. Changed title to Download Searcher

Version 1.3

1. Fixed startup problem with font name.

Version 1.31

1. Fixed problem when return pressed on pattern line.
2. Fixed problem when search path does not exist
3. Set initial path for file save to search path dir
   if search path exists, else set to c:\.

Version 1.32
Found and fixed problem with out of memory when there are a lot of matches.

Version 1.33

added paste to main window from clipboard
added paste to main window from file
added save main window to file
rearranged menus

Version 1.34

1. Changed update counter to long to prevent overflow on big data files.
2. Added match count to title bar.

Version 1.35
1. Fixed paste main window to clipboard to include first line in window.

-----------------------------------------------------------------
The following information is also in the help box in the 
program. 
-----------------------------------------------------------------
This program will scan selected filenames for search strings 
and place those lines into a window where the filenames can be 
extracted from them. It is primarily intended to be used to 
search BBS download file lists for a specific string and 
extract those filenames that it locates to the clipboard. This 
information can then be pasted to your comm program to download 
those files. There is a limit of roughly 1000 matches for any 
one file and there is an overall limit of 1000 matches for all 
files. This is due to the maximum size of a list box in Visual 
Basic.

This program will center itself on the screen when it loads. If 
multiple instances of this program are started, then each new 
instance of the program will be offset to the right and down 
from the center of the screen by a multiple of the number of 
running copies. If the EXE file name is changed from Searcher, 
then this feature may not work and and each new copy will 
possibly cover any previous copies, unless the previous copies 
have been moved. Also note that the search string and path of 
the last copy that gets executed is what is stored in the INI 
file.

--------------------------------------------------------------
Menu Commands
--------------------------------------------------------------

File | Save Main Window to File
Saves the contents of the found list window to a file. If the 
file exists then it is appended to.

File | Load Main Window from File
This command will load the main window from a file. This can be 
the file that was saved under Save Window to File.

File | Save Main Window to Clipboard
This command will copy all of the text in the main window
to the clipboard.

File | Load Main Window From Clipboard
This command will load the main window from the clipboard.

File | Exit Program
Exits the program

Config | Set Font
Set the Found List font and size.

Config | Set Delimiter
Sets the delimiter character for multiple pattern searches. The 
default delimiter is &.

Config | Set Yield
Sets the number of lines process before yielding to other 
system requests. Smaller numbers result in more frequent 
yielding and slower searches. 

Help | Help Text
Display help information

Help | About
Revision and copyright information

--------------------------------------------------------------
Non-Menu commands and field descriptions
--------------------------------------------------------------

Search Path
File specification to search

Search String
String to search all files for, if separated with delimiter 
character defined in Config | Delimiter, will perform multiple 
pattern searches.

Browse Button
Select file specification

Start/Stop Button
Start/Stop search process

AND/OR Button
Multiple pattern searches only. If AND mode then all patterns 
must be in file description. OR mode means that any of the 
patterns in search string will cause a match.

Exit Button
Leave program

MultiLine description check box
Will cause multiline file descriptions to be displayed in the 
Found List window.

Clipboard Button
copy filenames in small box to clipboard. This function is 
disabled until names are added to the small window. If and when 
all names are removed from the small window, this button will 
become disabled again.

Large file box
Lines from the files described by searchpath that contain the 
search string are displayed here. Double clicking a line will 
attempt to extract the file name to the small box in the upper 
right corner. The double click must be on a line with the file 
name when multiline descriptions are displayed. This box is 
referred to as Found List. 

Small file box
Extracted file names from Found List. Double clicking a name in 
the small box will remove the item from that box.

Should you find this program useful, I would appreciate a 
donation of $10.00. This would encourage me to continue to 
develop this program and others. Should you feel inclined to 
make a donation, send it to:

Tandy Penn
3306 Daisy Circle
Richardson, Tx. 75082

Prodigy FDFC37a
Compuserve 74720,1333

I also my be contacted by leaving a message in the FIDONET WINDOWS
conference.

LIMIT OF LIABILITY

Searcher is distributed as-is.  The author disclaims all 
warranties, expressed or implied.  The author will assume no 
liability for damages either from the direct use of this 
product or as a consequence of the use of this product.

Searcher may be used by any private individual or 
non-commercial organization for any purpose. You may distribute 
it to anyone, and you may place it on any archive or bulletin 
board system for wider access. You may not charge anyone for it 
other than a reasonable fee to cover your distribution costs.

This program is written with Visual Basic 2.0 from Microsoft 
Visual Basic and WINDOWS are trademarks of Microsoft Corp.


