home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1992 / TheOrigSharewareV1.cdr / 25 / pkzf11.exe / PKZFIND.DOC < prev    next >
Text File  |  1989-10-20  |  9KB  |  278 lines
  1. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                         Table of Contents
  8.                         -----------------
  9.  
  10.  
  11.  
  12.  Topic                                                 Page
  13.  -----                                                 ----
  14.  
  15.     Features ........................................... 2
  16.  
  17.     Using PKZFIND ...................................... 2
  18.  
  19.     Explanation of options ............................. 4
  20.  
  21.     PKZFIND Messages ................................... 5
  22.  
  23.     General Information ................................ 6
  24.  
  25.     Software License ................................... 7
  26.  
  27. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 2
  28.  
  29.  
  30.  
  31. Features of PKZFIND
  32. ------------------
  33.  
  34.   o PKZFIND File Finder Plus works like some other "whereis" type
  35.     programs, except with an important Plus.  The Plus is that PKZFIND
  36.     will not only search all the directories on your diskette or hard
  37.     disk like other "whereis" programs, but PKZFIND will search
  38.     through ZIP files too.  Once PKZFIND finds the desired file,
  39.     PKZFIND can automatically change to the subdirectory where the
  40.     file was found!  PKZFIND will allow you to find any file, Zipped
  41.     or not, simply and easily.
  42.  
  43.   o PKZFIND will run on any MS-DOS machine running MS-DOS version 2.0
  44.     or above, and requires only 32K of free memory to run.
  45.  
  46.   o PKZFIND opens files in SHARE mode, allowing for compatibility
  47.     with network software and LANs.
  48.  
  49.   o PKZFIND is not copy protected.
  50.  
  51.  
  52.  
  53. Using PKZFIND
  54. ------------
  55.  
  56. Recursively searches subdirectories + ZIP files for specified files.
  57.  
  58. Usage: PKZFIND [options] [d:path\] file [file...]
  59.  
  60. Options are:
  61.  
  62.   -b             = Brief listing.
  63.   -c             = Continuous listing, no query after each file.
  64.   -d             = List directory names too.
  65.   -j             = Jump to drive & directory where the first file is found.
  66.   -n             = Do not search ZIP files.
  67.   -z             = Search only ZIP files.
  68.  
  69.   d:path\        = Drive and/or path to start search.  The default
  70.                    is the root directory of the current drive.  If
  71.                    just a drive letter is given, the search will
  72.                    start at the root directory of that drive.  A
  73.                    period "." can be used to denote the current
  74.                    directory.
  75.  
  76.   file [file...] = List of one or more files to search for.  The
  77.                    wildcards * and ? can be used as part of the
  78.                    filename(s).  If no extension is specified, then
  79.                    ".*" will be assumed.
  80.  
  81. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 3
  82.  
  83.  
  84.  
  85. The parameters to PKZFIND can be supplied in any order, and are not
  86. case sensitive.  The options can be preceded by either the "-" or
  87. "/" (DOS switch char) characters.  Multiple options can be specified
  88. together or seperately, in any order.  For example, all the
  89. following syntax are equivalent:
  90.  
  91. pkzfind /dc d: startrek
  92. pkzfind d: -c startrek -d
  93. pkzfind startrek /cd d:
  94.  
  95.  
  96.  
  97. Sample output
  98. -------------
  99.  
  100. Command entered: pkzfind startrek /c
  101.  
  102. PKZFIND   File Finder Plus   Version 1.1   10-20-89
  103. Copyright (c) 1987 PKWARE, Inc. All Rights Reserved.  PKZFIND/h for help
  104.  
  105. /GAMES/STARTREK.ZIP                 43392  01-02-87  00:45:48
  106.    * STARTREK.EXE                   60544  01-22-85  22:57:40
  107. /PIC/PICTURES.ZIP:
  108.    * STARTREK.PIC                  114304  01.12-86  18:08:16
  109. /SIG/SIG0017.ZIP:
  110.    * STARTREK.BAS                   14208  11-02-82  17:07:34
  111.    * STARTREK.DUM                    6144  03-22-82  00:00:00
  112.  
  113. 5 files found.
  114.  
  115.  
  116. The files STARTREK.ZIP, STARTREK.EXE, STARTREK.PIC, STARTREK.BAS
  117. and STARTREK.DUM were found.  The last four files are indented
  118. and preceded by a * indicating that they were found in an ZIP
  119. file.  The name of the ZIP file is listed directly before the
  120. file.  For example, the file STARTREK.EXE is in the ZIP file
  121. STARTREK.ZIP.  Both the files STARTREK.BAS and STARTREK.DUM are in
  122. the ZIP file SIG0017.ZIP.
  123.  
  124. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 4
  125.  
  126.  
  127.  
  128. Explanation of options
  129. ----------------------
  130.  
  131. -b      When PKZFIND finds a file it will display the file's name,
  132.         size, date, and time.  If the -b (brief) option is used
  133.         only the file's name will be displayed.
  134.  
  135. -c      After finding a matching file, PKZFIND will display a
  136.         "More (ynj)?" prompt.  Using the -c (continous listing)
  137.         option will suppress the "More (ynj)?" prompt and cause
  138.         PKZFIND to list all matching files found without stopping.
  139.         PKZFIND can be aborted at any time by pressing Ctrl C or
  140.         Ctrl Break.  If DOS I/O redirection is used, this option
  141.         will default on.
  142.  
  143.         Entering "y" in response to the "More (ynj)?" prompt will
  144.         cause PKZFIND to search for the next matching file.
  145.         Entering "n" will end PKZFIND.  Entering "j" will cause
  146.         PKZFIND to Jump to the drive and subdirectory where the file
  147.         was found.
  148.  
  149. -d      Usually, PKZFIND only searches for files.  Using the -d
  150.         (directory) option will cause PKZFIND to also display
  151.         any matching directory names as well.
  152.  
  153. -j      Jump to the drive and directory where the first matching
  154.         file or directory is found.  This is equivalent to using
  155.     the software without the -c option, and then entering "j"
  156.     as described above.
  157.  
  158. -n      The -n (no ZIP files) option is the opposite of the -z
  159.         option.  Only normal files will be searched for.  Files
  160.         within a ZIP file will not be found.  If you know that
  161.         the desired file is not in a ZIP file, using this option
  162.         can yield better searching performance.
  163.  
  164. -z      The -z (ZIP only) option will force PKZFIND to only
  165.         search ZIP files for the specified file.  Files that
  166.         are not in an ZIP file will not be found.  If you know
  167.         that the desired file is in a ZIP file, using this option
  168.         can yield better searching performance.
  169.  
  170. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 5
  171.  
  172.  
  173.  
  174. PKZFIND messages
  175. ---------------
  176.  
  177. Error in ZIP: ZIP filename
  178.  
  179.   There is an error in the displayed ZIP file.  Searching of
  180.   the ZIP can not proceed.  PKZFIND will skip over this file.
  181.  
  182. PKZFIND: Can't mix Z and D options
  183. PKZFIND: Can't mix Z and N options
  184.  
  185.   The -z (ZIP only) option can not be mixed with either
  186.   the -d (directory) or -n (no ZIP) options.
  187.  
  188.  
  189. Exit Codes
  190. ----------
  191.  
  192. PKZFIND will exit with the following exit codes:
  193.  
  194. 0       At least one or more matching files or directories were found.
  195.  
  196. 1       No matching files of directories were found.
  197.  
  198. 2       Bad or illegal parameters were specified to PKZFIND.
  199.  
  200. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 6
  201.  
  202.  
  203.  
  204. General Information
  205. -------------------
  206.  
  207. PKZFIND will run on any MS-DOS compatible machine running MS-DOS 2.0 
  208. or higher and requires only 32K free RAM.
  209.  
  210. MS-DOS is a registered trademark of Microsoft Corp.
  211.  
  212.  
  213. If you have any questions or comments about PKZFIND send them to
  214. Phil Katz at:
  215.  
  216.  
  217. PKWARE BBS
  218. Glendale, Wisconsin
  219. 414-352-7176
  220.  
  221. or
  222.  
  223. Exec-PC BBS, Bob Mahoney SYSOP
  224. Shorewood, Wisconsin
  225. 414-964-5160
  226.  
  227. or
  228.  
  229. The Sound of Music BBS, Paul Waldinger SYSOP
  230. Oceanside, New York
  231. 516-536-5630
  232.  
  233. or
  234.  
  235. RBBS of Chicago, Loren Jones SYSOP
  236. Chicago, Illinois
  237. 312-352-1035
  238.  
  239. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 7
  240.  
  241.  
  242.  
  243. License
  244. -------
  245.  
  246. Copyright 1989 PKWARE, Inc.  All Rights Reserved.
  247.  
  248. You are free to use, copy and distribute PKZFIND for noncommercial use IF:
  249.  
  250.         NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION.
  251.  
  252.         IT IS NOT MODIFIED IN ANY WAY.
  253.  
  254.  
  255. Clubs and user groups may charge a nominal fee (not to exceed $10)
  256. for expenses and handling while distributing PKZFIND.
  257.  
  258. Site licenses, commercial licenses and custom versions of PKZFIND
  259. are available.  Write to the address below for more information.
  260.  
  261. PKWARE hereby disclaims all warranties relating to this software, whether
  262. express or implied, including without limitation any implied warranties of
  263. merchantability or fitness for a particular purpose. PKWARE will not be liable
  264. for any special, incidental, consequential, indirect or similar damages due to
  265. loss of data or any other reason, even if PKWARE or an agent of PKWARE has
  266. been advised of the possibility of such damages.  In no event shall PKWARE's
  267. liability for any damages ever exceed the price paid for the license to use
  268. software, regardless of the form of the claim.  The person using the software
  269. bears all risk as to the quality and performance of the software.
  270.  
  271. If you find PKZFIND useful and convenient, a registration of $25 would be
  272. appreciated.  Send registrations to:
  273.  
  274. PKWARE, Inc.
  275. 7545 N. Port Washington Rd.
  276. Glendale, WI 53217
  277.  
  278.