home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / SRCHR136.ZIP / SEARCHER.TXT < prev    next >
Encoding:
Text File  |  1993-08-17  |  11.0 KB  |  294 lines
  1. Download Searcher V1.36 8/17/93
  2.  
  3. ----------------------------------------------------------------- 
  4. What it does 
  5. -----------------------------------------------------------------   
  6. I wrote this program to help me locate files in the various bulletin 
  7. board file lists that I have. You can enter (or pick) files to scan 
  8. and enter a string and the program will attempt to locate files with 
  9. the string in the name or description. If you double click on a 
  10. description line in the big window, the program attempts to extract 
  11. the file name to the smaller file window in the upper right corner 
  12. of the program window. When you are finished searching for file 
  13. names, click the Clipboard button and the contents of the small 
  14. window will be copied into the clipboard. If this is done while you 
  15. are connected to a BBS via a WINDOWS comm program, you can generally 
  16. select a command for batch download and then do an Edit Paste or 
  17. press Shift Insert to paste the filenames so that they may be 
  18. downloaded. The exact procedures for this will be determined by both 
  19. the BBS that you call and the comm program that you are using.
  20.  
  21.   As the program searches, the name of the file that it is currently 
  22. working on is displayed in the title bar and the progress through 
  23. the file is displayed on the bargraph at the bottom of the program 
  24. window.    
  25. ----------------------------------------------------------------- 
  26. Installation 
  27. -----------------------------------------------------------------
  28.  
  29.   This program, as far as I know, requires WINDOWS 3.1. It also 
  30. requires that you have the Arial and MS SansSerif fonts installed. 
  31. If you did a normal WINDOWS installation, then these files are 
  32. already installed. 
  33.  
  34.   To install this program, either run the included setup     program 
  35. under Windows or do the installation manually. Manual installation 
  36. is performed by copying the SEARCHER.EXE File to a directory of your 
  37. choice. You will also have to copy the VBRUN200.DLL,CMDIALOG.VBX and 
  38. GAUGE.VBX files into the WINDOWS system directory. Then add the 
  39. program to a program manager group of your choice.
  40.  
  41. This program is composed of the following files:
  42.  
  43. SEARCHER.EXE     located (by default) in C:\SEARCHER.
  44. SEARCHER.TXT    located (by default) in C:\SEARCHER.
  45. ATP-SW.INI     located in the WINDOWS directory.
  46. VBRUN200.DLL    located in the WINDOWS/SYSTEM directory.
  47. CMDIALOG.VBX    located in the WINDOWS/SYSTEM directory.
  48. GAUGE.VBX    located in the WINDOWS/SYSTEM directory.
  49. SEARCHER.GRP    located in the WINDOWS directory
  50. FILE_ID.DIZ    This is a suggested BBS file description 
  51.         when uploading this program to other BBS's
  52.         Some BBS's will automatically extract this 
  53.         description file.
  54.  
  55. The program will generate ATP-SW.INI in the WINDOWS directory 
  56. when it is run for the first time. VBRUN200.DLL may already be 
  57. installed on your system by other programs.
  58.  
  59.  
  60. -----------------------------------------------------------------
  61. How to contact me
  62. -----------------------------------------------------------------
  63.  
  64. I will be uploading any new versions of this program to USER to USER 
  65. in Dallas, TX. The phone numbers for this BBS are  214-393-9317     or 
  66. 214-393-9318. If you have any comments about this program then leave 
  67. me a message there (Fidonet 1:124/6300) or write me a letter or 
  68. leave me mail in the FidoNet Windows conference. I can also be 
  69. contacted through Compuserve. See below for the addresses. I will no 
  70. longer be answering mail through Prodigy. I will also be uploading the 
  71. latest versions of this program onto Compuserve, in the WinShare 
  72. conference library 3, (Comm Apps/Utils). 
  73.  
  74. -----------------------------------------------------------------
  75. Changes
  76. -----------------------------------------------------------------
  77.  
  78. version 1.1
  79.  
  80.  1. note no file matches in the list
  81.  2. improve memory check
  82.  3. ding when search complete
  83.  4. add note about limits to docs
  84.  5. allow browse to have manual name entry
  85.  6. don't print/save lines with no file name
  86.  7. have search string be initial tab stop and be selected if possible
  87.  8. suppress display of initial form till sizing complete
  88.  9. make help window wider
  89.  10. If clipbox empty then don't do anything, disable clipbox button?
  90.  11. if enter pressed goto start
  91.  12. cascade multiple instances if possible
  92.  
  93. version 1.2
  94.  
  95. 1. added user font selection for found list
  96. 2. added remember window size
  97. 3. added multiple pattern search
  98. 4. changed search routine to go back to print line with file name if multiline
  99.    file description.
  100. 5. Added ability to display multiline file names in found list window.
  101. 6. Added search status to title bar.
  102. 7. Added total # matches to title bar.
  103. 8. Fixed not printing first match.
  104. 9. Added file save for found list window.
  105. 10. Changed title to Download Searcher
  106.  
  107. Version 1.3
  108.  
  109. 1. Fixed startup problem with font name.
  110.  
  111. Version 1.31
  112.  
  113. 1. Fixed problem when return pressed on pattern line.
  114. 2. Fixed problem when search path does not exist
  115. 3. Set initial path for file save to search path dir
  116.    if search path exists, else set to c:\.
  117.  
  118. Version 1.32
  119. Found and fixed problem with out of memory when there are a lot of matches.
  120.  
  121. Version 1.33
  122.  
  123. added paste to main window from clipboard
  124. added paste to main window from file
  125. added save main window to file
  126. rearranged menus
  127.  
  128. Version 1.34
  129.  
  130. 1. Changed update counter to long to prevent overflow on big data files.
  131. 2. Added match count to title bar.
  132.  
  133. Version 1.35
  134. 1. Fixed paste main window to clipboard to include first line in window.
  135.  
  136. Version 1.36
  137. 1. Fixed centering bug where first instance was offset from screen center
  138. 2. Added better end of file detection
  139. 3. Fixed a problem matching last description in a file.
  140. 4. Add config option for setting control fonts.
  141. 5. Change the Config | Set Delimiter so that it cannot be set to an empty 
  142.    string
  143. 6. Made a change to the browse box so that if *.* is selected then no 
  144. filename will also have to be selected.
  145.  
  146. -----------------------------------------------------------------
  147. The following information is also in the help box in the 
  148. program. 
  149. -----------------------------------------------------------------
  150. This program will scan selected filenames for search strings 
  151. and place those lines into a window where the filenames can be 
  152. extracted from them. It is primarily intended to be used to 
  153. search BBS download file lists for a specific string and 
  154. extract those filenames that it locates to the clipboard. This 
  155. information can then be pasted to your comm program to download 
  156. those files. There is a limit of roughly 1000 matches for any 
  157. one file and there is an overall limit of 1000 matches for all 
  158. files. This is due to the maximum size of a list box in Visual 
  159. Basic.
  160.  
  161. This program will center itself on the screen when it loads. If 
  162. multiple instances of this program are started, then each new 
  163. instance of the program will be offset to the right and down 
  164. from the center of the screen by a multiple of the number of 
  165. running copies. If the EXE file name is changed from Searcher, 
  166. then this feature may not work and and each new copy will 
  167. possibly cover any previous copies, unless the previous copies 
  168. have been moved. Also note that the search string and path of 
  169. the last copy that gets executed is what is stored in the INI 
  170. file.
  171.  
  172. --------------------------------------------------------------
  173. Menu Commands
  174. --------------------------------------------------------------
  175.  
  176. File | Save Main Window to File
  177. Saves the contents of the found list window to a file. If the 
  178. file exists then it is appended to.
  179.  
  180. File | Load Main Window from File
  181. This command will load the main window from a file. This can be 
  182. the file that was saved under Save Window to File.
  183.  
  184. File | Save Main Window to Clipboard
  185. This command will copy all of the text in the main window
  186. to the clipboard.
  187.  
  188. File | Load Main Window From Clipboard
  189. This command will load the main window from the clipboard.
  190.  
  191. File | Exit Program
  192. Exits the program
  193.  
  194. Config | Set Window Font
  195. Set the font for the Found List and clipboard windows.
  196.  
  197. Config | Set Control Font
  198. Set the font for the control buttons.
  199.  
  200. Config | Set Delimiter
  201. Sets the delimiter character for multiple pattern searches. The 
  202. default delimiter is &.
  203.  
  204. Config | Set Yield
  205. Sets the number of lines processed before yielding to other 
  206. system requests. Smaller numbers result in more frequent 
  207. yielding and slower searches. 
  208.  
  209. Help | Help Text
  210. Display help information
  211.  
  212. Help | About
  213. Revision and copyright information
  214.  
  215. --------------------------------------------------------------
  216. Non-Menu commands and field descriptions
  217. --------------------------------------------------------------
  218.  
  219. Search Path
  220. File specification to search
  221.  
  222. Search String
  223. String to search all files for, if separated with delimiter 
  224. character defined in Config | Delimiter, will perform multiple 
  225. pattern searches.
  226.  
  227. Browse Button
  228. Select file specification
  229.  
  230. Start/Stop Button
  231. Start/Stop search process
  232.  
  233. AND/OR Button
  234. Multiple pattern searches only. If AND mode then all patterns 
  235. must be in file description. OR mode means that any of the 
  236. patterns in search string will cause a match.
  237.  
  238. Exit Button
  239. Leave program
  240.  
  241. MultiLine description check box
  242. Will cause multiline file descriptions to be displayed in the 
  243. Found List window.
  244.  
  245. Clipboard Button
  246. copy filenames in small box to clipboard. This function is 
  247. disabled until names are added to the small window. If and when 
  248. all names are removed from the small window, this button will 
  249. become disabled again.
  250.  
  251. Large file box
  252. Lines from the files described by searchpath that contain the 
  253. search string are displayed here. Double clicking a line will 
  254. attempt to extract the file name to the small box in the upper 
  255. right corner. The double click must be on a line with the file 
  256. name when multiline descriptions are displayed. This box is 
  257. referred to as Found List. 
  258.  
  259. Small file box
  260. Extracted file names from Found List. Double clicking a name in 
  261. the small box will remove the item from that box.
  262.  
  263. Should you find this program useful, I would appreciate a 
  264. donation of $10.00. This would encourage me to continue to 
  265. develop this program and others. Should you feel inclined to 
  266. make a donation, send it to:
  267.  
  268. Tandy Penn
  269. 3306 Daisy Circle
  270. Richardson, Tx. 75082
  271.  
  272. Compuserve 74720,1333
  273.  
  274. I also my be contacted by leaving a message in the FIDONET WINDOWS
  275. conference.
  276.  
  277. LIMIT OF LIABILITY
  278.  
  279. Searcher is distributed as-is.  The author disclaims all 
  280. warranties, expressed or implied.  The author will assume no 
  281. liability for damages either from the direct use of this 
  282. product or as a consequence of the use of this product.
  283.  
  284. Searcher may be used by any private individual or 
  285. non-commercial organization for any purpose. You may distribute 
  286. it to anyone, and you may place it on any archive or bulletin 
  287. board system for wider access. You may not charge anyone for it 
  288. other than a reasonable fee to cover your distribution costs.
  289.  
  290. This program is written with Visual Basic 2.0 from Microsoft 
  291. Visual Basic and WINDOWS are trademarks of Microsoft Corp.
  292.  
  293.  
  294.