home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / pcmag / locate.lzh / LOCATE.DOC < prev   
Text File  |  1988-11-24  |  3KB  |  56 lines
  1.           LOCATE                                  Steven Holzner
  2.           ______________________________________________________
  3.  
  4.           Purpose:  Searches all files in the current and the
  5.                     root directories of a drive for all
  6.                     occurrences of any specified sequence (e.g.,
  7.                     a word or phrase) of up to 20 ASCII
  8.                     characters. Additional search paths and/or
  9.                     drives may be specified by using Option 1.
  10.  
  11.           Format:   LOCATE searchstring
  12.  
  13.           Remarks:  In addition to returning the path(s) and
  14.                     filename(s) of the file(s) in which the
  15.                     requested string is found, LOCATE puts
  16.                     searchstring into a context of up to 20
  17.                     immediately surrounding characters.
  18.  
  19.                     LOCATE.COM is case sensitive;  the string to
  20.                     be found must be typed exactly.  The program
  21.                     does, however, strip "high-order" (non-ASCII)
  22.                     bits from searchstring, so it can be used,
  23.                     for example with WordStar document files.
  24.  
  25.                     Note:
  26.  
  27.                     1.   Requires the use of DOS 2.0 or later.
  28.  
  29.           Option 1: Normally, if LOCATE does not find the
  30.                     requested string either in the current
  31.                     directory or in the disk's root directory, it
  32.                     simply exits.  It does not automatically
  33.                     search every subdirectory on every drive.
  34.  
  35.                     You can extend the search range, however, by
  36.                     preparing a simple ASCII file that specifies
  37.                     additional paths and/or drives.  The name of
  38.                     this file must be PATH.DAT, and it must be
  39.                     located in the root directory (usually C:\
  40.                     for hard disks, A:\ for floppies).  An
  41.                     example of such a PATH.DAT file would be
  42.  
  43.                     \WORK
  44.                     \LEVEL1
  45.                     \A:
  46.  
  47.                     Each line in the PATH.DAT file must end with
  48.                     a carriage return and specifies an additional
  49.                     path (or drive) for LOCATE to check before it
  50.                     exits.  The PATH.DAT file can be up to 300
  51.                     bytes in length, and incorrectly specified
  52.                     entries are ignored.
  53.  
  54.                     The use of Option 1 will, of course, slow
  55.                     down the overall speed of the search.
  56.