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