home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / dos_util / jff20d.zip / JFF.DOC < prev    next >
Text File  |  1993-09-03  |  14KB  |  408 lines
  1.  
  2.  
  3.  
  4.  
  5.  ********************************************************************
  6.  *                                                                  *
  7.  *                 Jason's File Finder - Version 2.0d               *
  8.  *              Copyright 1991-1993, Zinfandel Software             *
  9.  *                                                                  *
  10.  *                     Published exclusively by:                    *
  11.  *                       RMH Computer Services                      *
  12.  *                            PO Box  657                           *
  13.  *                     Beech Grove IN 46107-0657                    *
  14.  *                          (317)  782-9903                         *
  15.  *                                                                  *
  16.  ********************************************************************
  17.  
  18.                          _______
  19.                     ____|__     |               (R)
  20.                  --|       |    |-------------------
  21.                    |   ____|__  |  Association of
  22.                    |  |       |_|  Shareware
  23.                    |__|   o   |    Professionals
  24.                  -----|   |   |---------------------
  25.                       |___|___|    MEMBER
  26.              
  27.  
  28. RMH Computer Services is a member of the Association of Shareware 
  29. Professionals (ASP).  ASP wants to make sure that the shareware 
  30. principle works for you. If you are unable to resolve a 
  31. shareware-related problem with an ASP member by contacting the member 
  32. directly, ASP may be able to help. The ASP Ombudsman can help you 
  33. resolve a dispute or problem with an ASP member, but does not provide 
  34. technical support for members' products.  Please write to the ASP 
  35. Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 USA, FAX 
  36. 616-788-2765 or send a CompuServe message via CompuServe Mail to ASP 
  37. Ombudsman 70007,3536.
  38.  
  39.  
  40. Jason's File Finder (later referred to simply as JFF) is an extremely 
  41. FAST and easy to use file finder. It accepts standard DOS wildcard 
  42. specifications. It will search for multiple files. It will search 
  43. across multiple drives. It will search across multiple "specified" 
  44. drives, or will search a range of drives. It will search an entire 
  45. drive or just a specified subdirectory. It will display byte counts 
  46. for the files found. And, it will optionally perform a DOS command on 
  47. any found files.
  48.  
  49.  
  50.  
  51. WARRANTY
  52. --------
  53. Neither Zinfandel Software nor RMH Computer Services make warranty of 
  54. any kind, express or implied, including without limitation, any 
  55. warranties of merchantability and/or fitness for a particular purpose.  
  56. Neither Zinfandel Software nor RMH Computer Services shall be liable 
  57. for any damages, whether direct, indirect, special or consequential 
  58. arising from a failure of this program to operate in the manner 
  59. desired by the user. Neither Zinfandel Software nor RMH Computer 
  60. Services shall be liable for any damage to data or property which may 
  61. be caused directly or indirectly by use of the program.
  62.  
  63. IN NO EVENT WILL ZINFANDEL SOFTWARE OR RMH COMPUTER SERVICES BE LIABLE 
  64. FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER 
  65. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR 
  66. INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  67.  
  68.  
  69. INSTALLATION: 
  70. -------------
  71. Installation of JFF is very easy. Simply place a copy of the 
  72. executable file (JFF.EXE) on a floppy disk, or in a subdirectory on 
  73. your hard drive. For installation to a hard drive, it is recommended 
  74. that you place the files in a subdirectory which is included in your 
  75. PATH statement, as this will allow you to run the program from any 
  76. place on your system.
  77.  
  78. QUICK START: 
  79. ------------
  80. Simply executing the command JFF HELP, followed by pressing the 
  81. [ENTER] key will start the program and display a help screen listing 
  82. examples of the various commands that are available to you. 
  83.  
  84. Alternately, if you include a filename.ext on the command line after 
  85. JFF (separated by a single [SPACE]), JFF will search the current drive 
  86. (including all subdirectories) for the specified file. Valid DOS 
  87. wildcard characters are accepted. 
  88.  
  89. PRINTING THE DOCUMENTATION:
  90. ---------------------------
  91. This documentation file is formatted for 70-characters per line, and 
  92. 60-lines per page. To print the documentation, you can simply issue 
  93. the following command from the DOS command line:
  94.  
  95.      COPY JFF.DOC PRN
  96.  
  97. The documentation file contains form-feed characters, so it can also 
  98. be printed by various printing utilities.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106. ======================================================================
  107. JASON'S FILE FINDER v2.0d                                      PAGE 01
  108.  
  109.  
  110.  
  111. COMMAND LINE SYNTAX
  112. -------------------
  113.  
  114. The basic command line syntax for JFF is:
  115.  
  116.         JFF DRIVES ; FILESPECS ; COMMAND
  117.      
  118. where DRIVES is the list of drives (and/or directories) that you wish 
  119. to perform the search on, FILESPECS is the list of files that you wish 
  120. to search for, and COMMAND is the optional DOS command that you wish 
  121. to perform on all files that are found. Both DRIVES and COMMAND are 
  122. optional. If any combination of the command line parameters DRIVES and 
  123. COMMAND are used, the parameters must be separated by a ";" character. 
  124. Multiple specifications in the DRIVES and FILESPECS parameters must be 
  125. separated by "," characters.
  126.  
  127. The basic syntax can be remembered as:
  128.  
  129.    (1) Optionally specify search drives, if any, separated by commas, 
  130.        end with semicolon
  131.    (2) Specify search specs, separated by commas
  132.    (3) Optionally specify a DOS Command (in brackets), begin with 
  133.        semicolon
  134.  
  135. The ";" (semicolon) character separates the various DRIVES, FILESPECS,
  136. and the DOS Command like so:  DRIVES ; SPECS ; [COMMAND]. 
  137.  
  138. The "," (comma) character separates any multiple specifications within 
  139. any of the DRIVES and FILESPECS, like so: DRIVE1, DRIVE2 ; FILESPEC1, 
  140. FILESPEC2 ; [COMMAND]
  141.  
  142. Specifying DRIVES and a [COMMAND] is OPTIONAL, the only necessary 
  143. thing you need to specify are the file SPECS.
  144.  
  145.  
  146. BASIC OPERATION
  147. ---------------
  148. In it's most simple form, the following command will search the 
  149. current drive (including all subdirectories) for the specified file:
  150.  
  151.         JFF filename.ext
  152.  
  153. Likewise, DOS wildcards may be used in the filename spec:
  154.  
  155.         JFF *.BAK
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166. ======================================================================
  167. JASON'S FILE FINDER v2.0d                                      PAGE 02
  168.  
  169.  
  170.  
  171. MULTIPLE FILES SEARCHING
  172. ------------------------
  173. If you want to search for multiple files, each filespec may be entered 
  174. on the command line, separated by a "," (comma). For example:
  175.  
  176.         JFF *.BAT, *.EXE, WIN??.EMT, S*.GIF
  177.  
  178. would search the current drive (including all subdirectories) for:
  179.         all files with extensions of .BAT
  180.         all files with extensions of .EXE
  181.         all files with extensions of .EMT which begin with WIN
  182.         all files with extensions of .GIF which begin with S
  183.  
  184. Notice that each filespec is separated by a ","
  185.  
  186.  
  187. MULTIPLE DRIVE SEARCHING
  188. ------------------------
  189. If you want to search across multiple drives, you can enter the drive 
  190. list preceding the filespec, again separated with "," characters. The 
  191. DRIVE specs and the FILE specs must be separated by a ";" character. 
  192. For example:
  193.  
  194.         JFF C,D,E; *.EXE
  195.  
  196. would search for all files with .EXE in all subdirectories on Drives 
  197. C:, D:, and E:.
  198.  
  199. You can also specify a "range" of drives to search, by listing the 
  200. beginning and ending drive spec, separated by a "-" (minus) character. 
  201. For example:
  202.  
  203.         JFF D-F; *.GIF
  204.  
  205. would search all subdirectories on drives D thru F (i.e. D:, E:, and 
  206. F:) for all files with an extension of .GIF.
  207.  
  208. You can also use a combination of "specified" drives and "range" of 
  209. drives. For example:
  210.  
  211.         JFF A,B, H-J; *.GIF
  212.  
  213. would search all subdirectories on drives A:, B:, H:, I:, and J: for 
  214. any files with an extension of .GIF. Notice that all parameters in the 
  215. DRIVES spec are separated by "," characters, and the DRIVES and FILES 
  216. specs are separated by a ";" character.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. ======================================================================
  227. JASON'S FILE FINDER v2.0d                                      PAGE 03
  228.  
  229.  
  230.  
  231. MULTIPLE FILE SEARCHES ACROSS MULTIPLE DRIVES
  232. --------------------------------------------
  233. You can combine all of the above options, and search for multiple file 
  234. specs across multiple drives as well. For example:
  235.  
  236.         JFF A,B,E-I; *.BAT, *.EXE, *.COM
  237.  
  238. would search in all subdirectories on drives A:, B:, E:, F:, G:, H:, 
  239. and I:, and would search for all files having an extension of .BAT, 
  240. .EXE, and .COM. Again, notice that each DRIVE spec is separated by a 
  241. "," character, each FILE spec is separated by a "," character, and the 
  242. DRIVES and FILES specs are separated by a ";" character.
  243.  
  244.  
  245. SEARCHING SPECIFIED SUBDIRECTORIES
  246. ----------------------------------
  247. In the DRIVES specification, you can also select specific 
  248. subdirectories to search in, rather than searching the entire drive. 
  249. For example:
  250.  
  251.         JFF C:\DOS; *.TXT
  252.  
  253. would not search the entire C: drive, but rather only the \DOS 
  254. subdirectory (and any subdirectories underneath the \DOS directory) 
  255. for all files with an extension of .TXT.
  256.  
  257. You may also specify a combination of "All Drive" and "specified 
  258. subdirectory" on the command line. For example:
  259.  
  260.         JFF C, E:\MISC; *.TXT
  261.  
  262. would search the entire C: drive (including all subdirectories) and 
  263. the \MISC directory on the E: drive (including all subdirectories 
  264. underneath the \MISC directory) for all files with a .TXT extension.
  265.  
  266.  
  267. EXECUTING A DOS COMMAND ON FOUND FILES
  268. --------------------------------------
  269. You can also include a DOS command, which will be performed on ALL 
  270. files that are found by JFF. The command must be the last parameter on 
  271. the command line, and must be enclosed by square bracket ([ ]) 
  272. characters. The filespec parameter for the command will be #1. For 
  273. example:
  274.  
  275.         JFF *.GIF; [COPY #1 A:]
  276.  
  277. would search the entire current drive for all files with an extension 
  278. of .GIF, and then would COPY each file to drive A:
  279.  
  280.         JFF C,D; *.BAK, *.TMP; [DEL #1]
  281.  
  282. would search drives C: and D: for all files with extensions of .BAK 
  283. and .TMP, and would then DELete those those files.
  284.  
  285.  
  286. ======================================================================
  287. JASON'S FILE FINDER v2.0d                                      PAGE 04
  288.  
  289.  
  290.  
  291.         JFF A,B, D-H; *.GIF, *.BMP, *.PCX; [COPY #1 Z:\PICTURES]
  292.  
  293. would search drives A:, B:, D:, E:, F:, G:, and H: for any file with 
  294. extensions of .GIF, .BMP, and .PCX, and would then copy all of those 
  295. files to the \PICTURES directory on Drive Z:
  296.  
  297. When you perform any Dos command, no output will be displayed on the 
  298. screen from jFF... this is because many DOS commands have their own 
  299. output and would probably corrupt jFF's output.
  300.  
  301.  
  302. FINDING A BYTE-COUNT
  303. --------------------
  304. If you would like to find out how many bytes a certain spec takes up 
  305. on your disks without having to see all of them displayed, you can 
  306. include a parameter of [BYTECOUNT] at the end of the command line 
  307. (preceding by a ";" character). For example:
  308.  
  309.         JFF A,B; *.GIF, *.BMP; [BYTECOUNT]
  310.  
  311. That would calculate the byte count of all *.GIF and *.BMP files on 
  312. your A: and B: drives
  313.  
  314.  
  315. REGISTRATION BENEFITS
  316. ---------------------
  317. Registered users of Jason's File Finder (JFF) will receive:
  318.  
  319.      1) A lifetime license to use the product.
  320.  
  321.      2) Support via the phone, by fax, mail, CompuServe, and various 
  322.         other message networks.
  323.  
  324.      3) A 30 day money-back guarantee.
  325.  
  326.      4) Special discounts and online credits for CompuServe.
  327.  
  328.      5) Special discounts on magazines, newsletter, and products from 
  329.         Public (software) Libraries.
  330.  
  331.      6) Special discounts on Shareware Magazine, one of the industry's 
  332.         foremost publications, by Mike Callahan (alias Dr. FileFinder)
  333.  
  334. In addition to the registered benefits listed above, registered users 
  335. may also:
  336.  
  337.      7) purchase the source code for the program, so that they can 
  338.         create their own custom modifications to the program.
  339.  
  340.      8) request customized versions of the program. Fees for 
  341.         customized versions must be negotiated in advance.
  342.  
  343. And apart from all that, the knowledge that you are helping to support 
  344. the Shareware concept - a distribution system that brings you quality 
  345. software at realistic prices.
  346. ======================================================================
  347. JASON'S FILE FINDER v2.0d                                      PAGE 05
  348.  
  349.  
  350.  
  351. PRODUCT SUPPORT
  352. ---------------
  353. Registered users are entitled to full product support via mail or 
  354. telephone for a period of not less than 90 days. Support may also be 
  355. obtained via Compuserve email, and other electronic services. If 
  356. technical problems in the software are discovered within 90 days of 
  357. registration, RMH Computer Services will, at their option, either 
  358. provide a workable solution to the problem or a refund of the 
  359. registration cost. After the initial 90 days, RMH Computer Services is 
  360. only obligated to make reasonable effort to supply a revised copy of 
  361. the software.
  362.  
  363. Support for unregistered users will be available in regards to product
  364. installation and basic program operation.
  365.  
  366. Support via mail is available at RMH Computer Services, PO Box 657, 
  367. Beech Grove IN 46107-0657 USA. Telephone support is available at 
  368. 317-782-9903 between the hours of 08:00am - 06:00pm EST. Email support 
  369. is also available via our BBS at 317-784-2147 24hrs/day (*). You may 
  370. also direct email to Richard Holler via Compuserve [73567,1547], 
  371. INTERNET:73567.1547@compuserve.com, FidoNet NetMail [1:231/290], and 
  372. RIME private/routed email [->5056].
  373.  
  374. (*) When logging on to the BBS, using the name RMH COMPUTER, and a 
  375. password of SERVICES will take you directly to the RMH Computer 
  376. Services support/distribution area, and will bypass all of the 1st 
  377. time caller questionaires.
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405. ======================================================================
  406. JASON'S FILE FINDER v2.0d                                      PAGE 06
  407.  
  408.